UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

143 lines (125 loc) • 4.43 kB
/** * Minimal, zero-dependency gRPC-Web binary framing encoder and decoder. * Supports 5-byte header prefix: 0x00 data frames, 0x80 trailer frames. */ export interface GrpcWebTrailer { status: number; statusValues: string[]; statusMessage?: string; metadata: Record<string, string>; } export interface DecodedGrpcWebResponse { messages: Uint8Array[]; status: number; statusValues: string[]; framingComplete: boolean; statusMessage?: string; trailers?: GrpcWebTrailer; } export class GrpcWebError extends Error { readonly status: number; readonly statusMessage: string; constructor(status: number, statusMessage: string) { super(`gRPC-Web call failed with status ${status}: ${statusMessage}`); this.name = "GrpcWebError"; this.status = status; this.statusMessage = statusMessage; } } const FRAME_DATA = 0x00; const FRAME_TRAILER = 0x80; const HEADER_SIZE = 5; /** * Encodes a protobuf payload into a single gRPC-Web binary data frame (flag 0x00). */ export function encodeGrpcWebEnvelope(message: Uint8Array): Uint8Array { const envelope = new Uint8Array(HEADER_SIZE + message.length); envelope[0] = FRAME_DATA; const view = new DataView(envelope.buffer, envelope.byteOffset, envelope.byteLength); view.setUint32(1, message.length, false); // Big-endian u32 envelope.set(message, HEADER_SIZE); return envelope; } /** * Parses ASCII key-value lines from a gRPC-Web trailer frame payload. */ export function parseGrpcWebTrailers(bytes: Uint8Array): GrpcWebTrailer { const text = new TextDecoder("utf-8").decode(bytes); const lines = text.split(/\r?\n/); const metadata: Record<string, string> = {}; const statusValues: string[] = []; let status = 0; let statusMessage: string | undefined; for (const line of lines) { const colonIdx = line.indexOf(":"); if (colonIdx === -1) continue; const key = line.slice(0, colonIdx).trim().toLowerCase(); const value = line.slice(colonIdx + 1).trim(); if (!key) continue; metadata[key] = value; if (key === "grpc-status") { statusValues.push(value); const parsed = parseInt(value, 10); if (!Number.isNaN(parsed)) { status = parsed; } } else if (key === "grpc-message") { try { statusMessage = decodeURIComponent(value); } catch { statusMessage = value; } } } return { status, statusValues, statusMessage, metadata }; } /** * Decodes a contiguous gRPC-Web binary stream into data messages and trailing metadata. */ export function decodeGrpcWebResponse(bytes: Uint8Array): DecodedGrpcWebResponse { const messages: Uint8Array[] = []; const statusValues: string[] = []; let offset = 0; let trailer: GrpcWebTrailer | undefined; let firstTrailerPayload: Uint8Array | undefined; let framingComplete = true; while (offset + HEADER_SIZE <= bytes.length) { const flag = bytes[offset]; const view = new DataView(bytes.buffer, bytes.byteOffset + offset, HEADER_SIZE); const length = view.getUint32(1, false); const frameStart = offset + HEADER_SIZE; const frameEnd = frameStart + length; if (frameEnd > bytes.length) { throw new Error(`Incomplete gRPC-Web frame at offset ${offset}: expected ${length} bytes, got ${bytes.length - frameStart}`); } const payload = bytes.subarray(frameStart, frameEnd); // Preserve legacy decoding; callers needing confirmation inspect framingComplete. if (flag === FRAME_DATA) { if (firstTrailerPayload !== undefined) framingComplete = false; messages.push(payload); } else if (flag === FRAME_TRAILER) { const firstTrailer = firstTrailerPayload; if (firstTrailer === undefined) { firstTrailerPayload = payload; } else if (payload.length !== firstTrailer.length || payload.some((byte, index) => byte !== firstTrailer[index])) { framingComplete = false; } trailer = parseGrpcWebTrailers(payload); for (const value of trailer.statusValues) statusValues.push(value); } else { framingComplete = false; } offset = frameEnd; } const finalStatus = trailer ? trailer.status : 0; const finalMessage = trailer?.statusMessage; return { messages, status: finalStatus, statusValues, framingComplete: framingComplete && offset === bytes.length, statusMessage: finalMessage, trailers: trailer, }; }