@ibgib/core-gib 0.1.23 → 0.1.25

package/src/sync/sync-helpers.mts

@@ -80,7 +80,7 @@ export async function getTempSpaceName(): Promise<string> {
 
 /**
  * UNTESTED
- * 
+ *
  * Checks if an {@link olderAddr} is the address of a past frame in the ibgib
  * with {@link newerAddr}.
  */
@@ -89,8 +89,8 @@ export async function isPastFrame({
     newerAddr,
     space,
 }: {
-    olderAddr: string, // Was ancestorAddr
-    newerAddr: string, // Was descendantAddr
+    olderAddr: string,
+    newerAddr: string,
     space: IbGibSpaceAny,
 }): Promise<boolean> {
     const lc = `[${isPastFrame.name}]`;
@@ -148,15 +148,15 @@ export async function isPastFrame({
 
 /**
  * Gets a shallow dependency graph for a Sync Saga Frame.
- * 
+ *
  * DOES NOT GET THE ENTIRE DEPENDENCY FRAME (INCLUDING PAST).
- * 
+ *
  * Unlike standard `getDependencyGraph`, this does NOT traverse `ancestor` (history) or `past`.
  * It only retrieves the *content* of the current frame:
  * 1. The Frame itself.
  * 2. The Message Stone(s) (`rel8ns.msg`).
  * 3. The Identity(s) (`rel8ns.identity`).
- * 
+ *
  * This is used for efficient transmission of the "Current Step" without re-sending the entire history.
  */
 export async function getSyncSagaFrameDependencyGraph({

package/src/sync/sync-innerspace-constants.respec.mts

@@ -9,7 +9,7 @@ import {
     respecfully, ifWeMight, iReckon, ifWe
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 const maam = `[${import.meta.url}]`, sir = maam;
-import { delay } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { clone, delay } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
 
@@ -20,6 +20,7 @@ import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
 import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
+import { SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mjs';
 
 const lc = `[sync-innerspace-constants.respec]`;
 
@@ -69,17 +70,14 @@ await respecfully(sir, `Sync Constants (No TJP)`, async () => {
         const senderCoordinator = new SyncSagaCoordinator(mockKeystone);
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
-        // const peer = new SyncPeerInnerspace_V1({
-        //     senderSpace: sourceSpace,
-        //     receiverSpace: destSpace,
-        //     receiverCoordinator: receiverCoordinator,
-        //     receiverMetaspace: metaspace,
-        //     receiverTempSpace: 0 as any, // placeholder this is wrong // just to get to compile
-        //     senderTempSpace: 0 as any, // placeholder this is wrong // just to get to compile
-        // }, {
-        //     classname: SyncPeerInnerspace_V1.name,
-        // });
-        const peer = new SyncPeerInnerspace_V1(0 as any, 0 as any, 0 as any, 0 as any);
+        const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
+        await peer.initialized;
+        await peer.initializeSender({
+            senderSpace: sourceSpace,   // "Client"
+            receiverSpace: destSpace,   // "Server"
+            receiverCoordinator,
+            receiverMetaspace: metaspace,
+        });
 
         // 4. Sync C1 (First Pass)
         let resSync = await senderCoordinator.sync({

package/src/sync/sync-innerspace-deep-updates.respec.mts

@@ -9,7 +9,7 @@ import {
     ifWeMight
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 const maam = `[${import.meta.url}]`, sir = maam;
-import { delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { clone, delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { getDependencyGraph } from '../common/other/graph-helper.mjs';
 
@@ -22,6 +22,7 @@ import { mut8Timeline } from '../timeline/timeline-api.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
 import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
+import { SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-deep-updates.respec]`;
@@ -100,17 +101,14 @@ await respecfully(sir, `Sync InnerSpaces (Deep Updates)`, async () => {
         const senderCoordinator = new SyncSagaCoordinator(mockKeystone);
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
-        // const peer = new SyncPeerInnerspace_V1(
-        //     senderSpace: sourceSpace,
-        //     receiverSpace: destSpace,
-        //     receiverCoordinator: receiverCoordinator,
-        //     receiverMetaspace: metaspace,
-        //     receiverTempSpace: 0 as any, // just to get to compile
-        //     senderTempSpace: 0 as any, // just to get to compile
-        // }, {
-        //     classname: SyncPeerInnerspace_V1.name,
-        // });
-        const peer = new SyncPeerInnerspace_V1(0 as any, 0 as any, 0 as any, 0 as any);
+        const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
+        await peer.initialized;
+        await peer.initializeSender({
+            senderSpace: sourceSpace,   // "Client"
+            receiverSpace: destSpace,   // "Server"
+            receiverCoordinator,
+            receiverMetaspace: metaspace,
+        });
 
         // 4. Run Sync
         console.log(`${lc} Running Sync...`);

package/src/sync/sync-innerspace-dest-ahead.respec.mts

@@ -9,7 +9,7 @@ import {
     ifWeMight
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 const maam = `[${import.meta.url}]`, sir = maam;
-import { delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { clone, delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { getDependencyGraph } from '../common/other/graph-helper.mjs';
 
@@ -22,6 +22,7 @@ import { mut8Timeline } from '../timeline/timeline-api.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
 import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
+import { SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-dest-ahead.respec]`;
@@ -110,17 +111,14 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
         const senderCoordinator = new SyncSagaCoordinator(mockKeystone);
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
-        // const peer = new SyncPeerInnerspace_V1({
-        //     senderSpace: sourceSpace,
-        //     receiverSpace: destSpace,
-        //     receiverCoordinator: receiverCoordinator,
-        //     receiverMetaspace: metaspace,
-        //     receiverTempSpace: 0 as any,// this is wrong just getting to build
-        //     senderTempSpace: 0 as any, // this is wrong just getting to build
-        // }, {
-        //     classname: SyncPeerInnerspace_V1.name
-        // });
-        const peer = new SyncPeerInnerspace_V1(0 as any, 0 as any, 0 as any, 0 as any);
+        const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
+        await peer.initialized;
+        await peer.initializeSender({
+            senderSpace: sourceSpace,   // "Client"
+            receiverSpace: destSpace,   // "Server"
+            receiverCoordinator,
+            receiverMetaspace: metaspace,
+        });
 
         // 4. Run Sync (Source Pushes V1)
         console.log(`${lc} Running Sync...`);

package/src/sync/sync-innerspace-multiple-timelines.respec.mts

@@ -9,7 +9,7 @@ import {
     ifWeMight
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 const maam = `[${import.meta.url}]`, sir = maam;
-import { delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { clone, delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { getDependencyGraph } from '../common/other/graph-helper.mjs';
 
@@ -22,6 +22,7 @@ import { mut8Timeline } from '../timeline/timeline-api.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
 import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
+import { SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-multiple-timelines.respec]`;
@@ -104,18 +105,14 @@ await respecfully(sir, `Sync InnerSpaces (Multiple Timelines)`, async () => {
         const senderCoordinator = new SyncSagaCoordinator(mockKeystone);
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
-        // const peer = new SyncPeerInnerspace_V1({
-        //     senderSpace: sourceSpace,
-        //     receiverSpace: destSpace,
-        //     receiverCoordinator: receiverCoordinator,
-        //     receiverMetaspace: metaspace,
-        //     receiverTempSpace: 0 as any, // just to get to compile
-        //     senderTempSpace: 0 as any, // just to get to compile
-        // }, {
-        //     classname: SyncPeerInnerspace_V1.name,
-        // });
-        const peer = new SyncPeerInnerspace_V1(0 as any, 0 as any, 0 as any, 0 as any);
+        const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
+        await peer.initializeSender({
+            senderSpace: sourceSpace,   // "Client"
+            receiverSpace: destSpace,   // "Server"
+            receiverCoordinator,
+            receiverMetaspace: metaspace,
+        });
 
         // 4. Run Sync (Push Both)
         console.log(`${lc} Running Sync...`);

package/src/sync/sync-innerspace-partial-update.respec.mts

@@ -9,7 +9,7 @@ import {
     ifWeMight
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 const maam = `[${import.meta.url}]`, sir = maam;
-import { delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { clone, delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { getDependencyGraph } from '../common/other/graph-helper.mjs';
 
@@ -22,6 +22,7 @@ import { mut8Timeline } from '../timeline/timeline-api.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
 import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
+import { SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-partial-update.respec]`;
@@ -112,20 +113,14 @@ await respecfully(sir, `Sync InnerSpaces (Partial Update)`, async () => {
         const senderCoordinator = new SyncSagaCoordinator(mockKeystone);
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
-        // const peer = new SyncPeerInnerspace_V1({
-        //     senderSpace: sourceSpace,
-        //     receiverSpace: destSpace,
-        //     receiverCoordinator: receiverCoordinator,
-        //     receiverMetaspace: metaspace,
-        //     receiverTempSpace: 0 as any, // just to get to compile
-        //     senderTempSpace: 0 as any, // just to get to compile
-        // },
-        //     {
-        //         classname: SyncPeerInnerspace_V1.name,
-        //     }
-        // );
-        const peer = new SyncPeerInnerspace_V1(0 as any, 0 as any, 0 as any, 0 as any);
+        const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
+        await peer.initializeSender({
+            senderSpace: sourceSpace,   // "Client"
+            receiverSpace: destSpace,   // "Server"
+            receiverCoordinator,
+            receiverMetaspace: metaspace,
+        });
 
         // 4. Run Sync (Source Pushes V2)
         console.log(`${lc} Running Sync...`);

package/src/sync/sync-innerspace.respec.mts

@@ -10,7 +10,7 @@ import {
     ifWeMight
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 const maam = `[${import.meta.url}]`, sir = maam;
-import { delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { clone, delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 
 import { SyncSagaCoordinator } from './sync-saga-coordinator.mjs';
@@ -23,6 +23,7 @@ import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-
 import { toDto } from '../common/other/ibgib-helper.mjs';
 import { fnObs } from '../common/pubsub/observer/observer-helper.mjs';
 import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
+import { SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace.respec]`;
@@ -103,18 +104,14 @@ await respecfully(sir, `Sync InnerSpaces`, async () => {
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
         // Peer (The "Network")
-        // const peer = new SyncPeerInnerspace_V1({
-        //     senderSpace: sourceSpace,   // "Client"
-        //     receiverSpace: destSpace,   // "Server"
-        //     receiverCoordinator: receiverCoordinator,
-        //     receiverMetaspace: metaspace,
-        //     senderTempSpace: 0 as any,
-        //     receiverTempSpace: 0 as any,
-        // }, {
-        //     classname: SyncPeerInnerspace_V1.name,
-        // });
-        const peer = new SyncPeerInnerspace_V1(0 as any, 0 as any, 0 as any, 0 as any);
+        const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
+        await peer.initializeSender({
+            senderSpace: sourceSpace,   // "Client"
+            receiverSpace: destSpace,   // "Server"
+            receiverCoordinator,
+            receiverMetaspace: metaspace,
+        });
 
         // 4. Run Sync
         console.log(`${lc} Running Sync...`);

package/src/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mts

@@ -2,7 +2,14 @@
  * @module sync peer innerspace constants
  */
 
+import { SyncPeerInnerspaceData_V1 } from "./sync-peer-innerspace-types.mjs";
+import { SyncPeerInnerspace_V1 } from "./sync-peer-innerspace-v1.mjs";
+
 /**
  * Atom for the sync peer innerspace ibgib.
  */
 export const SYNC_PEER_INNERSPACE_ATOM = 'sync_peer_innerspace';
+
+export const SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1: SyncPeerInnerspaceData_V1 = {
+    classname: SyncPeerInnerspace_V1.name,
+}

package/src/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mts

@@ -15,6 +15,7 @@ import { SyncPeerInnerspaceData_V1, SyncPeerInnerspaceIbGib_V1, SyncPeerInnerspa
 import { MetaspaceService } from '../../../witness/space/metaspace/metaspace-types.mjs';
 import { SyncSagaCoordinator } from '../../sync-saga-coordinator.mjs';
 import { IbGibSpaceResultData } from '../../../witness/space/space-types.mjs';
+import { InitializeSyncPeerOpts } from '../sync-peer-types.mjs';
 
 
 const logalot = GLOBAL_LOG_A_LOT || true;
@@ -22,68 +23,82 @@ const logalotControlDomain = true;
 const lcControlDomain = '[ControlDomain]';
 
 /**
- * Concrete implementation of SyncPeer for local in-memory simulation (Innerspace to Innerspace).
- * 
- * Acts as the "Network" layer, transferring data between two local spaces and 
- * executing the receiver's coordinator logic.
+ * The innerspace sync peer works with innerspaces for both sender/receiver
+ * durable/temp spaces, as well as coordinators for each.
  */
-export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInnerspaceIbGib_V1 {
-
-    protected lc: string = `[${SyncPeerInnerspace_V1.name}]`;
-
+export interface InitializeSyncPeerInnerspaceOpts extends InitializeSyncPeerOpts {
     /**
      * specific to innerspace
      */
-    protected receiverCoordinator: SyncSagaCoordinator;
+    receiverCoordinator: SyncSagaCoordinator;
     /**
      * specific to innerspace
      */
-    protected receiverMetaspace: MetaspaceService;
-    public receiverSpace: IbGibSpaceAny;
-    public receiverTempSpace: IbGibSpaceAny;
+    receiverMetaspace: MetaspaceService;
+    /**
+     * specific to innerspace
+     */
+    receiverSpace: IbGibSpaceAny;
+    /**
+     * If not available at first, this will be automatically created.
+     */
+    receiverTempSpace?: IbGibSpaceAny;
+}
+
+/**
+ * Concrete implementation of SyncPeer for local in-memory simulation (Innerspace to Innerspace).
+ *
+ * Acts as the "Network" layer, transferring data between two local spaces and
+ * executing the receiver's coordinator logic.
+ */
+export class SyncPeerInnerspace_V1 extends SyncPeer_V1<InitializeSyncPeerInnerspaceOpts>
+    implements SyncPeerInnerspaceIbGib_V1 {
+
+    protected lc: string = `[${SyncPeerInnerspace_V1.name}]`;
 
     override get classname(): string {
         return SyncPeerInnerspace_V1.name;
     }
 
     constructor(
-        senderSpace: IbGibSpaceAny,
-        senderTempSpace: IbGibSpaceAny,
-        opts: SyncPeerInnerspaceOptions,
         initialData: SyncPeerInnerspaceData_V1,
         initialRel8ns?: SyncPeerInnerspaceRel8ns_V1,
     ) {
-        super(senderSpace, senderTempSpace, initialData, initialRel8ns);
-        const {
-            receiverCoordinator,
-            receiverMetaspace, receiverSpace, receiverTempSpace
-        } = opts;
-
-        this.receiverCoordinator = receiverCoordinator;
-        this.receiverMetaspace = receiverMetaspace;
-        this.receiverSpace = receiverSpace;
-        this.receiverTempSpace = receiverTempSpace;
+        super(initialData, initialRel8ns);
     }
 
     protected override async ensureReceiverTempSpace(): Promise<IbGibSpaceAny> {
-        if (!this.receiverTempSpace) {
-            const { receiverMetaspace } = this;
-
-            const uuid = crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36);
-            const tempSpaceName = `tmp_sync_recv_${uuid.substring(0, 8)}`;
-            const receiverTempSpace = await this.receiverMetaspace.createNewLocalSpace({
-                opts: {
-                    allowCancel: false,
-                    spaceName: tempSpaceName,
-                    getFnPrompt: this.receiverMetaspace.getFnPrompt!,
-                    logalot
-                }
-            });
-            if (!receiverTempSpace) { throw new Error(`(UNEXPECTED) receiverTempSpace falsy? couldn't create a temp space? (E: a6b8f86b0f58384b884a33b82924b826)`); }
-            await receiverTempSpace.initialized;
-            this.receiverTempSpace = receiverTempSpace;
+        const lc = `${this.lc}[${this.ensureReceiverTempSpace.name}]`;
+        try {
+            if (logalot) { console.log(`${lc} starting... (I: bab87f15dea77cd4892bd8a8d2e65826)`); }
+
+            if (!this.opts) { throw new Error(`(UNEXPECTED) this.opts falsy? (E: 0f85bd4c3efdbee2a829aca860c48926)`); }
+
+            if (!this.opts.receiverTempSpace) {
+                const { receiverMetaspace } = this.opts;
+
+                const uuid = crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36);
+                const tempSpaceName = `tmp_sync_recv_${uuid.substring(0, 8)}`;
+                const receiverTempSpace = await receiverMetaspace.createNewLocalSpace({
+                    opts: {
+                        allowCancel: false,
+                        spaceName: tempSpaceName,
+                        getFnPrompt: receiverMetaspace.getFnPrompt!,
+                        logalot
+                    }
+                });
+                if (!receiverTempSpace) { throw new Error(`(UNEXPECTED) receiverTempSpace falsy? couldn't create a temp space? (E: a6b8f86b0f58384b884a33b82924b826)`); }
+                await receiverTempSpace.initialized;
+                this.opts.receiverTempSpace = receiverTempSpace;
+            }
+
+            return this.opts.receiverTempSpace;
+        } catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        } finally {
+            if (logalot) { console.log(`${lc} complete.`); }
         }
-        return this.receiverTempSpace;
     }
 
 
@@ -91,12 +106,13 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
         const lc = `${this.lc}[${this.push.name}]`;
         try {
             if (logalot) { console.log(`${lc} starting... (I: 07bce80be18f3259b8a311ed9c4da926)`); }
+            if (!this.opts) { throw new Error(`(UNEXPECTED) this.opts falsy? (E: e1efd1b364cc8a8d985b243878f71e26)`); }
 
             // silly defensive checks because this has been a ridiculous development cycle
-            if (!this.senderSpace) { throw new Error(`(UNEXPECTED) this.senderSpace falsy? (E: 503e288168f5d297f4d4e028bc538826)`); }
-            if (!this.receiverSpace) { throw new Error(`(UNEXPECTED) this.receiverSpace falsy? (E: 0bd7c1a0ba4868ac7a260e15b504e826)`); }
+            if (!this.opts.senderSpace) { throw new Error(`(UNEXPECTED) this.opts.senderSpace falsy? (E: 503e288168f5d297f4d4e028bc538826)`); }
+            if (!this.opts.receiverTempSpace) { throw new Error(`(UNEXPECTED) this.opts.receiverTempSpace falsy? (E: 0bd7c1a0ba4868ac7a260e15b504e826)`); }
 
-            await this.transfer({ addrs, from: this.senderSpace, to: this.receiverSpace });
+            await this.transfer({ addrs, from: this.opts.senderSpace, to: this.opts.receiverTempSpace });
         } catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
             throw error;
@@ -110,11 +126,13 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
         try {
             if (logalot) { console.log(`${lc} starting... (I: b16a28ed0dc8f52f1838ee257d9b1126)`); }
 
+            if (!this.opts) { throw new Error(`(UNEXPECTED) this.opts falsy? (E: 5a72b83fc1a83bf0f81d19330f575626)`); }
+
             // silly defensive checks because this has been a ridiculous development cycle
-            if (!this.receiverSpace) { throw new Error(`(UNEXPECTED) this.receiverSpace falsy? (E: bd2fdfa89ba4c89a185b68e9bb1f1c26)`); }
-            if (!this.senderTempSpace) { throw new Error(`(UNEXPECTED) this.senderTempSpace falsy? (E: b23fa55713f881493dac4a9835ac7326)`); }
+            if (!this.opts.receiverSpace) { throw new Error(`(UNEXPECTED) this.opts.receiverSpace falsy? (E: bd2fdfa89ba4c89a185b68e9bb1f1c26)`); }
+            if (!this.opts.senderTempSpace) { throw new Error(`(UNEXPECTED) this.opts.senderTempSpace falsy? (E: b23fa55713f881493dac4a9835ac7326)`); }
 
-            await this.transfer({ addrs, from: this.receiverSpace, to: this.senderTempSpace });
+            await this.transfer({ addrs, from: this.opts.receiverSpace, to: this.opts.senderTempSpace });
         } catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
             throw error;
@@ -125,9 +143,11 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
 
     protected async sendContextRequest(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined> {
         const lc = `${this.lc}[${this.sendContextRequest.name}]`;
-        const { receiverSpace, receiverCoordinator, receiverMetaspace } = this;
-
         try {
+            if (!this.opts) { throw new Error(`(UNEXPECTED) this.opts falsy? (E: d8b1348e3233810128999596b1fa5826)`); }
+
+            const { receiverSpace, receiverCoordinator, receiverMetaspace } = this.opts;
+
             if (logalot) { console.log(`${lc} starting...Context: ${getIbGibAddr({ ibGib: context })}`); }
 
             // 0. Validate context (naive, not business logic validation)
@@ -137,6 +157,11 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
             if (!context.sagaFrame) { throw new Error(`(UNEXPECTED) context.sagaFrame falsy? (E: 79cd98a6d9b88a591f4596c8bc58ff26)`); }
 
 
+            // if we have push offer requests, start those.
+
+            // send the context itself, then send the payload ibgibs separately.
+
+
 
             throw new Error(`not implemented (E: 72840872e252d9f7380f1998b5a0c826)`);
         } catch (error) {

package/src/sync/sync-peer/sync-peer-types.mts

@@ -30,11 +30,32 @@ export interface SyncPeerRel8ns_V1 extends IbGibRel8ns_V1 {
  */
 export interface SyncPeerIbGib_V1 extends IbGib_V1<SyncPeerData_V1, SyncPeerRel8ns_V1> { }
 
+/**
+ * base initialization opts
+ */
+export interface InitializeSyncPeerOpts {
+    /**
+     * sender's durable space.
+     * 
+     * will store control ibgibs (context, sync saga ibgib, control msg stones)
+     * here (and in {@link senderTempSpace}) throughout the process for audit trail.
+     */
+    senderSpace: IbGibSpaceAny;
+    /**
+     * sender's temporary space for the entire sync transaction.
+     * 
+     * In addition to control ibgibs which are stored in both temp and durable
+     * spaces, this temp space will be where domain ibgibs are stored that are
+     * received/created throughout the transaction until commit.
+     */
+    senderTempSpace?: IbGibSpaceAny;
+}
+
 /**
  * The interface for the SyncPeer witness class.
  * It witnesses a SyncSagaContext and returns a SyncSagaContext (Request -> Response).
  */
-export interface SyncPeerWitness extends Witness_V1<
+export interface SyncPeerWitness<TInitializeOpts extends InitializeSyncPeerOpts = InitializeSyncPeerOpts> extends Witness_V1<
     SyncSagaContextData_V1,
     SyncSagaContextRel8ns_V1,
     SyncSagaContextIbGib_V1, // Input
@@ -44,23 +65,26 @@ export interface SyncPeerWitness extends Witness_V1<
     SyncPeerData_V1,
     SyncPeerRel8ns_V1
 > {
-    // witness(arg: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
+    get classname(): string;
 
     /**
-     * sender's durable space.
+     * sender-specific opts/config
      * 
-     * will store control ibgibs (context, sync saga ibgib, control msg stones)
-     * here (and in {@link senderTempSpace}) throughout the process for audit trail.
+     * ## notes
+     * 
+     * I'm doing this hack because I have to be able to create a peer without
+     * being able to fully configure it at construction time. So I can't place
+     * this init code in the {@link initialize} method.
      */
-    senderSpace: IbGibSpaceAny;
+    opts: TInitializeOpts | undefined;
+
     /**
-     * sender's temporary space for the entire sync transaction.
+     * use this to set the senderTempSpace and any other optional opts that need
+     * to be configured just before sending any contexts across the wire.
      * 
-     * In addition to control ibgibs which are stored in both temp and durable
-     * spaces, this temp space will be where domain ibgibs are stored that are
-     * received/created throughout the transaction until commit.
+     * @see {@link opts}
      */
-    senderTempSpace: IbGibSpaceAny;
+    setOptionalOpts(arg: Partial<TInitializeOpts>): void;
 
     /**
      * Observable for streaming large domain payloads asynchronously.