@ibgib/core-gib 0.1.58 → 0.1.60

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

@@ -1,321 +0,0 @@
-/**
- * @module sync-peer-websocket-sender-v1
- */
-
-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 { KeystoneIbGib_V1 } from '../../../keystone/keystone-types.mjs';
-import { KeystoneService_V1 } from '../../../keystone/keystone-service-v1.mjs';
-import { KeystoneStrategyFactory } from '../../../keystone/strategy/keystone-strategy-factory.mjs';
-import { deriveSessionSecret } from '../../sync-helpers.mjs';
-import { SyncPeer_V1 } from '../sync-peer-v1.mjs';
-import { SyncSagaContextIbGib_V1 } from '../../sync-saga-context/sync-saga-context-types.mjs';
-import { GLOBAL_LOG_A_LOT } from '../../../core-constants.mjs';
-import {
-    ConnectSyncPeerWebSocketSenderOpts,
-    InitializeSyncPeerWebSocketSenderOpts,
-    SyncPeerWebSocketSenderData_V1,
-    SyncPeerWebSocketSenderRel8ns_V1,
-    SyncPeerWebSocketSenderIbGib_V1
-} from './sync-peer-websocket-sender-types.mjs';
-import {
-    SESSION_KEYSTONE_POLICY,
-    getConnectChallenge
-} from '../sync-peer-websocket-receiver/sync-websocket-peer-helpers.mjs';
-
-const logalot = GLOBAL_LOG_A_LOT || true;
-
-/**
- * WebSocket Sender Peer implementation running in browser/native environment.
- */
-export class SyncPeerWebSocketSender_V1
-    extends SyncPeer_V1<ConnectSyncPeerWebSocketSenderOpts, InitializeSyncPeerWebSocketSenderOpts>
-    implements SyncPeerWebSocketSenderIbGib_V1 {
-
-    protected override lc: string = `[${SyncPeerWebSocketSender_V1.name}]`;
-
-    override get classname(): string {
-        return SyncPeerWebSocketSender_V1.name;
-    }
-
-    public get isSocketOpen(): boolean {
-        return this.ws !== undefined && this.ws.readyState === WebSocket.OPEN;
-    }
-
-    declare data: SyncPeerWebSocketSenderData_V1 | undefined;
-    declare rel8ns: SyncPeerWebSocketSenderRel8ns_V1 | undefined;
-
-    protected ws?: WebSocket;
-    protected activeResolve?: (value: SyncSagaContextIbGib_V1 | undefined) => void;
-    protected activeReject?: (reason: any) => void;
-
-    constructor(
-        initialData: SyncPeerWebSocketSenderData_V1,
-        initialRel8ns?: SyncPeerWebSocketSenderRel8ns_V1,
-    ) {
-        super(initialData, initialRel8ns);
-    }
-
-    protected override async preConnectCheck(opts: ConnectSyncPeerWebSocketSenderOpts): Promise<void> {
-        const lc = `${this.lc}[${this.preConnectCheck.name}]`;
-        if (!this.data?.wsUrl) {
-            throw new Error(`Missing wsUrl in peer data (E: a3b2c1d0e9f8e7d6c5b4a3f2e1d0c910)`);
-        }
-        if (!this.data?.httpEvolveUrl) {
-            throw new Error(`Missing httpEvolveUrl in peer data (E: a3b2c1d0e9f8e7d6c5b4a3f2e1d0c911)`);
-        }
-    }
-
-    /**
-     * Submits the evolved master identity (I1) and new session keystone (S) to the server's HTTP registry.
-     */
-    protected override async postEstablishToReceiver({
-        newSenderIdentity,
-        sessionIdentity,
-    }: {
-        newSenderIdentity: KeystoneIbGib_V1;
-        sessionIdentity: KeystoneIbGib_V1;
-    }): Promise<void> {
-        const lc = `${this.lc}[${this.postEstablishToReceiver.name}]`;
-        try {
-            if (logalot) { console.log(`${lc} posting evolved keystones to ${this.data!.httpEvolveUrl}...`); }
-            if (!this.data) { throw new Error(`(UNEXPECTED) this.data falsy? (E: d642e8a9af18b532c87c6f581aa53b26)`); }
-
-            if (!this.data.httpEvolveUrl) { throw new Error(`(UNEXPECTED) this.data.httpEvolveUrl falsy? (E: 8589ddbb155914d85c09658881da2c26)`); }
-
-            const response = await fetch(this.data.httpEvolveUrl, {
-                method: 'PUT',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({
-                    keystoneIbGib: newSenderIdentity,
-                    relatedIbGibs: [sessionIdentity]
-                }),
-            });
-
-            if (!response.ok) {
-                const data = await response.json().catch(() => ({}));
-                const errorMsg = data.message || data.error || 'Unknown error';
-                throw new Error(`HTTP ${response.status} evolution post rejected. errorMsg: ${errorMsg} (E: e8a478291b88d05c68cf6b385684b826)`);
-            }
-
-            if (logalot) { console.log(`${lc} evolve post accepted by server.`); }
-        } catch (error) {
-            console.error(`${lc} establish post failed: ${extractErrorMsg(error)}`);
-            throw error;
-        }
-    }
-
-    /**
-     * Establishes the stateful WebSocket connection and performs the multi-turn cryptographic challenge connect.
-     */
-    protected override async connectImpl(opts: ConnectSyncPeerWebSocketSenderOpts): Promise<void> {
-        const lc = `${this.lc}[${this.connectImpl.name}]`;
-        try {
-            if (logalot) { console.log(`${lc} starting...`); }
-
-            const { senderIdentity, fnSenderSecret, sagaId, localMetaspace, localSpace } = this.opts!;
-            if (!senderIdentity || !fnSenderSecret || !sagaId) {
-                throw new Error(`Missing identity parameters in peer options (E: ed49b6711ac82efcdb42b8a28c5b6826)`);
-            }
-
-            // 1. Solve upfront pre-filter solution
-            const senderSecret = await fnSenderSecret();
-            const sessionSecret = await deriveSessionSecret({ senderSecret, sagaId });
-
-            // Fetch session identity S that establishSessionIdentity just created
-            const sAddr_tjp = getIbGibAddr({ ibGib: senderIdentity }); // wait, S's past contains I
-            // Actually, we can get the S keystone that was returned by establishSessionIdentity.
-            // Let's resolve S from the sender localSpace using its target claim or the targetAddrs
-            const sAddr = getIbGibAddr({ ibGib: senderIdentity.rel8ns?.past ? senderIdentity : senderIdentity }); // stub: get the actual generated S
-
-            // To make sure we have the exact session identity S, we can query localSpace.
-            // Since we know the sagaId, we can walk or locate it.
-            // But wait, the coordinator calls establishSessionIdentity first, which returns the created S keystone!
-            // Let's store a reference to the sessionIdentity S on this class during establish, or lookup from localSpace.
-            // Wait, does the coordinator let the peer store S? No, but let's query the latest keystone in localSpace.
-            const senderIdentityLatestAddr =
-                await localMetaspace.getLatestAddr({ ibGib: senderIdentity, space: localSpace });
-            if (!senderIdentityLatestAddr) { throw new Error(`senderIdentityLatestAddr falsy. we should have a latest addr that is different than the sender identity at this point (done in the peer establish phase) (E: 225607318bef485d7821f82de97b6826)`); }
-
-            const resGet = await localMetaspace.get({ addrs: [senderIdentityLatestAddr], space: localSpace });
-            const I_tip = resGet.ibGibs?.[0] as KeystoneIbGib_V1;
-
-            // const targetSAddr = I_tip?.rel8ns?.past?.[0] ?? I_tip?.data?.proofs?.[0]?.claim?.target;
-            const targetSAddr = I_tip.data.proofs.at(0)?.claim.target;
-            if (!targetSAddr) {
-                throw new Error(`Could not locate session keystone target from identity (E: 5ec4882f7e5e4c33fbd00ab8b3166726)`);
-            }
-
-            const resGetS = await localMetaspace.get({ addrs: [targetSAddr], space: localSpace });
-            const sessionS = resGetS.ibGibs?.[0] as KeystoneIbGib_V1;
-            if (!sessionS) {
-                throw new Error(`Session keystone not found in local space: ${targetSAddr} (E: 9ba818e6622808bb4ae749be31f80b26)`);
-            }
-
-            // Solve dynamic upfront picket-fence challenge
-            const connectPool =
-                (sessionS.data?.challengePools ?? [])
-                    .find(p => p.id === SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID);
-            if (!connectPool) {
-                throw new Error(`Session keystone missing connect pool (E: f50968afca04b6d38ec19824ea201826)`);
-            }
-
-            const { challengeId } = getConnectChallenge(sessionS);
-            const strategy = KeystoneStrategyFactory.create({ config: connectPool.config });
-            const poolSecret = await strategy.derivePoolSecret({ masterSecret: sessionSecret });
-            const solution = await strategy.generateSolution({
-                poolSecret,
-                poolId: SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID,
-                challengeId
-            });
-
-            // 2. Open WebSocket connection
-            const wsUrl = `${this.data!.wsUrl}?sAddr=${encodeURIComponent(targetSAddr)}&solution=${encodeURIComponent(solution.value)}`;
-            if (logalot) { console.log(`${lc} connecting to WebSocket: ${wsUrl}`); }
-
-            const ws = new WebSocket(wsUrl);
-            this.ws = ws;
-
-            return new Promise<void>((resolve, reject) => {
-                let isResolved = false;
-
-                ws.addEventListener('open', () => {
-                    if (logalot) { console.log(`${lc} WebSocket opened. Awaiting challenge...`); }
-                });
-
-                ws.addEventListener('message', async (ev) => {
-                    try {
-                        const msg = JSON.parse(ev.data);
-                        if (logalot) { console.log(`${lc} received frame: ${msg.type}`); }
-
-                        if (msg.type === 'auth-challenge-init') {
-                            ws.send(JSON.stringify({
-                                type: 'auth-init',
-                                sAddr: targetSAddr
-                            }));
-                        } else if (msg.type === 'auth-challenge') {
-                            const { challengeUuid, demandedIds } = msg;
-                            if (logalot) { console.log(`${lc} solving demanded challenges: ${demandedIds.join(', ')}`); }
-
-                            const keystoneService = new KeystoneService_V1();
-                            const proofFrame = await keystoneService.sign({
-                                latestKeystone: sessionS,
-                                masterSecret: sessionSecret,
-                                poolId: SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID,
-                                requiredChallengeIds: demandedIds,
-                                claim: {
-                                    verb: SESSION_KEYSTONE_POLICY.CONNECT_POOL.VERB,
-                                    target: challengeUuid
-                                },
-                                metaspace: localMetaspace,
-                                space: localSpace
-                            });
-
-                            ws.send(JSON.stringify({
-                                type: 'auth-proof',
-                                proofFrame
-                            }));
-                        } else if (msg.type === 'auth-ok') {
-                            if (logalot) { console.log(`${lc} WebSocket connect SUCCESS!`); }
-                            isResolved = true;
-
-                            // Setup persistent runtime listeners
-                            ws.removeEventListener('message', (() => { }) as any);
-                            ws.addEventListener('message', (event) => this.handleRuntimeMessage(event));
-
-                            resolve();
-                        } else if (msg.type === 'auth-fail') {
-                            reject(new Error(`Connect failed: ${msg.message}`));
-                        }
-                    } catch (error) {
-                        reject(error);
-                    }
-                });
-
-                ws.addEventListener('close', (event) => {
-                    if (!isResolved) {
-                        reject(new Error(`WebSocket closed before connect completed (code: ${event.code})`));
-                    }
-                });
-
-                ws.addEventListener('error', (err) => {
-                    if (!isResolved) {
-                        reject(new Error(`WebSocket connection error`));
-                    }
-                });
-            });
-
-        } catch (error) {
-            console.error(`${lc} connect failed: ${extractErrorMsg(error)}`);
-            throw error;
-        }
-    }
-
-    /**
-     * Handles synchronizing messages and evolved context frames during active transaction turns.
-     */
-    protected handleRuntimeMessage(event: MessageEvent): void {
-        const lc = `${this.lc}[${this.handleRuntimeMessage.name}]`;
-        try {
-            const msg = JSON.parse(event.data);
-            if (logalot) { console.log(`${lc} received runtime frame: ${msg.type}`); }
-
-            if (msg.type === 'sync-frame-response') {
-                if (this.activeResolve) {
-                    const responseContext = msg.context as SyncSagaContextIbGib_V1;
-                    const resolve = this.activeResolve;
-                    this.activeResolve = undefined;
-                    this.activeReject = undefined;
-                    resolve(responseContext);
-                }
-            } else if (msg.type === 'domain-payload') {
-                const payload = msg.ibGib as IbGib_V1;
-                this.payloadIbGibsDomainReceived$.next(payload);
-            }
-        } catch (error) {
-            console.error(`${lc} failed parsing runtime frame: ${extractErrorMsg(error)}`);
-            if (this.activeReject) {
-                this.activeReject(error);
-            }
-        }
-    }
-
-    /**
-     * Serializes the transaction context and payload down the active WebSocket connection.
-     */
-    protected override async sendContextRequest(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined> {
-        const lc = `${this.lc}[${this.sendContextRequest.name}]`;
-        try {
-            if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-                throw new Error(`WebSocket is not connected or open (E: a3b2c1d0e9f8e7d6c5b4a3f2e1d0c915)`);
-            }
-
-            // 1. Push any outgoing payload domain ibgibs down the pipe
-            const domainPayloads = context.payloadIbGibsDomain ?? [];
-            for (const ibGib of domainPayloads) {
-                this.ws.send(JSON.stringify({
-                    type: 'domain-payload',
-                    ibGib
-                }));
-            }
-
-            // 2. Transmit the synchronizing transaction context
-            return new Promise<SyncSagaContextIbGib_V1 | undefined>((resolve, reject) => {
-                this.activeResolve = resolve;
-                this.activeReject = reject;
-
-                this.ws!.send(JSON.stringify({
-                    type: 'sync-frame',
-                    context
-                }));
-            });
-
-        } catch (error) {
-            console.error(`${lc} sendContextRequest failed: ${extractErrorMsg(error)}`);
-            throw error;
-        }
-    }
-}