Import packages/protocol/tests/protocol.test.ts
This commit is contained in:
parent
2b795ecd71
commit
c18e4fc411
|
|
@ -0,0 +1,146 @@
|
|||
import { describe, expect, it } from 'vitest'
|
||||
import {
|
||||
SECURE_FRAGMENT_CHUNK_BYTES,
|
||||
SecureMessageCodec,
|
||||
createEvent,
|
||||
createRpcError,
|
||||
createRpcRequest,
|
||||
decodeMessage,
|
||||
encodeMessage,
|
||||
parseRemoteMessage,
|
||||
remoteEvents,
|
||||
rpcMethods,
|
||||
harnessTransportDescriptionSchema,
|
||||
helloPayloadSchema,
|
||||
MAX_REMOTE_CAPABILITY_ENTRIES,
|
||||
MAX_REMOTE_WORKSPACE_TYPE_ENTRIES,
|
||||
parseRemoteWorkspaceTypes,
|
||||
remoteWorkspaceTypeDescriptionSchema,
|
||||
selectCapabilities,
|
||||
selectProtocolVersion,
|
||||
} from '../src/index.js'
|
||||
|
||||
describe('protocol envelope', () => {
|
||||
it('round-trips RPC messages', () => {
|
||||
const message = createRpcRequest('harness.api.call', { method: 'session.list', rpcId: 'native-1', payload: {} })
|
||||
expect(decodeMessage(encodeMessage(message))).toEqual(message)
|
||||
})
|
||||
|
||||
it('advertises the native Harness bridge as closed protocol methods and events', () => {
|
||||
expect(rpcMethods).toContain('harness.api.call')
|
||||
expect(rpcMethods).toContain('harness.api.transfer.open')
|
||||
expect(rpcMethods).toContain('harness.api.stream.open')
|
||||
expect(rpcMethods).toContain('fileviewer.call')
|
||||
expect(remoteEvents).toContain('harness.api.frame')
|
||||
expect(remoteEvents).toContain('harness.api.stream.closed')
|
||||
})
|
||||
|
||||
it('keeps Codex as an explicit Remote domain instead of a Harness session method', () => {
|
||||
expect(rpcMethods).toContain('codex.app.call')
|
||||
expect(rpcMethods).toContain('codex.app.transfer.commit')
|
||||
expect(remoteEvents).toContain('codex.app.frame')
|
||||
expect(remoteEvents).toContain('codex.app.stream.closed')
|
||||
expect(rpcMethods).not.toContain('harness.api.codex')
|
||||
})
|
||||
|
||||
it('rejects unsupported protocol versions', () => {
|
||||
expect(() => parseRemoteMessage({ v: 2, id: 'x', type: 'rpc.request', timestamp: Date.now(), payload: {} })).toThrow()
|
||||
})
|
||||
|
||||
it('selects the highest common hello protocol version', () => {
|
||||
expect(selectProtocolVersion([1])).toBe(1)
|
||||
expect(selectProtocolVersion([1, 3, 2], [1, 2])).toBe(2)
|
||||
expect(selectProtocolVersion([2, 3])).toBeUndefined()
|
||||
})
|
||||
|
||||
it('negotiates LAN independently from internet P2P', () => {
|
||||
expect(selectCapabilities(
|
||||
['transport.lan', 'transport.p2p'],
|
||||
['transport.lan'],
|
||||
)).toEqual(['transport.lan'])
|
||||
})
|
||||
|
||||
it('carries event metadata and retryable RPC errors', () => {
|
||||
expect(createEvent('harness.api.frame', { streamId: 's1', frame: {} }, { seq: 7, sessionId: 's1' })).toMatchObject({
|
||||
payload: { seq: 7, sessionId: 's1', event: 'harness.api.frame' },
|
||||
})
|
||||
expect(createRpcError('r1', 'RATE_LIMITED', 'Busy', undefined, true)).toMatchObject({
|
||||
payload: { requestId: 'r1', retryable: true },
|
||||
})
|
||||
expect(createRpcRequest('harness.api.stream.close', { streamId: 'stream-1' }).payload.method).toBe('harness.api.stream.close')
|
||||
})
|
||||
|
||||
it('fragments large Noise plaintext and reassembles it with strict ordering', () => {
|
||||
const source = Uint8Array.from(
|
||||
{ length: SECURE_FRAGMENT_CHUNK_BYTES * 2 + 37 },
|
||||
(_, index) => index % 251,
|
||||
)
|
||||
const encoder = new SecureMessageCodec()
|
||||
const frames = encoder.encode(source)
|
||||
expect(frames).toHaveLength(3)
|
||||
expect(frames.every(frame => frame.byteLength < 65_519)).toBe(true)
|
||||
|
||||
const decoder = new SecureMessageCodec()
|
||||
expect(decoder.decode(frames[0]!)).toBeUndefined()
|
||||
expect(decoder.decode(frames[1]!)).toBeUndefined()
|
||||
expect(decoder.decode(frames[2]!)).toEqual(source)
|
||||
|
||||
const outOfOrder = new SecureMessageCodec()
|
||||
expect(() => outOfOrder.decode(frames[1]!)).toThrow('Secure fragment sequence is invalid.')
|
||||
const small = new TextEncoder().encode('small message')
|
||||
expect(new SecureMessageCodec().decode(encoder.encode(small)[0]!)).toEqual(small)
|
||||
})
|
||||
|
||||
it('validates and safely parses structured workspace type descriptions', () => {
|
||||
const valid = {
|
||||
id: 'codex',
|
||||
name: 'CodeX',
|
||||
capability: 'codex.appserver.v1',
|
||||
available: true,
|
||||
}
|
||||
expect(remoteWorkspaceTypeDescriptionSchema.parse(valid)).toEqual(valid)
|
||||
|
||||
// Valid transport description with workspaceTypes
|
||||
const transportDesc = {
|
||||
capabilities: ['transport.relay', 'codex.appserver.v1'],
|
||||
workspaceTypes: [valid],
|
||||
}
|
||||
expect(harnessTransportDescriptionSchema.parse(transportDesc)).toEqual(transportDesc)
|
||||
|
||||
// Robust parsing of malformed workspaceTypes
|
||||
expect(parseRemoteWorkspaceTypes(undefined)).toEqual([])
|
||||
expect(parseRemoteWorkspaceTypes(null)).toEqual([])
|
||||
expect(parseRemoteWorkspaceTypes('not an array')).toEqual([])
|
||||
expect(parseRemoteWorkspaceTypes([
|
||||
valid,
|
||||
{ id: 'bad' }, // missing name, capability, available
|
||||
{ id: 123, name: 'Invalid', capability: 'codex.appserver.v1', available: true },
|
||||
null,
|
||||
'just a string',
|
||||
])).toEqual([valid])
|
||||
})
|
||||
|
||||
it('bounds remote capability collections before validating every child', () => {
|
||||
const oversizedCapabilities = Array.from({ length: MAX_REMOTE_CAPABILITY_ENTRIES + 1 }, () => 123)
|
||||
for (const parse of [
|
||||
() => helloPayloadSchema.parse({
|
||||
role: 'client', deviceId: 'client-1', accessToken: 'token-1', protocols: [1],
|
||||
capabilities: oversizedCapabilities,
|
||||
}),
|
||||
() => harnessTransportDescriptionSchema.parse({ capabilities: oversizedCapabilities }),
|
||||
]) {
|
||||
try {
|
||||
parse()
|
||||
throw new Error('expected oversized capabilities to be rejected')
|
||||
} catch (error) {
|
||||
expect(error).toMatchObject({ issues: expect.arrayContaining([expect.any(Object)]) })
|
||||
expect((error as { issues: unknown[] }).issues).toHaveLength(1)
|
||||
}
|
||||
}
|
||||
|
||||
const oversizedWorkspaceTypes = Array.from({ length: MAX_REMOTE_WORKSPACE_TYPE_ENTRIES + 1 }, () => ({
|
||||
id: 'bad', name: 'bad', capability: 'bad', available: true,
|
||||
}))
|
||||
expect(parseRemoteWorkspaceTypes(oversizedWorkspaceTypes)).toEqual([])
|
||||
})
|
||||
})
|
||||
Loading…
Reference in New Issue