@ibgib/node-gib 0.0.9 → 0.0.13

package/dist/serve-gib/handlers/ws/sync-upgrade-handler-base.mjs

@@ -0,0 +1,219 @@
+/**
+ * @module handlers/ws/sync-upgrade-handler-base
+ *
+ * Highly generic, reusable base class in serve-gib for handling WebSocket upgrades,
+ * mapping socket streams to isomorphic SyncPeers, and checking upfront connect handshakes.
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { getIbGibAddr, getIbAndGib } from '@ibgib/ts-gib/dist/helper.mjs';
+import { validateIbGibAddr } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
+import { parseKeystoneIb } from '@ibgib/core-gib/dist/keystone/keystone-helpers.mjs';
+import { SyncPeerWebSocketReceiver_V1 } from '@ibgib/core-gib/dist/sync/sync-peer/sync-peer-websocket/sync-peer-websocket-receiver/sync-peer-websocket-receiver-v1.mjs';
+import { validateUpfrontConnect } from '@ibgib/core-gib/dist/sync/sync-peer/sync-peer-websocket/sync-peer-websocket-receiver/sync-websocket-peer-helpers.mjs';
+import { SyncSagaCoordinator } from '@ibgib/core-gib/dist/sync/sync-saga-coordinator.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../constants.mjs';
+import { encodeTextFrame, encodeCloseFrame, performConnect, WebSocketFrameDecoder } from './ws-helper.mjs';
+import { ServeGibHandlerWithMetaspaceBase } from '../handler-base.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Reusable server-side upgrade handler plumbing.
+ * Binds raw node socket streams to platform-agnostic receiver peers.
+ */
+export class SyncUpgradeHandlerBase extends ServeGibHandlerWithMetaspaceBase {
+    lc = `[${SyncUpgradeHandlerBase.name}]`;
+    method = 'GET';
+    /**
+     * Entry point for WebSocket upgrades.
+     * Orchestrates the upgrade, upfront validation, and registers the Receiver peer.
+     */
+    async handleUpgrade(reqCtx, socket, head) {
+        const lc_fn = `${this.lc}[handleUpgrade]`;
+        try {
+            if (logalot) {
+                console.log(`${lc_fn} starting...`);
+            }
+            // 1. Initial routing checks
+            if (!this.canHandleRoute(reqCtx)) {
+                return false;
+            }
+            const ctx = reqCtx;
+            // Extract route parameters & query parameters
+            ctx.params = await this.parseParams(ctx);
+            ctx.queryParams = await this.parseQueryParams(ctx);
+            // 2. Bootstrap multi-tenant domain metaspace context
+            await this.initConcreteContext(ctx);
+            const metaspace = ctx.metaspace;
+            const space = await metaspace.getLocalUserSpace({ lock: false });
+            if (!space) {
+                throw new Error("No default local user space found.");
+            }
+            // 3. Upfront picket-fence pre-filter validation
+            const queryParams = ctx.queryParams;
+            await validateUpfrontConnect({
+                sAddr: queryParams.sAddr,
+                solution: queryParams.solution,
+                space,
+                metaspace
+            });
+            // 4. Perform standard RFC 6455 Connect H andshake Upgrade
+            const ok = performConnect(ctx, socket);
+            if (!ok) {
+                return true;
+            }
+            // 5. Instantiate and initialize isomorphic WebSocket Receiver Peer
+            const receiverPeer = new SyncPeerWebSocketReceiver_V1({
+                classname: 'SyncPeerWebSocketReceiver_V1'
+            });
+            const localCoordinator = new SyncSagaCoordinator();
+            await receiverPeer.initializeOpts({
+                localCoordinator,
+                localMetaspace: metaspace,
+                localSpace: space,
+                sagaId: undefined, // Resolved dynamically inside runtime turns
+            });
+            // Handle raw socket errors to prevent unhandled 'error' crash (e.g. ECONNRESET)
+            socket.on('error', (err) => {
+                if (logalot) {
+                    console.warn(`[SyncUpgradeHandlerBase] Socket error: ${extractErrorMsg(err)}`);
+                }
+                try {
+                    socket.destroy();
+                }
+                catch (e) {
+                    // ignore
+                }
+            });
+            // 6. Map standard Node.js Socket to platform-agnostic IWebSocketWrapper
+            const socketWrapper = {
+                send(data) {
+                    if (socket.writable) {
+                        try {
+                            socket.write(encodeTextFrame(data));
+                        }
+                        catch (e) {
+                            if (logalot) {
+                                console.warn(`[SyncUpgradeHandlerBase] failed to write message frame: ${extractErrorMsg(e)}`);
+                            }
+                        }
+                    }
+                },
+                onMessage(callback) {
+                    const decoder = new WebSocketFrameDecoder();
+                    socket.on('data', (buf) => {
+                        try {
+                            decoder.addChunk(buf);
+                            let frameText = decoder.nextFrame();
+                            while (frameText !== null) {
+                                callback(frameText);
+                                frameText = decoder.nextFrame();
+                            }
+                        }
+                        catch (error) {
+                            if (logalot) {
+                                console.warn(`[SyncUpgradeHandlerBase] closing connection due to decoder error: ${extractErrorMsg(error)}`);
+                            }
+                            if (socket.writable) {
+                                try {
+                                    socket.write(encodeCloseFrame());
+                                }
+                                catch (e) {
+                                    // ignore
+                                }
+                            }
+                            socket.end();
+                        }
+                    });
+                },
+                onClose(callback) {
+                    socket.on('close', callback);
+                },
+                close() {
+                    if (socket.writable) {
+                        try {
+                            socket.write(encodeCloseFrame());
+                        }
+                        catch (e) {
+                            // ignore
+                        }
+                    }
+                    socket.end();
+                }
+            };
+            // Bind peer receiver to handle all socket messages (connect & runtime)
+            await receiverPeer.bindSocket(socketWrapper);
+            return true;
+        }
+        catch (error) {
+            console.error(`${lc_fn} upgrade failure: ${extractErrorMsg(error)}`);
+            socket.destroy();
+            return true;
+        }
+    }
+    async parseParamsImpl(reqCtx) {
+        const match = reqCtx.pathname.match(this.regex);
+        if (!match) {
+            return undefined;
+        }
+        const domainIb = decodeURIComponent(match[1]);
+        const domainGib = decodeURIComponent(match[2]);
+        const domainAddr = getIbGibAddr({ ib: domainIb, gib: domainGib });
+        return {
+            domainInfo: this.getDomainInfo({ domainAddr })
+        };
+    }
+    async parseQueryParams(reqCtx) {
+        const sAddrRaw = reqCtx.url.searchParams.get('sAddr');
+        const sAddr = sAddrRaw ? decodeURIComponent(sAddrRaw) : undefined;
+        const solution = reqCtx.url.searchParams.get('solution') ?? undefined;
+        const queryParams = {};
+        if (sAddr !== undefined) {
+            queryParams.sAddr = sAddr;
+        }
+        if (solution !== undefined) {
+            queryParams.solution = solution;
+        }
+        if (Object.keys(queryParams).length > 0) {
+            const validationErrors = await this.validateQueryParams({ queryParams });
+            if (validationErrors.length === 0) {
+                return queryParams;
+            }
+            else {
+                throw new Error(`invalid query params: ${validationErrors.join(', ')}`);
+            }
+        }
+        return undefined;
+    }
+    async validateQueryParams({ queryParams }) {
+        const errors = [];
+        if (!queryParams) {
+            return ["Missing query parameters: sAddr, solution"];
+        }
+        if (!queryParams.sAddr) {
+            errors.push("Missing sAddr");
+        }
+        else {
+            try {
+                const decodedSAddr = queryParams.sAddr;
+                const addrErrors = validateIbGibAddr({ addr: decodedSAddr }) ?? [];
+                if (addrErrors.length > 0) {
+                    errors.push(`Invalid sAddr: ${addrErrors.join(', ')}`);
+                }
+                else {
+                    const { ib } = getIbAndGib({ ibGibAddr: decodedSAddr });
+                    parseKeystoneIb({ ib });
+                }
+            }
+            catch (error) {
+                errors.push(`Invalid sAddr: ${extractErrorMsg(error)}`);
+            }
+        }
+        if (!queryParams.solution) {
+            errors.push("Missing solution");
+        }
+        return errors;
+    }
+    async handleRouteImpl(reqCtx) {
+        return this.error(400, 'WS endpoint requires upgrade');
+    }
+}
+//# sourceMappingURL=sync-upgrade-handler-base.mjs.map

package/dist/serve-gib/handlers/ws/sync-upgrade-handler-base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-upgrade-handler-base.mjs","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/sync-upgrade-handler-base.mts"],"names":[],"mappings":"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"}

package/dist/serve-gib/handlers/ws/sync-upgrade.handler.d.mts

@@ -0,0 +1,21 @@
+/**
+ * @module handlers/ws/sync-upgrade.handler
+ *
+ * Concrete implementation of the serve-gib WebSocket Sync Peer wrapper.
+ * Decoupled from core protocols by extending SyncUpgradeHandlerBase.
+ */
+import { SyncUpgradeHandlerBase } from './sync-upgrade-handler-base.mjs';
+import { ServeGibHttpMethod } from '../../types.mjs';
+/**
+ * SyncChannelHandler manages the WebSocket Connect and Transport channel.
+ * Delegates 100% of connect handshake, signature verify, and sync turns to
+ * SyncPeerWebSocketReceiver_V1.
+ */
+export declare class SyncChannelHandler extends SyncUpgradeHandlerBase {
+    protected lc: string;
+    protected method: ServeGibHttpMethod;
+    protected regex: RegExp;
+}
+/** Keep naming backward-compatible for server registrations */
+export declare const SyncUpgradeHandler: typeof SyncChannelHandler;
+//# sourceMappingURL=sync-upgrade.handler.d.mts.map

package/dist/serve-gib/handlers/ws/sync-upgrade.handler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-upgrade.handler.d.mts","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/sync-upgrade.handler.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,sBAAsB;IAC1D,UAAmB,EAAE,EAAE,MAAM,CAAkC;IAC/D,UAAmB,MAAM,EAAE,kBAAkB,CAAS;IACtD,UAAmB,KAAK,EAAE,MAAM,CAA4B;CAC/D;AAED,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,2BAAqB,CAAC"}

package/dist/serve-gib/handlers/ws/sync-upgrade.handler.mjs

@@ -0,0 +1,21 @@
+/**
+ * @module handlers/ws/sync-upgrade.handler
+ *
+ * Concrete implementation of the serve-gib WebSocket Sync Peer wrapper.
+ * Decoupled from core protocols by extending SyncUpgradeHandlerBase.
+ */
+import { SyncUpgradeHandlerBase } from './sync-upgrade-handler-base.mjs';
+import { API_PATH_REGEXES } from '../../path-constants.mjs';
+/**
+ * SyncChannelHandler manages the WebSocket Connect and Transport channel.
+ * Delegates 100% of connect handshake, signature verify, and sync turns to
+ * SyncPeerWebSocketReceiver_V1.
+ */
+export class SyncChannelHandler extends SyncUpgradeHandlerBase {
+    lc = `[${SyncChannelHandler.name}]`;
+    method = 'GET';
+    regex = API_PATH_REGEXES.SYNC_WS;
+}
+/** Keep naming backward-compatible for server registrations */
+export const SyncUpgradeHandler = SyncChannelHandler;
+//# sourceMappingURL=sync-upgrade.handler.mjs.map

package/dist/serve-gib/handlers/ws/sync-upgrade.handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-upgrade.handler.mjs","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/sync-upgrade.handler.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,sBAAsB;IACvC,EAAE,GAAW,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC;IAC5C,MAAM,GAAuB,KAAK,CAAC;IACnC,KAAK,GAAW,gBAAgB,CAAC,OAAO,CAAC;CAC/D;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC"}

package/dist/serve-gib/handlers/ws/ws-helper.d.mts

@@ -0,0 +1,29 @@
+import { IncomingMessage } from 'node:http';
+import { Socket } from 'node:net';
+/** Encodes a UTF-8 string as a minimal unmasked WebSocket text frame. */
+export declare function encodeTextFrame(text: string): Buffer;
+/** Decodes a masked client WebSocket text frame. Returns null for non-text or incomplete frames. */
+export declare function decodeTextFrame(data: Buffer): string | null;
+/** Encodes a WebSocket close frame (opcode 0x8) with optional status code. */
+export declare function encodeCloseFrame(code?: number): Buffer;
+/** Performs the RFC 6455 opening connect handshake. */
+export declare function performConnect(req: IncomingMessage, socket: Socket): boolean;
+/**
+ * Stateful WebSocket text frame decoder that aggregates incoming TCP chunks
+ * and decodes full RFC 6455 frames.
+ */
+export declare class WebSocketFrameDecoder {
+    private buffer;
+    private fragments;
+    /** Adds new data chunk from TCP socket. */
+    addChunk(chunk: Buffer): void;
+    /**
+     * Parses the next complete text message, assembling fragments if necessary.
+     * Returns:
+     * - `string` if a complete text message was assembled/decoded (and consumes those bytes).
+     * - `null` if the buffer is incomplete or we need more data.
+     * - `throws Error` on protocol errors or close frames.
+     */
+    nextFrame(): string | null;
+}
+//# sourceMappingURL=ws-helper.d.mts.map

package/dist/serve-gib/handlers/ws/ws-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-helper.d.mts","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/ws-helper.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlC,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBpD;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoC3D;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,SAAO,GAAG,MAAM,CAMpD;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CA4B5E;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAgB;IAEjC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5B;IAED;;;;;;OAMG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI,CAkFzB;CACJ"}

package/dist/serve-gib/handlers/ws/ws-helper.mjs

@@ -0,0 +1,195 @@
+import { createHash } from 'node:crypto';
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+const WS_MAGIC = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+/** Encodes a UTF-8 string as a minimal unmasked WebSocket text frame. */
+export function encodeTextFrame(text) {
+    const payload = Buffer.from(text, 'utf-8');
+    const payloadLen = payload.length;
+    let header;
+    if (payloadLen < 126) {
+        header = Buffer.alloc(2);
+        header[0] = 0x81; // FIN + opcode 1 (text)
+        header[1] = payloadLen;
+    }
+    else if (payloadLen < 65536) {
+        header = Buffer.alloc(4);
+        header[0] = 0x81;
+        header[1] = 126;
+        header.writeUInt16BE(payloadLen, 2);
+    }
+    else {
+        header = Buffer.alloc(10);
+        header[0] = 0x81;
+        header[1] = 127;
+        header.writeBigUInt64BE(BigInt(payloadLen), 2);
+    }
+    return Buffer.concat([header, payload]);
+}
+/** Decodes a masked client WebSocket text frame. Returns null for non-text or incomplete frames. */
+export function decodeTextFrame(data) {
+    try {
+        if (data.length < 2) {
+            return null;
+        }
+        const opcode = data[0] & 0x0f;
+        if (opcode === 0x8) {
+            return null;
+        } // Close
+        if (opcode !== 0x1) {
+            return null;
+        } // Text only
+        const masked = (data[1] & 0x80) !== 0;
+        let payloadStart = 2;
+        let payloadLen = data[1] & 0x7f;
+        if (payloadLen === 126) {
+            payloadLen = data.readUInt16BE(2);
+            payloadStart = 4;
+        }
+        else if (payloadLen === 127) {
+            payloadLen = Number(data.readBigUInt64BE(2));
+            payloadStart = 10;
+        }
+        if (masked) {
+            const maskStart = payloadStart;
+            payloadStart += 4;
+            const mask = data.slice(maskStart, maskStart + 4);
+            const payload = data.slice(payloadStart, payloadStart + payloadLen);
+            for (let i = 0; i < payload.length; i++) {
+                payload[i] ^= mask[i % 4];
+            }
+            return payload.toString('utf-8');
+        }
+        return data.slice(payloadStart, payloadStart + payloadLen).toString('utf-8');
+    }
+    catch (error) {
+        console.error(`[ws-helper] decode error: ${extractErrorMsg(error)}`);
+        return null;
+    }
+}
+/** Encodes a WebSocket close frame (opcode 0x8) with optional status code. */
+export function encodeCloseFrame(code = 1000) {
+    const frame = Buffer.alloc(4);
+    frame[0] = 0x88;
+    frame[1] = 2;
+    frame.writeUInt16BE(code, 2);
+    return frame;
+}
+/** Performs the RFC 6455 opening connect handshake. */
+export function performConnect(req, socket) {
+    try {
+        const key = req.headers['sec-websocket-key'];
+        if (!key) {
+            socket.write('HTTP/1.1 400 Bad Request\r\n\r\nMissing Sec-WebSocket-Key');
+            socket.destroy();
+            return false;
+        }
+        const acceptKey = createHash('sha1')
+            .update(key + WS_MAGIC)
+            .digest('base64');
+        const response = [
+            'HTTP/1.1 101 Switching Protocols',
+            'Upgrade: websocket',
+            'Connection: Upgrade',
+            `Sec-WebSocket-Accept: ${acceptKey}`,
+            '\r\n',
+        ].join('\r\n');
+        socket.write(response);
+        return true;
+    }
+    catch (error) {
+        console.error(`[ws-helper] connect error: ${extractErrorMsg(error)}`);
+        socket.destroy();
+        return false;
+    }
+}
+/**
+ * Stateful WebSocket text frame decoder that aggregates incoming TCP chunks
+ * and decodes full RFC 6455 frames.
+ */
+export class WebSocketFrameDecoder {
+    buffer = Buffer.alloc(0);
+    fragments = [];
+    /** Adds new data chunk from TCP socket. */
+    addChunk(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+    }
+    /**
+     * Parses the next complete text message, assembling fragments if necessary.
+     * Returns:
+     * - `string` if a complete text message was assembled/decoded (and consumes those bytes).
+     * - `null` if the buffer is incomplete or we need more data.
+     * - `throws Error` on protocol errors or close frames.
+     */
+    nextFrame() {
+        while (true) {
+            if (this.buffer.length < 2) {
+                return null;
+            }
+            const firstByte = this.buffer[0];
+            const fin = (firstByte & 0x80) !== 0;
+            const opcode = firstByte & 0x0f;
+            if (opcode === 0x8) {
+                throw new Error('Close frame received');
+            }
+            const isContinuation = opcode === 0x0;
+            const isText = opcode === 0x1;
+            if (!isContinuation && !isText) {
+                throw new Error(`Unsupported WebSocket opcode: 0x${opcode.toString(16)}`);
+            }
+            // Protocol checks
+            if (isContinuation && this.fragments.length === 0) {
+                throw new Error('Continuation frame received without an active message.');
+            }
+            if (isText && this.fragments.length > 0) {
+                throw new Error('New message frame received before previous one completed.');
+            }
+            const secondByte = this.buffer[1];
+            const masked = (secondByte & 0x80) !== 0;
+            let payloadLen = secondByte & 0x7f;
+            let headerLen = 2;
+            if (payloadLen === 126) {
+                if (this.buffer.length < 4) {
+                    return null;
+                }
+                payloadLen = this.buffer.readUInt16BE(2);
+                headerLen = 4;
+            }
+            else if (payloadLen === 127) {
+                if (this.buffer.length < 10) {
+                    return null;
+                }
+                payloadLen = Number(this.buffer.readBigUInt64BE(2));
+                headerLen = 10;
+            }
+            const maskLen = masked ? 4 : 0;
+            const totalFrameLen = headerLen + maskLen + payloadLen;
+            if (this.buffer.length < totalFrameLen) {
+                return null;
+            }
+            // Consume frame from buffer
+            const frameData = this.buffer.subarray(0, totalFrameLen);
+            this.buffer = this.buffer.subarray(totalFrameLen);
+            let payloadStart = headerLen;
+            let payload;
+            if (masked) {
+                const mask = frameData.subarray(payloadStart, payloadStart + 4);
+                payloadStart += 4;
+                payload = Buffer.from(frameData.subarray(payloadStart));
+                for (let i = 0; i < payload.length; i++) {
+                    payload[i] ^= mask[i % 4];
+                }
+            }
+            else {
+                payload = Buffer.from(frameData.subarray(payloadStart));
+            }
+            this.fragments.push(payload);
+            if (fin) {
+                const completePayload = Buffer.concat(this.fragments);
+                this.fragments = [];
+                return completePayload.toString('utf-8');
+            }
+            // Loop again to process any subsequent frames already inside the TCP buffer
+        }
+    }
+}
+//# sourceMappingURL=ws-helper.mjs.map

package/dist/serve-gib/handlers/ws/ws-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-helper.mjs","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/ws-helper.mts"],"names":[],"mappings":"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"}

package/dist/serve-gib/handlers/ws/ws-types.d.mts

@@ -0,0 +1,32 @@
+import { KeystoneIbGib_V1 } from "@ibgib/core-gib/dist/keystone/keystone-types.mjs";
+export type HandshakeMessageType = 'auth-challenge-init' | 'auth-init' | 'auth-challenge' | 'auth-proof' | 'auth-ok' | 'auth-fail';
+export interface HandshakeMessageBase {
+    type: HandshakeMessageType;
+}
+export interface AuthChallengeInitMessage extends HandshakeMessageBase {
+    type: 'auth-challenge-init';
+    challengeUuid: string;
+}
+export interface AuthInitMessage extends HandshakeMessageBase {
+    type: 'auth-init';
+    sAddr: string;
+}
+export interface AuthChallengeMessage extends HandshakeMessageBase {
+    type: 'auth-challenge';
+    challengeUuid: string;
+    demandedIds: string[];
+}
+export interface AuthProofMessage extends HandshakeMessageBase {
+    type: 'auth-proof';
+    proofFrame: KeystoneIbGib_V1;
+}
+export interface AuthOkMessage extends HandshakeMessageBase {
+    type: 'auth-ok';
+}
+export interface AuthFailMessage extends HandshakeMessageBase {
+    type: 'auth-fail';
+    message: string;
+    errors?: string[];
+}
+export type HandshakeMessage = AuthChallengeInitMessage | AuthInitMessage | AuthChallengeMessage | AuthProofMessage | AuthOkMessage | AuthFailMessage;
+//# sourceMappingURL=ws-types.d.mts.map

package/dist/serve-gib/handlers/ws/ws-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-types.d.mts","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/ws-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEpF,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,WAAW,GACX,gBAAgB,GAChB,YAAY,GACZ,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IAClE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IACzD,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAC9D,IAAI,EAAE,gBAAgB,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC1D,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;CAChC;AAED,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACvD,IAAI,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IACzD,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,eAAe,GACf,oBAAoB,GACpB,gBAAgB,GAChB,aAAa,GACb,eAAe,CAAC"}

package/dist/serve-gib/handlers/ws/ws-types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ws-types.mjs.map

package/dist/serve-gib/handlers/ws/ws-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-types.mjs","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/ws-types.mts"],"names":[],"mappings":""}

package/dist/serve-gib/identity-index/identity-index-constants.d.mts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_IDENTITY_INDEX_DIR_NAME = "identity_index";
+export declare const DEFAULT_EMAIL_HASHES_SUBDIR = "email_hashes";
+export declare const DEFAULT_IDENTITY_INDEX_SALT = "ibgib_identity_salt_default_v1";
+//# sourceMappingURL=identity-index-constants.d.mts.map

package/dist/serve-gib/identity-index/identity-index-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-index-constants.d.mts","sourceRoot":"","sources":["../../../src/serve-gib/identity-index/identity-index-constants.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,mBAAmB,CAAC;AAChE,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,mCAAmC,CAAC"}

package/dist/serve-gib/identity-index/identity-index-constants.mjs

@@ -0,0 +1,4 @@
+export const DEFAULT_IDENTITY_INDEX_DIR_NAME = 'identity_index';
+export const DEFAULT_EMAIL_HASHES_SUBDIR = 'email_hashes';
+export const DEFAULT_IDENTITY_INDEX_SALT = 'ibgib_identity_salt_default_v1';
+//# sourceMappingURL=identity-index-constants.mjs.map

package/dist/serve-gib/identity-index/identity-index-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-index-constants.mjs","sourceRoot":"","sources":["../../../src/serve-gib/identity-index/identity-index-constants.mts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,gBAAgB,CAAC;AAChE,MAAM,CAAC,MAAM,2BAA2B,GAAG,cAAc,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,gCAAgC,CAAC"}

package/dist/serve-gib/identity-index/identity-index-helpers.d.mts

@@ -0,0 +1,35 @@
+/**
+ * Validates an email address against length constraints and KEYSTONE_EMAIL_REGEXP.
+ * Returns an array of error message strings (empty `[]` if valid).
+ */
+export declare function validateEmail({ email }: {
+    email: any;
+}): string[];
+/**
+ * Normalizes an email string (lowercased and trimmed).
+ */
+export declare function normalizeEmail(email: string): string;
+/**
+ * Computes SHA256 privacy hash of an email string:
+ * `SHA256(normalizeEmail(email) + salt)` using `hash` from `@ibgib/helper-gib`.
+ */
+export declare function getIdentityEmailHash({ email, salt, }: {
+    email: string;
+    salt?: string;
+}): Promise<string>;
+/**
+ * Returns the sharded directory path and truncated filename for an email hash.
+ *
+ * Full Hash (e.g. 64 chars): `abcdef12345...`
+ * Subfolders: `ab/cd/ef`
+ * Truncated filename: `12345....json` (strips the leading 6 characters that form the 3 subfolder pairs).
+ */
+export declare function getShardedIndexPath({ baseDir, emailHash, }: {
+    baseDir: string;
+    emailHash: string;
+}): {
+    folderPath: string;
+    filePath: string;
+    filename: string;
+};
+//# sourceMappingURL=identity-index-helpers.d.mts.map

package/dist/serve-gib/identity-index/identity-index-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-index-helpers.d.mts","sourceRoot":"","sources":["../../../src/serve-gib/identity-index/identity-index-helpers.mts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,GAAG,CAAA;CAAE,GAAG,MAAM,EAAE,CAiBjE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EACvC,KAAK,EACL,IAAqE,GACxE,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAChC,OAAO,EACP,SAAS,GACZ,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAe7D"}