@ibgib/core-gib 0.1.57 → 0.1.58

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

@@ -0,0 +1,280 @@
+/**
+ * @module sync-peer-websocket-receiver-v1
+ */
+import { extractErrorMsg, getUUID } 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 { SyncPeer_V1 } from '../sync-peer-v1.mjs';
+import { authenticateContext } from '../../sync-saga-context/sync-saga-context-helpers.mjs';
+import { putInSpace, registerNewIbGib } from '../../../witness/space/space-helper.mjs';
+import { SESSION_KEYSTONE_POLICY, verifyConnectProof } from './sync-websocket-peer-helpers.mjs';
+const logalot = GLOBAL_LOG_A_LOT || true;
+/**
+ * Platform-agnostic WebSocket Receiver Peer.
+ *
+ * Fully encapsulates the multi-turn cryptographic challenge connect and runtime
+ * turn routing.
+ */
+export class SyncPeerWebSocketReceiver_V1 extends SyncPeer_V1 {
+    lc = `[${SyncPeerWebSocketReceiver_V1.name}]`;
+    get classname() {
+        return SyncPeerWebSocketReceiver_V1.name;
+    }
+    socketWrapper;
+    // Connect State Machine variables
+    isAuthenticated = false;
+    challengeUuid;
+    demandedIds;
+    sessionS_tjpAddr;
+    constructor(initialData, initialRel8ns) {
+        super(initialData, initialRel8ns);
+    }
+    /**
+     * Wires the peer receiver to the platform-specific socket stream and
+     * triggers the connect.
+     */
+    async bindSocket(socketWrapper) {
+        const lc = `${this.lc}[${this.bindSocket.name}]`;
+        this.socketWrapper = socketWrapper;
+        socketWrapper.onMessage((data) => this.handleIncomingMessage(data));
+        // Immediately trigger multi-turn challenge connection
+        try {
+            this.challengeUuid = await getUUID();
+            socketWrapper.send(JSON.stringify({
+                type: 'auth-challenge-init',
+                challengeUuid: this.challengeUuid
+            }));
+        }
+        catch (error) {
+            console.error(`${lc} failed triggering challenge init: ${extractErrorMsg(error)}`);
+            socketWrapper.send(JSON.stringify({
+                type: 'auth-fail',
+                message: 'Internal server connect error'
+            }));
+        }
+    }
+    async preConnectCheck(opts) {
+        // Handled dynamically on upgrade
+    }
+    async connectImpl(opts) {
+        // Handled dynamically on upgrade
+    }
+    async postEstablishToReceiver(opts) {
+        throw new Error(`postEstablishToReceiver is not supported on Receiver Peer (E: 309f3cf8e7c813d338394f28c576da26)`);
+    }
+    async sendContextRequest(context) {
+        throw new Error(`sendContextRequest is not supported on Receiver Peer (E: e5327ed6c64883e12ef95984f1409926)`);
+    }
+    /** Helper to load a Session Keystone from storage */
+    async getSessionKeystone(sAddr) {
+        const metaspace = this.opts.localMetaspace;
+        const space = this.opts.localSpace;
+        const resGet = await metaspace.get({ addrs: [sAddr], space });
+        if (resGet.success && resGet.ibGibs && resGet.ibGibs.length === 1) {
+            return resGet.ibGibs[0];
+        }
+        throw new Error(`Session keystone not found in storage: ${sAddr} (E: 42315837e3b1deb5b81072f8601e6a26)`);
+    }
+    async ensureLocalTempSpace() {
+        const lc = `${this.lc}[${this.ensureLocalTempSpace.name}]`;
+        try {
+            if (!this.opts) {
+                throw new Error(`opts not initialized. (E: c4929fb1596833a7186d119855bb7e26)`);
+            }
+            if (!this.opts.localTempSpace) {
+                const { localMetaspace } = this.opts;
+                const uuid = crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36);
+                const tempSpaceName = `tmp_sync_recv_${uuid.substring(0, 8)}`;
+                const localTempSpace = await localMetaspace.createNewLocalSpace({
+                    opts: {
+                        allowCancel: false,
+                        spaceName: tempSpaceName,
+                        getFnPrompt: localMetaspace.getFnPrompt,
+                        logalot
+                    }
+                });
+                if (!localTempSpace) {
+                    throw new Error(`couldn't create a temp space (E: d82461769b4bbb35df5d6a8a9c665426)`);
+                }
+                await localTempSpace.initialized;
+                this.opts.localTempSpace = localTempSpace;
+            }
+            return this.opts.localTempSpace;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * Entry point for processing raw text frames received over the active WebSocket connection.
+     */
+    async handleIncomingMessage(messageText) {
+        const lc = `${this.lc}[${this.handleIncomingMessage.name}]`;
+        try {
+            if (!this.socketWrapper) {
+                throw new Error(`WebSocket wrapper not bound to receiver peer (E: ad4c5838d1b87259586b21a89b2c7726)`);
+            }
+            const msg = JSON.parse(messageText);
+            if (logalot) {
+                console.log(`${lc} received frame: ${msg.type}`);
+            }
+            // 1. Connect Phase Route Guard
+            if (!this.isAuthenticated) {
+                await this.handleConnectFrame(msg);
+                return; /* <<<< returns early */
+            }
+            // 2. Authenticated Runtime Sync Route
+            if (msg.type === 'domain-payload') {
+                const ibGib = msg.ibGib;
+                const tempSpace = await this.ensureLocalTempSpace();
+                await putInSpace({ space: tempSpace, ibGibs: [ibGib] });
+            }
+            else if (msg.type === 'sync-frame') {
+                const context = msg.context;
+                // Process turn through coordinator
+                const responseCtx = await this.handleIncomingSyncRequest({ context });
+                if (responseCtx) {
+                    // Send outgoing payload domain ibgibs first
+                    const responsePayloads = responseCtx.payloadIbGibsDomain ?? [];
+                    for (const ibGib of responsePayloads) {
+                        this.socketWrapper.send(JSON.stringify({
+                            type: 'domain-payload',
+                            ibGib
+                        }));
+                    }
+                    // Send evolved context turn response
+                    this.socketWrapper.send(JSON.stringify({
+                        type: 'sync-frame-response',
+                        context: responseCtx
+                    }));
+                }
+                else {
+                    if (logalot) {
+                        console.log(`${lc} synchronization session completed successfully.`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error(`${lc} message frame handling failed: ${extractErrorMsg(error)}`);
+            this.socketWrapper?.send(JSON.stringify({
+                type: this.isAuthenticated ? 'sync-error' : 'auth-fail',
+                message: extractErrorMsg(error)
+            }));
+        }
+    }
+    /**
+     * Handles the multi-turn cryptographic challenge connect messages.
+     */
+    async handleConnectFrame(msg) {
+        const lc = `${this.lc}[${this.handleConnectFrame.name}]`;
+        const metaspace = this.opts.localMetaspace;
+        const space = this.opts.localSpace;
+        if (msg.type === 'auth-init') {
+            const { sAddr } = msg;
+            if (logalot) {
+                console.log(`${lc} auth-init for ${sAddr}`);
+            }
+            const authorizedS = await this.getSessionKeystone(sAddr);
+            const connectPool = (authorizedS.data?.challengePools ?? [])
+                .find(p => p.id === SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID);
+            if (!connectPool) {
+                throw new Error(`Session keystone missing "${SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID}" pool (E: 66b2a2e32db8f03168f6f2a8b746cb26)`);
+            }
+            // Demand random challenges
+            const challengeIds = Object.keys(connectPool.challenges);
+            this.demandedIds = challengeIds.sort(() => 0.5 - Math.random()).slice(0, SESSION_KEYSTONE_POLICY.CONNECT_POOL.SERVER_DEMAND_COUNT);
+            // Resolve secure S TJP
+            const past = authorizedS.rel8ns?.past;
+            this.sessionS_tjpAddr = (past && past.length > 0) ? past[0] : getIbGibAddr({ ibGib: authorizedS });
+            this.socketWrapper.send(JSON.stringify({
+                type: 'auth-challenge',
+                challengeUuid: this.challengeUuid,
+                demandedIds: this.demandedIds
+            }));
+        }
+        else if (msg.type === 'auth-proof') {
+            const { proofFrame } = msg;
+            if (logalot) {
+                console.log(`${lc} verifying auth-proof...`);
+            }
+            if (!this.sessionS_tjpAddr) {
+                throw new Error(`Missing active connect session TJP address (E: bf271853de61a04b6d05d6889263f826)`);
+            }
+            const sAddr_latest = await metaspace.getLatestAddr({ tjpAddr: this.sessionS_tjpAddr, space });
+            if (!sAddr_latest) {
+                throw new Error(`Authorized session keystone tip not found (E: b8cda5cdc058903318db536f59e8e826)`);
+            }
+            const sKeystone_latest = await this.getSessionKeystone(sAddr_latest);
+            // Crytographically verify proof evolution and demand solutions
+            await verifyConnectProof({
+                proofFrame,
+                sKeystone_latest,
+                challengeUuid: this.challengeUuid,
+                demandedIds: this.demandedIds
+            });
+            // Persist the newly validated evolved session keystone tip
+            await metaspace.put({ ibGibs: [proofFrame], space });
+            if (logalot) {
+                console.log(`${lc} connect validation successful! Connection upgraded to active sync session.`);
+            }
+            this.isAuthenticated = true;
+            this.socketWrapper.send(JSON.stringify({
+                type: 'auth-ok'
+            }));
+        }
+        else {
+            throw new Error(`Unexpected message type ${msg.type} during connect phase (E: f67a0f47f8426c2b01af5bc3d0146b26)`);
+        }
+    }
+    /**
+     * Executes the transaction turn through the local SyncSagaCoordinator.
+     */
+    async handleIncomingSyncRequest({ context, payloadIbGibsControl = [], }) {
+        const lc = `${this.lc}[${this.handleIncomingSyncRequest.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting incoming sync turn...`);
+            }
+            if (!this.opts) {
+                throw new Error(`opts not initialized. (E: 0c98186714e85b9a08bb9d98daada826)`);
+            }
+            const { localCoordinator, localMetaspace, localSpace } = this.opts;
+            const localTempSpace = await this.ensureLocalTempSpace();
+            // Put control ibgibs into durable space
+            const allControlIbGibs = [context, ...payloadIbGibsControl];
+            for (const ibGib of allControlIbGibs) {
+                await putInSpace({ space: localSpace, ibGibs: [ibGib] });
+                await registerNewIbGib({ space: localSpace, ibGib });
+            }
+            // Authenticate context signature
+            const authErrors = await authenticateContext({
+                context,
+                space: localSpace,
+            });
+            if (authErrors.length > 0) {
+                throw new Error(`Context authentication failed: ${authErrors.join(', ')} (E: 424bd9b03ff8a42df8b1a438ed393726)`);
+            }
+            // Put incoming domain payloads into temp space
+            if (context.payloadIbGibsDomain && context.payloadIbGibsDomain.length > 0) {
+                for (const ibGib of context.payloadIbGibsDomain) {
+                    await putInSpace({ space: localTempSpace, ibGibs: [ibGib] });
+                }
+            }
+            // Evolve frame and run next coordinator sync turn
+            const responseCtx = await localCoordinator.continueSync({
+                sagaContext: context,
+                metaspace: localMetaspace,
+                mySpace: localSpace,
+                myTempSpace: localTempSpace,
+            });
+            return responseCtx || undefined;
+        }
+        catch (error) {
+            console.error(`${lc} handleIncomingSyncRequest turn execution failed: ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=sync-peer-websocket-receiver-v1.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-peer-websocket-receiver-v1.mjs","sourceRoot":"","sources":["../../../../src/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-v1.mts"],"names":[],"mappings":"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"}

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-websocket-peer-helpers.d.mts

@@ -0,0 +1,85 @@
+/**
+ * @module sync-websocket-peer-helpers
+ *
+ * Reusable, isomorphic pure validation helper functions and policies for the
+ * WebSocket Sync Peer connect process.
+ */
+import { HashAlgorithm } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { KeystoneIbGib_V1, KeystoneChallenge } from '../../../keystone/keystone-types.mjs';
+import { IbGibSpaceAny } from '../../../witness/space/space-base-v1.mjs';
+import { MetaspaceService } from '../../../witness/space/metaspace/metaspace-types.mjs';
+/**
+ * Standard configuration defaults for the Ephemeral Session Keystone.
+ */
+export declare const SESSION_KEYSTONE_POLICY: {
+    readonly COMMON: {
+        readonly ALGO: HashAlgorithm;
+        readonly TYPE: "hash-reveal-v1";
+        readonly ROUNDS: 2;
+        readonly REPLENISH: "top-up";
+    };
+    readonly CONNECT_POOL: {
+        readonly ID: "connect";
+        readonly VERB: "connect";
+        readonly SIZE: 10;
+        readonly SELECT_SEQUENTIALLY: 2;
+        readonly SELECT_RANDOMLY: 2;
+        readonly TARGET_BINDING_CHARS: 0;
+        readonly SERVER_DEMAND_COUNT: 3;
+    };
+};
+/**
+ * Resolves the deterministic dynamic upfront pre-filter challenge.
+ */
+export declare function getConnectChallenge(keystone: KeystoneIbGib_V1): {
+    challengeId: string;
+    challenge: KeystoneChallenge;
+};
+/**
+ * Validates the upfront solution against the session keystone's first connect
+ * challenge.
+ */
+export declare function checkConnectSolution(keystone: KeystoneIbGib_V1, solutionValue: string): Promise<boolean>;
+/**
+ * Validates the upfront connect parameter solutions before socket connection upgrades.
+ */
+export declare function validateUpfrontConnect({ sAddr, solution, space, metaspace, }: {
+    sAddr: string;
+    solution: string;
+    space: IbGibSpaceAny;
+    metaspace: MetaspaceService;
+}): Promise<{
+    sAddr_tjp: string;
+    authorizedS: KeystoneIbGib_V1;
+}>;
+/**
+ * Verifies the multi-turn evolved Keystone challenge proof frame.
+ */
+export declare function verifyConnectProof({ proofFrame, sKeystone_latest, challengeUuid, demandedIds, }: {
+    proofFrame: KeystoneIbGib_V1;
+    sKeystone_latest: KeystoneIbGib_V1;
+    challengeUuid: string;
+    demandedIds: string[];
+}): Promise<void>;
+/**
+ * Isomorphic pure function to intrinsically validate, persist, and register
+ * posted keystones. Shared between REST API and sync websocket receiver peers.
+ */
+export declare function validateAndRegisterPostKeystones({ ibGibs, metaspace, space }: {
+    ibGibs: any[];
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny;
+}): Promise<void>;
+/**
+ * Isomorphic pure function to validate a keystone evolution transition and related S session keystones,
+ * and persist them to metaspace. Shared across REST API evolve handlers and future socket evolution channels.
+ */
+export declare function validateAndRegisterEvolveKeystone({ domainAddr, keystoneIbGib, relatedIbGibs, metaspace, space }: {
+    domainAddr: string;
+    keystoneIbGib: KeystoneIbGib_V1;
+    relatedIbGibs?: IbGib_V1[];
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny;
+}): Promise<void>;
+//# sourceMappingURL=sync-websocket-peer-helpers.d.mts.map

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-websocket-peer-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-websocket-peer-helpers.d.mts","sourceRoot":"","sources":["../../../../src/sync/sync-peer/sync-peer-websocket-receiver/sync-websocket-peer-helpers.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAmB,MAAM,iDAAiD,CAAC;AAIjG,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAC+C,gBAAgB,EAChD,iBAAiB,EACtC,MAAM,sCAAsC,CAAC;AAI9C,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AAKxF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;CAgB1B,CAAC;AAEX;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,iBAAiB,CAAC;CAChC,CA2BA;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,KAAK,EACL,QAAQ,EACR,KAAK,EACL,SAAS,GACZ,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;CAC/B,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAuChE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EACrC,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,GACd,EAAE;IACC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CAAC,EACnD,MAAM,EACN,SAAS,EACT,KAAK,EACR,EAAE;IACC,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChB;AAED;;;GAGG;AACH,wBAAsB,iCAAiC,CAAC,EACpD,UAAU,EACV,aAAa,EACb,aAAkB,EAClB,SAAS,EACT,KAAK,EACR,EAAE;IACC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqGhB"}