@ibgib/core-gib 0.1.22 → 0.1.23

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

@@ -3,26 +3,18 @@
  */
 
 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';
 
 
 const logalot = GLOBAL_LOG_A_LOT || true;
@@ -39,43 +31,41 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
 
     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;
+    /**
+     * specific to innerspace
+     */
+    protected receiverCoordinator: SyncSagaCoordinator;
+    /**
+     * specific to innerspace
+     */
+    protected receiverMetaspace: MetaspaceService;
+    public receiverSpace: IbGibSpaceAny;
+    public receiverTempSpace: IbGibSpaceAny;
 
     override get classname(): string {
         return SyncPeerInnerspace_V1.name;
     }
 
     constructor(
+        senderSpace: IbGibSpaceAny,
+        senderTempSpace: IbGibSpaceAny,
         opts: SyncPeerInnerspaceOptions,
         initialData: SyncPeerInnerspaceData_V1,
         initialRel8ns?: SyncPeerInnerspaceRel8ns_V1,
     ) {
-        super(initialData, initialRel8ns);
+        super(senderSpace, senderTempSpace, initialData, initialRel8ns);
         const {
-            senderSpace, senderTempSpace, receiverCoordinator,
+            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> {
+    protected override async ensureReceiverTempSpace(): Promise<IbGibSpaceAny> {
         if (!this.receiverTempSpace) {
             const { receiverMetaspace } = this;
 
@@ -96,28 +86,6 @@ export class SyncPeerInnerspace_V1 extends SyncPeer_V1 implements SyncPeerInners
         return this.receiverTempSpace;
     }
 
-    protected async getLocalIbGib(addr: string): Promise<IbGib_V1 | undefined> {
-        const lc = `${this.lc}[${this.getLocalIbGib.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)`);
-            }
-        } catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        } finally {
-            if (logalot) { console.log(`${lc} complete.`); }
-        }
-    }
 
     protected async push(addrs: IbGibAddr[]): Promise<void> {
         const lc = `${this.lc}[${this.push.name}]`;
@@ -168,23 +136,6 @@ 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)
 
 
             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.
@@ -45,6 +46,22 @@ export interface SyncPeerWitness extends Witness_V1<
 > {
     // witness(arg: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
 
+    /**
+     * 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;
+
     /**
      * Observable for streaming large domain payloads asynchronously.
      * 

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

@@ -1,18 +1,35 @@
 /**
  * @module SyncPeer_V1 witness class
+ * 
+ * 
+ * NOTE: All push/pulls in this were done to get to compile. These should mostly
+ * not be single push/pull calls but should be batched with multiple addresses
+ * NOTE: All push/pulls in this were done to get to compile. These should mostly
+ * not be single push/pull calls but should be batched with multiple addresses
+ * NOTE: All push/pulls in this were done to get to compile. These should mostly
+ * not be single push/pull calls but should be batched with multiple addresses
+ * NOTE: All push/pulls in this were done to get to compile. These should mostly
+ * not be single push/pull calls but should be batched with multiple addresses
+ * NOTE: All push/pulls in this were done to get to compile. These should mostly
+ * not be single push/pull calls but should be batched with multiple addresses
  */
 
 import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-import { SubjectWitness } from '../../common/pubsub/subject/subject-types.mjs';
+import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
+import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
 
 import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
 import { SYNC_MSG_REL8N_NAME, SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN } from '../sync-constants.mjs';
+import { SubjectWitness } from '../../common/pubsub/subject/subject-types.mjs';
 import { SyncSagaContextIbGib_V1 } from '../sync-saga-context/sync-saga-context-types.mjs';
 import { SyncPeerData_V1, SyncPeerRel8ns_V1, SyncPeerWitness } from './sync-peer-types.mjs';
 import { LightWitnessBase_V1 } from '../../witness/light-witness-base-v1.mjs';
-import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
+import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
+import { newupSubject } from '../../common/pubsub/subject/subject-helper.mjs';
+import { validateContext } from '../sync-saga-context/sync-saga-context-helpers.mjs';
+import { getFromSpace } from '../../witness/space/space-helper.mjs';
 
 const logalot = GLOBAL_LOG_A_LOT || true;
 const logalotControlDomain = true;
@@ -33,7 +50,9 @@ export abstract class SyncPeer_V1 extends LightWitnessBase_V1<SyncPeerData_V1, S
 
     protected lc: string = `[${SyncPeer_V1.name}]`;
 
-    abstract payloadIbGibsDomainReceived$: SubjectWitness<IbGib_V1>;
+    public senderSpace: IbGibSpaceAny;
+    public senderTempSpace: IbGibSpaceAny;
+    public payloadIbGibsDomainReceived$!: SubjectWitness<IbGib_V1>;
 
     get classname(): string {
         if (!this.data) { throw new Error(`(UNEXPECTED) this.data falsy? (E: 1ab1841e9338b54f3aa615fa37024826)`); }
@@ -41,33 +60,84 @@ export abstract class SyncPeer_V1 extends LightWitnessBase_V1<SyncPeerData_V1, S
         return this.data.classname;
     }
 
-    constructor(initialData: SyncPeerData_V1, initialRel8ns?: SyncPeerRel8ns_V1) {
+    constructor(senderSpace: IbGibSpaceAny, senderTempSpace: IbGibSpaceAny, initialData: SyncPeerData_V1, initialRel8ns?: SyncPeerRel8ns_V1) {
         super(initialData, initialRel8ns);
+        this.senderSpace = senderSpace;
+        this.senderTempSpace = senderTempSpace;
+    }
+
+    async initialize(): Promise<void> {
+        this.payloadIbGibsDomainReceived$ = await newupSubject<IbGib_V1>();
     }
+
+    protected abstract ensureReceiverTempSpace(): Promise<IbGibSpaceAny>;
+
     /**
      * Witness the synchronization context (Send/Receive).
      * 
+     * At this point in code, we are sending the context OUTGOING. The {@link context} should
+     * have a fully populated {@link SyncSagaContextIbGib_V1.sagaFrame}
+     * 
      * @param arg The OUTGOING context (Request).
      * @returns The INCOMING context (Response), or undefined if failed/empty.
      */
-    async witness(arg: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined> {
+    override async witness(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined> {
         const lc = `${this.lc}[${this.witness.name}]`;
         try {
             if (logalot) { console.log(`${lc} starting...`); }
 
             if (logalot) { console.log(`${lc} starting...`); }
 
+            // validate, authenticate, and authorize the context, sagaFrame, and identity(s)
+            const validationErrors = await validateContext({ context });
+            if (validationErrors.length > 0) {
+                throw new Error(`invalid context received. validationErrors: ${validationErrors} (E: 8b34c875c968af29bc433138e57a7826)`);
+            }
+            const authenticationErrors = await this.authenticateContext({ context });
+            if (authenticationErrors.length > 0) {
+                throw new Error(`invalid context authentication. authenticationErrors: ${authenticationErrors} (E: da89da5ee1269aeb78952d475d607526)`);
+            }
+            const authorizationErrors = await this.authorizeContext({ context });
+            if (authorizationErrors.length > 0) {
+                throw new Error(`invalid context authorization. authorizationErrors: ${authorizationErrors} (E: 8ddc284a758cf10ba829334c1babb826)`);
+            }
+
+            // at this point, we have a valid, authenticated, authorized context
+
+            // 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)
+
             // 1. PUSH: Ensure Request Data is available on Receiver
-            await this.pushContextGraph({ context: arg });
+            await this.pushContextGraph({ context }); // ???
 
             // 2. EXECUTE: Trigger Remote Processing
-            const response = await this.sendContextRequest(arg);
+            const response = await this.sendContextRequest(context);
 
             if (!response) {
                 if (logalot) { console.log(`${lc} No response from peer.`); }
                 return undefined;
             }
 
+            // at this point, we have received the response context, sync saga
+            // frame/msg stones, and any keystones should be evolved. Depending
+            // on the concrete implementation, if there are domain ibgibs to
+            // receive, they may already be coming. 
+
+            // todo: this pull is a 
             // 3. PULL: Ensure Response Data is available on Sender (Local)
             await this.pullContextGraph({ context: response });
 
@@ -100,6 +170,46 @@ export abstract class SyncPeer_V1 extends LightWitnessBase_V1<SyncPeerData_V1, S
      */
     protected abstract pull(addrs: IbGibAddr[]): Promise<void>;
 
+
+
+    /**
+     * move to sync-peer-helpers.mts as a pure function?
+     */
+    protected async authenticateContext({ context }: { context: SyncSagaContextIbGib_V1 }): Promise<string[]> {
+        const lc = `${this.lc}[${this.authenticateContext.name}]`;
+        try {
+            if (logalot) { console.log(`${lc} starting... (I: 2677a482dfa873dcd1aa04a3031ff826)`); }
+
+            console.error(`${lc} NAG ERROR (NOT THROWN): not implemented. // todo: authenticate  (v1 must have this after we get merge logic workflow going) (E: bc3a78f2dab18ab64c36d055a4b50526)`);
+
+            return [];
+        } catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        } finally {
+            if (logalot) { console.log(`${lc} complete.`); }
+        }
+    }
+
+    /**
+     * move to sync-peer-helpers.mts as a pure function?
+     */
+    protected async authorizeContext({ context }: { context: SyncSagaContextIbGib_V1 }): Promise<string[]> {
+        const lc = `${this.lc}[${this.authorizeContext.name}]`;
+        try {
+            if (logalot) { console.log(`${lc} starting... (I: 48c918b41ceec0cd489ca3b8819e6826)`); }
+
+            console.error(`${lc} NAG ERROR (NOT THROWN): not implemented. authorize business logic (v1 must have this, but later when we are working on admin vs. student)(E: bc3a78f2dab18ab64c36d055a4b50526)`);
+
+            return [];
+        } catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        } finally {
+            if (logalot) { console.log(`${lc} complete.`); }
+        }
+    }
+
     /**
      * Helper to orchestrate the PUSH of a Context's dependency graph.
      */
@@ -239,6 +349,29 @@ export abstract class SyncPeer_V1 extends LightWitnessBase_V1<SyncPeerData_V1, S
     /**
      * Abstract accessor to get an IbGib from the Local space/store.
      * Needed for inspecting rela8ns during the graph walk.
+     * 
+     * Default implementation simply looks in senderSpace
      */
-    protected abstract getLocalIbGib(addr: string): Promise<IbGib_V1 | undefined>;
+    protected async getLocalIbGib(addr: string): Promise<IbGib_V1 | undefined> {
+        const lc = `${this.lc}[${this.getLocalIbGib.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)`);
+            }
+        } catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        } finally {
+            if (logalot) { console.log(`${lc} complete.`); }
+        }
+    }
 }

package/src/sync/sync-saga-context/sync-saga-context-helpers.mts

@@ -7,14 +7,20 @@ import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/factory.mjs';
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { IbGib_V1, } from '@ibgib/ts-gib/dist/V1/types.mjs';
 import { Ib } from '@ibgib/ts-gib/dist/types.mjs';
+import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
 
+import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
 import { SYNC_SAGA_CONTEXT_ATOM } from './sync-saga-context-constants.mjs';
 import { SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN } from '../sync-constants.mjs';
 import {
-    SyncSagaContextData_V1, SyncSagaContextIbGib_V1,
-    SyncSagaContextIb_V1, SyncSagaContextRel8ns_V1
+    SyncSagaContextData_V1, SyncSagaContextIbGib_V1, SyncSagaContextIb_V1,
+    SyncSagaContextRel8ns_V1,
 } from './sync-saga-context-types.mjs';
-import { getTimestampInfo } from '../../common/other/ibgib-helper.mjs';
+import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
+import { putInSpace, registerNewIbGib } from '../../witness/space/space-helper.mjs';
+import { SyncIbGib_V1 } from '../sync-types.mjs';
+
+const logalot = GLOBAL_LOG_A_LOT;
 
 /**
  * Options for creating a SyncSagaContext ibgib.
@@ -23,7 +29,7 @@ export interface CreateSyncSagaContextOptions {
     /**
      * The main saga frame (Init, Ack, etc.).
      */
-    sagaFrame: IbGib_V1;
+    sagaFrame: SyncIbGib_V1;
     /**
      * Session identity keystones.
      */
@@ -33,6 +39,11 @@ export interface CreateSyncSagaContextOptions {
      * payloads to send, e.g., in a Delta frame.
      */
     payloadIbGibsDomain?: IbGib_V1[];
+    /**
+     * we persist the context in the local/sender space (relative to our
+     * execution POV) right when we create it.
+     */
+    localSpace: IbGibSpaceAny;
 }
 
 /**
@@ -98,53 +109,121 @@ export async function parseSyncSagaContextIb({
 }
 
 /**
- * Creates a new SyncSagaContext ibGib stone.
+ * Creates new SyncSagaContext stone. Puts/registers in {@link localSpace}
+ * immediately after creation.
  * 
  * @returns The context ibGib.
+ * 
+ * ## notes
+ * 
+ * the other ibgibs that are related to this context stone should already be
+ * put/registered in {@link localSpace}. 
  */
 export async function createSyncSagaContext({
     sagaFrame,
     sessionKeystones,
     payloadIbGibsDomain,
+    localSpace,
 }: CreateSyncSagaContextOptions): Promise<SyncSagaContextIbGib_V1> {
+    const lc = `[${createSyncSagaContext.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: 6b87bee313e811d1d2fc90e87fbec826)`); }
+
+        const date = new Date();
+        const timestamp = getTimestamp(date);
+        const timestampMs = date.getMilliseconds();
+
+        const data: SyncSagaContextData_V1 = {
+            timestamp,
+            timestampMs,
+        };
+
+        // Domain Payloads 
+        const payloadAddrsDomain = payloadIbGibsDomain ?
+            payloadIbGibsDomain?.map(x => getIbGibAddr({ ibGib: x })) :
+            undefined;
+        if (payloadAddrsDomain && payloadAddrsDomain.length > 0) {
+            data[SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN] = payloadAddrsDomain;
+        }
 
-    const date = new Date();
-    const timestamp = getTimestamp(date);
-    const timestampMs = date.getMilliseconds();
+        // rel8ns should always have saga frame, sometimes have keystone
+        const rel8ns: SyncSagaContextRel8ns_V1 = {
+            sagaFrame: [getIbGibAddr({ ibGib: sagaFrame })],
+        };
+        if (sessionKeystones && sessionKeystones.length > 0) {
+            rel8ns.sessionKeystone = sessionKeystones.map(x => getIbGibAddr({ ibGib: x }));
+        }
 
-    const data: SyncSagaContextData_V1 = {
-        timestamp,
-        timestampMs,
-    };
+        // Generate standard ib
+        const ib = await getSyncSagaContextIb({ data });
+
+        const contextIbGib = await Factory_V1.stone<SyncSagaContextData_V1, SyncSagaContextRel8ns_V1>({
+            parentPrimitiveIb: SYNC_SAGA_CONTEXT_ATOM,
+            ib,
+            data,
+            rel8ns,
+        }) as SyncSagaContextIbGib_V1;
+
+        // put/register immediately. Note that contextIbGib at this point is
+        // pure DTO, i.e., only ib, gib, data, rel8ns props.
+        await putInSpace({ ibGib: contextIbGib, space: localSpace, });
+        await registerNewIbGib({
+            ibGib: contextIbGib,
+            space: localSpace,
+            fnBroadcast: undefined,
+        });
+
+        // Attach actual ibgibs for transport (not pure DTO now)
+        contextIbGib.sagaFrame = sagaFrame;
+        if (payloadIbGibsDomain && payloadIbGibsDomain.length > 0) {
+            contextIbGib.payloadIbGibsDomain = payloadIbGibsDomain;
+        }
 
-    // Domain Payloads 
-    const payloadAddrsDomain = payloadIbGibsDomain ? payloadIbGibsDomain?.map(x => getIbGibAddr({ ibGib: x })) : undefined;
-    if (payloadAddrsDomain && payloadAddrsDomain.length > 0) {
-        data[SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN] = payloadAddrsDomain;
+        return contextIbGib;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
     }
+}
 
-    // rel8ns should always have saga frame, sometimes have keystone
-    const rel8ns: SyncSagaContextRel8ns_V1 = {
-        sagaFrame: [getIbGibAddr({ ibGib: sagaFrame })],
-    };
-    if (sessionKeystones && sessionKeystones.length > 0) {
-        rel8ns.sessionKeystone = sessionKeystones.map(x => getIbGibAddr({ ibGib: x }));
-    }
+/**
+ * move to sync-peer-helpers.mts as a pure function?
+ */
+export async function validateContext({ context }: { context: SyncSagaContextIbGib_V1 }): Promise<string[]> {
+    const lc = `[${validateContext.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: 7797f8294bd8f7e5089cb722ad468226)`); }
 
-    // Generate standard ib
-    const ib = await getSyncSagaContextIb({ data });
+        const errors: string[] = [];
 
-    const contextIbGib = await Factory_V1.stone<SyncSagaContextData_V1, SyncSagaContextRel8ns_V1>({
-        parentPrimitiveIb: SYNC_SAGA_CONTEXT_ATOM,
-        ib,
-        data,
-        rel8ns,
-    }) as SyncSagaContextIbGib_V1;
+        // validate just the context first. if this fails we return early.
+        const intrinsicErrors = await validateIbGibIntrinsically({ ibGib: context });
+        if (intrinsicErrors && intrinsicErrors.length > 0) {
+            intrinsicErrors.forEach(x => errors.push(x));
+            return errors; /* <<<< returns early */
+        }
 
-    // Attach actual ibgibs for transport 
-    if (payloadIbGibsDomain && payloadIbGibsDomain.length > 0) {
-        contextIbGib.payloadIbGibsDomain = payloadIbGibsDomain;
-    }
+        if (context.sagaFrame) {
 
-    return contextIbGib;
-}
+        } else {
+            errors.push(`context.sagaFrame is falsy. (E: b4edd88f4963f493789f83b29ba2df26)`);
+        }
+
+        // validate the entire context graph intrinsically, including saga frame, stones, identity(s) (if applicable but not authentication, that will be done in a separate step)
+
+
+
+        // ensure the non-dto properties on the context object (i.e. props
+        // that are not ib, gib, data, or rel8ns) match the data in the
+        // context object
+
+        throw new Error(`not implemented (E: cb639658e1183fa6c8a4ebca023ba926)`);
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}

package/src/sync/sync-saga-context/sync-saga-context-types.mts

@@ -43,6 +43,11 @@ export interface SyncSagaContextRel8ns_V1 extends IbGibRel8ns_V1 {
     /**
      * The Ephemeral Session Keystone Identity used for this saga.
      * Required for validating the saga frame signature.
+     * 
+     * ## notes
+     * 
+     * This will be different for the sender and receiver, yes? hmm...
+     * I think I need to put "sender" or "receiver" in the session keystone ib.
      */
     sessionKeystone?: IbGibAddr[];
 }