@ibgib/core-gib 0.0.75 → 0.0.77

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.75",
+  "version": "0.0.77",
   "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> {

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

@@ -1490,7 +1490,9 @@ export async function createSpecialIbGib({
             nCounter: true,
         });
         await persistTransformResult({ resTransform: resNewSpecial, space });
-        if (type !== 'roots' && !skipRel8ToRoot) {
+        // we don't relate the special roots index to itself and we don't relate
+        // the latest index as it is a super (woohoo!) special ephemeral ibgib.
+        if (type !== 'roots' && type !== 'latest' && !skipRel8ToRoot) {
             await rel8ToCurrentRoot({
                 ibGib: resNewSpecial.newIbGib,
                 linked: true,

package/src/witness/witness-with-context/witness-with-context-base-v1.mts

@@ -102,7 +102,7 @@ export abstract class WitnessWithContextBase_V1<
      *
      * todo: refactor this to `metaspace` after we have completed majority of refactor/breakout from mvp
      */
-    public ibgibsSvc: MetaspaceService | undefined;
+    public metaspace: MetaspaceService | undefined;
 
     protected _contextChangesSubscription: SubscriptionWitness | undefined;
     protected _currentWorkingContextIbGib: IbGib_V1 | undefined;
@@ -142,13 +142,13 @@ export abstract class WitnessWithContextBase_V1<
         const lc = `${this.lc}[${this.loadNewerSelfIfAvailable.name}]`;
         try {
             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)`);
                     }
@@ -157,7 +157,7 @@ export abstract class WitnessWithContextBase_V1<
                     if (validationErrors?.length > 0) { throw new Error(`validationErrors when loading newer version: ${pretty(validationErrors)} (E: 0d9f0684a1ff6af44e20a57130e3ac22)`); }
                 }
             } else {
-                console.warn(`${lc} this.ibgibsSvc undefined (W: 44cc5bf1b14b4695b8de4c589787be06)`);
+                console.warn(`${lc} this.metaspace undefined (W: 44cc5bf1b14b4695b8de4c589787be06)`);
             }
         } catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
@@ -176,20 +176,20 @@ export abstract class WitnessWithContextBase_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.
      */
     protected async rel8To({
         ibGibs,
         rel8nName,
         linked,
-        ibgibsSvc,
+        metaspace,
         // space,
     }: {
         /**
@@ -211,7 +211,7 @@ export abstract class WitnessWithContextBase_V1<
         /**
          * If provided, will register the newly created ibgib.
          */
-        ibgibsSvc?: MetaspaceService,
+        metaspace?: MetaspaceService,
         // /**
         //  * If given (which atow is most likely the case), then the {@link TransformResult} will
         //  * be persisted in this `space`.
@@ -232,24 +232,24 @@ export abstract class WitnessWithContextBase_V1<
             const thisValidationErrors = await this.validateThis();
             if (thisValidationErrors?.length > 0) { throw new Error(`this is an invalid ibGib. thisValidationErrors: ${thisValidationErrors.join('|')} (E: 8f08716866cd13bf254222ee9e6a6722)`); }
 
-            ibgibsSvc = ibgibsSvc ?? this.ibgibsSvc;
+            metaspace = metaspace ?? this.metaspace;
 
-            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;
+            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
 
@@ -285,7 +285,7 @@ export abstract class WitnessWithContextBase_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)`); }
             // }
@@ -295,7 +295,7 @@ export abstract class WitnessWithContextBase_V1<
             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)}`);
             throw error;
@@ -321,9 +321,9 @@ export abstract class WitnessWithContextBase_V1<
         try {
             if (!ibGibToRel8 && !ibGibAddrToRel8) { throw new Error(`ibGibToRel8 or ibGibAddrToRel8 required (E: 3ee14659fd22355a5ba0e537a477be22)`); }
             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) {
@@ -346,11 +346,11 @@ export abstract class WitnessWithContextBase_V1<
                 });
 
             // ...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)}`);
             throw error;
@@ -365,27 +365,27 @@ export abstract class WitnessWithContextBase_V1<
         text: string,
         contextIbGib: IbGib_V1,
         rel8nName: string,
-        ibgibsSvc?: MetaspaceService,
+        metaspace?: MetaspaceService,
     }): Promise<void> {
         const lc = `${this.lc}[${this.createCommentAndRel8ToContextIbGib.name}]`;
         try {
             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 as CommentIbGib_V1;
             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({
@@ -477,22 +477,22 @@ export abstract class WitnessWithContextBase_V1<
             if (logalot) { console.log(`${lc} starting... (I: c13f7cb92133984048f606075efb8a22)`); }
             let contextIbGib: IbGib_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) { throw new Error(`(UNEXPECTED) invalid arg? no context ibgib on arg (E: 89997eb4bdeb3885bee9de5d33ee0f22)`); }
                 if ((arg.ibGibs ?? []).length !== 1) { throw new Error(`(UNEXPECTED) invalid arg? only expected one ibgib on arg.ibGibs (E: 1a1498af668740fe9439f4953a74ea8a)`); }
                 contextIbGib = arg.ibGibs![0];
             } 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];
                     } else {
@@ -513,7 +513,7 @@ export abstract class WitnessWithContextBase_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
@@ -553,7 +553,7 @@ export abstract class WitnessWithContextBase_V1<
         const lc = `${this.lc}[${this.initializeContext.name}]`;
         try {
             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)`);
             }
@@ -593,10 +593,10 @@ export abstract class WitnessWithContextBase_V1<
 
             // 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.ibgibsSvc.latestObs) { throw new Error(`(UNEXPECTED) this.ibgibsSvc.latestObs falsy? (E: 831936570c14ed526f9c9ab511929923)`); }
+            if (!this.metaspace) { throw new Error(`(UNEXPECTED) this.metaspace falsy...not initialized? (E: 6e38bfdc5c2eb5fef884f0183889e823)`); }
+            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) => {
@@ -631,7 +631,7 @@ export abstract class WitnessWithContextBase_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)`)
                         },
                     }));
 
@@ -649,7 +649,7 @@ export abstract class WitnessWithContextBase_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 */ }
@@ -809,8 +809,8 @@ export abstract class WitnessWithContextBase_V1<
             }
 
             // get the latest addrs for those children
-            if (!this.ibgibsSvc) { throw new Error(`this.ibgibsSvc falsy. not initialized? (E: 1cc26ca7de7fadcdbaecbd6613350e23)`); }
-            const space = await this.ibgibsSvc.getLocalUserSpace({});
+            if (!this.metaspace) { throw new Error(`this.metaspace falsy. not initialized? (E: 1cc26ca7de7fadcdbaecbd6613350e23)`); }
+            const space = await this.metaspace.getLocalUserSpace({});
             if (!space) { throw new Error(`couldn't get local user space? (E: f118f75e5852fc22bba3a6495beec723)`); }
             const resLatestAddrs = await getLatestAddrs({ addrs: newChildrenAddrs, space, });
             const latestAddrs = Object.values(resLatestAddrs?.data?.latestAddrsMap ?? {});
@@ -821,7 +821,7 @@ export abstract class WitnessWithContextBase_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 as IbGibAddr[] });
+            const resGet = await this.metaspace.get({ addrs: latestAddrs as IbGibAddr[] });
             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)`);
             }