@ibgib/core-gib 0.0.101 → 0.0.103

package/src/witness/space/space-helper.mts

@@ -1062,6 +1062,7 @@ export async function rel8ToSpecialIbGib({
     rel8nName,
     ibGibsToRel8,
     ibGibsToUnRel8,
+    addrsToUnRel8,
     linked,
     severPast,
     deletePreviousSpecialIbGib,
@@ -1086,9 +1087,21 @@ export async function rel8ToSpecialIbGib({
      */
     ibGibsToRel8?: IbGib_V1[],
     /**
-     * multiple ibgibs to UNrel8
+     * multiple ibgibs to UNrel8.
+     * YOU CANNOT SET BOTH {@link ibGibsToUnRel8} AND {@link addrsToUnRel8}
+     * There is no technical reason for this, I'm just too tired to implement
+     * yagni overhead.
+     * @see {@link addrsToUnRel8}
      */
     ibGibsToUnRel8?: IbGib_V1[],
+    /**
+     * alternatively just specify addrs to unrel8.
+     * YOU CANNOT SET BOTH {@link ibGibsToUnRel8} AND {@link addrsToUnRel8}
+     * There is no technical reason for this, I'm just too tired to implement
+     * yagni overhead.
+     * @see {@link ibGibsToUnRel8}
+     */
+    addrsToUnRel8?: IbGibAddr[],
     /**
      * If linked, then the rel8nName will only contain one address, i.e. the
      * last rel8d ibgib's address.
@@ -1139,12 +1152,18 @@ export async function rel8ToSpecialIbGib({
     const lc = `[${rel8ToSpecialIbGib.name}](type:${type},rel8nName:${rel8nName})`;
     try {
         if (!space) { throw new Error(`space required. (E: 956192eea28047eba6dad81620bb96fb)`); }
-        if ((ibGibsToRel8 ?? []).length === 0 && (ibGibsToUnRel8 ?? []).length === 0) {
+        if ((ibGibsToRel8 ?? []).length === 0 &&
+            (ibGibsToUnRel8 ?? []).length === 0 &&
+            (addrsToUnRel8 ?? []).length === 0
+        ) {
             throw new Error(`either ibGibsToRel8 or ibGibsToUnRel8 required. (E: 5add49c8e46a54e2c6b057c22646a822)`);
         }
+        if ((ibGibsToUnRel8 ?? []).length > 0 && (addrsToUnRel8 ?? []).length > 0) {
+            throw new Error(`can't provide both ibGibsToUnRel8 and addrsToUnRel8. There isn't a technical reason but I'm too tired right now to implement the overhead to enable this atow (05/2025). (E: 31ef66be26349cfe1b1f352389b99425)`);
+        }
 
         const addrsToRel8 = ibGibsToRel8?.map(ibGib => getIbGibAddr({ ibGib }));
-        const addrsToUnRel8 = ibGibsToUnRel8?.map(ibGib => getIbGibAddr({ ibGib }));
+        addrsToUnRel8 ??= ibGibsToUnRel8?.map(ibGib => getIbGibAddr({ ibGib }));
 
         // get the special ibgib
         const configKey = getSpecialConfigKey({ type });