@aiquants/daily-report 0.7.0 → 0.9.0

package/src/shared/ids-stream.ts

@@ -0,0 +1,139 @@
+/**
+ * Wire contract and ordering helpers for the daily-report ids NDJSON stream.
+ * 日報 ID 一覧 NDJSON ストリームのワイヤ契約と並び順ヘルパー。
+ *
+ * サーバーは `GET {apiBasePath}/ids-stream` で 1 行 1 JSON の NDJSON を返す。
+ * 行は原則 {@link DailyReportIdsStreamChunkLine} で、送出中に予期しない失敗が
+ * 起きた場合のみ {@link DailyReportIdsStreamErrorLine} を 1 行流して正常クローズする
+ * (クライアントは「isLast 無しで終端」を再開シグナルとして扱う)。
+ *
+ * 並び順は SQL の `ORDER BY business_date DESC, id DESC` (MSSQL の DESC は NULL を
+ * 末尾に置く) と完全一致させる。カーソル再開はこの全順序に対する「厳密に後」の
+ * 位置からのスライスとして定義する。
+ */
+import type { DailyReportItem } from "./types"
+
+/** ストリーム再開カーソル。直前チャンク末尾アイテムの並び順キー。 */
+export type DailyReportIdsStreamCursor = {
+    /** 営業日 (YYYY-MM-DD)。null は「営業日なし領域」(並び順の末尾) を表す。 */
+    businessDate: string | null
+    /** 日報 Hub ID。 */
+    reportHubId: number
+}
+
+/** データを運ぶ NDJSON 行。 */
+export type DailyReportIdsStreamChunkLine = {
+    /** このチャンクのアイテム群 (並び順どおり)。 */
+    items: DailyReportItem[]
+    /** 次チャンクの再開カーソル。最終チャンクでは null。 */
+    nextCursor: DailyReportIdsStreamCursor | null
+    /** これが最終チャンクかどうか。 */
+    isLast: boolean
+    /** 全体件数。接続ごとの先頭行にのみ載る。 */
+    total?: number
+}
+
+/** サーバー側の予期しない失敗を伝える NDJSON 行 (内部情報は含めない)。 */
+export type DailyReportIdsStreamErrorLine = {
+    error: string
+}
+
+/** NDJSON 1 行のユニオン。 */
+export type DailyReportIdsStreamLine = DailyReportIdsStreamChunkLine | DailyReportIdsStreamErrorLine
+
+/**
+ * Type guard for chunk lines (anything else is treated as an error line).
+ * チャンク行の型ガード (それ以外はエラー行として扱う)。
+ *
+ * @param line Parsed NDJSON line. パース済みの NDJSON 行。
+ * @returns True when the line carries items. アイテムを運ぶ行なら true。
+ */
+export const isIdsStreamChunkLine = (line: unknown): line is DailyReportIdsStreamChunkLine => {
+    return typeof line === "object" && line !== null && Array.isArray((line as { items?: unknown }).items)
+}
+
+/**
+ * Total order of the ids stream: businessDate DESC (NULL last), then id DESC.
+ * ids ストリームの全順序。営業日降順 (NULL は末尾)、同日内は ID 降順。
+ *
+ * MSSQL の `ORDER BY business_date DESC, id DESC` と一致させることが唯一の存在理由。
+ * 営業日は正規化済みの `YYYY-MM-DD` 文字列なので辞書順比較 = 時系列比較になる。
+ *
+ * @param a Left key. 左辺キー。
+ * @param b Right key. 右辺キー。
+ * @returns Negative when `a` streams before `b`. `a` が先に流れるなら負値。
+ */
+export const compareIdsStreamOrder = (a: DailyReportIdsStreamCursor, b: DailyReportIdsStreamCursor): number => {
+    if (a.businessDate !== b.businessDate) {
+        // null 営業日は並び順の末尾 (MSSQL DESC の NULL 末尾挙動へ揃える)
+        if (a.businessDate === null) return 1
+        if (b.businessDate === null) return -1
+        return a.businessDate > b.businessDate ? -1 : 1
+    }
+    return b.reportHubId - a.reportHubId
+}
+
+/**
+ * Checks whether items already follow the ids-stream total order.
+ * アイテム配列が ids ストリームの全順序に既に従っているかを検査する処理。
+ *
+ * ストリームはソート順どおりに届いて末尾へ追記されるため通常は整列済みで、
+ * この O(n) 検査で全件ソート (O(n log n)) を省略できる。
+ *
+ * @param items Items to probe. 検査対象のアイテム配列。
+ * @returns True when already ordered. 整列済みなら true。
+ */
+export const isIdsStreamOrdered = (items: readonly DailyReportItem[]): boolean => {
+    for (let i = 1; i < items.length; i++) {
+        if (compareIdsStreamOrder(items[i - 1], items[i]) > 0) return false
+    }
+    return true
+}
+
+/**
+ * Returns a copy with the item upserted at its ids-stream-ordered position.
+ * アイテムを ids ストリーム順の正しい位置へ upsert した複製配列を返す処理。
+ *
+ * 前提: `items` は ids ストリーム順に整列済み (このモジュールの比較器を使う全書き込み元が
+ * 維持する不変条件)。既存の同 ID は除去してから二分探索で挿入位置を求めるため、
+ * 全件ソート無しの O(n) で並び順を保てる (以前は SSE 1 件ごとに 20 万件超を
+ * localeCompare で全ソートしていた)。
+ *
+ * @param items Ordered items. 整列済みアイテム配列。
+ * @param item Item to upsert. upsert するアイテム。
+ * @returns New ordered array. 新しい整列済み配列。
+ */
+export const upsertInIdsStreamOrder = (items: readonly DailyReportItem[], item: DailyReportItem): DailyReportItem[] => {
+    // 既存の同 ID を除いた複製 (位置移動を伴う更新もこれで単一経路になる)
+    const next = items.filter((existing) => existing.reportHubId !== item.reportHubId)
+    let low = 0
+    let high = next.length
+    while (low < high) {
+        const mid = (low + high) >> 1
+        if (compareIdsStreamOrder(next[mid], item) <= 0) {
+            low = mid + 1
+        } else {
+            high = mid
+        }
+    }
+    next.splice(low, 0, item)
+    return next
+}
+
+/**
+ * Finds the first index that streams strictly after the cursor.
+ * カーソルより厳密に後ろへ並ぶ最初のインデックスを求める処理。
+ *
+ * 配列は必ずストリーム順 (SQL の ORDER BY) で渡されるが、比較器とのズレが
+ * あっても壊れない線形走査で決定する (件数は高々数万・再開時のみの実行)。
+ * 該当なし (カーソルが末尾以降) は `items.length` を返し、空チャンク +
+ * `isLast: true` の正常終端に落ちる。
+ *
+ * @param items Stream-ordered items. ストリーム順のアイテム配列。
+ * @param cursor Resume cursor. 再開カーソル。
+ * @returns Index to resume emission from. 送出を再開するインデックス。
+ */
+export const findIdsStreamResumeIndex = (items: readonly DailyReportItem[], cursor: DailyReportIdsStreamCursor): number => {
+    const index = items.findIndex((item) => compareIdsStreamOrder({ businessDate: item.businessDate, reportHubId: item.reportHubId }, cursor) > 0)
+    return index === -1 ? items.length : index
+}

package/src/shared/sse-schema.ts

@@ -108,6 +108,9 @@ export const commentAddMessageSchema = z.object({
     reportHubId: z.number(),
     comment: dailyReportCommentItemSchema,
     clientTempId: z.string(),
+    // 下書き日報のコメントは所有者以外に見えてはならない (本文の全員配信を防ぐ)。
+    // サーバーサイドフィルタ専用で、SSE ルートがフィルタ後に除去する
+    recipientRawUserId: z.number().optional(),
 })
 
 export const commentDeleteMessageSchema = z.object({
@@ -115,6 +118,8 @@ export const commentDeleteMessageSchema = z.object({
     reportHubId: z.number(),
     commentId: z.number(),
     clientTempId: z.string(),
+    // comment-add と同じ理由の宛先フィルタ
+    recipientRawUserId: z.number().optional(),
 })
 
 export const reportCreateMessageSchema = z.object({

package/src/shared/text-utils.spec.ts

@@ -0,0 +1,42 @@
+/**
+ * Tests for shared text helpers.
+ * 共通テキストヘルパーのテスト。
+ */
+import { describe, expect, it } from "vitest"
+import { fallbackText, formatToIsoDate } from "./text-utils"
+
+describe("text-utils", () => {
+    describe("fallbackText", () => {
+        it("returns a dash for empty / nullish values", () => {
+            expect(fallbackText(null)).toBe("-")
+            expect(fallbackText(undefined)).toBe("-")
+            expect(fallbackText("   ")).toBe("-")
+        })
+
+        it("trims and returns real text", () => {
+            expect(fallbackText("  hello  ")).toBe("hello")
+        })
+    })
+
+    describe("formatToIsoDate", () => {
+        it("returns a date-only string verbatim WITHOUT a UTC round-trip", () => {
+            // `new Date('2026-08-08')` は UTC 深夜と解釈され、負オフセット圏では前日へずれる。
+            // 日付のみは Date を経由せず、どのタイムゾーンでも同じ値を返さなければならない。
+            expect(formatToIsoDate("2026-08-08")).toBe("2026-08-08")
+        })
+
+        it("normalizes slash date-only to hyphenated", () => {
+            expect(formatToIsoDate("2026/08/08")).toBe("2026-08-08")
+        })
+
+        it("keeps the time portion for datetime strings", () => {
+            expect(formatToIsoDate("2026-08-08T13:05:09")).toBe("2026-08-08T13:05:09")
+        })
+
+        it("returns a dash for empty and the raw string for unparseable input", () => {
+            expect(formatToIsoDate("")).toBe("-")
+            expect(formatToIsoDate(null)).toBe("-")
+            expect(formatToIsoDate("not-a-date")).toBe("not-a-date")
+        })
+    })
+})

package/src/shared/text-utils.ts

@@ -35,6 +35,14 @@ export const formatToIsoDate = (value: unknown): string => {
         return "-"
     }
 
+    // 日付のみ (YYYY-MM-DD / YYYY/MM/DD) は Date を経由せず整形する。
+    // `new Date("2026-08-08")` は UTC 深夜と解釈され、ローカル getter で負オフセット圏
+    // (米国など) では前日へずれるため。
+    const dateOnly = trimmed.match(/^(\d{4})[-/](\d{2})[-/](\d{2})$/)
+    if (dateOnly) {
+        return `${dateOnly[1]}-${dateOnly[2]}-${dateOnly[3]}`
+    }
+
     const date = new Date(trimmed)
     if (Number.isNaN(date.getTime())) {
         return trimmed