@aiquants/daily-report 0.20.0 → 0.21.0

package/src/client/streaming/daily-report-ids-stream-session.spec.ts

@@ -1,401 +0,0 @@
-/**
- * Lifecycle tests for the module-resident ids stream session.
- * モジュール常駐 ids ストリームセッションのライフサイクルテスト。
- *
- * ここで固定する不変条件のうち、特に重要なもの:
- *
- * - **userKey (難読化ユーザー ID) が変わったらセッションを作り直す** — 別ユーザーの
- *   受信済みデータを次のユーザーへ見せてはならない。
- * - **failed セッションへの再訪 (ensure) は自動 retry する** — 再訪はユーザーの再試行意思。
- * - **完走から一定時間を過ぎた再訪はバックグラウンド再検証する** (SWR)。
- * - **フックはセッション生成前でも安全に IDLE を返し、生成後は再購読なしで追従する。**
- *
- * モジュールスコープ状態を分離するため、テストごとに `vi.resetModules()` +
- * 動的 import でモジュールを作り直す (use-daily-report.spec.ts と同じ流儀)。
- */
-import { act, renderHook } from "@testing-library/react"
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
-import type { DailyReportIdsStreamState } from "./daily-report-ids-stream-client"
-
-/** FakeClient の呼び出し記録と状態操作面。 */
-type FakeClientHandle = {
-    startCalls: number
-    retryCalls: number
-    refreshCalls: Array<{ forceRefresh?: boolean }>
-    disposeCalls: number
-    upserts: Array<{ reportHubId: number; businessDate: string | null }>
-    removals: number[]
-    setState: (partial: Partial<DailyReportIdsStreamState>) => void
-    options: { apiBasePath?: string }
-}
-
-/** 生成された FakeClient のハンドル一覧 (生成順)。 */
-const createdClients: FakeClientHandle[] = []
-
-/** ユーザー切替時の詳細キャッシュ破棄の呼び出し記録。 */
-const clearCacheMock = vi.fn()
-
-vi.mock("../hooks/use-daily-report", () => ({
-    clearDailyReportCache: () => clearCacheMock(),
-}))
-
-vi.mock("./daily-report-ids-stream-client", () => {
-    class FakeClient {
-        private listeners = new Set<() => void>()
-        private state: DailyReportIdsStreamState = {
-            items: [],
-            loadedCount: 0,
-            totalCount: null,
-            phase: "idle",
-            isRevalidating: false,
-            hasCompletedOnce: false,
-            completedAt: null,
-            error: null,
-        }
-        readonly handle: FakeClientHandle
-
-        constructor(options: { apiBasePath?: string } = {}) {
-            this.handle = {
-                startCalls: 0,
-                retryCalls: 0,
-                refreshCalls: [],
-                disposeCalls: 0,
-                upserts: [],
-                removals: [],
-                options,
-                setState: (partial) => {
-                    this.state = { ...this.state, ...partial }
-                    for (const listener of this.listeners) listener()
-                },
-            }
-            createdClients.push(this.handle)
-        }
-
-        getState() {
-            return this.state
-        }
-
-        subscribe(listener: () => void) {
-            this.listeners.add(listener)
-            return () => this.listeners.delete(listener)
-        }
-
-        start() {
-            this.handle.startCalls += 1
-        }
-
-        retry() {
-            this.handle.retryCalls += 1
-        }
-
-        refresh(options: { forceRefresh?: boolean } = {}) {
-            this.handle.refreshCalls.push(options)
-        }
-
-        dispose() {
-            this.handle.disposeCalls += 1
-        }
-
-        applyExternalUpsert(item: { reportHubId: number; businessDate: string | null }) {
-            this.handle.upserts.push(item)
-        }
-
-        applyExternalRemoval(reportHubId: number) {
-            this.handle.removals.push(reportHubId)
-        }
-    }
-    return { DailyReportIdsStreamClient: FakeClient }
-})
-
-/** テスト対象モジュールを新品で読み込む。 */
-const importSession = async () => await import("./daily-report-ids-stream-session")
-
-beforeEach(() => {
-    vi.resetModules()
-    createdClients.length = 0
-    clearCacheMock.mockClear()
-    vi.useFakeTimers()
-})
-
-afterEach(() => {
-    vi.useRealTimers()
-})
-
-describe("ensureDailyReportIdsStreamSession", () => {
-    it("初回 ensure でクライアントを生成して start する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ apiBasePath: "/daily_report/api", userKey: "userA" })
-        expect(createdClients).toHaveLength(1)
-        expect(createdClients[0].startCalls).toBe(1)
-        expect(createdClients[0].options.apiBasePath).toBe("/daily_report/api")
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("同一 userKey の再 ensure はセッションを再利用する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients).toHaveLength(1)
-        expect(createdClients[0].disposeCalls).toBe(0)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("userKey が変わったら旧セッションと詳細キャッシュを破棄して作り直す", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        session.ensureDailyReportIdsStreamSession({ userKey: "userB" })
-        expect(createdClients).toHaveLength(2)
-        expect(createdClients[0].disposeCalls).toBe(1)
-        expect(createdClients[1].startCalls).toBe(1)
-        // 旧ユーザーが閲覧した詳細 (下書き含む) を新ユーザーへ供給しない
-        expect(clearCacheMock).toHaveBeenCalledTimes(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("apiBasePath が変わったら作り直す (同一ユーザーなので詳細キャッシュは保持)", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ apiBasePath: "/a", userKey: "userA" })
-        session.ensureDailyReportIdsStreamSession({ apiBasePath: "/b", userKey: "userA" })
-        expect(createdClients).toHaveLength(2)
-        expect(createdClients[0].disposeCalls).toBe(1)
-        expect(clearCacheMock).not.toHaveBeenCalled()
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("failed セッションへの ensure は retry する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        createdClients[0].setState({ phase: "failed" })
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients[0].retryCalls).toBe(1)
-        expect(createdClients[0].refreshCalls).toHaveLength(0)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("完走直後の ensure は再検証しないが、鮮度窓を過ぎた ensure は refresh する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        createdClients[0].setState({ phase: "complete", hasCompletedOnce: true, completedAt: Date.now() })
-
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients[0].refreshCalls).toHaveLength(0)
-
-        // 鮮度窓 (60 秒) を越えて再訪
-        vi.advanceTimersByTime(61_000)
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients[0].refreshCalls).toHaveLength(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("再検証の諦め (completedAt 据え置き) 後の ensure は再び refresh する — 古いデータを新鮮扱いしない", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        createdClients[0].setState({ phase: "complete", hasCompletedOnce: true, completedAt: Date.now() })
-
-        vi.advanceTimersByTime(61_000)
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients[0].refreshCalls).toHaveLength(1)
-
-        // 再検証の力尽き publish: phase は complete のまま、completedAt は据え置き
-        createdClients[0].setState({ isRevalidating: false, error: new Error("gave up") })
-
-        // 次の ensure は据え置かれた completedAt を根拠に再検証を再度走らせる
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients[0].refreshCalls).toHaveLength(2)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("undefined と既定文字列の apiBasePath は同一視され、セッションを破棄しない", async () => {
-        const session = await importSession()
-        // clientLoader 相当 (apiBasePath 未指定 = undefined)
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        // ページ effect 相当 (config の既定文字列)
-        session.ensureDailyReportIdsStreamSession({ apiBasePath: "/daily_report/api", userKey: "userA" })
-        expect(createdClients).toHaveLength(1)
-        expect(createdClients[0].disposeCalls).toBe(0)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-})
-
-describe("ensure / isRevalidating ガード", () => {
-    it("走行中の再検証 (isRevalidating) がある間の ensure は refresh を重ねない", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        createdClients[0].setState({ phase: "complete", hasCompletedOnce: true, completedAt: Date.now() })
-        vi.advanceTimersByTime(61_000)
-
-        // 1 回目の ensure が再検証を起動する想定 (FakeClient は refresh を記録するだけ)
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients[0].refreshCalls).toHaveLength(1)
-
-        // 実クライアントは再検証中 isRevalidating を立てる。以後の ensure は重ねない
-        createdClients[0].setState({ isRevalidating: true })
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        session.primeDailyReportIdsStreamSession()
-        expect(createdClients[0].refreshCalls).toHaveLength(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-})
-
-describe("bootstrapDailyReportIdsStreamSession", () => {
-    it("セッションが無ければローダー時点で生成して start する (コールドロードの最重要最適化)", async () => {
-        const session = await importSession()
-        session.bootstrapDailyReportIdsStreamSession({ apiBasePath: "/daily_report/api", userKey: "userA" })
-        expect(createdClients).toHaveLength(1)
-        expect(createdClients[0].startCalls).toBe(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("userKey 不一致なら描画前に破棄 (詳細キャッシュ含む) し、新ユーザーで即時再生成する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        session.bootstrapDailyReportIdsStreamSession({ userKey: "userB" })
-        expect(createdClients[0].disposeCalls).toBe(1)
-        expect(createdClients).toHaveLength(2)
-        expect(createdClients[1].startCalls).toBe(1)
-        expect(clearCacheMock).toHaveBeenCalledTimes(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("userKey 一致なら既存セッションを保ち鮮度確認を行う (failed は retry)。パスは照合しない", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ apiBasePath: "/custom/api", userKey: "userA" })
-        createdClients[0].setState({ phase: "failed" })
-        // factory 未指定 (undefined → 既定値) でもセッションは破棄されない —
-        // 照合するとナビゲーションごとのスラッシングが再発する
-        session.bootstrapDailyReportIdsStreamSession({ userKey: "userA" })
-        expect(createdClients).toHaveLength(1)
-        expect(createdClients[0].disposeCalls).toBe(0)
-        expect(createdClients[0].retryCalls).toBe(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-})
-
-describe("外部ミューテーション中継", () => {
-    it("upsert / removal はセッションのクライアントへ委譲され、セッション無しでは何もしない", async () => {
-        const session = await importSession()
-        // セッション無し: 例外なく無視される
-        session.upsertDailyReportIdsStreamItem({ reportHubId: 1, businessDate: "2026-08-01" })
-        session.removeDailyReportIdsStreamItem(1)
-        expect(createdClients).toHaveLength(0)
-
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        session.upsertDailyReportIdsStreamItem({ reportHubId: 2, businessDate: "2026-08-02" })
-        session.removeDailyReportIdsStreamItem(3)
-        expect(createdClients[0].upserts).toEqual([{ reportHubId: 2, businessDate: "2026-08-02" }])
-        expect(createdClients[0].removals).toEqual([3])
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-})
-
-describe("primeDailyReportIdsStreamSession", () => {
-    it("セッションが無ければ何もしない", async () => {
-        const session = await importSession()
-        session.primeDailyReportIdsStreamSession()
-        expect(createdClients).toHaveLength(0)
-    })
-
-    it("既存セッションがあれば userKey 未確定でも鮮度確認を先行できる", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        createdClients[0].setState({ phase: "complete", hasCompletedOnce: true, completedAt: Date.now() })
-        vi.advanceTimersByTime(61_000)
-        session.primeDailyReportIdsStreamSession()
-        expect(createdClients[0].refreshCalls).toHaveLength(1)
-        // prime はセッションを作り直さない
-        expect(createdClients).toHaveLength(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-})
-
-describe("useDailyReportIdsStream", () => {
-    it("セッション生成前は IDLE、生成後は再購読なしで追従する", async () => {
-        const session = await importSession()
-        const { result } = renderHook(() => session.useDailyReportIdsStream())
-        expect(result.current.phase).toBe("idle")
-        expect(result.current.items).toEqual([])
-
-        act(() => {
-            session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        })
-        act(() => {
-            createdClients[0].setState({
-                phase: "streaming",
-                loadedCount: 2,
-                items: [
-                    { reportHubId: 2, businessDate: "2026-08-01" },
-                    { reportHubId: 1, businessDate: "2026-08-01" },
-                ],
-            })
-        })
-        expect(result.current.phase).toBe("streaming")
-        expect(result.current.loadedCount).toBe(2)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("retry / refresh のエントリポイントはクライアントへ委譲する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        session.retryDailyReportIdsStream()
-        session.refreshDailyReportIdsStream({ forceRefresh: true })
-        expect(createdClients[0].retryCalls).toBe(1)
-        expect(createdClients[0].refreshCalls).toEqual([{ forceRefresh: true }])
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("resetDailyReportIdsStreamSessionForTesting はセッションを破棄して IDLE へ戻す", async () => {
-        const session = await importSession()
-        const { result } = renderHook(() => session.useDailyReportIdsStream())
-        act(() => {
-            session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-            createdClients[0].setState({ phase: "streaming", loadedCount: 1 })
-        })
-        expect(result.current.phase).toBe("streaming")
-        act(() => {
-            session.resetDailyReportIdsStreamSessionForTesting()
-        })
-        expect(createdClients[0].disposeCalls).toBe(1)
-        expect(result.current.phase).toBe("idle")
-    })
-})
-
-describe("時間駆動の再検証 (再訪以外の新規走査起動経路)", () => {
-    // ❗ これが無いと新規走査を起動できるのは「再訪 (ナビゲーション)」だけになる。
-    //    REVALIDATE_AFTER_MS はタイマーではなく再訪時の閾値なので、タブを開いたまま
-    //    放置する使い方では走査が二度と走らず、走査時点の不整合が残り続ける
-    it("可視化復帰 (visibilitychange) は鮮度切れなら再検証する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        createdClients[0].setState({ phase: "complete", hasCompletedOnce: true, completedAt: Date.now() })
-
-        // 鮮度窓の内側では起動しない (無用な全量走査を増やさない)
-        document.dispatchEvent(new Event("visibilitychange"))
-        expect(createdClients[0].refreshCalls).toHaveLength(0)
-
-        vi.advanceTimersByTime(61_000)
-        document.dispatchEvent(new Event("visibilitychange"))
-        expect(createdClients[0].refreshCalls).toHaveLength(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("フォーカス取得 (focus) も同じ経路で再検証する", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        createdClients[0].setState({ phase: "complete", hasCompletedOnce: true, completedAt: Date.now() })
-
-        vi.advanceTimersByTime(61_000)
-        window.dispatchEvent(new Event("focus"))
-        expect(createdClients[0].refreshCalls).toHaveLength(1)
-        session.resetDailyReportIdsStreamSessionForTesting()
-    })
-
-    it("セッション破棄後に発火しても落ちない (リスナーはモジュール寿命で残る)", async () => {
-        const session = await importSession()
-        session.ensureDailyReportIdsStreamSession({ userKey: "userA" })
-        session.resetDailyReportIdsStreamSessionForTesting()
-        expect(() => {
-            document.dispatchEvent(new Event("visibilitychange"))
-            window.dispatchEvent(new Event("focus"))
-        }).not.toThrow()
-    })
-})