@ibgib/core-gib 0.1.22 → 0.1.25

package/dist/sync/sync-peer/sync-peer-v1.d.mts

@@ -1,12 +1,15 @@
 /**
- * @module SyncPeer_V1 witness class
+ * @module SyncPeer_V1 witness class for base class plumbing of sync peers.
+ *
+ * You are expected to implement concrete peer classes for concrete architecture.
  */
 import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibAddr } from '@ibgib/ts-gib/dist/types.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 { InitializeSyncPeerOpts, 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';
 /**
  * Abstract witness for talking to a Sync Peer (e.g. Remote Node or Local Simulator).
  *
@@ -17,20 +20,48 @@ import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
  * 2. Send Request (RPC)
  * 3. Pull Response & Dependencies (Receiver -> Sender)
  */
-export declare abstract class SyncPeer_V1 extends LightWitnessBase_V1<SyncPeerData_V1, SyncPeerRel8ns_V1> implements SyncPeerWitness {
+export declare abstract class SyncPeer_V1<TInitializeOpts extends InitializeSyncPeerOpts = InitializeSyncPeerOpts> extends LightWitnessBase_V1<SyncPeerData_V1, SyncPeerRel8ns_V1> implements SyncPeerWitness<TInitializeOpts> {
     protected lc: string;
-    abstract payloadIbGibsDomainReceived$: SubjectWitness<IbGib_V1>;
+    opts: TInitializeOpts | undefined;
+    payloadIbGibsDomainReceived$: SubjectWitness<IbGib_V1>;
     get classname(): string;
     constructor(initialData: SyncPeerData_V1, initialRel8ns?: SyncPeerRel8ns_V1);
+    initialize(): Promise<void>;
+    /**
+     * base implementation just sets the opts property.
+     *
+     * override this in concrete classes for further initialization code
+     * specific to the sender.
+     *
+     * @see {@link SyncPeerWitness.opts}
+     */
+    initializeSender(opts: TInitializeOpts): Promise<void>;
+    setOptionalOpts(arg: Partial<TInitializeOpts>): void;
+    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.
      */
-    witness(arg: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
+    witness(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
     /**
-     * Transmits the Context IbGib itself to the Peer.
+     * This is responsible for:
+     *
+     * * sending outgoing {@link context}, the sync saga frame and msg stone(s),
+     *   and identities...
+     * * AND sending OUTGOING domain ibgibs
+     *   {@link SyncSagaContextIbGib_V1.payloadIbGibsDomain}
+     * * getting back the other end's resultant context ibgib, sync saga frame
+     *   and msg stone(s), and identities in their entirety...
+     * * AND stream/receiving the RESPONSE payload domain ibgibs, publishing
+     *   these to this.payloadIbGibsDomainReceived$.
+     *
+     * So this returns the RESPONSE context, possibly BEFORE the RESPONSE domain
+     * ibgibs have been completely received/streamed. The coordinator is responsible
      */
     protected abstract sendContextRequest(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
     /**
@@ -46,21 +77,23 @@ export declare abstract class SyncPeer_V1 extends LightWitnessBase_V1<SyncPeerDa
      */
     protected abstract pull(addrs: IbGibAddr[]): Promise<void>;
     /**
-     * Helper to orchestrate the PUSH of a Context's dependency graph.
+     * move to sync-peer-helpers.mts as a pure function?
      */
-    protected pushContextGraph({ context }: {
+    protected authenticateContext({ context }: {
         context: SyncSagaContextIbGib_V1;
-    }): Promise<void>;
+    }): Promise<string[]>;
     /**
-     * Helper to orchestrate the PULL of a Context's dependency graph.
+     * move to sync-peer-helpers.mts as a pure function?
      */
-    protected pullContextGraph({ context }: {
+    protected authorizeContext({ context }: {
         context: SyncSagaContextIbGib_V1;
-    }): Promise<void>;
+    }): Promise<string[]>;
     /**
      * 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 getLocalIbGib(addr: string): Promise<IbGib_V1 | undefined>;
 }
 //# sourceMappingURL=sync-peer-v1.d.mts.map

package/dist/sync/sync-peer/sync-peer-v1.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-peer-v1.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAI/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAMzD;;;;;;;;;GASG;AACH,8BAAsB,WAAY,SAAQ,mBAAmB,CAAC,eAAe,EAAE,iBAAiB,CAC5F,YAAW,eAAe;IAE1B,SAAS,CAAC,EAAE,EAAE,MAAM,CAA2B;IAE/C,QAAQ,CAAC,4BAA4B,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEhE,IAAI,SAAS,IAAI,MAAM,CAItB;gBAEW,WAAW,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,iBAAiB;IAG3E;;;;;OAKG;IACG,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IA+BzF;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAErH;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1D;;OAEG;cACa,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,uBAAuB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuElG;;OAEG;cACa,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,uBAAuB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DlG;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;CAChF"}
+{"version":3,"file":"sync-peer-v1.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKzD,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAStE;;;;;;;;;GASG;AACH,8BAAsB,WAAW,CAAC,eAAe,SAAS,sBAAsB,GAAG,sBAAsB,CACrG,SAAQ,mBAAmB,CAAC,eAAe,EAAE,iBAAiB,CAC9D,YAAW,eAAe,CAAC,eAAe,CAAC;IAE3C,SAAS,CAAC,EAAE,EAAE,MAAM,CAA2B;IAExC,IAAI,EAAE,eAAe,GAAG,SAAS,CAAC;IAClC,4BAA4B,EAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE/D,IAAI,SAAS,IAAI,MAAM,CAItB;gBAEW,WAAW,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,iBAAiB;IAI9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;;;OAOG;IACU,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAoC3D,SAAS,CAAC,QAAQ,CAAC,uBAAuB,IAAI,OAAO,CAAC,aAAa,CAAC;IAEpE;;;;;;;;OAQG;IACY,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAwFtG;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAErH;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;cACa,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,uBAAuB,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBzG;;OAEG;cACa,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,uBAAuB,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBtG;;;;;OAKG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;CAuB7E"}

package/dist/sync/sync-peer/sync-peer-v1.mjs

@@ -1,11 +1,14 @@
 /**
- * @module SyncPeer_V1 witness class
+ * @module SyncPeer_V1 witness class for base class plumbing of sync peers.
+ *
+ * You are expected to implement concrete peer classes for concrete architecture.
  */
 import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/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 { LightWitnessBase_V1 } from '../../witness/light-witness-base-v1.mjs';
+import { newupSubject } from '../../common/pubsub/subject/subject-helper.mjs';
+import { validateContextAndSagaFrame } 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;
 const lcControlDomain = '[ControlDomain]';
@@ -21,6 +24,8 @@ const lcControlDomain = '[ControlDomain]';
  */
 export class SyncPeer_V1 extends LightWitnessBase_V1 {
     lc = `[${SyncPeer_V1.name}]`;
+    opts;
+    payloadIbGibsDomainReceived$;
     get classname() {
         if (!this.data) {
             throw new Error(`(UNEXPECTED) this.data falsy? (E: 1ab1841e9338b54f3aa615fa37024826)`);
@@ -33,33 +38,143 @@ export class SyncPeer_V1 extends LightWitnessBase_V1 {
     constructor(initialData, initialRel8ns) {
         super(initialData, initialRel8ns);
     }
+    async initialize() {
+        this.payloadIbGibsDomainReceived$ = await newupSubject();
+    }
+    /**
+     * base implementation just sets the opts property.
+     *
+     * override this in concrete classes for further initialization code
+     * specific to the sender.
+     *
+     * @see {@link SyncPeerWitness.opts}
+     */
+    async initializeSender(opts) {
+        const lc = `${this.lc}[${this.initializeSender.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 31bd5fda37c89fa37fbaf14daf5fe726)`);
+            }
+            this.opts = opts;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    setOptionalOpts(arg) {
+        const lc = `${this.lc}[${this.setOptionalOpts.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: ae5ddbd3577db267f84743175a736626)`);
+            }
+            if (!this.opts) {
+                throw new Error(`(UNEXPECTED) this.opts falsy? (E: 0dd4d6080a6e2f31d86cf4d86e11b826)`);
+            }
+            if (logalot) {
+                console.log(`${lc} updating opts. arg keys: ${Object.keys(arg)} (I: 452d78a558f8fc3468c8e2e68c70b226)`);
+            }
+            this.opts = { ...this.opts, ...arg };
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
     /**
      * 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) {
+    async witness(context) {
         const lc = `${this.lc}[${this.witness.name}]`;
         try {
             if (logalot) {
                 console.log(`${lc} starting...`);
             }
-            if (logalot) {
-                console.log(`${lc} starting...`);
+            if (!this.opts) {
+                throw new Error(`(UNEXPECTED) this.opts falsy? Concrete class should have initialized sender opts by now. (E: 0b9e28287318fdf8bf9f5a6886a24826)`);
+            }
+            // NOTE: There are two basic types of peers:
+            // * local-only (peer)
+            //   * this peer is both sender/receiver peer
+            //   * for local merges and relatively fast spaces
+            // * proxy to remote space
+            //   * this peer is both sender/receiver peer
+            //   * works directly with remote/outerspaces
+            //   * Less efficient over-the-wire xfer due to chatiness
+            // * symmetric node sender/receiver peers
+            //   * separate sender/receiver classes
+            //     * e.g., SyncPeerClient[Substrate]Sender_V1,
+            //       SyncPeerClient[Substrate]Receiver_V1
+            //   * More efficient over-the-wire xfer
+            //   * Most difficult to mentally model
+            //   * sender.witness does the pushing out
+            //     * what the sender/initiator's coordinator has a reference to
+            //   * receiver.witness does the coming in
+            //     * lives on a server/remote instance with its own coordinator
+            //       instance
+            //     * must do its own validation/authn/authz for possible MITM
+            //       issues
+            // The following is a sketch where some of these may be blurred
+            // 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)
+            // validate, authenticate, and authorize the context, sagaFrame, and identity(s)
+            const validationErrors = await validateContextAndSagaFrame({ context });
+            if (validationErrors.length > 0) {
+                throw new Error(`invalid context received. validationErrors: ${validationErrors} (E: 8b34c875c968af29bc433138e57a7826)`);
             }
-            // 1. PUSH: Ensure Request Data is available on Receiver
-            await this.pushContextGraph({ context: arg });
+            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
             // 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;
             }
-            // 3. PULL: Ensure Response Data is available on Sender (Local)
-            await this.pullContextGraph({ context: response });
+            // at this point, all outgoing payload domain ibgibs have been sent.
+            // we have received the response context, wherein the sync saga
+            // frame/msg stone(s) and any keystones should be evolved. Depending
+            // on the concrete implementation, if there are domain ibgibs to
+            // receive, they may still be transferring. These will be published
+            // to this.payloadIbGibsDomainReceived$
             return response;
         }
         catch (error) {
@@ -73,153 +188,82 @@ export class SyncPeer_V1 extends LightWitnessBase_V1 {
         }
     }
     /**
-     * Helper to orchestrate the PUSH of a Context's dependency graph.
+     * move to sync-peer-helpers.mts as a pure function?
      */
-    async pushContextGraph({ context }) {
-        const lc = `[${SyncPeer_V1.name}][pushContextGraph]`;
-        // A. Push Context Envelope
-        const contextAddr = getIbGibAddr({ ibGib: context });
-        if (logalotControlDomain) {
-            console.log(`${lc}${lcControlDomain} PUSH Context Envelope -> ${contextAddr} (I: 3f4e5a6b7c8d9e0f)`);
-        }
-        await this.push([contextAddr]);
-        // B. Push Saga Frame & Immediate Deps (Msg, Identity)
-        const frameAddr = context.rel8ns?.sagaFrame?.[0];
-        if (frameAddr) {
-            if (logalotControlDomain) {
-                console.log(`${lc}${lcControlDomain} PUSH CONTROL: Saga Frame -> ${frameAddr} (I: 4a5b6c7d8e9f0a1b)`);
-            }
-            await this.push([frameAddr]);
-            // We inspect the local frame to find its immediate deps
-            const frame = await this.getLocalIbGib(frameAddr);
-            if (frame) {
-                // Msg Stone
-                const msgAddrs = frame.rel8ns?.[SYNC_MSG_REL8N_NAME];
-                if (msgAddrs) {
-                    for (const addr of msgAddrs) {
-                        if (logalotControlDomain) {
-                            console.log(`${lc}${lcControlDomain} PUSH CONTROL: Msg Stone -> ${addr} (I: 5b6c7d8e9f0a1b2c)`);
-                        }
-                        await this.push([addr]);
-                    }
-                }
-                // Identity
-                const idAddrs = frame.rel8ns?.identity;
-                if (idAddrs) {
-                    for (const addr of idAddrs) {
-                        if (logalotControlDomain) {
-                            console.log(`${lc}${lcControlDomain} PUSH CONTROL: Identity -> ${addr} (I: 6c7d8e9f0a1b2c3d)`);
-                        }
-                        await this.push([addr]);
-                    }
-                }
+    async authenticateContext({ context }) {
+        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 [];
         }
-        // C. Push Session Identity
-        const sessionKeystoneAddr = context.rel8ns?.sessionKeystone?.[0];
-        if (sessionKeystoneAddr) {
-            if (logalotControlDomain) {
-                console.log(`${lc}${lcControlDomain} PUSH CONTROL: Session Keystone -> ${sessionKeystoneAddr} (I: 7d8e9f0a1b2c3d4e)`);
-            }
-            await this.push([sessionKeystoneAddr]);
-        }
-        // D. Push Payloads (Deep/Soft)
-        // For payloads, the Peer is just a transport. It doesn't know the structure.
-        // It relies on "push" handling the "deep" transfer if needed, or we explicitly iterate if we had a graph.
-        // But since we are "Witnessing", we usually assume "push(addr)" acts like "copy(addr, recursive=true)"?
-        // Or do we need to be explicit?
-        // User said: "payloads should be flat... sync coordinator is the one doing the heavy lifting".
-        // So we just push the addrs listed.
-        // 1. Control Payloads
-        // const controlAddrs = context.data?.[SYNC_SAGA_PAYLOAD_ADDRS_CONTROL];
-        // if (controlAddrs && controlAddrs.length > 0) {
-        //     if (logalotControlDomain) { console.log(`${lc}${lcControlDomain} PUSH CONTROL PAYLOADS (${controlAddrs.length}): ${controlAddrs.join(', ')} (I: 8e9f0a1b2c3d4e5f)`); }
-        //     for (const addr of controlAddrs) {
-        //         await this.push(addr);
-        //     }
-        // }
-        // 2. Domain Payloads
-        const domainAddrs = context.data?.[SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN];
-        if (domainAddrs && domainAddrs.length > 0) {
-            if (logalotControlDomain) {
-                console.log(`${lc}${lcControlDomain} PUSH DOMAIN PAYLOADS (${domainAddrs.length}): ${domainAddrs.join(', ')} (I: 9f0a1b2c3d4e5f6a)`);
-            }
-            for (const addr of domainAddrs) {
-                await this.push([addr]);
-            }
-        }
-        if (logalotControlDomain) {
-            console.log(`${lc}${lcControlDomain} PUSH COMPLETE for context ${contextAddr} (I: a0b1c2d3e4f5a6b7)`);
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
         }
     }
     /**
-     * Helper to orchestrate the PULL of a Context's dependency graph.
+     * move to sync-peer-helpers.mts as a pure function?
      */
-    async pullContextGraph({ context }) {
-        const lc = `[${SyncPeer_V1.name}][pullContextGraph]`;
-        // A. Pull Context Envelope
-        const contextAddr = getIbGibAddr({ ibGib: context });
-        if (logalotControlDomain) {
-            console.log(`${lc}${lcControlDomain} PULL Context Envelope <- ${contextAddr} (I: b1c2d3e4f5a6b7c8)`);
-        }
-        await this.pull([contextAddr]);
-        // B. Pull Saga Frame & Immediate Deps
-        const frameAddr = context.rel8ns?.sagaFrame?.[0];
-        if (frameAddr) {
-            if (logalotControlDomain) {
-                console.log(`${lc}${lcControlDomain} PULL CONTROL: Saga Frame <- ${frameAddr} (I: c2d3e4f5a6b7c8d9)`);
-            }
-            await this.pull([frameAddr]);
-            // Inspect REMOTE frame? We need to have pulled it first.
-            const frame = await this.getLocalIbGib(frameAddr); // Should be local now
-            if (frame) {
-                const msgAddrs = frame.rel8ns?.[SYNC_MSG_REL8N_NAME];
-                if (msgAddrs) {
-                    for (const addr of msgAddrs) {
-                        if (logalotControlDomain) {
-                            console.log(`${lc}${lcControlDomain} PULL CONTROL: Msg Stone <- ${addr} (I: d3e4f5a6b7c8d9e0)`);
-                        }
-                        await this.pull([addr]);
-                    }
-                }
-                const idAddrs = frame.rel8ns?.identity;
-                if (idAddrs) {
-                    for (const addr of idAddrs) {
-                        if (logalotControlDomain) {
-                            console.log(`${lc}${lcControlDomain} PULL CONTROL: Identity <- ${addr} (I: e4f5a6b7c8d9e0f1)`);
-                        }
-                        await this.pull([addr]);
-                    }
-                }
+    async authorizeContext({ context }) {
+        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 [];
         }
-        // C. Pull Session Identity
-        const sessionKeystoneAddr = context.rel8ns?.sessionKeystone?.[0];
-        if (sessionKeystoneAddr) {
-            if (logalotControlDomain) {
-                console.log(`${lc}${lcControlDomain} PULL CONTROL: Session Keystone <- ${sessionKeystoneAddr} (I: f5a6b7c8d9e0f1a2)`);
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
             }
-            await this.pull([sessionKeystoneAddr]);
         }
-        // D. Pull Payloads
-        // const controlAddrs = context.data?.[SYNC_SAGA_PAYLOAD_ADDRS_CONTROL];
-        // if (controlAddrs && controlAddrs.length > 0) {
-        //     if (logalotControlDomain) { console.log(`${lc}${lcControlDomain} PULL CONTROL PAYLOADS (${controlAddrs.length}): ${controlAddrs.join(', ')} (I: a6b7c8d9e0f1a2b3)`); }
-        //     for (const addr of controlAddrs) {
-        //         await this.pull(addr);
-        //     }
-        // }
-        const domainAddrs = context.data?.[SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN];
-        if (domainAddrs && domainAddrs.length > 0) {
-            if (logalotControlDomain) {
-                console.log(`${lc}${lcControlDomain} PULL DOMAIN PAYLOADS (${domainAddrs.length}): ${domainAddrs.join(', ')} (I: b7c8d9e0f1a2b3c4)`);
+    }
+    /**
+     * 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
+     */
+    async getLocalIbGib(addr) {
+        const lc = `${this.lc}[${this.getLocalIbGib.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 27b248cb9801eeb2386b71485389a826)`);
             }
-            for (const addr of domainAddrs) {
-                await this.pull([addr]);
+            console.warn(`${lc} possibly a bottleneck here, getLocalIbGib only gets a single ibgib... (W: 2fd448a435480e6b128f6b8bcbef4826)`);
+            if (!this.opts) {
+                throw new Error(`(UNEXPECTED) this.opts falsy? (E: cfb9431f2fb851f24a6c88e80c3b3326)`);
             }
+            const resGet = await getFromSpace({ space: this.opts.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.opts.senderSpace}. reason: ${resGet.errorMsg ?? 'unknown error (E: 926ef8bf4fcc299ab89dba34ea691a26)'} (E: d8a89807e471d3f8b938ab21df44cb26)`);
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
         }
-        if (logalotControlDomain) {
-            console.log(`${lc}${lcControlDomain} PULL COMPLETE for context ${contextAddr} (I: c8d9e0f1a2b3c4d5)`);
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
         }
     }
 }

package/dist/sync/sync-peer/sync-peer-v1.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sync-peer-v1.mjs","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAG9E,MAAM,OAAO,GAAG,gBAAgB,IAAI,IAAI,CAAC;AACzC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,OAAgB,WAAY,SAAQ,mBAAuD;IAGnF,EAAE,GAAW,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC;IAI/C,IAAI,SAAS;QACT,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAAC,CAAC;QAC3G,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAAC,CAAC;QAClI,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,YAAY,WAA4B,EAAE,aAAiC;QACvE,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACtC,CAAC;IACD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,GAA4B;QACtC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;QAC9C,IAAI,CAAC;YACD,IAAI,OAAO,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAC,CAAC;YAElD,IAAI,OAAO,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAC,CAAC;YAElD,wDAAwD;YACxD,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAE9C,wCAAwC;YACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAEpD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,IAAI,OAAO,EAAE,CAAC;oBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;gBAAC,CAAC;gBAC7D,OAAO,SAAS,CAAC;YACrB,CAAC;YAED,+DAA+D;YAC/D,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAEnD,OAAO,QAAQ,CAAC;QAEpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,IAAI,OAAO,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAqBD;;OAEG;IACO,KAAK,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAwC;QAC9E,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,IAAI,qBAAqB,CAAC;QAErD,2BAA2B;QAC3B,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACrD,IAAI,oBAAoB,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,6BAA6B,WAAW,wBAAwB,CAAC,CAAC;QAAC,CAAC;QACnI,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAE/B,sDAAsD;QACtD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,oBAAoB,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,gCAAgC,SAAS,wBAAwB,CAAC,CAAC;YAAC,CAAC;YACpI,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7B,wDAAwD;YACxD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,KAAK,EAAE,CAAC;gBACR,YAAY;gBACZ,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,mBAAmB,CAAC,CAAC;gBACrD,IAAI,QAAQ,EAAE,CAAC;oBACX,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;wBAC1B,IAAI,oBAAoB,EAAE,CAAC;4BAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,+BAA+B,IAAI,wBAAwB,CAAC,CAAC;wBAAC,CAAC;wBAC9H,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC5B,CAAC;gBACL,CAAC;gBACD,WAAW;gBACX,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;gBACvC,IAAI,OAAO,EAAE,CAAC;oBACV,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;wBACzB,IAAI,oBAAoB,EAAE,CAAC;4BAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,8BAA8B,IAAI,wBAAwB,CAAC,CAAC;wBAAC,CAAC;wBAC7H,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC5B,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,2BAA2B;QAC3B,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,mBAAmB,EAAE,CAAC;YACtB,IAAI,oBAAoB,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,sCAAsC,mBAAmB,wBAAwB,CAAC,CAAC;YAAC,CAAC;YACpJ,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,+BAA+B;QAC/B,6EAA6E;QAC7E,0GAA0G;QAC1G,wGAAwG;QACxG,gCAAgC;QAChC,+FAA+F;QAC/F,oCAAoC;QAEpC,sBAAsB;QACtB,wEAAwE;QACxE,iDAAiD;QACjD,6KAA6K;QAC7K,yCAAyC;QACzC,iCAAiC;QACjC,QAAQ;QACR,IAAI;QAEJ,qBAAqB;QACrB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,8BAA8B,CAAC,CAAC;QACnE,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,oBAAoB,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,0BAA0B,WAAW,CAAC,MAAM,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAAC,CAAC;YACnK,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;QACL,CAAC;QAED,IAAI,oBAAoB,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,8BAA8B,WAAW,wBAAwB,CAAC,CAAC;QAAC,CAAC;IACxI,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAwC;QAC9E,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,IAAI,qBAAqB,CAAC;QAErD,2BAA2B;QAC3B,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACrD,IAAI,oBAAoB,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,6BAA6B,WAAW,wBAAwB,CAAC,CAAC;QAAC,CAAC;QACnI,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAE/B,sCAAsC;QACtC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,oBAAoB,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,gCAAgC,SAAS,wBAAwB,CAAC,CAAC;YAAC,CAAC;YACpI,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7B,yDAAyD;YACzD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB;YACzE,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,mBAAmB,CAAC,CAAC;gBACrD,IAAI,QAAQ,EAAE,CAAC;oBACX,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;wBAC1B,IAAI,oBAAoB,EAAE,CAAC;4BAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,+BAA+B,IAAI,wBAAwB,CAAC,CAAC;wBAAC,CAAC;wBAC9H,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC5B,CAAC;gBACL,CAAC;gBACD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;gBACvC,IAAI,OAAO,EAAE,CAAC;oBACV,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;wBACzB,IAAI,oBAAoB,EAAE,CAAC;4BAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,8BAA8B,IAAI,wBAAwB,CAAC,CAAC;wBAAC,CAAC;wBAC7H,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC5B,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,2BAA2B;QAC3B,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,mBAAmB,EAAE,CAAC;YACtB,IAAI,oBAAoB,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,sCAAsC,mBAAmB,wBAAwB,CAAC,CAAC;YAAC,CAAC;YACpJ,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,mBAAmB;QACnB,wEAAwE;QACxE,iDAAiD;QACjD,6KAA6K;QAC7K,yCAAyC;QACzC,iCAAiC;QACjC,QAAQ;QACR,IAAI;QACJ,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,8BAA8B,CAAC,CAAC;QACnE,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,oBAAoB,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,0BAA0B,WAAW,CAAC,MAAM,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAAC,CAAC;YACnK,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;QACL,CAAC;QAED,IAAI,oBAAoB,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,eAAe,8BAA8B,WAAW,wBAAwB,CAAC,CAAC;QAAC,CAAC;IACxI,CAAC;CAOJ"}
+{"version":3,"file":"sync-peer-v1.mjs","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"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"}

package/dist/sync/sync-saga-context/sync-saga-context-helpers.d.mts

@@ -4,6 +4,8 @@
 import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
 import { Ib } from '@ibgib/ts-gib/dist/types.mjs';
 import { SyncSagaContextData_V1, SyncSagaContextIbGib_V1, SyncSagaContextIb_V1 } from './sync-saga-context-types.mjs';
+import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
+import { SyncIbGib_V1 } from '../sync-types.mjs';
 /**
  * Options for creating a SyncSagaContext ibgib.
  */
@@ -11,7 +13,7 @@ export interface CreateSyncSagaContextOptions {
     /**
      * The main saga frame (Init, Ack, etc.).
      */
-    sagaFrame: IbGib_V1;
+    sagaFrame: SyncIbGib_V1;
     /**
      * Session identity keystones.
      */
@@ -21,6 +23,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;
 }
 /**
  * Constructs the standard 'ib' string for a Sync Saga Context stone.
@@ -35,9 +42,38 @@ export declare function parseSyncSagaContextIb({ ib, }: {
     ib: Ib;
 }): Promise<SyncSagaContextIb_V1>;
 /**
- * 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 declare function createSyncSagaContext({ sagaFrame, sessionKeystones, payloadIbGibsDomain, localSpace, }: CreateSyncSagaContextOptions): Promise<SyncSagaContextIbGib_V1>;
+/**
+ * Validates ONLY the {@link context} ibgib itself and saga frame/msg stone(s)
+ * ({@link SyncSagaContextIbGib_V1.sagaFrame}).
+ *
+ * Does NOT...
+ * * validate keystones (authn or authz)
+ * * validate domain payload ibgibs...
+ *   * intrinsically
+ *   * in relation to this context (addrs match up)
+ *
+ * @returns empty array if valid, else validation errors
+ */
+export declare function validateContextAndSagaFrame({ context }: {
+    context: SyncSagaContextIbGib_V1;
+}): Promise<string[]>;
+/**
+ * validates the payload ibgibs ({@link SyncSagaContextIbGib_V1.payloadIbGibsDomain}) intrinsically
+ *
+ * @returns empty array if valid, else validation errors
  */
-export declare function createSyncSagaContext({ sagaFrame, sessionKeystones, payloadIbGibsDomain, }: CreateSyncSagaContextOptions): Promise<SyncSagaContextIbGib_V1>;
+export declare function validateContextDomainPayloadIbGibs({ context }: {
+    context: SyncSagaContextIbGib_V1;
+}): Promise<string[]>;
 //# sourceMappingURL=sync-saga-context-helpers.d.mts.map

package/dist/sync/sync-saga-context/sync-saga-context-helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-saga-context-helpers.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-saga-context/sync-saga-context-helpers.mts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,QAAQ,EAAG,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAC;AAIlD,OAAO,EACH,sBAAsB,EAAE,uBAAuB,EAC/C,oBAAoB,EACvB,MAAM,+BAA+B,CAAC;AAGvC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IACzC;;OAEG;IACH,SAAS,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,EACvC,IAAI,GACP,EAAE;IACC,IAAI,EAAE,sBAAsB,CAAC;CAChC,GAAG,OAAO,CAAC,EAAE,CAAC,CAiBd;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,EAAE,GACL,EAAE;IACC,EAAE,EAAE,EAAE,CAAC;CACV,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2BhC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GACtB,EAAE,4BAA4B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAyCjE"}
+{"version":3,"file":"sync-saga-context-helpers.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-saga-context/sync-saga-context-helpers.mts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,QAAQ,EAAG,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAC;AAMlD,OAAO,EACH,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,EAExE,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IACzC;;OAEG;IACH,SAAS,EAAE,YAAY,CAAC;IACxB;;OAEG;IACH,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC;IACjC;;;OAGG;IACH,UAAU,EAAE,aAAa,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,EACvC,IAAI,GACP,EAAE;IACC,IAAI,EAAE,sBAAsB,CAAC;CAChC,GAAG,OAAO,CAAC,EAAE,CAAC,CAiBd;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,EAAE,GACL,EAAE;IACC,EAAE,EAAE,EAAE,CAAC;CACV,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2BhC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,GACb,EAAE,4BAA4B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA8DjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,2BAA2B,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,uBAAuB,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmCtH;AAGD;;;;GAIG;AACH,wBAAsB,kCAAkC,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,uBAAuB,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY7H"}