chore: finish error cleanup

Author: nbbeeken

src/error.ts

@@ -98,8 +98,8 @@ export class BSONOffsetError extends BSONError {
 
   public offset: number;
 
-  constructor(message: string, offset: number) {
-    super(`${message}. offset: ${offset}`);
+  constructor(message: string, offset: number, options?: { cause?: unknown }) {
+    super(`${message}. offset: ${offset}`, options);
     this.offset = offset;
   }
 }

src/parser/on_demand/parse_to_elements.ts

@@ -45,6 +45,14 @@ export type BSONElement = [
   length: number
 ];
 
+const getSize = (source: Uint8Array, offset: number) => {
+  try {
+    return NumberUtils.getSize(source, offset);
+  } catch (cause) {
+    throw new BSONOffsetError('BSON size cannot be negative', offset, { cause });
+  }
+};
+
 /**
  * Searches for null terminator of a BSON element's value (Never the document null terminator)
  * **Does not** bounds check since this should **ONLY** be used within parseToElements which has asserted that `bytes` ends with a `0x00`.
@@ -80,7 +88,7 @@ export function parseToElements(
     );
   }
 
-  const documentSize = NumberUtils.getSize(bytes, startOffset);
+  const documentSize = getSize(bytes, startOffset);
 
   if (documentSize > bytes.length - startOffset) {
     throw new BSONOffsetError(
@@ -144,15 +152,15 @@ export function parseToElements(
       type === BSONElementType.array ||
       type === BSONElementType.javascriptWithScope
     ) {
-      length = NumberUtils.getSize(bytes, offset);
+      length = getSize(bytes, offset);
     } else if (
       type === BSONElementType.string ||
       type === BSONElementType.binData ||
       type === BSONElementType.dbPointer ||
       type === BSONElementType.javascript ||
       type === BSONElementType.symbol
     ) {
-      length = NumberUtils.getSize(bytes, offset) + 4;
+      length = getSize(bytes, offset) + 4;
       if (type === BSONElementType.binData) {
         // binary subtype
         length += 1;

src/utils/number_utils.ts

@@ -1,5 +1,3 @@
-import { BSONOffsetError } from '../error';
-
 const FLOAT = new Float64Array(1);
 const FLOAT_BYTES = new Uint8Array(FLOAT.buffer, 0, 8);
 
@@ -40,7 +38,7 @@ export type NumberUtils = {
 export const NumberUtils: NumberUtils = {
   getSize(source: Uint8Array, offset: number): number {
     if (source[offset + 3] > 127) {
-      throw new BSONOffsetError('BSON size cannot be negative', offset);
+      throw new RangeError(`Size cannot be negative at offset: ${offset}`);
     }
     return (
       source[offset] |