@ibgib/ts-gib 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 0.5.2
+* meta: changed to respec-gib for testing.
+
 ## 0.5.1
 * meta: reorg V1/index.mts to export * from transform-helper
   * was only exporting a subset, forcing consumers to import certain fns

package/README.md

@@ -513,14 +513,33 @@ frameworks for them), I have kluged a workaround by editing
 section. So atow paste the following code before any other `script` tags in the
 `head` section.  (the versions may need to change):
 
-_note: atow I am copy/pasting this text whenever I reinstall node_modules folder_
+
+_note: atow I am copy/pasting this text whenever I reinstall `node_modules` folder._
+
+_note: if you are having CORS issues, it may be due to the cdn being down._
+
+
+using **unpkg**:
+
+```html
+  <script type="importmap">
+    {
+      "imports": {
+        "@ibgib/helper-gib": "https://unpkg.com/@ibgib/helper-gib@0.0.4/dist/index.mjs",
+        "@ibgib/helper-gib/": "https://unpkg.com/@ibgib/helper-gib@0.0.4/"
+      }
+    }
+  </script>
+```
+
+**using jsdelivr.net**:
 
 ```html
   <script type="importmap">
     {
       "imports": {
-        "@ibgib/helper-gib": "https://unpkg.com/@ibgib/helper-gib@0.0.2/dist/index.mjs",
-        "@ibgib/helper-gib/": "https://unpkg.com/@ibgib/helper-gib@0.0.2/"
+        "@ibgib/helper-gib": "https://cdn.jsdelivr.net/npm/@ibgib/helper-gib@0.0.4/dist/index.mjs",
+        "@ibgib/helper-gib/": "https://cdn.jsdelivr.net/npm/@ibgib/helper-gib@0.0.4/"
       }
     }
   </script>

package/dist/respec-gib.node.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=respec-gib.node.d.mts.map

package/dist/respec-gib.node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respec-gib.node.d.mts","sourceRoot":"","sources":["../src/respec-gib.node.mts"],"names":[],"mappings":""}

package/dist/respec-gib.node.mjs

@@ -0,0 +1,211 @@
+import { readdir, open } from 'node:fs/promises';
+import { statSync } from 'node:fs';
+import * as pathUtils from 'path';
+import { pretty } from '@ibgib/helper-gib';
+import { getGlobalRespecGib } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+// #region settings
+/**
+ * This is how I enable/disable verbose logging. Do with it what you will.
+ */
+const logalot = false;
+/** set this to the root of the respecs to look at */
+const RESPEC_ROOT_DIR_RELATIVE_TO_BASE = './dist';
+/** change this to suit your naming convention */
+const RESPEC_FILE_REG_EXP = /^.+respec\.mjs$/;
+// const RESPEC_FILE_REG_EXP = /^.*respec-gib.respec\.mjs$/;
+// if (respecPath.includes('respec-gib.respec.mjs')) {
+/**
+ * If on, will first load a file and see if there is an extra respecful
+ * `respecfully`/`ifWe` block. Use these if you want to focus on a single or
+ * subset of respecs.
+ *
+ * If there are no extra respecful blocks found in an entire file, that file
+ * will be skipped.
+ *
+ * Note: this only is a flag to search through respec files.
+ */
+const LOOK_FOR_EXTRA_RESPEC = true;
+/**
+ * The names of the functions that indicate that we want to focus on just those
+ * blocks.
+ *
+ * ATOW, for first run implementation here, I am implementing it such that it
+ * will filter out files that don't have these indicators. The respec files that
+ * do have these will execute fully, but the output will only include these
+ * particular blocks.
+ */
+const EXTRA_RESPEC_FUNCTION_NAMES = ['respecfullyDear', 'ifWeMight'];
+// #endregion settings
+// #region 1. get respec paths
+const basePath = process.cwd();
+const srcPath = pathUtils.join(basePath, RESPEC_ROOT_DIR_RELATIVE_TO_BASE);
+if (logalot) {
+    console.log(`cwd: ${process.cwd()}`);
+}
+if (logalot) {
+    console.log(`basePath: ${basePath}`);
+}
+if (logalot) {
+    console.log(`srcPath: ${srcPath}`);
+}
+const respecGib = getGlobalRespecGib();
+const allRespecPaths = await getRespecFileFullPaths(srcPath, []);
+if (logalot) {
+    console.log(`allRespecPaths: ${allRespecPaths} (I: f5182a455375a8cf2aa6e1127a082423)`);
+}
+let filteredRespecPaths = undefined;
+if (LOOK_FOR_EXTRA_RESPEC) {
+    const hasExtraRespecPromises = allRespecPaths.map(async (respecPath) => {
+        const hasExtra = await respecFileHasExtraRespec(respecPath);
+        return [respecPath, hasExtra];
+    });
+    const resPathHasExtraTuples = await Promise.all(hasExtraRespecPromises);
+    filteredRespecPaths = resPathHasExtraTuples
+        .filter(([_respecPath, hasExtra]) => hasExtra)
+        .map(([respecPath, _hasExtra]) => respecPath);
+    // if there are no files that have extra respec then we do all files
+    if (filteredRespecPaths.length === 0) {
+        if (logalot) {
+            console.log(`filteredRespecPaths is empty. doing allRespecPaths found (I: b98f54656899646025eecb4c028ab523)`);
+        }
+        filteredRespecPaths = allRespecPaths.concat();
+    }
+    else {
+        console.log(`filteredRespecPaths for extra respec: ${filteredRespecPaths} (I: b98f54656899646025eecb4c028ab523)`);
+        respecGib.extraRespecOnly = true;
+    }
+}
+// #endregion 1. get respec paths
+respecGib.allRespecPaths = allRespecPaths;
+respecGib.filteredRespecPaths = filteredRespecPaths;
+const respecPaths = filteredRespecPaths ?? allRespecPaths;
+respecGib.respecPaths = respecPaths;
+if (logalot) {
+    console.log(`respecPaths found:\n${respecPaths}`);
+}
+// #region 2. execute paths' respective respecs
+// for now, we'll do sequentially, but in the future we could conceivable farm
+// these out to other node processes, or at least Promise.all
+for (let i = 0; i < respecPaths.length; i++) {
+    const respecPath = respecPaths[i];
+    if (logalot) {
+        console.log(respecPath);
+    }
+    const esm = await import(respecPath);
+    if (logalot) {
+        console.log(pretty(Object.keys(esm)));
+    }
+}
+const skippedRespecPathCount = respecGib.allRespecPaths.length - respecGib.respecPaths.length;
+if (skippedRespecPathCount > 0) {
+    console.log('');
+    console.error('\x1b[33m%s\x1b[0m', `${skippedRespecPathCount} respec files completely skipped.`); // yellow
+}
+if (respecGib.ifWeBlocksSkipped > 0) {
+    console.log('');
+    console.error('\x1b[33m%s\x1b[0m', `${respecGib.ifWeBlocksSkipped} ifWe blocks ran but skipped reporting`); // yellow
+}
+if (respecGib.errorMsgs.length === 0) {
+    console.log('');
+    console.error('\x1b[32m%s\x1b[0m', `💚💚 nothing but respec 💚💚`); // green
+}
+else {
+    console.log('');
+    console.error('\x1b[31m%s\x1b[0m', `💔💔 DISrespec found 💔💔`); // red
+    for (const errorMsg of respecGib.errorMsgs) {
+        console.error('\x1b[31m%s\x1b[0m', errorMsg); // red
+    }
+}
+// #endregion 2. execute paths' respective respecs
+// #region helper functions
+/**
+ * builds a list of respec file paths, recursively traversing subdirectories
+ * starting from `dirPath`.
+ *
+ * @param dirPath a full path corresponding to a directory
+ * @param found respec paths already found (used in recursive calls)
+ * @returns list of all respec paths according to the respec regexp constant {@link RESPEC_FILE_REG_EXP}
+ */
+async function getRespecFileFullPaths(dirPath, found) {
+    const lc = `[${getRespecFileFullPaths.name}][${dirPath}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 16026290523925f79ba1933847e2a623)`);
+        }
+        found ?? (found = []);
+        const children = await readdir(dirPath);
+        if (logalot) {
+            for (let i = 0; i < children.length; i++) {
+                console.log(children[i]);
+            }
+        }
+        const files = [];
+        const dirs = [];
+        children.forEach(name => {
+            const fullPath = pathUtils.join(dirPath, name);
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                // symbolic link could create a loop
+                if (!stat.isSymbolicLink()) {
+                    dirs.push(fullPath);
+                }
+            }
+            else if (!!name.match(RESPEC_FILE_REG_EXP)) {
+                files.push(fullPath);
+            }
+        });
+        found = found.concat(files);
+        for (let i = 0; i < dirs.length; i++) {
+            const subfound = await getRespecFileFullPaths(dirs[i], found);
+            found = found.concat(subfound);
+        }
+        return Array.from(new Set(found)); // unique
+    }
+    catch (error) {
+        console.error(`${lc} ${error.message}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * Searches through the file (without importing it) for extra respecful
+ * functions.
+ *
+ * @param respecPath
+ * @returns true if extra respecful functions found in file
+ */
+async function respecFileHasExtraRespec(respecPath) {
+    const lc = `[${respecFileHasExtraRespec.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 61f3221917ba77175efa305b14defc23)`);
+        }
+        const file = await open(respecPath);
+        for await (const line of file.readLines()) {
+            const hasExtraRespecInLine = EXTRA_RESPEC_FUNCTION_NAMES.some(fnName => {
+                if (line.includes(`${fnName}(`)) {
+                    return true;
+                }
+            });
+            if (hasExtraRespecInLine) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch (error) {
+        console.error(`${lc} ${error.message}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+// #endregion helper functions
+//# sourceMappingURL=respec-gib.node.mjs.map

package/dist/respec-gib.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"respec-gib.node.mjs","sourceRoot":"","sources":["../src/respec-gib.node.mts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/ts-gib",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "ibgib library with low-level graphing-related substrate functionality, e.g. creating raw ibgibs and transformations. node19+ needed for heavily-used webcrypto hashing isomorphically consumed in node and browsers (apps).",
   "repository": {
     "url": "https://gitlab.com/ibgib/ts-gib",
@@ -19,17 +19,18 @@
     "test": "npm run test:both",
     "test:both": "npm run build:test && npm run test:node:nobuild && npm run test:browser:nobuild",
     "man:test:both": "use this if you want to test in both node and browser contexts",
-    "test:node": "npm run build:test && npx jasmine --config=jasmine.json",
+    "pretest:node": "npm run build:test",
+    "test:node": "node dist/respec-gib.node.mjs --inspect",
     "man:test:node": "use this if you want to build+test in node",
-    "test:node:nobuild": "npx jasmine --config=jasmine.json",
+    "test:node:nobuild": "node dist/respec-gib.node.mjs --inspect",
     "man:test:node:nobuild": "use this if you want to test in node but its already built",
-    "test:browser": "npm run build:test && npx jasmine-browser-runner runSpecs --config=jasmine-browser.json ",
+    "test:browser": "npm run build:test && echo \"not implemented yet\"",
     "man:test:browser": "use this if you want to build+test only the browser context",
-    "test:browser:nobuild": "npx jasmine-browser-runner runSpecs --config=jasmine-browser.json ",
+    "test:browser:nobuild": "echo \"not implemented yet\"",
     "man:test:browser:nobuild": "use this if you want to test only the browser context but its already built",
-    "test:browser:serve": "npm run build:test && npx jasmine-browser-runner serve --config=jasmine-browser.json ",
+    "test:browser:serve": "npm run build:test && echo \"not implemented yet\"",
     "man:test:browser:serve": "use this if you want to build+test in the browser and don't want the browser to close when your done. (i.e. you're debugging)",
-    "test:browser:serve:nobuild": "npx jasmine-browser-runner serve --config=jasmine-browser.json ",
+    "test:browser:serve:nobuild": "\"not implemented yet\"",
     "man:test:browser:serve:nobuild": "use this if you are troubleshooting existing dist output and don't want to overwrite those files. (and you're debugging in the browser)",
     "pack": "npm pack --pack-destination=\"./published\"",
     "prepare:publish:minor": "npm run clean && npm version minor && npm run build && npm run pack",
@@ -46,11 +47,7 @@
   "author": "William Raiford",
   "license": "ISC",
   "devDependencies": {
-    "@types/jasmine": "^4.3.1",
-    "@types/node": "^16.11.6",
-    "jasmine": "^4.5.0",
-    "jasmine-browser-runner": "^1.3.0",
-    "jasmine-core": "^4.5.0",
+    "@types/node": "^20.2.1",
     "typescript": "^4.9.5"
   },
   "engines": {
@@ -60,6 +57,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@ibgib/helper-gib": "^0.0.2"
+    "@ibgib/helper-gib": "^0.0.7"
   }
 }

package/src/V1/{factory.spec.mts → factory.respec.mts}

@@ -9,6 +9,8 @@ import { Factory_V1 as factory } from './factory.mjs';
 import { mut8 } from './transforms/mut8.mjs';
 import { sha256v1 } from './sha256v1.mjs';
 import { getGib, getGibInfo } from './transforms/transform-helper.mjs';
+import { firstOfAll, ifWe, iReckon, respecfully } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
 
 const PRIMITIVE_IBS: string[] = [
     'a', '7', 'tag',
@@ -25,24 +27,24 @@ const SIMPLE_REL8N_NAMES: string[] = [
 ];
 
 
-describe(`when using factory`, () => {
+await respecfully(sir, `when using factory`, async () => {
 
-    it(`primitives() should make multiple ibgibs`, async () => {
+    await ifWe(sir, `primitives() should make multiple ibgibs`, async () => {
         const primitiveIbGibs = factory.primitives({ ibs: PRIMITIVE_IBS });
-        expect(primitiveIbGibs).toBeTruthy();
-        expect(primitiveIbGibs.length).toEqual(PRIMITIVE_IBS.length);
+        iReckon(sir, primitiveIbGibs).isGonnaBeTruthy();
+        iReckon(sir, primitiveIbGibs.length).isGonnaBe(PRIMITIVE_IBS.length);
     });
 
-    describe(`firstGen`, () => {
-        it(`should make an ibgib`, async () => {
+    await respecfully(sir, `firstGen`, async () => {
+        await ifWe(sir, `should make an ibgib`, async () => {
             const testIb = 'some ib here';
             const { newIbGib } = await factory.firstGen({
                 ib: testIb,
                 parentIbGib: ROOT,
             });
-            expect(newIbGib).toBeTruthy;
+            iReckon(sir, newIbGib).isGonnaBeTruthy;
         });
-        it(`should make ibgibs with initial data`, async () => {
+        await ifWe(sir, `should make ibgibs with initial data`, async () => {
             const testIb = 'some ib here';
             const { newIbGib, intermediateIbGibs } = await factory.firstGen({
                 ib: testIb,
@@ -50,17 +52,17 @@ describe(`when using factory`, () => {
                 data: DATA_SIMPLE_XY,
                 noTimestamp: true,
             });
-            expect(newIbGib.data).withContext(`newIbGib.data`).toBeTruthy();
-            expect(newIbGib.data).toEqual(DATA_SIMPLE_XY);
+            iReckon(sir, newIbGib.data).asTo(`newIbGib.data`).isGonnaBeTruthy();
+            iReckon(sir, newIbGib.data).isGonnaBe(DATA_SIMPLE_XY);
 
             // an intermediate ibGib should be created with
             // the same ib, but not yet mutated with the data.
-            expect(intermediateIbGibs).withContext(`intermediateIbGibs`).toBeTruthy();
-            expect(intermediateIbGibs!.length).toEqual(1);
-            expect(intermediateIbGibs![0].ib).toEqual(testIb);
-            expect(intermediateIbGibs![0].data).withContext(`intermediateIbGibs[0].data`).not.toBeTruthy();
+            iReckon(sir, intermediateIbGibs).asTo(`intermediateIbGibs`).isGonnaBeTruthy();
+            iReckon(sir, intermediateIbGibs!.length).isGonnaBe(1);
+            iReckon(sir, intermediateIbGibs![0].ib).isGonnaBe(testIb);
+            iReckon(sir, intermediateIbGibs![0].data).asTo(`intermediateIbGibs[0].data`).not.isGonnaBeTruthy();
         });
-        it(`should make ibgibs with initial data & rel8ns`, async () => {
+        await ifWe(sir, `should make ibgibs with initial data & rel8ns`, async () => {
             const primitiveIbgibAddrs =
                 factory
                     .primitives({ ibs: PRIMITIVE_IBS })
@@ -78,28 +80,28 @@ describe(`when using factory`, () => {
                 noTimestamp: true,
                 rel8ns: testRel8ns,
             });
-            expect(newIbGib.data).withContext(`newIbGib.data`).toBeTruthy();
-            expect(newIbGib.data).toEqual(DATA_SIMPLE_XY);
-            expect(newIbGib.rel8ns).withContext(`newIbGib.rel8ns`).toBeTruthy();
+            iReckon(sir, newIbGib.data).asTo(`newIbGib.data`).isGonnaBeTruthy();
+            iReckon(sir, newIbGib.data).isGonnaBe(DATA_SIMPLE_XY);
+            iReckon(sir, newIbGib.rel8ns).asTo(`newIbGib.rel8ns`).isGonnaBeTruthy();
             SIMPLE_REL8N_NAMES.forEach(rel8nName => {
-                expect(newIbGib.rel8ns![rel8nName]).toEqual(primitiveIbgibAddrs);
+                iReckon(sir, newIbGib.rel8ns![rel8nName]).isGonnaBe(primitiveIbgibAddrs);
             })
 
             // an intermediate ibGib should be created with
             // the same ib, but not yet mutated with the data.
-            expect(intermediateIbGibs).withContext(`intermediateIbGibs`).toBeTruthy();
-            expect(intermediateIbGibs!.length).toEqual(2);
-            expect(intermediateIbGibs![0].ib).toEqual(testIb);
-            expect(intermediateIbGibs![1].ib).toEqual(testIb);
+            iReckon(sir, intermediateIbGibs).asTo(`intermediateIbGibs`).isGonnaBeTruthy();
+            iReckon(sir, intermediateIbGibs!.length).isGonnaBe(2);
+            iReckon(sir, intermediateIbGibs![0].ib).isGonnaBe(testIb);
+            iReckon(sir, intermediateIbGibs![1].ib).isGonnaBe(testIb);
         });
 
 
 
     });
 
-    describe('other stuff here because jasmine is opinionated about no async in describe', () => {
+    await respecfully(sir, 'hmm how to do this?', async () => {
         var allIbGibs: IbGib_V1[];
-        beforeAll(async () => {
+        firstOfAll(sir, async () => {
             // I'm having some weird discrepancies between calling `sha256v1` and
             // `getGib` (which itself calls sha256v1 supposedly).
             //
@@ -148,14 +150,14 @@ describe(`when using factory`, () => {
             ];
         });
 
-        it('should match up ibGib.gib and getGib & should match up sha256v1 hash and punctiliar hash', async () => {
+        await ifWe(sir, 'should match up ibGib.gib and getGib & should match up sha256v1 hash and punctiliar hash', async () => {
             for (let i = 0; i < allIbGibs.length; i++) {
                 const x = allIbGibs[i];
                 let hash_sha256v1Direct = await sha256v1(x, '');
                 let hash_getGib = await getGib({ ibGib: x });
                 let punctiliarHash = getGibInfo({ gib: hash_getGib }).punctiliarHash;
-                expect(hash_getGib).toEqual(x.gib!, 'hash_getGib does not equal x.gib');
-                expect(hash_sha256v1Direct).toEqual(punctiliarHash!);
+                iReckon(sir, hash_getGib).asTo('hash_getGib does not equal x.gib').isGonnaBe(x.gib!);
+                iReckon(sir, hash_sha256v1Direct).isGonnaBe(punctiliarHash!);
             }
         });
     });

package/src/V1/{sha256v1.spec.mts → sha256v1.respec.mts}

@@ -1,4 +1,6 @@
 /**
+ * @module sha256v1
+ *
  * Test basic hashing that is used when calculating V1 gib hashes
  * using sha256.
  *
@@ -7,11 +9,16 @@
  *   is required for browser until I get some kind of browser testing
  *   going.
  */
+
+import { firstOfAll, ifWe, iReckon, respecfully } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
+
 import { IbGib_V1, IbGibRel8ns_V1 } from './types.mjs';
 import { sha256v1, hashToHexCopy } from './sha256v1.mjs';
 import { IbGibWithDataAndRel8ns, IbGibRel8ns } from '../types.mjs';
 import { getGib, getGibInfo } from './transforms/transform-helper.mjs';
 
+
 import { Factory_V1 as factory } from './factory.mjs';
 
 // #region Test Data
@@ -110,9 +117,9 @@ const TEST_IBGIBS: TestData[] = [
 
 // #endregion
 
-describe(`when hashing sha256v1`, () => {
+await respecfully(sir, `when hashing sha256v1`, async () => {
 
-    it(`should hash ibgibs with empty/null/undefined data/rel8ns consistently "forever"`, async () => {
+    await ifWe(sir, `should hash ibgibs with empty/null/undefined data/rel8ns consistently "forever"`, async () => {
         const ib: string = "ib";
         const gib: string = "gib ignored when hashing";
         const ibHash: string = await hashToHexCopy(ib) || "";
@@ -120,7 +127,7 @@ describe(`when hashing sha256v1`, () => {
         const rel8nsHash: string = "";
         const all = (ibHash + rel8nsHash + dataHash).toUpperCase();
         const manualAllHash = (await hashToHexCopy(all))?.toUpperCase();
-        expect(manualAllHash).toEqual("E975776B1A3E4468086E1D8C409116F6E098D13BEEDFE17AF668071B5D11CD55");
+        iReckon(sir, manualAllHash).isGonnaBe("E975776B1A3E4468086E1D8C409116F6E098D13BEEDFE17AF668071B5D11CD55");
 
         const equivalents: IbGib_V1[] = [
             // #region empty rel8ns
@@ -183,23 +190,23 @@ describe(`when hashing sha256v1`, () => {
         for (let j = 0; j < equivalents.length; j++) {
             const ibgib = equivalents[j];
             const result = (await sha256v1(ibgib, "")).toUpperCase();
-            expect(result).toEqual(manualAllHash!);
+            iReckon(sir, result).isGonnaBe(manualAllHash!);
         }
     });
 
-    it(`should hash ibgibs with non-null data/rel8ns consistently "forever"`, async () => {
+    await ifWe(sir, `should hash ibgibs with non-null data/rel8ns consistently "forever"`, async () => {
         for (const x of TEST_IBGIBS.filter(x => x.type === "simple_data_rel8ns")) {
             const ibHash: string = await hashToHexCopy(x.ibgib.ib) || "";
             const dataHash: string = await hashToHexCopy(JSON.stringify(x.ibgib.data)) || "";
-            expect(dataHash.toUpperCase()).toEqual(x.dataHash);
+            iReckon(sir, dataHash.toUpperCase()).isGonnaBe(x.dataHash);
             const rel8nsHash: string = await hashToHexCopy(JSON.stringify(x.ibgib.rel8ns)) || "";
-            expect(rel8nsHash.toUpperCase()).toEqual(x.rel8nsHash);
+            iReckon(sir, rel8nsHash.toUpperCase()).isGonnaBe(x.rel8nsHash);
             const all = (ibHash + rel8nsHash + dataHash).toUpperCase();
             const manualAllHash = (await hashToHexCopy(all))?.toUpperCase();
-            expect(manualAllHash).toEqual(x.ibgib.gib);
+            iReckon(sir, manualAllHash).isGonnaBe(x.ibgib.gib);
 
             const calculatedGibHash = (await sha256v1(x.ibgib, "")).toUpperCase();
-            expect(calculatedGibHash).toEqual(x.ibgib.gib!);
+            iReckon(sir, calculatedGibHash).isGonnaBe(x.ibgib.gib!);
         }
     });
 
@@ -211,11 +218,14 @@ describe(`when hashing sha256v1`, () => {
     // this is testing a function that is internal to the sha256v1 func.
     // terrible as can be duplicated (i.e. not DRY), but simple albeit fragile testing
     // for now.
-    Object.keys(testHashes_sha256_strings).forEach(x => {
-        it(`test internal hash function ib: ${x}`, async () => {
+    const keyStrings = Object.keys(testHashes_sha256_strings);
+    for (let i = 0; i < keyStrings.length; i++) {
+        const x = keyStrings[i];
+        await ifWe(sir, `test internal hash function ib: ${x}`, async () => {
             const result = await hashToHexCopy(x);
-            expect(result?.toUpperCase()).toEqual(testHashes_sha256_strings[x]);
+            iReckon(sir, result?.toUpperCase()).isGonnaBe(testHashes_sha256_strings[x]);
         });
-    });
+
+    }
 
 });