Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure
TypeScript
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { verifyRpcToken } from './authToken.js'
const jwtMock = vi.hoisted(() => ({ verify: vi.fn() }))
vi.mock('jsonwebtoken', () => ({
default: { verify: jwtMock.verify },
}))
const BASE_PAYLOAD = {
sub: 'user-1',
typ: 'user',
scopes: ['host:message:invoke'],
hostRefs: ['pro-agent'],
jti: 'rpc-token-1',
iat: 1,
exp: 2,
}
describe('verifyRpcToken access scope binding', () => {
beforeEach(() => jwtMock.verify.mockReset())
it('accepts an explicit user-scoped token without a team id', () => {
jwtMock.verify.mockReturnValue({
...BASE_PAYLOAD,
accessScope: 'user',
teamId: null,
})
expect(verifyRpcToken('token')).toMatchObject({
accessScope: 'user',
teamId: null,
hostRefs: ['pro-agent'],
})
})
it('normalizes a legacy team token to team scope', () => {
jwtMock.verify.mockReturnValue({ ...BASE_PAYLOAD, teamId: 'team-1' })
expect(verifyRpcToken('token')).toMatchObject({
accessScope: 'team',
teamId: 'team-1',
})
})
it('rejects inconsistent scope/team combinations and wildcard hosts', () => {
jwtMock.verify.mockReturnValue({
...BASE_PAYLOAD,
accessScope: 'user',
teamId: 'team-1',
})
expect(verifyRpcToken('token')).toBeNull()
jwtMock.verify.mockReturnValue({
...BASE_PAYLOAD,
accessScope: 'team',
teamId: null,
})
expect(verifyRpcToken('token')).toBeNull()
jwtMock.verify.mockReturnValue({
...BASE_PAYLOAD,
accessScope: 'user',
teamId: null,
hostRefs: ['pro-agent', '*'],
})
expect(verifyRpcToken('token')).toBeNull()
})
})
describe('verifyRpcToken scope allow-list', () => {
beforeEach(() => jwtMock.verify.mockReset())
it('preserves a write-only host:session:write token through the allow-list filter', () => {
jwtMock.verify.mockReturnValue({
...BASE_PAYLOAD,
scopes: ['host:session:write'],
accessScope: 'user',
teamId: null,
})
// Guards the ALLOWED_SCOPES membership of 'host:session:write': dropping it
// there would filter a write-only token down to zero scopes -> null -> 401.
expect(verifyRpcToken('token')).toMatchObject({
scopes: ['host:session:write'],
})
})
it('drops scopes outside the allow-list while keeping the recognized one', () => {
jwtMock.verify.mockReturnValue({
...BASE_PAYLOAD,
scopes: ['host:session:write', 'totally:unknown:scope'],
accessScope: 'user',
teamId: null,
})
expect(verifyRpcToken('token')).toMatchObject({
scopes: ['host:session:write'],
})
})
})