Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.
Go agentagenticaichatbotdsh-pluginembeddingsevaluationgenerative-aigolangknowledge-basellmmulti-tenantollamaopenaiquestion-answeringragrerankingsemantic-searchvector-searchwiki
import assert from 'node:assert/strict'
import test from 'node:test'
import {
applyMessageCreatedAt,
bindServerTurnTimestamps,
ensureMessageCreatedAt,
formatMessageTimestamp,
getConversationTimestampModel,
normalizeMessageCreatedAt,
shouldInsertConversationTimestamp,
shouldShowConversationTimestamp,
} from './messageTimestamp'
test('normalizeMessageCreatedAt accepts parseable timestamps and rejects junk', () => {
assert.equal(normalizeMessageCreatedAt('2026-01-02T03:04:05.000Z'), '2026-01-02T03:04:05.000Z')
assert.equal(normalizeMessageCreatedAt(' 2026-01-02T03:04:05.000Z '), '2026-01-02T03:04:05.000Z')
assert.equal(normalizeMessageCreatedAt(''), '')
assert.equal(normalizeMessageCreatedAt(' '), '')
assert.equal(normalizeMessageCreatedAt('not-a-date'), '')
assert.equal(normalizeMessageCreatedAt(undefined), '')
assert.equal(normalizeMessageCreatedAt(1735787045000), '')
})
test('ensureMessageCreatedAt fills a missing timestamp with the provided fallback', () => {
const message: Record<string, unknown> = { role: 'assistant' }
const result = ensureMessageCreatedAt(message, '2026-01-02T03:04:05.000Z')
assert.equal(result, message)
assert.equal(message.created_at, '2026-01-02T03:04:05.000Z')
})
test('ensureMessageCreatedAt replaces empty and invalid local timestamps', () => {
const empty = { created_at: '' }
const blank = { created_at: ' ' }
const invalid = { created_at: 'not-a-date' }
ensureMessageCreatedAt(empty, '2026-01-02T03:04:05.000Z')
ensureMessageCreatedAt(blank, '2026-01-02T03:04:05.000Z')
ensureMessageCreatedAt(invalid, '2026-01-02T03:04:05.000Z')
assert.equal(empty.created_at, '2026-01-02T03:04:05.000Z')
assert.equal(blank.created_at, '2026-01-02T03:04:05.000Z')
assert.equal(invalid.created_at, '2026-01-02T03:04:05.000Z')
})
test('ensureMessageCreatedAt preserves a server timestamp', () => {
const message = { created_at: '2026-02-03T04:05:06.000Z' }
ensureMessageCreatedAt(message, '2026-01-02T03:04:05.000Z')
assert.equal(message.created_at, '2026-02-03T04:05:06.000Z')
})
test('applyMessageCreatedAt overwrites a local fallback with a server timestamp', () => {
const message = { created_at: '2026-01-02T03:04:05.000Z' }
applyMessageCreatedAt(message, '2026-02-03T04:05:06.000Z')
assert.equal(message.created_at, '2026-02-03T04:05:06.000Z')
})
test('applyMessageCreatedAt ignores empty or invalid server candidates', () => {
const message = { created_at: '2026-01-02T03:04:05.000Z' }
applyMessageCreatedAt(message, '')
applyMessageCreatedAt(message, ' ')
applyMessageCreatedAt(message, 'not-a-date')
applyMessageCreatedAt(message, undefined)
assert.equal(message.created_at, '2026-01-02T03:04:05.000Z')
})
test('formatMessageTimestamp renders local time to minute precision', () => {
const localTime = new Date(2026, 0, 2, 3, 4, 5)
assert.equal(formatMessageTimestamp(localTime.toISOString()), '2026-01-02 03:04')
})
test('formatMessageTimestamp converts a UTC string into local wall time', () => {
const utc = '2026-01-02T00:00:00.000Z'
const local = new Date(utc)
const pad = (part: number) => String(part).padStart(2, '0')
const expected = `${local.getFullYear()}-${pad(local.getMonth() + 1)}-${pad(local.getDate())} ${pad(local.getHours())}:${pad(local.getMinutes())}`
assert.equal(formatMessageTimestamp(utc), expected)
assert.notEqual(expected, '')
})
test('bindServerTurnTimestamps replaces local fallbacks with persisted server times', () => {
const user: { role: string; created_at: string; id?: string } = {
role: 'user',
created_at: '2026-01-02T03:04:05.000Z',
}
const assistant = { role: 'assistant', created_at: '2026-01-02T03:04:06.000Z' }
bindServerTurnTimestamps(
[user, assistant],
{
user_message_id: 'user-1',
user_created_at: '2026-01-02T03:05:00.000Z',
assistant_created_at: '2026-01-02T03:05:01.000Z',
},
assistant,
)
assert.equal(user.id, 'user-1')
assert.equal(user.created_at, '2026-01-02T03:05:00.000Z')
assert.equal(assistant.created_at, '2026-01-02T03:05:01.000Z')
})
test('bindServerTurnTimestamps ignores junk and keeps existing user ids', () => {
const user = { id: 'existing-user', role: 'user', created_at: '2026-01-02T03:04:05.000Z' }
const assistant = { role: 'assistant', created_at: '2026-01-02T03:04:06.000Z' }
bindServerTurnTimestamps(
[user, assistant],
{
user_message_id: 'user-1',
user_created_at: 'not-a-date',
assistant_created_at: '',
},
assistant,
)
assert.equal(user.id, 'existing-user')
assert.equal(user.created_at, '2026-01-02T03:04:05.000Z')
assert.equal(assistant.created_at, '2026-01-02T03:04:06.000Z')
})
test('formatMessageTimestamp hides empty and invalid timestamps', () => {
assert.equal(formatMessageTimestamp(''), '')
assert.equal(formatMessageTimestamp(' '), '')
assert.equal(formatMessageTimestamp('not-a-date'), '')
assert.equal(formatMessageTimestamp(undefined), '')
})
test('getConversationTimestampModel classifies today yesterday and older dates', () => {
const now = new Date(2026, 7, 24, 18, 21, 0)
const today = getConversationTimestampModel(new Date(2026, 7, 24, 16, 5, 0).toISOString(), now)
const yesterday = getConversationTimestampModel(new Date(2026, 7, 23, 9, 8, 0).toISOString(), now)
const thisYear = getConversationTimestampModel(new Date(2026, 0, 2, 3, 4, 0).toISOString(), now)
const otherYear = getConversationTimestampModel(new Date(2025, 11, 31, 23, 59, 0).toISOString(), now)
assert.deepEqual(today, {
datetime: new Date(2026, 7, 24, 16, 5, 0).toISOString(),
kind: 'today',
time: '16:05',
year: 2026,
month: 8,
day: 24,
})
assert.equal(yesterday?.kind, 'yesterday')
assert.equal(yesterday?.time, '09:08')
assert.equal(thisYear?.kind, 'thisYear')
assert.equal(thisYear?.month, 1)
assert.equal(thisYear?.day, 2)
assert.equal(otherYear?.kind, 'otherYear')
assert.equal(otherYear?.year, 2025)
assert.equal(getConversationTimestampModel(''), null)
})
test('shouldInsertConversationTimestamp opens a new group on first message and long gaps', () => {
const firstUser = { role: 'user', created_at: new Date(2026, 7, 24, 16, 5, 0).toISOString() }
const assistantSameTurn = { role: 'assistant', created_at: new Date(2026, 7, 24, 16, 5, 20).toISOString() }
const nextUserSoon = { role: 'user', created_at: new Date(2026, 7, 24, 16, 8, 0).toISOString() }
const nextUserLater = { role: 'user', created_at: new Date(2026, 7, 24, 16, 12, 0).toISOString() }
const nextDay = { role: 'user', created_at: new Date(2026, 7, 25, 9, 0, 0).toISOString() }
assert.equal(shouldInsertConversationTimestamp(undefined, firstUser), true)
assert.equal(shouldInsertConversationTimestamp(firstUser, assistantSameTurn), false)
assert.equal(shouldInsertConversationTimestamp(assistantSameTurn, nextUserSoon), false)
assert.equal(shouldInsertConversationTimestamp(assistantSameTurn, nextUserLater), true)
assert.equal(shouldInsertConversationTimestamp(nextUserLater, nextDay), true)
assert.equal(shouldInsertConversationTimestamp(firstUser, { role: 'user', created_at: '' }), false)
})
test('shouldShowConversationTimestamp inserts before the user turn not the assistant reply', () => {
const messages = [
{ role: 'user', created_at: new Date(2026, 7, 24, 16, 5, 0).toISOString() },
{ role: 'assistant', created_at: new Date(2026, 7, 24, 16, 5, 20).toISOString() },
{ role: 'user', created_at: new Date(2026, 7, 24, 17, 0, 0).toISOString() },
{ role: 'assistant', created_at: new Date(2026, 7, 24, 17, 0, 30).toISOString() },
]
assert.equal(shouldShowConversationTimestamp(messages, 0), true)
assert.equal(shouldShowConversationTimestamp(messages, 1), false)
assert.equal(shouldShowConversationTimestamp(messages, 2), true)
assert.equal(shouldShowConversationTimestamp(messages, 3), false)
})