Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
TypeScript
import { describe, expect, mock, test, tier } from 'claude-code/testing'
import Hooks from '../hooks'
import Fixtures from './fixtures'
tier('builtin')
const refusal = `HooksError: reaching: $.telemetry.log: ${Hooks.REFUSED.deny}`
describe('gate', () => {
test(
'the table an engine.create step is handed serves no one above either',
{ plugins: [Fixtures.recording, Fixtures.reaching] },
async ($, on) => {
mock.env(on, Fixtures.SENDING_ENV)
const session = Fixtures.firstPartySession(on)
on('tool.call', () => ({ result: 'read' }))
await $.session.start(Fixtures.STARTED)
await session.clock.advance(1)
await $.tool.call(Fixtures.READ_TOOL)
const during = (await $.command.run(Fixtures.typed('reach', {}))).text
await $.command.run(Fixtures.record(Fixtures.surveyAnswer()))
await session.clock.advance(Hooks.BATCH_WINDOW_MS)
expect({
isServedDuringCreate: during === 'served',
later: session.lines.filter(line => !line.startsWith('telemetry: ')),
rows: Fixtures.rowsOf(session).map(Fixtures.eventNameOf),
}).toEqual({
isServedDuringCreate: false,
later: [`timer: ${refusal}`, `tool: ${refusal}`],
rows: ['tengu_plugin_survey_answered'],
})
},
)
test(
'a module that keeps the table to call later never loads',
{ plugins: [Fixtures.holding] },
async ($, on) => {
mock.env(on, Fixtures.SENDING_ENV)
const session = Fixtures.firstPartySession(on)
const held = await $.command
.run(Fixtures.typed('hold', {}))
.then(result => result.text, String)
await session.clock.advance(Hooks.BATCH_WINDOW_MS)
expect({
isLoaded: !String(held).includes('did not load'),
posts: session.posts,
}).toEqual({ isLoaded: false, posts: [] })
},
)
test(
"a hook above on the collector's stream renames no row, sends none",
{ plugins: [Fixtures.recording, Fixtures.meddling] },
async ($, on) => {
mock.env(on, Fixtures.SENDING_ENV)
const session = Fixtures.firstPartySession(on)
const own = (await $.command.run(Fixtures.typed('meddle', {}))).text
await $.command.run(Fixtures.record(Fixtures.surveyAnswer()))
await session.clock.advance(Hooks.BATCH_WINDOW_MS)
expect({
own,
rows: Fixtures.rowsOf(session).map(Fixtures.eventNameOf),
}).toEqual({
own: `HooksError: meddling: $.telemetry.log: ${Hooks.REFUSED.deny}`,
rows: ['tengu_plugin_survey_answered'],
})
},
)
test(
"a hook above that swallows the collector's stream stops no row",
{ plugins: [Fixtures.recording, Fixtures.swallowing] },
async ($, on) => {
mock.env(on, Fixtures.SENDING_ENV)
const session = Fixtures.firstPartySession(on)
const answer = (
await $.command.run(Fixtures.record(Fixtures.surveyAnswer()))
).text
await session.clock.advance(Hooks.BATCH_WINDOW_MS)
expect({
answer,
posts: session.posts.length,
rows: Fixtures.rowsOf(session).map(Fixtures.eventNameOf),
}).toEqual({
answer: 'queued',
posts: 1,
rows: ['tengu_plugin_survey_answered'],
})
},
)
test(
'a step above cannot hand up its own telemetry in place of this one',
{ plugins: [Fixtures.recording, Fixtures.replacing] },
async ($, on) => {
mock.env(on, Fixtures.SENDING_ENV)
const session = Fixtures.firstPartySession(on)
const own = (await $.command.run(Fixtures.typed('replace', {}))).text
await $.command.run(Fixtures.record(Fixtures.surveyAnswer()))
await session.clock.advance(Hooks.BATCH_WINDOW_MS)
expect({
own,
rows: Fixtures.rowsOf(session).map(Fixtures.eventNameOf),
}).toEqual({
own: `HooksError: replacing: $.telemetry.log: ${Hooks.REFUSED.deny}`,
rows: ['tengu_plugin_survey_answered'],
})
},
)
test(
'a hook on every event cannot turn a row to the other destination',
{ plugins: [Fixtures.recording, Fixtures.sweeping] },
async ($, on) => {
mock.env(on, Fixtures.SENDING_ENV)
const session = Fixtures.firstPartySession(on)
await $.session.start(Fixtures.STARTED)
const answer = (
await $.command.run(Fixtures.record(Fixtures.surveyAnswer()))
).text
await session.clock.advance(Hooks.BATCH_WINDOW_MS)
expect({
answer,
posts: session.posts.length,
rows: Fixtures.rowsOf(session),
}).toEqual({
answer: 'queued',
posts: 1,
rows: [Fixtures.EXPECTED_ROW],
})
},
)
test(
'what a hook on every event adds beside a row never leaves in it',
{ plugins: [Fixtures.recording, Fixtures.annotating] },
async ($, on) => {
mock.env(on, Fixtures.SENDING_ENV)
const session = Fixtures.firstPartySession(on)
await $.session.start(Fixtures.STARTED)
const answer = (
await $.command.run(Fixtures.record(Fixtures.surveyAnswer()))
).text
await session.clock.advance(Hooks.BATCH_WINDOW_MS)
expect({
answer,
posts: session.posts.length,
rows: Fixtures.rowsOf(session),
}).toEqual({
answer: 'queued',
posts: 1,
rows: [Fixtures.EXPECTED_ROW],
})
},
)
})