@mxjp/binary 1.0.0 → 1.1.0

package/dist/base64.d.ts

@@ -26,7 +26,7 @@ export declare function base64UrlEncode(bytes: Bytes, padding?: boolean): string
  *
  * @param value The text to decode.
  */
-export declare function base64Decode(value: string): Uint8Array;
+export declare function base64Decode(value: string): Uint8Array<ArrayBuffer>;
 /**
  * Decode a base64 url encoded text with optional trailing padding.
  *
@@ -36,4 +36,4 @@ export declare function base64Decode(value: string): Uint8Array;
  *
  * @param value The text to decode.
  */
-export declare function base64UrlDecode(value: string): Uint8Array;
+export declare function base64UrlDecode(value: string): Uint8Array<ArrayBuffer>;

package/dist/bytes.d.ts

@@ -8,3 +8,9 @@ export declare function isArrayBuffer(value: unknown): value is ArrayBuffer;
  * Check if the specified value is exactly a {@link Uint8Array `Uint8Array<ArrayBuffer>`}.
  */
 export declare function isUint8Array(value: unknown): value is Uint8Array<ArrayBuffer>;
+/**
+ * Check if the specified bytes are equal in length and content.
+ *
+ * This is **not** a constant time comparison.
+ */
+export declare function bytesEqual(a: Bytes, b: Bytes): boolean;

package/dist/bytes.js

@@ -21,4 +21,22 @@ export function isArrayBuffer(value) {
 export function isUint8Array(value) {
     return value instanceof Uint8Array && value.constructor === Uint8Array && isArrayBuffer(value.buffer);
 }
+/**
+ * Check if the specified bytes are equal in length and content.
+ *
+ * This is **not** a constant time comparison.
+ */
+export function bytesEqual(a, b) {
+    a = asUint8Array(a);
+    b = asUint8Array(b);
+    if (a.byteLength !== b.byteLength) {
+        return false;
+    }
+    for (let i = 0; i < a.byteLength; i++) {
+        if (a[i] !== b[i]) {
+            return false;
+        }
+    }
+    return true;
+}
 //# sourceMappingURL=bytes.js.map

package/dist/bytes.js.map

@@ -1 +1 @@
-{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,KAAY;IACxC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;SAAM,CAAC;QACP,MAAM,IAAI,SAAS,EAAE,CAAC;IACvB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACvG,CAAC"}
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,KAAY;IACxC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;SAAM,CAAC;QACP,MAAM,IAAI,SAAS,EAAE,CAAC;IACvB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACvG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,CAAQ,EAAE,CAAQ;IAC5C,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/package.json

@@ -7,7 +7,7 @@
 	},
 	"license": "MIT",
 	"type": "module",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"main": "./dist/index.js",
 	"exports": {
 		".": "./dist/index.js"

package/src/base64.ts

@@ -45,7 +45,7 @@ function encode(bytes: Uint8Array<ArrayBuffer>, map: Uint8Array<ArrayBuffer>, pa
 	return value;
 }
 
-function decode(value: string, map: Uint16Array): Uint8Array {
+function decode(value: string, map: Uint16Array): Uint8Array<ArrayBuffer> {
 	if (typeof value !== "string") {
 		throw new TypeError();
 	}
@@ -128,7 +128,7 @@ export function base64UrlEncode(bytes: Bytes, padding = false): string {
  *
  * @param value The text to decode.
  */
-export function base64Decode(value: string): Uint8Array {
+export function base64Decode(value: string): Uint8Array<ArrayBuffer> {
 	return decode(value, ASCII_TO_BASE64);
 }
 
@@ -141,6 +141,6 @@ export function base64Decode(value: string): Uint8Array {
  *
  * @param value The text to decode.
  */
-export function base64UrlDecode(value: string): Uint8Array {
+export function base64UrlDecode(value: string): Uint8Array<ArrayBuffer> {
 	return decode(value, ASCII_TO_BASE64URL);
 }

package/src/bytes.ts

@@ -24,3 +24,22 @@ export function isArrayBuffer(value: unknown): value is ArrayBuffer {
 export function isUint8Array(value: unknown): value is Uint8Array<ArrayBuffer> {
 	return value instanceof Uint8Array && value.constructor === Uint8Array && isArrayBuffer(value.buffer);
 }
+
+/**
+ * Check if the specified bytes are equal in length and content.
+ *
+ * This is **not** a constant time comparison.
+ */
+export function bytesEqual(a: Bytes, b: Bytes): boolean {
+	a = asUint8Array(a);
+	b = asUint8Array(b);
+	if (a.byteLength !== b.byteLength) {
+		return false;
+	}
+	for (let i = 0; i < a.byteLength; i++) {
+		if (a[i] !== b[i]) {
+			return false;
+		}
+	}
+	return true;
+}