@rehamo/telemetry-schema

Rehamo のテレメトリ送信における wire 契約 (Zod スキーマ + anon-token ユーティリティ)。

• テレメトリ送信用イベント (TelemetryEvent) のスキーマ
• 匿名トークン (anon_token) の生成・検証 (FNV-1a チェックサム)

送信側 (rehamo MCP サーバ) と受信側 (このリポジトリの server/) の両方が同じパッケージを import することで、wire 契約の不整合を構造的に防ぎます。

インストール

npm install @rehamo/telemetry-schema zod

使い方

TelemetryEventSchema.parse は構造（型）の検証のみを行います。 anon_token のチェックサム検証は値ドメインの責務として isValidAnonToken に分離してあるので、 untrusted input を扱う受信側では parse 後に明示的に呼び出してください。

import { TelemetryEventSchema, isValidAnonToken, type TelemetryEvent } from '@rehamo/telemetry-schema';

const event: TelemetryEvent = TelemetryEventSchema.parse(payload);
if (!isValidAnonToken(event.anon_token)) {
  throw new Error('invalid anon_token checksum');
}

ライセンス

MIT