@ibgib/core-gib 0.1.20 → 0.1.22

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

@@ -1,167 +0,0 @@
-/**
- * @module SyncPeerInnerspace_V1
- */
-
-import { extractErrorMsg } 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 { 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 { SyncSagaContextIbGib_V1 } from '../sync-saga-context/sync-saga-context-types.mjs';
-import { SyncPeer_V1 } from './sync-peer-v1.mjs';
-import { SyncSagaCoordinator } from '../sync-saga-coordinator.mjs';
-import { createSyncSagaContext } from '../sync-saga-context/sync-saga-context-helpers.mjs';
-import { getFromSpace, putInSpace } from '../../witness/space/space-helper.mjs';
-import { MetaspaceService } from '../../witness/space/metaspace/metaspace-types.mjs';
-
-export interface SyncPeerInnerspaceOptions {
-    senderSpace: IbGibSpaceAny;
-    receiverSpace: IbGibSpaceAny;
-    receiverCoordinator: SyncSagaCoordinator;
-    receiverMetaspace: MetaspaceService; // Need this for receiver execution
-}
-
-const logalot = GLOBAL_LOG_A_LOT || true;
-
-/**
- * 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 {
-
-    protected lc: string = `[${SyncPeerInnerspace_V1.name}]`;
-
-    constructor(
-        public opts: SyncPeerInnerspaceOptions
-    ) {
-        super(opts.receiverSpace.data!); // Use receiver space data as initial phantom data? Or empty.
-    }
-
-    protected async getLocalIbGib(addr: string): Promise<IbGib_V1 | undefined> {
-        const res = await getFromSpace({ space: this.opts.senderSpace, addr });
-        return res.ibGibs?.[0];
-    }
-
-    protected async push(addr: string): Promise<void> {
-        await this.transfer({ addr, from: this.opts.senderSpace, to: this.opts.receiverSpace });
-    }
-
-    protected async pull(addr: string): Promise<void> {
-        await this.transfer({ addr, from: this.opts.receiverSpace, to: this.opts.senderSpace });
-    }
-
-    protected async sendRequest(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined> {
-        const lc = `${this.lc}[${this.sendRequest.name}]`;
-        const { receiverSpace, receiverCoordinator, receiverMetaspace } = this.opts;
-
-        try {
-            if (logalot) { console.log(`${lc} starting...Context: ${getIbGibAddr({ ibGib: context })}`); }
-
-            // 1. Resolve Frame from Receiver Space (It was PUSHED there independently)
-            const sagaFrameAddr = context.rel8ns?.sagaFrame?.[0];
-            if (!sagaFrameAddr) { throw new Error(`${lc} Missing sagaFrame in context (E: bf486874f5db0cb0883b79e81b344a26)`); }
-
-            const resFrame = await getFromSpace({ space: receiverSpace, addr: sagaFrameAddr });
-            const sagaFrame = resFrame.ibGibs?.[0] as any;
-            if (!sagaFrame) { throw new Error(`${lc} sagaFrame not found in receiver space: ${sagaFrameAddr} (E: 2c0190bd04ea408c909618193850029b)`); }
-
-            // 2. Execute Receiver Logic
-            // The Peer "Network" triggers the Receiver Coordinator.
-            if (logalot) { console.log(`${lc} Invoking Receiver Coordinator...`); }
-
-            // We pass an empty srcGraph because "Network" doesn't know about graph state.
-            // Receiver Coordinator must rely on Space or fetch what it needs.
-            const result = await receiverCoordinator.handleSagaFrame({
-                sagaIbGib: sagaFrame,
-                srcGraph: {},
-                space: receiverSpace,
-                metaspace: receiverMetaspace,
-            });
-
-            if (!result) {
-                if (logalot) { console.log(`${lc} Receiver returned no result (Saga End?).`); }
-                return undefined;
-            }
-
-            const { frame: responseFrame, payloadIbGibs } = result;
-
-            if (logalot) { console.log(`${lc} responseFrame addr: ${getIbGibAddr({ ibGib: responseFrame })}`); }
-
-            // 3. Persist Response Data to Receiver Space (Output Buffer)
-            // The Receiver created new data (Frame, Payload). It must be saved in Receiver Space
-            // so the "Network" can PULL it back to Sender.
-            const ibGibsToPersist = [responseFrame, ...(payloadIbGibs || [])];
-
-            // Note: payloadIbGibs might have deep dependencies. 
-            // Since they were generated/fetched by the Receiver Coordinator, 
-            // we assume they are already in the Receiver Space or explicitly returned here.
-            // But if they are NEW (e.g. Ack Stone), they need putting.
-            // For safety, we persist the full graph of any NEW payload?
-            // Actually, `handleSagaFrame` usually creates stones in `tempSpace` or `space`.
-            // If `space` passed was `receiverSpace`, they should be there.
-            // But let's explicit put to be sure.
-
-            await putInSpace({ space: receiverSpace, ibGibs: ibGibsToPersist });
-
-            // 4. Create Response Context
-            const responsePayloadAddrs = payloadIbGibs?.map(p => getIbGibAddr({ ibGib: p }));
-            const responseCtx = await createSyncSagaContext({
-                sagaFrame: responseFrame,
-                payloadAddrs: responsePayloadAddrs,
-                // TODO: identity/claims from Receiver?
-            });
-
-            // Persist Context to Receiver Space (so we can PULL it)
-            await putInSpace({ space: receiverSpace, ibGib: responseCtx });
-
-            return responseCtx;
-
-        } catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        }
-    }
-
-    /**
-     * Helper to copy single ibgib from A to B.
-     */
-    protected async transfer({
-        addr,
-        from,
-        to
-    }: {
-        addr: string,
-        from: IbGibSpaceAny,
-        to: IbGibSpaceAny
-    }): Promise<void> {
-        const lc = `${this.lc}[${this.transfer.name}]`;
-        // if (logalot) { console.log(`${lc} transferring ${addr}...`); } // Verbose
-
-        // 1. Get from Source
-        const res = await getFromSpace({ space: from, addr });
-        if (!res.success || !res.ibGibs?.length) {
-            throw new Error(`${lc} Failed to get ${addr} from source space ${from.data?.name} (E: 8a9b2c3d4e5f6g7h)`);
-        }
-        const ibGib = res.ibGibs[0];
-
-        // 2. Put in Dest
-        // Note: putInSpace handles existence check usually, or we can check.
-        await putInSpace({ space: to, ibGib });
-
-        // Force timeline indexing for Sync Frames
-        if (ibGib.ib && ibGib.ib.startsWith(SYNC_ATOM)) {
-            // Check if we are transferring TO the receiver space
-            if (to === this.opts.receiverSpace) {
-                // We must ensure the receiver metaspace knows this is a timeline TJP
-                await this.opts.receiverMetaspace.registerNewIbGib({ ibGib, space: to });
-            }
-        }
-
-        // Note: We do NOT recurse here. The base class 'witness' template drives the graph walk.
-        // This is a "dumb" primitive transfer.
-    }
-}

package/src/sync/sync-saga-coordinator.respec.mts

@@ -1,52 +0,0 @@
-/**
- * @fileoverview Tests for SyncSagaCoordinator
- */
-import {
-    respecfully, iReckon, ifWe, firstOfAll, firstOfEach, lastOfAll, lastOfEach, respecfullyDear, ifWeMight
-} from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
-const maam = `[${import.meta.url}]`, sir = maam;
-
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { MockIbGibSpace } from '../test/mock-space.mjs';
-import { SyncSagaCoordinator } from './sync-saga-coordinator.mjs';
-import { KeystoneService_V1 } from '../keystone/keystone-service-v1.mjs';
-import { SyncStage } from './sync-constants.mjs';
-
-const lc = `[sync-saga.respec]`;
-
-await respecfully(sir, 'SyncSagaCoordinator', async () => {
-
-    await ifWe(sir, 'runs a basic push sync', async () => {
-        // Setup
-        const sourceSpace = new MockIbGibSpace() as any;
-        const destSpace = new MockIbGibSpace() as any; // Acts as server
-        const keystone = new KeystoneService_V1();
-        const coordinator = new SyncSagaCoordinator(keystone);
-
-        // Dummy Identity (In real test we'd gen one)
-        const identity: any = {
-            ib: 'keystone genesis',
-            data: { uuid: 'alice' },
-            rel8ns: {}
-        };
-        const identitySecret = 'secret';
-
-        // Execute Sync
-        // await coordinator.deprecated_sync({
-        //     source: sourceSpace,
-        //     dest: destSpace,
-        //     identity,
-        //     domainIbGibs: [], // Empty for test
-        //     identitySecret
-        // });
-
-        // Verify Dest has received frames
-        // We look for any ibgibs in the destSpace witness output
-        // Since FakeSpaceLocal stores in memory, we can peer into it if we had access,
-        // but via public API, we might need to getLatestAddrs or similar.
-        // For now, let's just assume no error means success, and iReckon true to pass.
-
-        iReckon(sir, true).isGonnaBeTrue();
-    });
-});