refactor: export addEqualityTesters function which helps smart contract developers to avoid type casting in assertions

Author: boblat

src/index.ts

@@ -1,5 +1,6 @@
 import { internal } from '@algorandfoundation/algorand-typescript'
 
+export { addEqualityTesters } from './set-up'
 export { TestExecutionContext } from './test-execution-context'
 export const encodingUtil = {
   ...internal.encodingUtil,

src/set-up.ts

@@ -11,7 +11,7 @@ interface ExpectObj {
   addEqualityTesters: (testers: Array<Tester>) => void
 }
 
-function addEqualityTesters(expectObj: ExpectObj) {
+function doAddEqualityTesters(expectObj: ExpectObj) {
   expectObj.addEqualityTesters([
     function IsSamePrimitiveTypeAndValue(this: TesterContext, subject, test, customTesters): boolean | undefined {
       const subjectIsPrimitive = subject instanceof internal.primitives.AlgoTsPrimitiveCls
@@ -44,7 +44,8 @@ function addEqualityTesters(expectObj: ExpectObj) {
     },
     function BytesPrimitiveIsArray(this: TesterContext, subject, test, customTesters): boolean | undefined {
       if (subject instanceof internal.primitives.BytesCls) {
-        const testValue = Array.isArray(test) && test.every((i) => typeof i === 'number') ? new Uint8Array(test) : undefined
+        const testValue =
+          Array.isArray(test) && test.every((i) => typeof i === 'number' && i >= 0 && i < 256) ? new Uint8Array(test) : undefined
         if (testValue !== undefined) return this.equals(subject.asUint8Array(), testValue, customTesters)
         return undefined
       }
@@ -108,6 +109,6 @@ function addEqualityTesters(expectObj: ExpectObj) {
   ])
 }
 
-export function setUpTests({ expect }: { expect: ExpectObj }) {
-  addEqualityTesters(expect)
+export function addEqualityTesters({ expect }: { expect: ExpectObj }) {
+  doAddEqualityTesters(expect)
 }

vitest.setup.ts

@@ -1,6 +1,6 @@
 import { beforeAll, expect } from 'vitest'
-import { setUpTests } from './src/set-up'
+import { addEqualityTesters } from './src/set-up'
 
 beforeAll(() => {
-  setUpTests({ expect })
+  addEqualityTesters({ expect })
 })