Files
gemini-nexus/src/tests/unit/proxy-retry-mock.test.ts
T

695 lines
23 KiB
TypeScript

import { beforeEach, describe, it, expect, vi } from 'vitest';
import { EventEmitter } from 'events';
import { ProxyService } from '../../server/modules/proxy/proxy.service';
import { Observable } from 'rxjs';
// Mock dependencies
const mockTokenManager = {
getNextToken: vi.fn(),
markAsRateLimited: vi.fn(),
markAsForbidden: vi.fn(),
markFromUpstreamError: vi.fn(),
recordParityError: vi.fn(),
getModelOutputLimitForAccount: vi.fn(),
getModelThinkingBudgetForAccount: vi.fn(),
resolveDynamicModelForAccount: vi.fn((_token: unknown, model: string) => model),
};
const mockGeminiClient = { streamGenerateInternal: vi.fn(), generateInternal: vi.fn() };
// Subclass to access private method
class TestableProxyService extends ProxyService {
constructor() {
super(mockTokenManager as any, mockGeminiClient as any);
}
public testProcessStream(stream: any, model: string = 'model'): Observable<string> {
// Access private method using type assertion
return (this as any).processAnthropicInternalStream(stream, model);
}
public testPassthroughStream(stream: any): Observable<string> {
return (this as any).passthroughSseStream(stream);
}
public testModelHeaders(model: string): Record<string, string> {
return (this as any).createModelSpecificHeaders(model);
}
}
function createToken(id: string = 'acc-1') {
return {
id,
email: `${id}@test.com`,
token: {
access_token: 'token',
refresh_token: 'refresh',
expires_in: 3600,
expiry_timestamp: Math.floor(Date.now() / 1000) + 3600,
project_id: 'project-1',
session_id: 'session-1',
upstream_proxy_url: undefined,
},
};
}
describe('ProxyService Empty Stream Retry Logic', () => {
beforeEach(() => {
vi.clearAllMocks();
});
it('classifies retry matrix consistently', () => {
const service = new TestableProxyService();
const classify = (message: string) => (service as any).classifyUpstreamFailure(message);
expect(classify('401 unauthorized token')).toEqual({
retry: true,
markAsForbidden: true,
markAsRateLimited: false,
});
expect(classify('403 permission_denied')).toEqual({
retry: true,
markAsForbidden: true,
markAsRateLimited: false,
});
expect(classify('429 quota exceeded')).toEqual({
retry: true,
markAsForbidden: false,
markAsRateLimited: true,
});
expect(classify('500 internal error')).toEqual({
retry: true,
markAsForbidden: false,
markAsRateLimited: false,
});
expect(classify('400 invalid argument')).toEqual({
retry: false,
markAsForbidden: false,
markAsRateLimited: false,
});
});
it('builds Claude-specific beta headers consistently', () => {
const service = new TestableProxyService();
const claudeHeaders = service.testModelHeaders('claude-sonnet-4-5');
const geminiHeaders = service.testModelHeaders('gemini-2.5-flash');
expect(claudeHeaders['anthropic-beta']).toContain('claude-code-20250219');
expect(geminiHeaders).toEqual({});
});
it('should emit error when stream ends without data', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const resultObservable = service.testProcessStream(stream);
let errorReceived: Error | undefined;
const promise = new Promise<void>((resolve) => {
resultObservable.subscribe({
next: () => {},
error: (err) => {
errorReceived = err;
resolve();
},
complete: () => resolve(),
});
});
// Simulate empty stream: straight to end
setTimeout(() => stream.emit('end'), 10);
await promise;
expect(errorReceived).toBeDefined();
expect(errorReceived?.message).toBe('Empty response stream');
});
it('should NOT emit error when stream has data', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const resultObservable = service.testProcessStream(stream);
let errorReceived: Error | undefined;
const receivedChunks: string[] = [];
const promise = new Promise<void>((resolve) => {
resultObservable.subscribe({
next: (c) => receivedChunks.push(c),
error: (err) => {
errorReceived = err;
resolve();
},
complete: () => resolve(),
});
});
// Simulate valid data stream
setTimeout(() => {
const validJson = JSON.stringify({
candidates: [
{
content: { parts: [{ text: 'hello' }] },
finishReason: 'STOP',
},
],
});
stream.emit('data', Buffer.from(`data: ${validJson}\n\n`));
stream.emit('end');
}, 10);
await promise;
expect(errorReceived).toBeUndefined();
// It should produce chunks (though exact number depends on mapper logic, at least it shouldn't error)
// Actually our mapper might produce "message_start", "content_block_start" etc.
// We just care that it didn't error with "Empty response stream"
});
it('falls back to stream aggregation when non-stream response is empty', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
mockGeminiClient.generateInternal.mockResolvedValueOnce({ candidates: [] });
mockGeminiClient.streamGenerateInternal.mockResolvedValueOnce(stream);
const promise = (service as any).generateInternalWithStreamFallback(
{ model: 'gemini-2.5-flash' },
'token',
undefined,
);
setTimeout(() => {
const payload = JSON.stringify({
candidates: [
{
content: { parts: [{ text: 'fallback text' }] },
finishReason: 'STOP',
},
],
usageMetadata: { totalTokenCount: 5 },
});
stream.emit('data', Buffer.from(`data: ${payload}\n\n`));
stream.emit('end');
}, 10);
const result = await promise;
expect(mockGeminiClient.streamGenerateInternal).toHaveBeenCalledOnce();
expect(result.candidates[0].content.parts[0].text).toBe('fallback text');
expect(result.candidates[0].finishReason).toBe('STOP');
});
it('injects Claude beta headers when handling Gemini-compatible Claude models', async () => {
const service = new TestableProxyService();
mockTokenManager.getNextToken.mockResolvedValue(createToken());
mockGeminiClient.generateInternal.mockResolvedValue({
candidates: [{ content: { parts: [{ text: 'ok' }] } }],
});
await service.handleGeminiGenerateContent('models/claude-sonnet-4-5', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
const headers = mockGeminiClient.generateInternal.mock.calls[0][3];
expect(headers['anthropic-beta']).toContain('claude-code-20250219');
});
it('tolerates malformed partial chunks and still completes Anthropic stream', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const resultObservable = service.testProcessStream(stream);
let completed = false;
let errored = false;
const done = new Promise<void>((resolve) => {
resultObservable.subscribe({
next: () => {},
error: () => {
errored = true;
resolve();
},
complete: () => {
completed = true;
resolve();
},
});
});
setTimeout(() => {
stream.emit('data', Buffer.from('data: {"invalid_json":\n\n'));
const validPayload = JSON.stringify({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
});
stream.emit('data', Buffer.from(`data: ${validPayload}\n\n`));
stream.emit('end');
}, 10);
await done;
expect(errored).toBe(false);
expect(completed).toBe(true);
});
it('raises error for empty Gemini passthrough stream', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const observable = service.testPassthroughStream(stream);
let errorMessage = '';
const done = new Promise<void>((resolve) => {
observable.subscribe({
next: () => {},
error: (error: Error) => {
errorMessage = error.message;
resolve();
},
complete: () => resolve(),
});
});
setTimeout(() => stream.emit('end'), 10);
await done;
expect(errorMessage).toBe('Empty response stream');
});
it('propagates Anthropic stream interruption errors', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const observable = service.testProcessStream(stream);
let errorMessage = '';
const done = new Promise<void>((resolve) => {
observable.subscribe({
next: () => {},
error: (error: Error) => {
errorMessage = error.message;
resolve();
},
complete: () => resolve(),
});
});
setTimeout(() => stream.emit('error', new Error('upstream interrupted')), 10);
await done;
expect(errorMessage).toBe('upstream interrupted');
});
it('propagates Gemini passthrough interruption errors', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const observable = service.testPassthroughStream(stream);
let errorMessage = '';
const done = new Promise<void>((resolve) => {
observable.subscribe({
next: () => {},
error: (error: Error) => {
errorMessage = error.message;
resolve();
},
complete: () => resolve(),
});
});
setTimeout(() => stream.emit('error', new Error('connection reset by peer')), 10);
await done;
expect(errorMessage).toBe('connection reset by peer');
});
it('retries OpenAI flow with the same error classification matrix', async () => {
const service = new TestableProxyService();
const token1 = createToken('acc-1');
const token2 = createToken('acc-2');
mockTokenManager.getNextToken.mockResolvedValueOnce(token1).mockResolvedValueOnce(token2);
mockGeminiClient.generateInternal
.mockRejectedValueOnce(new Error('429 quota exceeded'))
.mockResolvedValueOnce({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
usageMetadata: { totalTokenCount: 5 },
});
const result = await service.handleChatCompletions({
model: 'gpt-4o',
stream: false,
messages: [{ role: 'user', content: 'hello' }],
} as any);
expect(mockTokenManager.getNextToken).toHaveBeenCalledTimes(2);
expect(mockTokenManager.markAsRateLimited).toHaveBeenCalledWith('acc-1');
expect((result as any).choices?.[0]?.message?.content).toBeDefined();
});
it('retries Anthropic flow with the same error classification matrix', async () => {
const service = new TestableProxyService();
const token1 = createToken('acc-1');
const token2 = createToken('acc-2');
mockTokenManager.getNextToken.mockResolvedValueOnce(token1).mockResolvedValueOnce(token2);
mockGeminiClient.generateInternal
.mockRejectedValueOnce(new Error('429 rate limit exceeded'))
.mockResolvedValueOnce({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
usageMetadata: { totalTokenCount: 5 },
});
const result = await service.handleAnthropicMessages({
model: 'claude-sonnet-4-5',
stream: false,
max_tokens: 256,
messages: [{ role: 'user', content: 'hello' }],
} as any);
expect(mockTokenManager.getNextToken).toHaveBeenCalledTimes(2);
expect(mockTokenManager.markAsRateLimited).toHaveBeenCalledWith('acc-1');
expect((result as any).type).toBe('message');
});
it('retries Gemini flow with the same error classification matrix', async () => {
const service = new TestableProxyService();
const token1 = createToken('acc-1');
const token2 = createToken('acc-2');
mockTokenManager.getNextToken.mockResolvedValueOnce(token1).mockResolvedValueOnce(token2);
mockGeminiClient.generateInternal
.mockRejectedValueOnce(new Error('429 quota exceeded'))
.mockResolvedValueOnce({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
usageMetadata: { totalTokenCount: 5 },
});
const result = await service.handleGeminiGenerateContent('models/gemini-2.5-flash', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
expect(mockTokenManager.getNextToken).toHaveBeenCalledTimes(2);
expect(mockTokenManager.markAsRateLimited).toHaveBeenCalledWith('acc-1');
expect((result as any).candidates?.[0]?.content?.parts?.[0]?.text).toBe('ok');
});
it('does not include sessionId in Gemini internal generate payload', async () => {
const service = new TestableProxyService();
mockTokenManager.getNextToken.mockResolvedValue(createToken('acc-1'));
mockGeminiClient.generateInternal.mockResolvedValue({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
usageMetadata: { totalTokenCount: 5 },
});
await service.handleGeminiGenerateContent('models/gemini-2.5-flash', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
const internalPayload = mockGeminiClient.generateInternal.mock.calls[0][0];
expect(internalPayload).not.toHaveProperty('sessionId');
});
it('normalizes Gemini 3.1 preview alias to Gemini 3.1 Pro High for upstream', async () => {
const service = new TestableProxyService();
mockTokenManager.getNextToken.mockResolvedValue(createToken('acc-1'));
mockGeminiClient.generateInternal.mockResolvedValue({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
usageMetadata: { totalTokenCount: 5 },
});
await service.handleGeminiGenerateContent('models/gemini-3.1-pro-preview', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
const internalPayload = mockGeminiClient.generateInternal.mock.calls[0][0];
expect(internalPayload.model).toBe('gemini-3.1-pro-high');
});
it('strips non-parity Gemini usage metadata fields', async () => {
const service = new TestableProxyService();
mockTokenManager.getNextToken.mockResolvedValue(createToken('acc-1'));
mockGeminiClient.generateInternal.mockResolvedValue({
candidates: [
{
content: { role: 'model', parts: [{ text: 'ok' }] },
finishReason: 'STOP',
},
],
usageMetadata: {
promptTokenCount: 1,
candidatesTokenCount: 2,
totalTokenCount: 3,
thoughtsTokenCount: 4,
},
responseId: 'resp_123',
createTime: '2026-02-10T00:00:00.000Z',
});
const result = await service.handleGeminiGenerateContent('models/gemini-2.5-flash', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
expect((result as any).usageMetadata).toEqual({
promptTokenCount: 1,
candidatesTokenCount: 2,
totalTokenCount: 3,
});
expect((result as any).usageMetadata.thoughtsTokenCount).toBeUndefined();
});
it('retries Gemini generate-content without project when project context is invalid', async () => {
const service = new TestableProxyService();
mockTokenManager.getNextToken.mockResolvedValue(createToken('acc-1'));
mockGeminiClient.generateInternal
.mockRejectedValueOnce(
new Error(
'You are currently configured to use a Google Cloud Project but lack a Gemini Code Assist license. (#3501)',
),
)
.mockResolvedValueOnce({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
usageMetadata: { totalTokenCount: 5 },
});
const result = await service.handleGeminiGenerateContent('models/gemini-2.5-flash', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
expect(mockTokenManager.getNextToken).toHaveBeenCalledTimes(1);
expect(mockGeminiClient.generateInternal).toHaveBeenCalledTimes(2);
expect(mockGeminiClient.generateInternal.mock.calls[0][0].project).toBe('project-1');
expect(mockGeminiClient.generateInternal.mock.calls[1][0].project).toBeUndefined();
expect(mockGeminiClient.generateInternal.mock.calls[1][0]).not.toHaveProperty('project');
expect((result as any).candidates?.[0]?.content?.parts?.[0]?.text).toBe('ok');
});
it('omits empty project id in Gemini internal payload', async () => {
const service = new TestableProxyService();
const token = createToken('acc-1');
token.token.project_id = '';
mockTokenManager.getNextToken.mockResolvedValue(token);
mockGeminiClient.generateInternal.mockResolvedValue({
candidates: [{ content: { parts: [{ text: 'ok' }] }, finishReason: 'STOP' }],
usageMetadata: { totalTokenCount: 5 },
});
await service.handleGeminiGenerateContent('models/gemini-2.5-flash', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
const internalPayload = mockGeminiClient.generateInternal.mock.calls[0][0];
expect(internalPayload.project).toBeUndefined();
expect(internalPayload).not.toHaveProperty('project');
});
it('uses generate-content requestType for Gemini stream internal payload', async () => {
const service = new TestableProxyService();
mockTokenManager.getNextToken.mockResolvedValue(createToken('acc-1'));
mockGeminiClient.streamGenerateInternal.mockResolvedValue(new EventEmitter());
await service.handleGeminiStreamGenerateContent('models/gemini-2.5-flash', {
contents: [{ role: 'user', parts: [{ text: 'hello' }] }],
} as any);
const internalPayload = mockGeminiClient.streamGenerateInternal.mock.calls[0][0];
expect(internalPayload.requestType).toBe('generate-content');
});
});
describe('ProxyService Protocol Parity Fixtures', () => {
it('maps OpenAI request to Anthropic request with tools and tool result', () => {
const service = new TestableProxyService();
const openaiRequest = {
model: 'claude-sonnet-4-5',
stream: false,
temperature: 0.2,
max_tokens: 512,
tools: [
{
type: 'function',
function: {
name: 'search_docs',
description: 'Search docs',
parameters: {
type: 'object',
properties: {
query: { type: 'string' },
},
},
},
},
],
messages: [
{ role: 'system', content: 'You are a precise assistant.' },
{ role: 'user', content: [{ type: 'text', text: 'Find API key docs' }] },
{
role: 'assistant',
content: 'Calling search tool',
tool_calls: [
{
id: 'call_1',
type: 'function',
function: {
name: 'search_docs',
arguments: '{"query":"api key"}',
},
},
],
},
{
role: 'tool',
tool_call_id: 'call_1',
name: 'search_docs',
content: 'Found 3 results',
},
],
};
const anthropicRequest = (service as any).convertOpenAIToClaude(openaiRequest);
expect(anthropicRequest.system).toContain('You are a precise assistant.');
expect(anthropicRequest.tools?.[0]?.name).toBe('search_docs');
expect(anthropicRequest.messages.length).toBe(3);
const assistantMessage = anthropicRequest.messages[1];
expect(Array.isArray(assistantMessage.content)).toBe(true);
expect(assistantMessage.content.some((block: any) => block.type === 'tool_use')).toBe(true);
const toolResultMessage = anthropicRequest.messages[2];
expect(toolResultMessage.role).toBe('user');
expect(Array.isArray(toolResultMessage.content)).toBe(true);
expect(toolResultMessage.content[0].type).toBe('tool_result');
});
it('maps Anthropic response to OpenAI response with reasoning and tool_calls', () => {
const service = new TestableProxyService();
const anthropicResponse = {
content: [
{ type: 'thinking', thinking: 'Need to call tool first.' },
{
type: 'tool_use',
id: 'tool-1',
name: 'search_docs',
input: { query: 'api key' },
},
{ type: 'text', text: 'Here are the docs.' },
],
stop_reason: 'tool_use',
usage: {
input_tokens: 20,
output_tokens: 30,
},
};
const openaiResponse = (service as any).convertClaudeToOpenAIResponse(
anthropicResponse,
'gpt-4o-mini',
);
expect(openaiResponse.model).toBe('gpt-4o-mini');
expect(openaiResponse.choices[0].message.role).toBe('assistant');
expect(openaiResponse.choices[0].message.reasoning_content).toContain('Need to call tool');
expect(openaiResponse.choices[0].message.tool_calls?.length).toBe(1);
expect(openaiResponse.choices[0].finish_reason).toBe('tool_calls');
});
it('converts internal SSE stream into OpenAI SSE chunks', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const observable = (service as any).processStreamResponse(stream, 'gpt-4o-mini');
const chunks: string[] = [];
await new Promise<void>((resolve, reject) => {
observable.subscribe({
next: (chunk: string) => {
chunks.push(chunk);
},
error: reject,
complete: resolve,
});
const payload = JSON.stringify({
candidates: [
{
content: {
parts: [
{ thought: true, text: 'reasoning text' },
{ functionCall: { id: 'fc1', name: 'search_docs', args: { query: 'api key' } } },
{ text: 'final answer' },
],
},
finishReason: 'STOP',
},
],
});
stream.emit('data', Buffer.from(`data: ${payload}\n`));
stream.emit('end');
});
const output = chunks.join('');
expect(output).toContain('"reasoning_content":"reasoning text"');
expect(output).toContain('"tool_calls"');
expect(output).toContain('"content":"final answer"');
expect(output).toContain('data: [DONE]');
});
it('propagates OpenAI-compatible upstream stream errors instead of completing with [DONE]', async () => {
const service = new TestableProxyService();
const stream = new EventEmitter();
const observable = (service as any).processStreamResponse(stream, 'gpt-4o-mini');
const chunks: string[] = [];
const streamResult = await new Promise<{ error?: Error; completed: boolean }>((resolve) => {
observable.subscribe({
next: (chunk: string) => {
chunks.push(chunk);
},
error: (error: unknown) =>
resolve({
completed: false,
error: error instanceof Error ? error : new Error(String(error)),
}),
complete: () => resolve({ completed: true }),
});
const payload = JSON.stringify({
candidates: [
{
content: {
parts: [{ text: 'partial output' }],
},
},
],
});
stream.emit('data', Buffer.from(`data: ${payload}\n`));
stream.emit('error', new Error('socket hang up'));
});
expect(streamResult.completed).not.toBe(true);
expect(streamResult.error?.message).toContain('socket hang up');
expect(chunks.join('')).toContain('"content":"partial output"');
expect(chunks.join('')).not.toContain('data: [DONE]');
});
});