Skip to content

an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions

test(hooks): add hook event contract regression coverage

hsien wei6446a8d856d0
diff --git a/test/hook-event-contract.test.cjs b/test/hook-event-contract.test.cjs
new file mode 100644
index 00000000..83759bc3
--- /dev/null
+++ b/test/hook-event-contract.test.cjs
@@ -0,0 +1,50 @@
+'use strict';
+
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const loadTs = require('./load-ts.cjs');
+
+const { validateHookEvent } = loadTs('src/shared/hookEvents.ts');
+
+test('accepts valid hook event payloads', () => {
+ assert.equal(validateHookEvent({
+ agentId: 'jim-1',
+ event: 'PreToolUse',
+ tool: 'Bash',
+ notificationType: 'permission',
+ source: 'claude',
+ message: 'Running a command',
+ blocked: false
+ }), true);
+});
+
+test('accepts optional agent ids and open provider event names', () => {
+ assert.equal(validateHookEvent({ event: 'Stop' }), true);
+ assert.equal(validateHookEvent({ agentId: 'jim-1', event: 'Unknown' }), true);
+ assert.equal(validateHookEvent({ agentId: 'jim-1', event: 'FutureProviderEvent' }), true);
+});
+
+test('rejects payloads missing a valid event name', () => {
+ assert.equal(validateHookEvent({ agentId: 'jim-1' }), false);
+ assert.equal(validateHookEvent({ agentId: 'jim-1', event: '' }), false);
+ assert.equal(validateHookEvent({ agentId: 'jim-1', event: 42 }), false);
+});
+
+test('rejects malformed optional fields', () => {
+ assert.equal(validateHookEvent({ agentId: '', event: 'Stop' }), false);
+ assert.equal(validateHookEvent({ agentId: 'jim-1', event: 'PreToolUse', tool: 42 }), false);
+ assert.equal(validateHookEvent({ agentId: 'jim-1', event: 'Stop', blocked: 'false' }), false);
+ assert.equal(validateHookEvent(null), false);
+});
+
+test('main and preload share the hook event contract', () => {
+ const root = path.resolve(__dirname, '..');
+ const main = fs.readFileSync(path.join(root, 'src/main/hooks.ts'), 'utf8');
+ const preload = fs.readFileSync(path.join(root, 'src/preload/index.ts'), 'utf8');
+
+ assert.match(main, /validateHookEvent.*shared\/hookEvents|shared\/hookEvents.*validateHookEvent/s);
+ assert.match(preload, /HookEvent.*shared\/hookEvents|shared\/hookEvents.*HookEvent/s);
+ assert.match(preload, /payload: HookEvent/);
+});