Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import { logger } from '@librechat/data-schemas';
import { buildLangfuseTraceMetadata, resolveLangfuseTraceUserId } from './identity';
const user = {
id: 'user-1',
email: '[email protected]',
username: 'alice',
name: ' Alice ',
role: 'ADMIN',
provider: 'openid',
openidId: 'oidc-sub-1',
};
describe('resolveLangfuseTraceUserId', () => {
it('keeps the SDK default when no field is configured', () => {
expect(resolveLangfuseTraceUserId(undefined, user)).toBeUndefined();
expect(resolveLangfuseTraceUserId({}, user)).toBeUndefined();
});
it('keeps the SDK default when the internal id is selected explicitly', () => {
expect(resolveLangfuseTraceUserId({ userIdField: 'id' }, user)).toBeUndefined();
});
it('selects the configured user field, trimmed', () => {
expect(resolveLangfuseTraceUserId({ userIdField: 'email' }, user)).toBe('[email protected]');
expect(resolveLangfuseTraceUserId({ userIdField: 'name' }, user)).toBe('Alice');
expect(resolveLangfuseTraceUserId({ userIdField: 'openidId' }, user)).toBe('oidc-sub-1');
});
it('falls back to the internal id when the user lacks the configured field, warning once', () => {
const warn = jest.spyOn(logger, 'warn').mockImplementation(() => logger);
expect(resolveLangfuseTraceUserId({ userIdField: 'samlId' }, user)).toBeUndefined();
expect(resolveLangfuseTraceUserId({ userIdField: 'samlId' }, { id: 'user-3' })).toBeUndefined();
expect(warn).toHaveBeenCalledTimes(1);
expect(warn.mock.calls[0][0]).toContain('"samlId"');
warn.mockRestore();
expect(resolveLangfuseTraceUserId({ userIdField: 'email' }, { id: 'user-2' })).toBeUndefined();
expect(
resolveLangfuseTraceUserId({ userIdField: 'email' }, { id: 'user-2', email: ' ' }),
).toBeUndefined();
expect(resolveLangfuseTraceUserId({ userIdField: 'email' }, undefined)).toBeUndefined();
});
it('ignores a field name outside the allowlist that bypassed schema validation', () => {
const warn = jest.spyOn(logger, 'warn').mockImplementation(() => logger);
const trace = { userIdField: 'federatedTokens' as never };
expect(
resolveLangfuseTraceUserId(trace, { ...user, federatedTokens: 'secret' } as never),
).toBeUndefined();
expect(resolveLangfuseTraceUserId(trace, user)).toBeUndefined();
expect(warn).toHaveBeenCalledTimes(1);
expect(warn.mock.calls[0][0]).toContain('not an allowed user field');
warn.mockRestore();
});
});
describe('buildLangfuseTraceMetadata', () => {
const context = {
conversationId: 'convo-1',
endpoint: 'agents',
endpointType: undefined,
provider: 'openAI',
model: 'gpt-5',
modelLabel: '',
spec: 'support-bot',
};
it('skips metadata field names outside the allowlists that bypassed schema validation', () => {
expect(
buildLangfuseTraceMetadata({
trace: {
userMetadataFields: ['federatedTokens', 'email'] as never,
conversationMetadataFields: ['text', 'spec'] as never,
},
user: { ...user, federatedTokens: 'secret' } as never,
context: { ...context, text: 'prompt' } as never,
}),
).toEqual({
'librechat.user.email': '[email protected]',
'librechat.spec': 'support-bot',
});
});
it('exports nothing unless a field is allowlisted', () => {
expect(buildLangfuseTraceMetadata({ trace: undefined, user, context })).toBeUndefined();
expect(buildLangfuseTraceMetadata({ trace: {}, user, context })).toBeUndefined();
expect(
buildLangfuseTraceMetadata({
trace: { userMetadataFields: [], conversationMetadataFields: [] },
user,
context,
}),
).toBeUndefined();
});
it('exports only the allowlisted user fields under librechat.user', () => {
expect(
buildLangfuseTraceMetadata({
trace: { userMetadataFields: ['email', 'role', 'email'] },
user,
context,
}),
).toEqual({
'librechat.user.email': '[email protected]',
'librechat.user.role': 'ADMIN',
});
});
it('exports only the allowlisted request fields under their trace keys', () => {
expect(
buildLangfuseTraceMetadata({
trace: {
conversationMetadataFields: [
'conversationId',
'endpoint',
'endpointType',
'provider',
'model',
'modelLabel',
'spec',
],
},
user,
context,
}),
).toEqual({
'librechat.conversation.id': 'convo-1',
'librechat.endpoint': 'agents',
'librechat.provider': 'openAI',
'librechat.model': 'gpt-5',
'librechat.spec': 'support-bot',
});
});
it('skips blank and missing values instead of exporting empty keys', () => {
expect(
buildLangfuseTraceMetadata({
trace: {
userMetadataFields: ['samlId', 'name'],
conversationMetadataFields: ['modelLabel'],
},
user: { ...user, name: ' ' },
context,
}),
).toBeUndefined();
expect(
buildLangfuseTraceMetadata({
trace: { userMetadataFields: ['email'], conversationMetadataFields: ['model'] },
user: undefined,
context: undefined,
}),
).toBeUndefined();
});
});