多対多なPub-Subの場合はどこに仕様を記載するのか

例えば、同じ foo イベント名に対して複数の購読者(Subscriber)が設定されている場合、

emitter.on('foo', function({ x, y }) {
  // do stuff
});

emitter.on('foo', function({ y, z }) {
  // do stuff
});

イベント名 foo が発行もしくは購読する全引数 x, y, z を満たす実装は基本的にどこにも無い。
だから仕様を書く場所が無い。

聞いた管理手法だと：

・テストに残す
・別ドキュメントに残す

というのがあるが、まぁ状況によっては期待できないこともあるだろう。

コールバックの型を検証するような高階関数を介すのがいいのだろうか？