@adnsistemas/pdf-lib 1.18.0

package/es/utils/unicode.js

@@ -0,0 +1,367 @@
+import { toHexString } from "./strings";
+/**
+ * Encodes a string to UTF-8.
+ *
+ * @param input The string to be encoded.
+ * @param byteOrderMark Whether or not a byte order marker (BOM) should be added
+ *                      to the start of the encoding. (default `true`)
+ * @returns A Uint8Array containing the UTF-8 encoding of the input string.
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * JavaScript strings are composed of Unicode code points. Code points are
+ * integers in the range 0 to 1,114,111 (0x10FFFF). When serializing a string,
+ * it must be encoded as a sequence of words. A word is typically 8, 16, or 32
+ * bytes in size. As such, Unicode defines three encoding forms: UTF-8, UTF-16,
+ * and UTF-32. These encoding forms are described in the Unicode standard [1].
+ * This function implements the UTF-8 encoding form.
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * In UTF-8, each code point is mapped to a sequence of 1, 2, 3, or 4 bytes.
+ * Note that the logic which defines this mapping is slightly convoluted, and
+ * not as straightforward as the mapping logic for UTF-16 or UTF-32. The UTF-8
+ * mapping logic is as follows [2]:
+ *
+ * • If a code point is in the range U+0000..U+007F, then view it as a 7-bit
+ *   integer: 0bxxxxxxx. Map the code point to 1 byte with the first high order
+ *   bit set to 0:
+ *
+ *       b1=0b0xxxxxxx
+ *
+ * • If a code point is in the range U+0080..U+07FF, then view it as an 11-bit
+ *   integer: 0byyyyyxxxxxx. Map the code point to 2 bytes with the first 5 bits
+ *   of the code point stored in the first byte, and the last 6 bits stored in
+ *   the second byte:
+ *
+ *       b1=0b110yyyyy    b2=0b10xxxxxx
+ *
+ * • If a code point is in the range U+0800..U+FFFF, then view it as a 16-bit
+ *   integer, 0bzzzzyyyyyyxxxxxx. Map the code point to 3 bytes with the first
+ *   4 bits stored in the first byte, the next 6 bits stored in the second byte,
+ *   and the last 6 bits in the third byte:
+ *
+ *       b1=0b1110zzzz    b2=0b10yyyyyy    b3=0b10xxxxxx
+ *
+ * • If a code point is in the range U+10000...U+10FFFF, then view it as a
+ *   21-bit integer, 0bvvvzzzzzzyyyyyyxxxxxx. Map the code point to 4 bytes with
+ *   the first 3 bits stored in the first byte, the next 6 bits stored in the
+ *   second byte, the next 6 bits stored in the third byte, and the last 6 bits
+ *   stored in the fourth byte:
+ *
+ *       b1=0b11110xxx    b2=0b10zzzzzz    b3=0b10yyyyyy    b4=0b10xxxxxx
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * It is important to note, when iterating through the code points of a string
+ * in JavaScript, that if a character is encoded as a surrogate pair it will
+ * increase the string's length by 2 instead of 1 [4]. For example:
+ *
+ * ```
+ * > 'a'.length
+ * 1
+ * > '💩'.length
+ * 2
+ * > '語'.length
+ * 1
+ * > 'a💩語'.length
+ * 4
+ * ```
+ *
+ * The results of the above example are explained by the fact that the
+ * characters 'a' and '語' are not represented by surrogate pairs, but '💩' is.
+ *
+ * Because of this idiosyncrasy in JavaScript's string implementation and APIs,
+ * we must "jump" an extra index after encoding a character as a surrogate
+ * pair. In practice, this means we must increment the index of our for loop by
+ * 2 if we encode a surrogate pair, and 1 in all other cases.
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * References:
+ *   - [1] https://www.unicode.org/versions/Unicode12.0.0/UnicodeStandard-12.0.pdf
+ *         3.9  Unicode Encoding Forms - UTF-8
+ *   - [2] http://www.herongyang.com/Unicode/UTF-8-UTF-8-Encoding.html
+ *   - [3] http://www.herongyang.com/Unicode/UTF-8-UTF-8-Encoding-Algorithm.html
+ *   - [4] https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/length#Description
+ *
+ */
+export var utf8Encode = function (input, byteOrderMark) {
+    if (byteOrderMark === void 0) { byteOrderMark = true; }
+    var encoded = [];
+    if (byteOrderMark)
+        encoded.push(0xef, 0xbb, 0xbf);
+    for (var idx = 0, len = input.length; idx < len;) {
+        var codePoint = input.codePointAt(idx);
+        // One byte encoding
+        if (codePoint < 0x80) {
+            var byte1 = codePoint & 0x7f;
+            encoded.push(byte1);
+            idx += 1;
+        }
+        // Two byte encoding
+        else if (codePoint < 0x0800) {
+            var byte1 = ((codePoint >> 6) & 0x1f) | 0xc0;
+            var byte2 = (codePoint & 0x3f) | 0x80;
+            encoded.push(byte1, byte2);
+            idx += 1;
+        }
+        // Three byte encoding
+        else if (codePoint < 0x010000) {
+            var byte1 = ((codePoint >> 12) & 0x0f) | 0xe0;
+            var byte2 = ((codePoint >> 6) & 0x3f) | 0x80;
+            var byte3 = (codePoint & 0x3f) | 0x80;
+            encoded.push(byte1, byte2, byte3);
+            idx += 1;
+        }
+        // Four byte encoding (surrogate pair)
+        else if (codePoint < 0x110000) {
+            var byte1 = ((codePoint >> 18) & 0x07) | 0xf0;
+            var byte2 = ((codePoint >> 12) & 0x3f) | 0x80;
+            var byte3 = ((codePoint >> 6) & 0x3f) | 0x80;
+            var byte4 = ((codePoint >> 0) & 0x3f) | 0x80;
+            encoded.push(byte1, byte2, byte3, byte4);
+            idx += 2;
+        }
+        // Should never reach this case
+        else
+            throw new Error("Invalid code point: 0x" + toHexString(codePoint));
+    }
+    return new Uint8Array(encoded);
+};
+/**
+ * Encodes a string to UTF-16.
+ *
+ * @param input The string to be encoded.
+ * @param byteOrderMark Whether or not a byte order marker (BOM) should be added
+ *                      to the start of the encoding. (default `true`)
+ * @returns A Uint16Array containing the UTF-16 encoding of the input string.
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * JavaScript strings are composed of Unicode code points. Code points are
+ * integers in the range 0 to 1,114,111 (0x10FFFF). When serializing a string,
+ * it must be encoded as a sequence of words. A word is typically 8, 16, or 32
+ * bytes in size. As such, Unicode defines three encoding forms: UTF-8, UTF-16,
+ * and UTF-32. These encoding forms are described in the Unicode standard [1].
+ * This function implements the UTF-16 encoding form.
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * In UTF-16, each code point is mapped to one or two 16-bit integers. The
+ * UTF-16 mapping logic is as follows [2]:
+ *
+ * • If a code point is in the range U+0000..U+FFFF, then map the code point to
+ *   a 16-bit integer with the most significant byte first.
+ *
+ * • If a code point is in the range U+10000..U+10000, then map the code point
+ *   to two 16-bit integers. The first integer should contain the high surrogate
+ *   and the second integer should contain the low surrogate. Both surrogates
+ *   should be written with the most significant byte first.
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * It is important to note, when iterating through the code points of a string
+ * in JavaScript, that if a character is encoded as a surrogate pair it will
+ * increase the string's length by 2 instead of 1 [4]. For example:
+ *
+ * ```
+ * > 'a'.length
+ * 1
+ * > '💩'.length
+ * 2
+ * > '語'.length
+ * 1
+ * > 'a💩語'.length
+ * 4
+ * ```
+ *
+ * The results of the above example are explained by the fact that the
+ * characters 'a' and '語' are not represented by surrogate pairs, but '💩' is.
+ *
+ * Because of this idiosyncrasy in JavaScript's string implementation and APIs,
+ * we must "jump" an extra index after encoding a character as a surrogate
+ * pair. In practice, this means we must increment the index of our for loop by
+ * 2 if we encode a surrogate pair, and 1 in all other cases.
+ *
+ * -----------------------------------------------------------------------------
+ *
+ * References:
+ *   - [1] https://www.unicode.org/versions/Unicode12.0.0/UnicodeStandard-12.0.pdf
+ *         3.9  Unicode Encoding Forms - UTF-8
+ *   - [2] http://www.herongyang.com/Unicode/UTF-16-UTF-16-Encoding.html
+ *   - [3] https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/length#Description
+ *
+ */
+export var utf16Encode = function (input, byteOrderMark) {
+    if (byteOrderMark === void 0) { byteOrderMark = true; }
+    var encoded = [];
+    if (byteOrderMark)
+        encoded.push(0xfeff);
+    for (var idx = 0, len = input.length; idx < len;) {
+        var codePoint = input.codePointAt(idx);
+        // Two byte encoding
+        if (codePoint < 0x010000) {
+            encoded.push(codePoint);
+            idx += 1;
+        }
+        // Four byte encoding (surrogate pair)
+        else if (codePoint < 0x110000) {
+            encoded.push(highSurrogate(codePoint), lowSurrogate(codePoint));
+            idx += 2;
+        }
+        // Should never reach this case
+        else
+            throw new Error("Invalid code point: 0x" + toHexString(codePoint));
+    }
+    return new Uint16Array(encoded);
+};
+/**
+ * Returns `true` if the `codePoint` is within the
+ * Basic Multilingual Plane (BMP). Code points inside the BMP are not encoded
+ * with surrogate pairs.
+ * @param codePoint The code point to be evaluated.
+ *
+ * Reference: https://en.wikipedia.org/wiki/UTF-16#Description
+ */
+export var isWithinBMP = function (codePoint) {
+    return codePoint >= 0 && codePoint <= 0xffff;
+};
+/**
+ * Returns `true` if the given `codePoint` is valid and must be represented
+ * with a surrogate pair when encoded.
+ * @param codePoint The code point to be evaluated.
+ *
+ * Reference: https://en.wikipedia.org/wiki/UTF-16#Description
+ */
+export var hasSurrogates = function (codePoint) {
+    return codePoint >= 0x010000 && codePoint <= 0x10ffff;
+};
+// From Unicode 3.0 spec, section 3.7:
+//   http://unicode.org/versions/Unicode3.0.0/ch03.pdf
+export var highSurrogate = function (codePoint) {
+    return Math.floor((codePoint - 0x10000) / 0x400) + 0xd800;
+};
+// From Unicode 3.0 spec, section 3.7:
+//   http://unicode.org/versions/Unicode3.0.0/ch03.pdf
+export var lowSurrogate = function (codePoint) {
+    return ((codePoint - 0x10000) % 0x400) + 0xdc00;
+};
+var ByteOrder;
+(function (ByteOrder) {
+    ByteOrder["BigEndian"] = "BigEndian";
+    ByteOrder["LittleEndian"] = "LittleEndian";
+})(ByteOrder || (ByteOrder = {}));
+var REPLACEMENT = '�'.codePointAt(0);
+/**
+ * Decodes a Uint8Array of data to a string using UTF-16.
+ *
+ * Note that this function attempts to recover from erronous input by
+ * inserting the replacement character (�) to mark invalid code points
+ * and surrogate pairs.
+ *
+ * @param input A Uint8Array containing UTF-16 encoded data
+ * @param byteOrderMark Whether or not a byte order marker (BOM) should be read
+ *                      at the start of the encoding. (default `true`)
+ * @returns The decoded string.
+ */
+export var utf16Decode = function (input, byteOrderMark) {
+    if (byteOrderMark === void 0) { byteOrderMark = true; }
+    // Need at least 2 bytes of data in UTF-16 encodings
+    if (input.length <= 1)
+        return String.fromCodePoint(REPLACEMENT);
+    var byteOrder = byteOrderMark ? readBOM(input) : ByteOrder.BigEndian;
+    // Skip byte order mark if needed
+    var idx = byteOrderMark ? 2 : 0;
+    var codePoints = [];
+    while (input.length - idx >= 2) {
+        var first = decodeValues(input[idx++], input[idx++], byteOrder);
+        if (isHighSurrogate(first)) {
+            if (input.length - idx < 2) {
+                // Need at least 2 bytes left for the low surrogate that is required
+                codePoints.push(REPLACEMENT);
+            }
+            else {
+                var second = decodeValues(input[idx++], input[idx++], byteOrder);
+                if (isLowSurrogate(second)) {
+                    codePoints.push(first, second);
+                }
+                else {
+                    // Low surrogates should always follow high surrogates
+                    codePoints.push(REPLACEMENT);
+                }
+            }
+        }
+        else if (isLowSurrogate(first)) {
+            // High surrogates should always come first since `decodeValues()`
+            // accounts for the byte ordering
+            idx += 2;
+            codePoints.push(REPLACEMENT);
+        }
+        else {
+            codePoints.push(first);
+        }
+    }
+    // There shouldn't be extra byte(s) left over
+    if (idx < input.length)
+        codePoints.push(REPLACEMENT);
+    return String.fromCodePoint.apply(String, codePoints);
+};
+/**
+ * Returns `true` if the given `codePoint` is a high surrogate.
+ * @param codePoint The code point to be evaluated.
+ *
+ * Reference: https://en.wikipedia.org/wiki/UTF-16#Description
+ */
+var isHighSurrogate = function (codePoint) {
+    return codePoint >= 0xd800 && codePoint <= 0xdbff;
+};
+/**
+ * Returns `true` if the given `codePoint` is a low surrogate.
+ * @param codePoint The code point to be evaluated.
+ *
+ * Reference: https://en.wikipedia.org/wiki/UTF-16#Description
+ */
+var isLowSurrogate = function (codePoint) {
+    return codePoint >= 0xdc00 && codePoint <= 0xdfff;
+};
+/**
+ * Decodes the given utf-16 values first and second using the specified
+ * byte order.
+ * @param first The first byte of the encoding.
+ * @param second The second byte of the encoding.
+ * @param byteOrder The byte order of the encoding.
+ * Reference: https://en.wikipedia.org/wiki/UTF-16#Examples
+ */
+var decodeValues = function (first, second, byteOrder) {
+    // Append the binary representation of the preceding byte by shifting the
+    // first one 8 to the left and than applying a bitwise or-operator to append
+    // the second one.
+    if (byteOrder === ByteOrder.LittleEndian)
+        return (second << 8) | first;
+    if (byteOrder === ByteOrder.BigEndian)
+        return (first << 8) | second;
+    throw new Error("Invalid byteOrder: " + byteOrder);
+};
+/**
+ * Returns whether the given array contains a byte order mark for the
+ * UTF-16BE or UTF-16LE encoding. If it has neither, BigEndian is assumed.
+ *
+ * Reference: https://en.wikipedia.org/wiki/Byte_order_mark#UTF-16
+ *
+ * @param bytes The byte array to be evaluated.
+ */
+// prettier-ignore
+var readBOM = function (bytes) { return (hasUtf16BigEndianBOM(bytes) ? ByteOrder.BigEndian
+    : hasUtf16LittleEndianBOM(bytes) ? ByteOrder.LittleEndian
+        : ByteOrder.BigEndian); };
+var hasUtf16BigEndianBOM = function (bytes) {
+    return bytes[0] === 0xfe && bytes[1] === 0xff;
+};
+var hasUtf16LittleEndianBOM = function (bytes) {
+    return bytes[0] === 0xff && bytes[1] === 0xfe;
+};
+export var hasUtf16BOM = function (bytes) {
+    return hasUtf16BigEndianBOM(bytes) || hasUtf16LittleEndianBOM(bytes);
+};
+//# sourceMappingURL=unicode.js.map

package/es/utils/unicode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode.js","sourceRoot":"","sources":["../../src/utils/unicode.ts"],"names":[],"mappings":"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"}

package/es/utils/validators.d.ts

@@ -0,0 +1,27 @@
+export declare const backtick: (val: any) => string;
+export declare const singleQuote: (val: any) => string;
+declare type Primitive = string | number | boolean | undefined | null;
+export declare const createValueErrorMsg: (value: any, valueName: string, values: Primitive[]) => string;
+export declare const assertIsOneOf: (value: any, valueName: string, allowedValues: Primitive[] | {
+    [key: string]: Primitive;
+}) => void;
+export declare const assertIsOneOfOrUndefined: (value: any, valueName: string, allowedValues: Primitive[] | {
+    [key: string]: Primitive;
+}) => void;
+export declare const assertIsSubset: (values: any[], valueName: string, allowedValues: Primitive[] | {
+    [key: string]: Primitive;
+}) => void;
+export declare const getType: (val: any) => any;
+export declare type TypeDescriptor = 'null' | 'undefined' | 'string' | 'number' | 'boolean' | 'symbol' | 'bigint' | DateConstructor | ArrayConstructor | Uint8ArrayConstructor | ArrayBufferConstructor | FunctionConstructor | [Function, string];
+export declare const isType: (value: any, type: TypeDescriptor) => boolean;
+export declare const createTypeErrorMsg: (value: any, valueName: string, types: TypeDescriptor[]) => string;
+export declare const assertIs: (value: any, valueName: string, types: TypeDescriptor[]) => void;
+export declare const assertOrUndefined: (value: any, valueName: string, types: TypeDescriptor[]) => void;
+export declare const assertEachIs: (values: any[], valueName: string, types: TypeDescriptor[]) => void;
+export declare const assertRange: (value: any, valueName: string, min: number, max: number) => void;
+export declare const assertRangeOrUndefined: (value: any, valueName: string, min: number, max: number) => void;
+export declare const assertMultiple: (value: any, valueName: string, multiplier: number) => void;
+export declare const assertInteger: (value: any, valueName: string) => void;
+export declare const assertPositive: (value: number, valueName: string) => void;
+export {};
+//# sourceMappingURL=validators.d.ts.map

package/es/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,QAAQ,QAAS,GAAG,WAAiB,CAAC;AACnD,eAAO,MAAM,WAAW,QAAS,GAAG,WAAe,CAAC;AAEpD,aAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAU9D,eAAO,MAAM,mBAAmB,UACvB,GAAG,aACC,MAAM,UACT,SAAS,EAAE,WAapB,CAAC;AAEF,eAAO,MAAM,aAAa,UACjB,GAAG,aACC,MAAM;;UAUlB,CAAC;AAEF,eAAO,MAAM,wBAAwB,UAC5B,GAAG,aACC,MAAM;;UAOlB,CAAC;AAEF,eAAO,MAAM,cAAc,WACjB,GAAG,EAAE,aACF,MAAM;;UASlB,CAAC;AAEF,eAAO,MAAM,OAAO,QAAS,GAAG,QAa/B,CAAC;AAEF,oBAAY,cAAc,GACtB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,eAAe,GACf,gBAAgB,GAChB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEvB,eAAO,MAAM,MAAM,UAAW,GAAG,QAAQ,cAAc,YActD,CAAC;AAEF,eAAO,MAAM,kBAAkB,UACtB,GAAG,aACC,MAAM,SACV,cAAc,EAAE,WAuBxB,CAAC;AAEF,eAAO,MAAM,QAAQ,UACZ,GAAG,aACC,MAAM,SACV,cAAc,EAAE,SAMxB,CAAC;AAEF,eAAO,MAAM,iBAAiB,UACrB,GAAG,aACC,MAAM,SACV,cAAc,EAAE,SAGxB,CAAC;AAEF,eAAO,MAAM,YAAY,WACf,GAAG,EAAE,aACF,MAAM,SACV,cAAc,EAAE,SAKxB,CAAC;AAEF,eAAO,MAAM,WAAW,UACf,GAAG,aACC,MAAM,OACZ,MAAM,OACN,MAAM,SAUZ,CAAC;AAEF,eAAO,MAAM,sBAAsB,UAC1B,GAAG,aACC,MAAM,OACZ,MAAM,OACN,MAAM,SAIZ,CAAC;AAEF,eAAO,MAAM,cAAc,UAClB,GAAG,aACC,MAAM,cACL,MAAM,SAOnB,CAAC;AAEF,eAAO,MAAM,aAAa,UAAW,GAAG,aAAa,MAAM,SAM1D,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,MAAM,aAAa,MAAM,SAK9D,CAAC"}

package/es/utils/validators.js

@@ -0,0 +1,180 @@
+/* tslint:disable:ban-types */
+import { values as objectValues } from "./objects";
+export var backtick = function (val) { return "`" + val + "`"; };
+export var singleQuote = function (val) { return "'" + val + "'"; };
+// prettier-ignore
+var formatValue = function (value) {
+    var type = typeof value;
+    if (type === 'string')
+        return singleQuote(value);
+    else if (type === 'undefined')
+        return backtick(value);
+    else
+        return value;
+};
+export var createValueErrorMsg = function (value, valueName, values) {
+    var allowedValues = new Array(values.length);
+    for (var idx = 0, len = values.length; idx < len; idx++) {
+        var v = values[idx];
+        allowedValues[idx] = formatValue(v);
+    }
+    var joinedValues = allowedValues.join(' or ');
+    // prettier-ignore
+    return backtick(valueName) + " must be one of " + joinedValues + ", but was actually " + formatValue(value);
+};
+export var assertIsOneOf = function (value, valueName, allowedValues) {
+    if (!Array.isArray(allowedValues)) {
+        allowedValues = objectValues(allowedValues);
+    }
+    for (var idx = 0, len = allowedValues.length; idx < len; idx++) {
+        if (value === allowedValues[idx])
+            return;
+    }
+    throw new TypeError(createValueErrorMsg(value, valueName, allowedValues));
+};
+export var assertIsOneOfOrUndefined = function (value, valueName, allowedValues) {
+    if (!Array.isArray(allowedValues)) {
+        allowedValues = objectValues(allowedValues);
+    }
+    assertIsOneOf(value, valueName, allowedValues.concat(undefined));
+};
+export var assertIsSubset = function (values, valueName, allowedValues) {
+    if (!Array.isArray(allowedValues)) {
+        allowedValues = objectValues(allowedValues);
+    }
+    for (var idx = 0, len = values.length; idx < len; idx++) {
+        assertIsOneOf(values[idx], valueName, allowedValues);
+    }
+};
+export var getType = function (val) {
+    if (val === null)
+        return 'null';
+    if (val === undefined)
+        return 'undefined';
+    if (typeof val === 'string')
+        return 'string';
+    if (isNaN(val))
+        return 'NaN';
+    if (typeof val === 'number')
+        return 'number';
+    if (typeof val === 'boolean')
+        return 'boolean';
+    if (typeof val === 'symbol')
+        return 'symbol';
+    if (typeof val === 'bigint')
+        return 'bigint';
+    if (val.constructor && val.constructor.name)
+        return val.constructor.name;
+    if (val.name)
+        return val.name;
+    if (val.constructor)
+        return String(val.constructor);
+    return String(val);
+};
+export var isType = function (value, type) {
+    if (type === 'null')
+        return value === null;
+    if (type === 'undefined')
+        return value === undefined;
+    if (type === 'string')
+        return typeof value === 'string';
+    if (type === 'number')
+        return typeof value === 'number' && !isNaN(value);
+    if (type === 'boolean')
+        return typeof value === 'boolean';
+    if (type === 'symbol')
+        return typeof value === 'symbol';
+    if (type === 'bigint')
+        return typeof value === 'bigint';
+    if (type === Date)
+        return value instanceof Date;
+    if (type === Array)
+        return value instanceof Array;
+    if (type === Uint8Array)
+        return value instanceof Uint8Array;
+    if (type === ArrayBuffer)
+        return value instanceof ArrayBuffer;
+    if (type === Function)
+        return value instanceof Function;
+    return value instanceof type[0];
+};
+export var createTypeErrorMsg = function (value, valueName, types) {
+    var allowedTypes = new Array(types.length);
+    for (var idx = 0, len = types.length; idx < len; idx++) {
+        var type = types[idx];
+        if (type === 'null')
+            allowedTypes[idx] = backtick('null');
+        if (type === 'undefined')
+            allowedTypes[idx] = backtick('undefined');
+        if (type === 'string')
+            allowedTypes[idx] = backtick('string');
+        else if (type === 'number')
+            allowedTypes[idx] = backtick('number');
+        else if (type === 'boolean')
+            allowedTypes[idx] = backtick('boolean');
+        else if (type === 'symbol')
+            allowedTypes[idx] = backtick('symbol');
+        else if (type === 'bigint')
+            allowedTypes[idx] = backtick('bigint');
+        else if (type === Array)
+            allowedTypes[idx] = backtick('Array');
+        else if (type === Uint8Array)
+            allowedTypes[idx] = backtick('Uint8Array');
+        else if (type === ArrayBuffer)
+            allowedTypes[idx] = backtick('ArrayBuffer');
+        else
+            allowedTypes[idx] = backtick(type[1]);
+    }
+    var joinedTypes = allowedTypes.join(' or ');
+    // prettier-ignore
+    return backtick(valueName) + " must be of type " + joinedTypes + ", but was actually of type " + backtick(getType(value));
+};
+export var assertIs = function (value, valueName, types) {
+    for (var idx = 0, len = types.length; idx < len; idx++) {
+        if (isType(value, types[idx]))
+            return;
+    }
+    throw new TypeError(createTypeErrorMsg(value, valueName, types));
+};
+export var assertOrUndefined = function (value, valueName, types) {
+    assertIs(value, valueName, types.concat('undefined'));
+};
+export var assertEachIs = function (values, valueName, types) {
+    for (var idx = 0, len = values.length; idx < len; idx++) {
+        assertIs(values[idx], valueName, types);
+    }
+};
+export var assertRange = function (value, valueName, min, max) {
+    assertIs(value, valueName, ['number']);
+    assertIs(min, 'min', ['number']);
+    assertIs(max, 'max', ['number']);
+    max = Math.max(min, max);
+    if (value < min || value > max) {
+        // prettier-ignore
+        throw new Error(backtick(valueName) + " must be at least " + min + " and at most " + max + ", but was actually " + value);
+    }
+};
+export var assertRangeOrUndefined = function (value, valueName, min, max) {
+    assertIs(value, valueName, ['number', 'undefined']);
+    if (typeof value === 'number')
+        assertRange(value, valueName, min, max);
+};
+export var assertMultiple = function (value, valueName, multiplier) {
+    assertIs(value, valueName, ['number']);
+    if (value % multiplier !== 0) {
+        // prettier-ignore
+        throw new Error(backtick(valueName) + " must be a multiple of " + multiplier + ", but was actually " + value);
+    }
+};
+export var assertInteger = function (value, valueName) {
+    if (!Number.isInteger(value)) {
+        throw new Error(backtick(valueName) + " must be an integer, but was actually " + value);
+    }
+};
+export var assertPositive = function (value, valueName) {
+    if (![1, 0].includes(Math.sign(value))) {
+        // prettier-ignore
+        throw new Error(backtick(valueName) + " must be a positive number or 0, but was actually " + value);
+    }
+};
+//# sourceMappingURL=validators.js.map

package/es/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"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"}