mirror of
https://github.com/hanzoai/opencode-openai-codex-auth.git
synced 2026-09-24 17:01:02 +00:00
## 🎯 Overview Complete TypeScript rewrite with comprehensive testing, modular architecture, and enhanced user experience. Adds 9 pre-configured model variants matching Codex CLI presets and a beautiful OAuth success page. ## ✨ New Features ### Configuration System - **9 Model Variants**: Pre-configured reasoning levels (Low/Medium/High) for both gpt-5-codex and gpt-5, plus Minimal variants - **Full Config Example**: `config/full-opencode.json` with all variants ready to use - **Minimal Config Example**: `config/minimal-opencode.json` for basic setup - **Config Documentation**: Comprehensive guide in `config/README.md` ### OAuth Enhancement - **Animated Success Page**: Beautiful terminal-style UI with matrix rain effect, animated checkmark, and glowing effects - **Interactive Elements**: Mouse-responsive matrix rain and parallax effects - **Professional Branding**: OpenCode logo with pulse animations ### Developer Experience - **TypeScript Rewrite**: Complete migration from .mjs to .ts with strict typing - **93 Comprehensive Tests**: Full test coverage using Vitest - **Modular Architecture**: 10 focused helper functions, each < 40 lines - **Centralized Constants**: All magic values in `lib/constants.ts` - **CI/CD Pipeline**: GitHub Actions workflow for automated testing ### Documentation - **AGENTS.md**: Complete guide for AI assistants maintaining the codebase - **Enhanced README**: Updated with new configuration options and examples - **Inline JSDoc**: Comprehensive documentation for all public functions ## 🏗️ Technical Changes ### Architecture Improvements - Extracted 10 focused helper functions from monolithic fetch() - Centralized all constants and error messages - Separated concerns: auth, browser, codex, server, etc. - Type-safe discriminated unions for result types ### Build System - TypeScript compilation with declarations and source maps - Automatic HTML asset copying in build process - Test files excluded from distribution bundle - Clean dist/ output with only production code ### Testing Infrastructure - Vitest test runner with UI mode - 93 tests across 7 test files - Mock-based testing for external dependencies - Coverage reporting capability ## 📁 New Structure ``` opencode-openai-codex-auth/ ├── index.ts # Main plugin (TypeScript) ├── lib/ │ ├── auth.ts # OAuth logic │ ├── browser.ts # Platform-specific browser opening │ ├── codex.ts # Codex instructions │ ├── server.ts # OAuth callback server │ ├── fetch-helpers.ts # 10 focused helpers │ ├── constants.ts # All magic values │ ├── types.ts # TypeScript types │ ├── oauth-success.html # Animated success page │ └── ... ├── config/ │ ├── full-opencode.json # Complete config with variants │ ├── minimal-opencode.json # Basic config │ └── README.md # Config docs ├── test/ # 93 comprehensive tests ├── AGENTS.md # AI maintenance guide └── tsconfig.json # TypeScript config ``` ## 🔄 Migration Notes ### Breaking Changes - Plugin now requires TypeScript compilation (dist/ folder) - Configuration structure enhanced (backward compatible) - OAuth success page replaces plain HTML response ### Upgrade Path 1. Use new config from `config/full-opencode.json` for best experience 2. Or continue with minimal config (uses plugin defaults) 3. Rebuild plugin: `npm run build` ## 📊 Metrics - **Lines of Code**: Modular design with functions < 70 lines - **Test Coverage**: 93 tests covering all functionality - **Type Safety**: Strict TypeScript with no `any` types - **Dependencies**: Still minimal (only @openauthjs/openauth) - **Model Variants**: 9 pre-configured options for users ## 🎨 User Experience - **Codex CLI Parity**: Match official CLI reasoning presets - **Beautiful OAuth**: Professional animated success page - **Clear Documentation**: Step-by-step guides and examples - **Flexible Config**: From minimal to comprehensive setups Co-authored-by: Hanzo Dev <[email protected]>
102 lines
2.8 KiB
TypeScript
102 lines
2.8 KiB
TypeScript
import { logRequest, LOGGING_ENABLED } from "./logger.js";
|
|
import type { SSEEventData } from "./types.js";
|
|
|
|
/**
|
|
* Parse SSE stream to extract final response
|
|
* @param sseText - Complete SSE stream text
|
|
* @returns Final response object or null if not found
|
|
*/
|
|
function parseSseStream(sseText: string): unknown | null {
|
|
const lines = sseText.split('\n');
|
|
|
|
for (const line of lines) {
|
|
if (line.startsWith('data: ')) {
|
|
try {
|
|
const data = JSON.parse(line.substring(6)) as SSEEventData;
|
|
|
|
// Look for response.done event with final data
|
|
if (data.type === 'response.done' || data.type === 'response.completed') {
|
|
return data.response;
|
|
}
|
|
} catch (e) {
|
|
// Skip malformed JSON
|
|
}
|
|
}
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Convert SSE stream response to JSON for generateText()
|
|
* @param response - Fetch response with SSE stream
|
|
* @param headers - Response headers
|
|
* @returns Response with JSON body
|
|
*/
|
|
export async function convertSseToJson(response: Response, headers: Headers): Promise<Response> {
|
|
if (!response.body) {
|
|
throw new Error('[openai-codex-plugin] Response has no body');
|
|
}
|
|
const reader = response.body.getReader();
|
|
const decoder = new TextDecoder();
|
|
let fullText = '';
|
|
|
|
try {
|
|
// Consume the entire stream
|
|
while (true) {
|
|
const { done, value } = await reader.read();
|
|
if (done) break;
|
|
fullText += decoder.decode(value, { stream: true });
|
|
}
|
|
|
|
if (LOGGING_ENABLED) {
|
|
logRequest("stream-full", { fullContent: fullText });
|
|
}
|
|
|
|
// Parse SSE events to extract the final response
|
|
const finalResponse = parseSseStream(fullText);
|
|
|
|
if (!finalResponse) {
|
|
console.error('[openai-codex-plugin] Could not find final response in SSE stream');
|
|
logRequest("stream-error", { error: "No response.done event found" });
|
|
|
|
// Return original stream if we can't parse
|
|
return new Response(fullText, {
|
|
status: response.status,
|
|
statusText: response.statusText,
|
|
headers: headers,
|
|
});
|
|
}
|
|
|
|
// Return as plain JSON (not SSE)
|
|
const jsonHeaders = new Headers(headers);
|
|
jsonHeaders.set('content-type', 'application/json; charset=utf-8');
|
|
|
|
return new Response(JSON.stringify(finalResponse), {
|
|
status: response.status,
|
|
statusText: response.statusText,
|
|
headers: jsonHeaders,
|
|
});
|
|
|
|
} catch (error) {
|
|
console.error('[openai-codex-plugin] Error converting stream:', error);
|
|
logRequest("stream-error", { error: String(error) });
|
|
throw error;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Ensure response has content-type header
|
|
* @param headers - Response headers
|
|
* @returns Headers with content-type set
|
|
*/
|
|
export function ensureContentType(headers: Headers): Headers {
|
|
const responseHeaders = new Headers(headers);
|
|
|
|
if (!responseHeaders.has('content-type')) {
|
|
responseHeaders.set('content-type', 'text/event-stream; charset=utf-8');
|
|
}
|
|
|
|
return responseHeaders;
|
|
}
|