@ibgib/core-gib 0.1.22 → 0.1.25

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,15 +104,13 @@ await respecfully(sir, `Sync InnerSpaces`, async () => {
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
         // Peer (The "Network")
-        const peer = new SyncPeerInnerspace_V1({
+        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: receiverCoordinator,
+            receiverCoordinator,
             receiverMetaspace: metaspace,
-            senderTempSpace: 0 as any,
-            receiverTempSpace: 0 as any,
-        }, {
-            classname: SyncPeerInnerspace_V1.name,
         });
 
         // 4. Run 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-types.mts

@@ -14,21 +14,6 @@ import { SyncPeerData_V1, SyncPeerRel8ns_V1 } from '../sync-peer-types.mjs';
  * Options for creating a SyncPeerInnerspace instance.
  */
 export interface SyncPeerInnerspaceOptions {
-    /**
-     * 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 "receiver" durable space (not temp). 
      * 

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

@@ -3,114 +3,96 @@
  */
 
 import { extractErrorMsg, unique } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
+import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
 
 import { GLOBAL_LOG_A_LOT } from '../../../core-constants.mjs';
-import { SYNC_ATOM, } from '../../sync-constants.mjs';
 import { IbGibSpaceAny } from '../../../witness/space/space-base-v1.mjs';
 import { SyncPeer_V1 } from '../sync-peer-v1.mjs';
 import { getFromSpace, putInSpace } from '../../../witness/space/space-helper.mjs';
 import { SyncSagaContextIbGib_V1, } from '../../sync-saga-context/sync-saga-context-types.mjs';
-import { createSyncSagaContext } from '../../sync-saga-context/sync-saga-context-helpers.mjs';
-import { SubjectWitness } from '../../../common/pubsub/subject/subject-types.mjs';
-import { newupSubject } from '../../../common/pubsub/subject/subject-helper.mjs';
 import { SyncPeerInnerspaceData_V1, SyncPeerInnerspaceIbGib_V1, SyncPeerInnerspaceOptions, SyncPeerInnerspaceRel8ns_V1 } from './sync-peer-innerspace-types.mjs';
-import { SYNC_PEER_INNERSPACE_ATOM } from './sync-peer-innerspace-constants.mjs';
-import { SyncPeerData_V1, SyncPeerRel8ns_V1 } from '../sync-peer-types.mjs';
 import { MetaspaceService } from '../../../witness/space/metaspace/metaspace-types.mjs';
 import { SyncSagaCoordinator } from '../../sync-saga-coordinator.mjs';
-import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
 import { IbGibSpaceResultData } from '../../../witness/space/space-types.mjs';
-import { getSyncSagaDependencyGraph } from '../../sync-helpers.mjs';
+import { InitializeSyncPeerOpts } from '../sync-peer-types.mjs';
 
 
 const logalot = GLOBAL_LOG_A_LOT || true;
 const logalotControlDomain = true;
 const lcControlDomain = '[ControlDomain]';
 
+/**
+ * The innerspace sync peer works with innerspaces for both sender/receiver
+ * durable/temp spaces, as well as coordinators for each.
+ */
+export interface InitializeSyncPeerInnerspaceOpts extends InitializeSyncPeerOpts {
+    /**
+     * specific to innerspace
+     */
+    receiverCoordinator: SyncSagaCoordinator;
+    /**
+     * specific to innerspace
+     */
+    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 
+ *
+ * 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 implements SyncPeerInnerspaceIbGib_V1 {
+export class SyncPeerInnerspace_V1 extends SyncPeer_V1<InitializeSyncPeerInnerspaceOpts>
+    implements SyncPeerInnerspaceIbGib_V1 {
 
     protected lc: string = `[${SyncPeerInnerspace_V1.name}]`;
 
-    public payloadIbGibsDomainReceived$!: SubjectWitness<IbGib_V1>;
-
-    private senderSpace: IbGibSpaceAny;
-    private senderTempSpace: IbGibSpaceAny;
-    private receiverCoordinator: SyncSagaCoordinator;
-    private receiverMetaspace: MetaspaceService;
-    private receiverSpace: IbGibSpaceAny;
-    private receiverTempSpace: IbGibSpaceAny;
-
     override get classname(): string {
         return SyncPeerInnerspace_V1.name;
     }
 
     constructor(
-        opts: SyncPeerInnerspaceOptions,
         initialData: SyncPeerInnerspaceData_V1,
         initialRel8ns?: SyncPeerInnerspaceRel8ns_V1,
     ) {
         super(initialData, initialRel8ns);
-        const {
-            senderSpace, senderTempSpace, receiverCoordinator,
-            receiverMetaspace, receiverSpace, receiverTempSpace
-        } = opts;
-
-        this.senderSpace = senderSpace;
-        this.senderTempSpace = senderTempSpace;
-        this.receiverCoordinator = receiverCoordinator;
-        this.receiverMetaspace = receiverMetaspace;
-        this.receiverSpace = receiverSpace;
-        this.receiverTempSpace = receiverTempSpace;
-    }
-
-    async initialize(): Promise<void> {
-        this.payloadIbGibsDomainReceived$ = await newupSubject<IbGib_V1>();
     }
 
-    private 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;
-        }
-        return this.receiverTempSpace;
-    }
-
-    protected async getLocalIbGib(addr: string): Promise<IbGib_V1 | undefined> {
-        const lc = `${this.lc}[${this.getLocalIbGib.name}]`;
+    protected override async ensureReceiverTempSpace(): Promise<IbGibSpaceAny> {
+        const lc = `${this.lc}[${this.ensureReceiverTempSpace.name}]`;
         try {
-            if (logalot) { console.log(`${lc} starting... (I: 27b248cb9801eeb2386b71485389a826)`); }
-
-            console.warn(`${lc} possibly a bottleneck here, getLocalIbGib only gets a single ibgib... (W: 2fd448a435480e6b128f6b8bcbef4826)`);
-
-            const resGet = await getFromSpace({ space: this.senderSpace, addr });
-
-            if (resGet.success && resGet.ibGibs && resGet.ibGibs.length === 1) {
-                const ibGib = resGet.ibGibs[0];
-                return ibGib;
-            } else {
-                throw new Error(`couldn't get addr (${addr}) from local space ${this.senderSpace}. reason: ${resGet.errorMsg ?? 'unknown error (E: 926ef8bf4fcc299ab89dba34ea691a26)'} (E: d8a89807e471d3f8b938ab21df44cb26)`);
+            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;
@@ -119,16 +101,18 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
         }
     }
 
+
     protected async push(addrs: IbGibAddr[]): Promise<void> {
         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;
@@ -142,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;
@@ -157,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)
@@ -168,23 +156,11 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
             if (!context.rel8ns.sagaFrame) { throw new Error(`(UNEXPECTED) context.rel8ns.sagaFrame falsy? (E: ac06782ad538be406882605f0a83aa26)`); }
             if (!context.sagaFrame) { throw new Error(`(UNEXPECTED) context.sagaFrame falsy? (E: 79cd98a6d9b88a591f4596c8bc58ff26)`); }
 
-            // validate the context, sagaFrame, and identity(s)
-            // persist the context, sagaframe, identity(s) ONLY in the receiver's durable space
-            // if sending domain ibgibs...
-            //   verify the domain ibgibs intrinsically. 
-            //   persist the domain ibgibs in the receiver's temp space (push all addrs?)
-            //   await until all domain ibgibs are in receiver's temp space
-            // process the context with the receiver's coordinator to get a new response context
-            // analyze the response context
-            //   validate context intrinsically
-            //   validate return identity if present
-            // persist the response context's dependency graph (context, saga frame and msg(s), identities)
-            // if response has payload domain ibgibs, 
-            //   spin off...
-            //     pull domain ibgibs to local temp space
-            //     publish domain ibgibs to observable
-            //     when all domain ibgibs are pulled, publish complete to the observable
-            // return resulting context ibgib (which the caller should get BEFORE the domain ibgibs observable completes)
+
+            // 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)`);

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

@@ -7,6 +7,7 @@ import { SubjectWitness } from '../../common/pubsub/subject/subject-types.mjs';
 
 import { SyncSagaContextData_V1, SyncSagaContextIbGib_V1, SyncSagaContextRel8ns_V1 } from '../sync-saga-context/sync-saga-context-types.mjs';
 import { Witness_V1 } from '../../witness/witness-types.mjs';
+import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
 
 /**
  * Data for the SyncPeer witness.
@@ -29,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
@@ -43,7 +65,26 @@ export interface SyncPeerWitness extends Witness_V1<
     SyncPeerData_V1,
     SyncPeerRel8ns_V1
 > {
-    // witness(arg: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
+    get classname(): string;
+
+    /**
+     * sender-specific opts/config
+     * 
+     * ## 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.
+     */
+    opts: TInitializeOpts | undefined;
+
+    /**
+     * use this to set the senderTempSpace and any other optional opts that need
+     * to be configured just before sending any contexts across the wire.
+     * 
+     * @see {@link opts}
+     */
+    setOptionalOpts(arg: Partial<TInitializeOpts>): void;
 
     /**
      * Observable for streaming large domain payloads asynchronously.