@ibgib/core-gib 0.0.76 → 0.0.78

package/dist/witness/witness-with-context/witness-with-context-base-v1.mjs

@@ -105,13 +105,13 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             if (logalot) {
                 console.log(`${lc} starting... (I: 94755c3131f4dfa12d20fa38e2926522)`);
             }
-            if (this.ibgibsSvc) {
+            if (this.metaspace) {
                 // check for newer version of self locally before executing
                 const thisAddr = getIbGibAddr({ ibGib: this });
-                const latestAddr = await this.ibgibsSvc.getLatestAddr({ ibGib: this });
+                const latestAddr = await this.metaspace.getLatestAddr({ ibGib: this });
                 if (latestAddr && latestAddr !== thisAddr) {
                     // this has a newer ibgib in its timeline
-                    let resGet = await this.ibgibsSvc.get({ addr: latestAddr });
+                    let resGet = await this.metaspace.get({ addr: latestAddr });
                     if (!resGet || !resGet?.success || (resGet?.ibGibs ?? []).length === 0) {
                         throw new Error(`could not get newer ibgib in timeline (E: 15fa346c8ac17edb96e4b0870104c122)`);
                     }
@@ -123,7 +123,7 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
                 }
             }
             else {
-                console.warn(`${lc} this.ibgibsSvc undefined (W: 44cc5bf1b14b4695b8de4c589787be06)`);
+                console.warn(`${lc} this.metaspace undefined (W: 44cc5bf1b14b4695b8de4c589787be06)`);
             }
         }
         catch (error) {
@@ -145,16 +145,16 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
      *
      * @see {@link ibGibs}
      * @see {@link rel8nName}
-     * @see {@link ibgibsSvc}
+     * @see {@link metaspace}
      * @see {@link space}
      *
      * ## notes
      *
-     * * If there is no given `space`, then we will use the `ibgibsSvc` to get
+     * * If there is no given `space`, then we will use the `metaspace` to get
      *   the local user space. If none, then we skip persistence.
-     * * If there is no `ibgibsSvc`, we won't register the new ibgibs locally.
+     * * If there is no `metaspace`, we won't register the new ibgibs locally.
      */
-    async rel8To({ ibGibs, rel8nName, linked, ibgibsSvc,
+    async rel8To({ ibGibs, rel8nName, linked, metaspace,
     // space,
      }) {
         const lc = `${this.lc}[${this.rel8To.name}]`;
@@ -174,21 +174,21 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             if (thisValidationErrors?.length > 0) {
                 throw new Error(`this is an invalid ibGib. thisValidationErrors: ${thisValidationErrors.join('|')} (E: 8f08716866cd13bf254222ee9e6a6722)`);
             }
-            ibgibsSvc = ibgibsSvc ?? this.ibgibsSvc;
-            if (!ibgibsSvc) {
-                // if (this.ibgibsSvc) {
-                //     if (logalot) { console.log(`${lc} ibgibsSvc arg falsy, but we have a reference on this object, which we will use. (I: ee0d39a47ee8aee8ffd797721fea4322)`); }
-                //     ibgibsSvc = this.ibgibsSvc;
+            metaspace = metaspace ?? this.metaspace;
+            if (!metaspace) {
+                // if (this.metaspace) {
+                //     if (logalot) { console.log(`${lc} metaspace arg falsy, but we have a reference on this object, which we will use. (I: ee0d39a47ee8aee8ffd797721fea4322)`); }
+                //     metaspace = this.metaspace;
                 // }
-                throw new Error(`either ibgibsSvc or this.ibgibsSvc required (E: b5f9453ddb394a2b76dec74c7304df22)`);
+                throw new Error(`either metaspace or this.metaspace required (E: b5f9453ddb394a2b76dec74c7304df22)`);
             }
             // if (!space) {
-            //     if (ibgibsSvc) {
-            //         if (logalot) { console.log(`${lc} space arg falsy, but ibgibsSvc truthy, so we'll use ibgibsSvc's local user space for persistence. (I: 37a4b4c1406556cb23831671755b0d22)`); }
-            //         space = await ibgibsSvc.getLocalUserSpace({ lock: true });
+            //     if (metaspace) {
+            //         if (logalot) { console.log(`${lc} space arg falsy, but metaspace truthy, so we'll use metaspace's local user space for persistence. (I: 37a4b4c1406556cb23831671755b0d22)`); }
+            //         space = await metaspace.getLocalUserSpace({ lock: true });
             //     }
             // }
-            // if (!space) { throw new Error(`(UNEXPECTED) space required and ibgibsSvc couldn't get it? (E: a3b9f9b72f6f6f18883199a19d38c622)`); }
+            // if (!space) { throw new Error(`(UNEXPECTED) space required and metaspace couldn't get it? (E: a3b9f9b72f6f6f18883199a19d38c622)`); }
             // #endregion initialize, validate args and this
             // we want to rel8 only to the ibGibs whose timelines we're not
             // already related to. So we look to see if we already have the tjpGib
@@ -222,7 +222,7 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             }
             // if space is given, perform the persistence
             // if (space) {
-            await ibgibsSvc.persistTransformResult({ resTransform: resNewThis });
+            await metaspace.persistTransformResult({ resTransform: resNewThis });
             // } else {
             //     if (logalot) { console.log(`${lc} space falsy, skipping persistence (I: 90aa3553e92ad1d02bce61f83648ea22)`); }
             // }
@@ -230,7 +230,7 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             //   override `loadIbGibDto` to update secondary/derivative properties
             await this.loadIbGibDto(newThisIbGib);
             // (in the future, need to revisit the ibgibs service to the idea of locality/ies).
-            await ibgibsSvc.registerNewIbGib({ ibGib: newThisIbGib });
+            await metaspace.registerNewIbGib({ ibGib: newThisIbGib });
         }
         catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
@@ -253,10 +253,10 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             if (!contextIbGib) {
                 throw new Error(`contextIbGib required (E: 85f27c7cbf713704c21084c141cd8822)`);
             }
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc required (E: 6a38c4274bdefc8d44cafd2d6faaa222)`);
+            if (!this.metaspace) {
+                throw new Error(`this.metaspace required (E: 6a38c4274bdefc8d44cafd2d6faaa222)`);
             }
-            // space = space ?? await this.ibgibsSvc.getLocalUserSpace({ lock: true });
+            // space = space ?? await this.metaspace.getLocalUserSpace({ lock: true });
             // if (!space) { throw new Error(`space required (E: 267ad87c148942cda641349df0bbbd22)`); }
             if ((rel8nNames ?? []).length === 0) {
                 if (!this.data?.defaultRel8nName) {
@@ -276,10 +276,10 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
                 nCounter: true
             });
             // ...persist it...
-            await this.ibgibsSvc.persistTransformResult({ resTransform: resRel8ToContext });
+            await this.metaspace.persistTransformResult({ resTransform: resRel8ToContext });
             // ...register the context.
             const { newIbGib: newContext } = resRel8ToContext;
-            await this.ibgibsSvc.registerNewIbGib({ ibGib: newContext });
+            await this.metaspace.registerNewIbGib({ ibGib: newContext });
         }
         catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
@@ -292,21 +292,21 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             if (logalot) {
                 console.log(`${lc} starting... (I: c3a005f7d323468a5b4e1b2710901d22)`);
             }
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc required (E: 5dbb1a7f0ff5469b8ce3cb1be175e521)`);
+            if (!this.metaspace) {
+                throw new Error(`this.metaspace required (E: 5dbb1a7f0ff5469b8ce3cb1be175e521)`);
             }
-            // space = space ?? await this.ibgibsSvc.getLocalUserSpace({ lock: true });
-            // if (!space) { throw new Error(`(UNEXPECTED) space required and wasn't able to get it from ibgibsSvc? (E: 7159f9893a66c28a7e09b61384545622)`); }
-            let space = await this.ibgibsSvc.getLocalUserSpace({ lock: true });
+            // space = space ?? await this.metaspace.getLocalUserSpace({ lock: true });
+            // if (!space) { throw new Error(`(UNEXPECTED) space required and wasn't able to get it from metaspace? (E: 7159f9893a66c28a7e09b61384545622)`); }
+            let space = await this.metaspace.getLocalUserSpace({ lock: true });
             /** tag this comment with metadata to show it came from this witness */
             let resComment = await createCommentIbGib({ text, addlMetadataText: this.getAddlMetadata(), saveInSpace: true, space });
             // get again to be sure it's the latest space.
-            space = await this.ibgibsSvc.getLocalUserSpace({ lock: true });
+            space = await this.metaspace.getLocalUserSpace({ lock: true });
             const commentIbGib = resComment.newIbGib;
             if (!commentIbGib) {
                 throw new Error(`(UNEXPECTED) failed to create comment? (E: 6d668f4e55198e654324622eabaac922)`);
             }
-            await this.ibgibsSvc.registerNewIbGib({ ibGib: commentIbGib });
+            await this.metaspace.registerNewIbGib({ ibGib: commentIbGib });
             await this.rel8ToContextIbGib({ ibGibToRel8: commentIbGib, contextIbGib, rel8nNames: ['comment'] });
             await this.rel8To({
                 ibGibs: [commentIbGib],
@@ -393,8 +393,8 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             if (!arg && !addr) {
                 throw new Error(`either arg or addr required. (E: 3f647b65742242fd9ba878521acf7c22)`);
             }
-            if (!this.ibgibsSvc) {
-                throw new Error(`(UNEXPECTED) this.ibgibsSvc required (E: f0046290b0d66d28c4bbbf83d9d9f523)`);
+            if (!this.metaspace) {
+                throw new Error(`(UNEXPECTED) this.metaspace required (E: f0046290b0d66d28c4bbbf83d9d9f523)`);
             }
             if (arg) {
                 if ((arg.ibGibs ?? []).length === 0) {
@@ -407,16 +407,16 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             }
             else {
                 // addr provided
-                const resGet = await this.ibgibsSvc.get({ addr });
+                const resGet = await this.metaspace.get({ addr });
                 if (!resGet.success || resGet.ibGibs?.length !== 1) {
                     throw new Error(`could not get context addr (${addr}) (E: 834492313512a45b23a7bebacdc48122)`);
                 }
                 contextIbGib = resGet.ibGibs[0];
             }
             if (latest) {
-                const resLatestAddr = await this.ibgibsSvc.getLatestAddr({ ibGib: contextIbGib });
+                const resLatestAddr = await this.metaspace.getLatestAddr({ ibGib: contextIbGib });
                 if (resLatestAddr !== getIbGibAddr({ ibGib: contextIbGib })) {
-                    const resGet = await this.ibgibsSvc.get({ addr: resLatestAddr });
+                    const resGet = await this.metaspace.get({ addr: resLatestAddr });
                     if (resGet.success && resGet.ibGibs?.length === 1) {
                         contextIbGib = resGet.ibGibs[0];
                     }
@@ -441,7 +441,7 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
      * The context is the ibgib where we are interacting with the user(s).
      *
      * When we initialize, we are setting state on this witness as well as
-     * subscribing to the context ibgib's updates in `this.ibgibsSvc`.
+     * subscribing to the context ibgib's updates in `this.metaspace`.
      *
      * if we already have a context, then this will check the new incoming
      * context against it.  If it's the same timeline, then this won't do
@@ -453,8 +453,8 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             if (logalot) {
                 console.log(`${lc} starting... (I: d93429c85b0a494388f66fba3eece922)`);
             }
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc (metaspace) required. set this before using this witness. (E: 67db388a0223bf813b40accd9941ad23)`);
+            if (!this.metaspace) {
+                throw new Error(`this.metaspace (metaspace) required. set this before using this witness. (E: 67db388a0223bf813b40accd9941ad23)`);
             }
             if (arg && contextIbGib) {
                 console.warn(`${lc} both arg and contextIbGib provided. using raw contextIbGib (W: d6d723ad7fb942079833c40647aecd22)`);
@@ -493,14 +493,14 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             updatePriorChildren();
             // subscribe to context ibgib updates
             const contextTjpAddr = getTjpAddr({ ibGib: this._currentWorkingContextIbGib });
-            if (!this.ibgibsSvc) {
-                throw new Error(`(UNEXPECTED) this.ibgibsSvc falsy...not initialized? (E: 6e38bfdc5c2eb5fef884f0183889e823)`);
+            if (!this.metaspace) {
+                throw new Error(`(UNEXPECTED) this.metaspace falsy...not initialized? (E: 6e38bfdc5c2eb5fef884f0183889e823)`);
             }
-            if (!this.ibgibsSvc.latestObs) {
-                throw new Error(`(UNEXPECTED) this.ibgibsSvc.latestObs falsy? (E: 831936570c14ed526f9c9ab511929923)`);
+            if (!this.metaspace.latestObs) {
+                throw new Error(`(UNEXPECTED) this.metaspace.latestObs falsy? (E: 831936570c14ed526f9c9ab511929923)`);
             }
             this._contextChangesSubscription =
-                await this.ibgibsSvc.latestObs
+                await this.metaspace.latestObs
                     // .pipe(
                     //     filter(x => x.tjpAddr === contextTjpAddr)
                     // ).subscribe(async (update: any) => {
@@ -543,7 +543,7 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
                     },
                     error: async (err) => {
                         const lcErr = `${lc}[latestObs.error]`;
-                        console.error(`${lcErr} this.ibgibsSvc.latestObs error: ${extractObsErrMsg({ err })}. (E: 99df4c42195d46d0a9dbfb06ac45ae00)`);
+                        console.error(`${lcErr} this.metaspace.latestObs error: ${extractObsErrMsg({ err })}. (E: 99df4c42195d46d0a9dbfb06ac45ae00)`);
                     },
                 }));
             // rel8 to the context (conversation)
@@ -558,7 +558,7 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
             // if needed)
             // let gibInfo = getGibInfo({ gib: this._currentWorkingContextIbGib.gib });
             // if (gibInfo.tjpGib) {
-            //     this.ibgibsSvc.latestObs
+            //     this.metaspace.latestObs
             //         .subscribe(update => {
             //             if (!update.tjpAddr) { return; /* <<<< returns early */ }
             //             if (getIbAndGib({ ibGibAddr: update.tjpAddr }).gib !== gibInfo.tjpGib) { return; /* <<<< returns early */ }
@@ -724,10 +724,10 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
                 return []; /* <<<< returns early */
             }
             // get the latest addrs for those children
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc falsy. not initialized? (E: 1cc26ca7de7fadcdbaecbd6613350e23)`);
+            if (!this.metaspace) {
+                throw new Error(`this.metaspace falsy. not initialized? (E: 1cc26ca7de7fadcdbaecbd6613350e23)`);
             }
-            const space = await this.ibgibsSvc.getLocalUserSpace({});
+            const space = await this.metaspace.getLocalUserSpace({});
             if (!space) {
                 throw new Error(`couldn't get local user space? (E: f118f75e5852fc22bba3a6495beec723)`);
             }
@@ -741,7 +741,7 @@ export class WitnessWithContextBase_V1 extends WitnessBase_V1 {
                 // some of the addrs were not found in the space
                 throw new Error(`some addrs were not found in the space. (E: 2216d8e5ad7fb600ceb025ed7c90f323)`);
             }
-            const resGet = await this.ibgibsSvc.get({ addrs: latestAddrs });
+            const resGet = await this.metaspace.get({ addrs: latestAddrs });
             if (!resGet.success || resGet.ibGibs?.length !== newChildrenAddrs.length) {
                 throw new Error(`failed to get newChildren with addrs: ${newChildrenAddrs.join('|')}. Error: ${resGet.errorMsg ?? 'unknown error 5737bd0996d5445b8bd80975bedc0d57'} (E: 05722e11350ec6ffffdb5c7d0caa2922)`);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/core-gib",
-  "version": "0.0.76",
+  "version": "0.0.78",
   "description": "ibgib core functionality, including base architecture for witnesses, spaces, apps, robbots, etc., as well as shared utility functions. Node v19+ needed for heavily-used isomorphic webcrypto hashing consumed in both node and browsers.",
   "repository": {
     "url": "https://gitlab.com/ibgib/core-gib",

package/src/common/pubsub/observable/observable-base-v1.mts

@@ -64,7 +64,7 @@ export abstract class ObservableBase_V1<
      * Reference to the local ibgibs service, which is one way at getting at the
      * local user space.
      */
-    public ibgibsSvc: MetaspaceService | undefined;
+    public metaspace: MetaspaceService | undefined;
 
     protected _subscribers: { [subscriptionId: string]: [SubscriptionWitness, ObserverWitness<TIbGibIn_ie_Payload> | WitnessAny] } = {};
 

package/src/common/pubsub/subject/subject-v1.mts

@@ -89,7 +89,7 @@ export class Subject_V1<
      * Reference to the local ibgibs service, which is one way at getting at the
      * local user space.
      */
-    public ibgibsSvc: MetaspaceService | undefined;
+    public metaspace: MetaspaceService | undefined;
 
     constructor(initialData?: SubjectData_V1, initialRel8ns?: SubjectRel8ns_V1) {
         super(initialData, initialRel8ns);

package/src/common/pubsub/subscription/subscription-v1.mts

@@ -82,7 +82,7 @@ export class Subscription_V1
      * Reference to the local ibgibs service, which is one way at getting at the
      * local user space.
      */
-    public ibgibsSvc: MetaspaceService | undefined;
+    public metaspace: MetaspaceService | undefined;
 
     /**
      * this is UNDEFINED if we have not yet subscribed.

package/src/witness/app/app-base-v1.mts

@@ -61,7 +61,7 @@ export abstract class AppBase_V1<
      * Reference to the local ibgibs service, which is one way at getting at the
      * local user space.
      */
-    ibgibsSvc: MetaspaceService | undefined;
+    metaspace: MetaspaceService | undefined;
 
     constructor(initialData?: TData, initialRel8ns?: TRel8ns) {
         super(initialData, initialRel8ns);

package/src/witness/keystone/keystone-base-v1.mts

@@ -69,7 +69,7 @@ export abstract class KeystoneBase_V1<
      * Reference to the local ibgibs service, which is one way at getting at the
      * local user space.
      */
-    ibgibsSvc: MetaspaceService | undefined;
+    metaspace: MetaspaceService | undefined;
 
     constructor(initialData?: TData, initialRel8ns?: TRel8ns) {
         super(initialData, initialRel8ns);

package/src/witness/robbot/robbot-base-v1.mts

@@ -685,8 +685,8 @@ export abstract class RobbotBase_V1<
 
             await this.loadNewerSelfIfAvailable();
 
-            if (!this.ibgibsSvc) { throw new Error(`this.ibgibsSvc falsy (E: fd2f9e4384a725122f4de2eb76696923)`); }
-            const space = await this.ibgibsSvc.getLocalUserSpace({ lock: true });
+            if (!this.metaspace) { throw new Error(`this.metaspace falsy (E: fd2f9e4384a725122f4de2eb76696923)`); }
+            const space = await this.metaspace.getLocalUserSpace({ lock: true });
 
             const rel8dIbGibs: { [rel8nName: string]: IbGib_V1[] } = {};
 

package/src/witness/space/metaspace/metaspace-base.mts

@@ -459,8 +459,11 @@ export abstract class MetaspaceBase implements MetaspaceService {
         protected cacheSvc: IbGibCacheService | undefined,
     ) {
         const lc = `${this.lc}[ctor]`;
-        if (logalot) { console.log(`${lc}${GLOBAL_TIMER_NAME}`); console.timeLog(GLOBAL_TIMER_NAME); }
-        console.log(`${lc} created.`);
+        if (logalot) {
+            console.log(`${lc}${GLOBAL_TIMER_NAME}`);
+            console.timeLog(GLOBAL_TIMER_NAME);
+            console.log(`${lc} created. (I: 5fe7af9fccc2488282eecc8255729cec)`);
+        }
     }
 
     protected async initializeMetaspaceFactory({ metaspaceFactory }: { metaspaceFactory: MetaspaceFactory }): Promise<void> {
@@ -1583,11 +1586,17 @@ export abstract class MetaspaceBase implements MetaspaceService {
         initialize,
         space,
         lock,
+        dontWarnIfNotExist,
     }: {
         type: SpecialIbGibType,
         initialize?: boolean,
         space?: IbGibSpaceAny,
         lock?: boolean,
+        /**
+         * if true, won't warn about non-existent/non-initialized things.
+         * useful if you are just checking to see if a special ibgib exists.
+         */
+        dontWarnIfNotExist?: boolean,
     }): Promise<IbGib_V1 | null> {
         const lc = `${this.lc}[${this.getSpecialIbGib.name}]`;
         try {
@@ -1607,7 +1616,8 @@ export abstract class MetaspaceBase implements MetaspaceService {
                 fnUpdateBootstrap: (x) => this.fnUpdateBootstrap(x),
                 fnBroadcast: (x) => this.fnBroadcast(x),
                 fnGetInitializing: () => { return this._initializing; },
-                fnSetInitializing: (value: boolean) => { this._initializing = value; }
+                fnSetInitializing: (value: boolean) => { this._initializing = value; },
+                dontWarnIfNotExist,
             });
         } catch (error) {
             console.error(`${lc} ${error.message}`);

package/src/witness/space/metaspace/metaspace-types.mts

@@ -485,6 +485,11 @@ export interface MetaspaceService {
         initialize?: boolean,
         space?: IbGibSpaceAny,
         lock?: boolean,
+        /**
+         * if true, won't warn about non-existent/non-initialized things.
+         * useful if you are just checking to see if a special ibgib exists.
+         */
+        dontWarnIfNotExist?: boolean,
     }): Promise<IbGib_V1 | null>;
     getSpecialRel8dIbGibs<TIbGib extends IbGib_V1 = IbGib_V1>(arg: {
         type: SpecialIbGibType,

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

@@ -380,6 +380,7 @@ export async function getSpecialIbGib({
     fnBroadcast,
     fnGetInitializing,
     fnSetInitializing,
+    dontWarnIfNotExist,
 }: {
     type: SpecialIbGibType,
     initialize?: boolean,
@@ -406,6 +407,11 @@ export async function getSpecialIbGib({
      * Because we don't want to initialize while we're initializing.
      */
     fnSetInitializing?: (x: boolean) => void,
+    /**
+     * if true, won't warn about non-existent/non-initialized things.
+     * useful if you are just checking to see if a special ibgib exists.
+     */
+    dontWarnIfNotExist?: boolean,
 }): Promise<IbGib_V1 | null> {
     const lc = `[${getSpecialIbGib.name}]`;
     try {
@@ -414,7 +420,7 @@ export async function getSpecialIbGib({
         let key = getSpecialConfigKey({ type });
         let addr = await getConfigAddr({
             key, space,
-            dontWarn: !!initialize // dont warn if we're initializing
+            dontWarn: dontWarnIfNotExist || !!initialize // dont warn if we're initializing
         });
 
         if (!addr) {
@@ -652,6 +658,10 @@ export async function getConfigAddr({
 }: {
     key: string,
     space: IbGibSpaceAny,
+    /**
+     * if true, won't warn about non-existent/non-initialized things.
+     * useful if you are just checking to see if a special ibgib exists.
+     */
     dontWarn?: boolean,
 }): Promise<string | undefined> {
     const lc = `[${getConfigAddr.name}](${key})`;