@aiquants/daily-report 0.12.4 → 0.13.0

package/src/shared/sse-schema.ts

@@ -103,6 +103,18 @@ export const statusUpdateMessageSchema = z.object({
     recipientRawUserId: z.number().optional(),
 })
 
+/**
+ * 親日報の区分 (sourceType)。受信側の可視性フィルタ専用。
+ *
+ * ❗ `.optional()` は必須。SSE の実体は永続 Redis Stream (MAXLEN 保持) であり、このフィールドを
+ * 載せる前に publish された**旧エントリが配備をまたいで残る**。必須にすると共有リーダーの
+ * 再生と再接続クライアントの catch-up が fail-closed で全て捨てられ、更新が永久に届かなくなる。
+ *
+ * `recipientRawUserId` と異なりクライアントへ**除去せず転送する**。フィルタを通過した時点で
+ * その区分は当該閲覧者に可視であり、`sourceType` は一覧・詳細で既に開示済みのため漏洩しない。
+ */
+const sseSourceTypeSchema = z.string().optional()
+
 export const commentAddMessageSchema = z.object({
     type: z.literal("comment-add"),
     reportHubId: z.number(),
@@ -111,6 +123,7 @@ export const commentAddMessageSchema = z.object({
     // 下書き日報のコメントは所有者以外に見えてはならない (本文の全員配信を防ぐ)。
     // サーバーサイドフィルタ専用で、SSE ルートがフィルタ後に除去する
     recipientRawUserId: z.number().optional(),
+    sourceType: sseSourceTypeSchema,
 })
 
 export const commentDeleteMessageSchema = z.object({
@@ -120,6 +133,7 @@ export const commentDeleteMessageSchema = z.object({
     clientTempId: z.string(),
     // comment-add と同じ理由の宛先フィルタ
     recipientRawUserId: z.number().optional(),
+    sourceType: sseSourceTypeSchema,
 })
 
 export const reportCreateMessageSchema = z.object({
@@ -150,6 +164,7 @@ export const reportDeleteMessageSchema = z.object({
     type: z.literal("report-delete"),
     reportHubId: z.number(),
     clientTempId: z.string(),
+    sourceType: sseSourceTypeSchema,
 })
 
 // --- Discriminated Union ---