@aiquants/daily-report 0.19.0 → 0.20.1

package/src/server/handlers.ids-stream.spec.ts

@@ -1,618 +0,0 @@
-/**
- * NDJSON streaming tests for the `ids-stream` endpoint.
- * `ids-stream` エンドポイントの NDJSON 配信テスト。
- *
- * ここで固定する不変条件のうち、特に重要なもの:
- *
- * - **旧 `ids` JSON エンドポイントは存在しない** (クリーンカットオーバーの回帰防止)。
- * - **チャンク順序とカーソル連鎖が SQL の並び順 (営業日降順・ID 降順・NULL 営業日末尾) と
- *   厳密に一致する。** ズレると再開時に行の欠落または重複が起きる。
- * - **`total` は接続ごとの先頭行にのみ載る** (進捗分母の契約)。
- * - **不正カーソルは fail-closed で 400** (DB アクセスなし)。
- * - **`Cache-Control: no-transform`** — compression ミドルウェアのバッファリング防止が
- *   ストリーミングの成立条件そのもの。
- */
-import { describe, expect, it, vi } from "vitest"
-import { computeIdsStreamSnapshotToken, type DailyReportIdsStreamChunkLine, type DailyReportIdsStreamLine } from "../shared/ids-stream"
-import type { DailyReportItem } from "../shared/types"
-import { createDailyReportHandlers } from "./handlers"
-import { makeApiArgs, makeHandlersFixture, TEST_EXTERNAL_USER_ID } from "./test-helpers/handlers-config"
-
-/** ストリーム順 (営業日降順・ID 降順) の合成アイテムを count 件生成する。 */
-const makeItems = (count: number): DailyReportItem[] => {
-    // 10 件ごとに営業日を 1 日下げ、同日内は ID 降順になる (日付演算で常に正規形 YYYY-MM-DD を保つ)
-    const baseUtc = Date.UTC(2026, 6, 31)
-    return Array.from({ length: count }, (_, index) => ({
-        reportHubId: count - index,
-        businessDate: new Date(baseUtc - Math.floor(index / 10) * 86_400_000).toISOString().slice(0, 10),
-        sourceType: "Internal",
-    }))
-}
-
-/** レスポンス全体をドレインし、NDJSON 行の配列へパースする。 */
-const readNdjsonLines = async (response: Response): Promise<DailyReportIdsStreamLine[]> => {
-    const text = await response.text()
-    return text
-        .split("\n")
-        .filter((line) => line.trim() !== "")
-        .map((line) => JSON.parse(line) as DailyReportIdsStreamLine)
-}
-
-/** チャンク行だけを取り出す (エラー行が混じればテストを落とす)。 */
-const asChunks = (lines: DailyReportIdsStreamLine[]): DailyReportIdsStreamChunkLine[] => {
-    return lines.map((line) => {
-        expect(line).toHaveProperty("items")
-        return line as DailyReportIdsStreamChunkLine
-    })
-}
-
-describe("ids-stream / 入口の検証", () => {
-    it("未認証は 401 を返し、サービスを呼ばない", async () => {
-        const { config, calls } = makeHandlersFixture({ user: null })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        expect(response.status).toBe(401)
-        expect(calls.getDailyReportIds).toHaveLength(0)
-    })
-
-    it("GET 以外は 405 を返す", async () => {
-        const { config } = makeHandlersFixture()
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream", { method: "POST" }))
-        expect(response.status).toBe(405)
-    })
-
-    it("旧 ids エンドポイントは存在せず 404 を返す (クリーンカットオーバーの固定)", async () => {
-        const { config } = makeHandlersFixture()
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids"))
-        expect(response.status).toBe(404)
-    })
-
-    it("ストリーミング応答のヘッダー契約 (x-ndjson / no-transform / nosniff / Set-Cookie 伝搬)", async () => {
-        const { config } = makeHandlersFixture({ cookie: "session=abc", idsStreamItems: makeItems(1) })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        expect(response.status).toBe(200)
-        expect(response.headers.get("Content-Type")).toBe("application/x-ndjson; charset=utf-8")
-        expect(response.headers.get("Cache-Control")).toBe("private, no-cache, no-transform")
-        expect(response.headers.get("X-Content-Type-Options")).toBe("nosniff")
-        expect(response.headers.get("Set-Cookie")).toBe("session=abc")
-    })
-
-    it("新規接続でサービス例外 (全量・先頭ページとも失敗) は定型エラー行 + 正常クローズ", async () => {
-        const { config } = makeHandlersFixture({ idsStreamError: new Error("db down: SanwaPython secret") })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        // ストリーミングは開始済みなので 200 のままエラー行で通知する (クライアントは再開する)
-        expect(response.status).toBe(200)
-        const body = await response.text()
-        expect(body).not.toContain("SanwaPython")
-        const lines = body
-            .split("\n")
-            .filter((line) => line.trim() !== "")
-            .map((line) => JSON.parse(line) as Record<string, unknown>)
-        expect(lines).toHaveLength(1)
-        expect(lines[0]).toEqual({ kind: "error", error: "stream interrupted by server error" })
-    })
-
-    it("再開接続でサービス例外はストリーム開始前に 500 JSON へ落ちる", async () => {
-        const { config } = makeHandlersFixture({ idsStreamError: new Error("db down: SanwaPython secret") })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream", { query: "?cursor_report_hub_id=10&cursor_business_date=2026-07-31" }))
-        expect(response.status).toBe(500)
-        expect(response.headers.get("Content-Type")).toContain("application/json")
-        expect(await response.text()).not.toContain("SanwaPython")
-    })
-})
-
-describe("ids-stream / 高速先頭ページ (キャッシュミス時の初回描画短縮)", () => {
-    it("全量クエリが遅い場合、先頭ページが先に届き、全量確定後の行に total が載る", async () => {
-        const items = makeItems(1100)
-        // 同ファイル後半と同じ書き方。null 初期化だと制御フロー解析が null へ絞り込み、
-        // 同期的に代入されることを追跡できず呼び出しが never 型になる
-        let releaseFull: () => void = () => {}
-        const fullGate = new Promise<void>((resolve) => {
-            releaseFull = resolve
-        })
-        const { config, calls } = makeHandlersFixture({ idsStreamItems: items, idsStreamFullGate: fullGate })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        const reader = response.body?.getReader()
-        if (!reader) throw new Error("body must be a stream")
-        const decoder = new TextDecoder()
-
-        // 1 行目: 全量を待たずに先頭ページ (30 件・total 無し) が**暫定**として届く
-        const first = await reader.read()
-        const firstLine = JSON.parse(decoder.decode(first.value)) as DailyReportIdsStreamChunkLine
-        expect(firstLine.items).toEqual(items.slice(0, 30))
-        expect(firstLine.total).toBeUndefined()
-        expect(firstLine.isLast).toBe(false)
-        expect(firstLine.provisional).toBe(true)
-        // ❗ 暫定行にカーソルを載せてはならない。未確認領域を指すカーソルで再開すると、
-        //    継ぎ目が三つ目のスナップショットへ移るだけになる
-        expect(firstLine.nextCursor).toBeNull()
-        expect(calls.getDailyReportIdsFirstPage).toEqual([[TEST_EXTERNAL_USER_ID, 30]])
-
-        // 全量を解放すると、続きの行 (先頭ページの続きから) に total が載る
-        releaseFull()
-        let rest = ""
-        while (true) {
-            const { done, value } = await reader.read()
-            if (done) break
-            rest += decoder.decode(value, { stream: true })
-        }
-        const restLines = rest
-            .split("\n")
-            .filter((line) => line.trim() !== "")
-            .map((line) => JSON.parse(line) as DailyReportIdsStreamChunkLine)
-        expect(restLines[0].total).toBe(1100)
-        expect(restLines.slice(1).every((line) => line.total === undefined)).toBe(true)
-        // ❗ 権威パスは**先頭から**流し直す。ページのキーを再開カーソルにすると、ページ送出後に
-        //    先頭領域へ入った行が丸ごと飛ばされる (欠損の構造的原因)
-        expect(restLines.flatMap((line) => line.items)).toEqual(items)
-        expect(restLines.every((line) => line.provisional === undefined)).toBe(true)
-        expect(restLines[restLines.length - 1].isLast).toBe(true)
-    })
-
-    it("先頭ページが上限未満なら全量クエリを待たずに完結する (小規模データセットの最速経路)", async () => {
-        const items = makeItems(5)
-        // 全量は永遠に解決しない (待っていないことの証明)
-        const { config } = makeHandlersFixture({ idsStreamItems: items, idsStreamFullGate: new Promise<void>(() => {}) })
-        const { api } = createDailyReportHandlers(config)
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream"))))
-        expect(lines).toHaveLength(1)
-        expect(lines[0]).toEqual({ kind: "chunk", items, nextCursor: null, isLast: true, total: 5 })
-    })
-
-    it("先頭ページ送出後に全量クエリが失敗したら、定型エラー行 + 正常クローズ (受信済みの続きから再開できる)", async () => {
-        const items = makeItems(1100)
-        // 全量クエリだけを失敗させる (先頭ページは成功して 200 件が届いている)。
-        // 生成直後に catch を付けて未処理拒否警告を防ぐ (await 側では正しく throw される)
-        const failedGate = Promise.reject(new Error("full query down: SanwaPython secret"))
-        failedGate.catch(() => {})
-        const { config } = makeHandlersFixture({ idsStreamItems: items, idsStreamFullGate: failedGate })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        expect(response.status).toBe(200)
-        const body = await response.text()
-        expect(body).not.toContain("SanwaPython")
-        const lines = body
-            .split("\n")
-            .filter((line) => line.trim() !== "")
-            .map((line) => JSON.parse(line) as Record<string, unknown>)
-        // 1 行目: 先頭ページ (30 件・total 無し・isLast 無し) が暫定として届く。
-        // 完走しない走査では剪定が走らないため、暫定行はそのまま残って画面を埋める
-        expect((lines[0] as DailyReportIdsStreamChunkLine).items).toHaveLength(30)
-        expect((lines[0] as DailyReportIdsStreamChunkLine).isLast).toBe(false)
-        expect((lines[0] as DailyReportIdsStreamChunkLine).total).toBeUndefined()
-        expect((lines[0] as DailyReportIdsStreamChunkLine).provisional).toBe(true)
-        expect((lines[0] as DailyReportIdsStreamChunkLine).nextCursor).toBeNull()
-        // 2 行目: 内部情報を含まない定型エラー行 (カーソルが無いのでクライアントは先頭からやり直す)
-        expect(lines[1]).toEqual({ kind: "error", error: "stream interrupted by server error" })
-        expect(lines).toHaveLength(2)
-    })
-
-    it("キャッシュヒット相当 (全量が即時) では従来どおり先頭行に total が載る", async () => {
-        const items = makeItems(5)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream"))))
-        expect(lines[0].total).toBe(5)
-    })
-
-    it("再開接続は先頭ページクエリを発行しない (受信済みの続きだけを読む)", async () => {
-        const items = makeItems(5)
-        const { config, calls } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        await (await api.loader(makeApiArgs("ids-stream", { query: `?cursor_report_hub_id=${items[1].reportHubId}&cursor_business_date=${items[1].businessDate}` }))).text()
-        expect(calls.getDailyReportIdsFirstPage).toHaveLength(0)
-    })
-})
-
-describe("ids-stream / チャンク分割と total", () => {
-    it("空データセットは total 0 の単一終端行になる", async () => {
-        const { config } = makeHandlersFixture({ idsStreamItems: [] })
-        const { api } = createDailyReportHandlers(config)
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream"))))
-        expect(lines).toHaveLength(1)
-        expect(lines[0]).toEqual({ kind: "chunk", items: [], nextCursor: null, isLast: true, total: 0, snapshot: computeIdsStreamSnapshotToken([]) })
-    })
-
-    it("小規模データは 1 行で全件 + total + isLast", async () => {
-        const items = makeItems(5)
-        const { config, calls } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream"))))
-        expect(lines).toHaveLength(1)
-        expect(lines[0].items).toEqual(items)
-        expect(lines[0].total).toBe(5)
-        expect(lines[0].isLast).toBe(true)
-        expect(lines[0].nextCursor).toBeNull()
-        expect(calls.getDailyReportIds).toEqual([[TEST_EXTERNAL_USER_ID, false]])
-    })
-
-    it("9000 件は 30/4000/4000/970 の 4 チャンクに割れ、total は先頭行のみ、カーソルが連鎖する", async () => {
-        const items = makeItems(9000)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream"))))
-
-        expect(lines.map((line) => line.items.length)).toEqual([30, 4000, 4000, 970])
-        expect(lines[0].total).toBe(9000)
-        expect(lines.slice(1).every((line) => line.total === undefined)).toBe(true)
-
-        // カーソルは各チャンク末尾アイテムのキーと一致する
-        expect(lines[0].nextCursor).toEqual({ businessDate: items[29].businessDate, reportHubId: items[29].reportHubId })
-        expect(lines[1].nextCursor).toEqual({ businessDate: items[4029].businessDate, reportHubId: items[4029].reportHubId })
-        expect(lines[2].nextCursor).toEqual({ businessDate: items[8029].businessDate, reportHubId: items[8029].reportHubId })
-        expect(lines[3].nextCursor).toBeNull()
-        expect(lines.map((line) => line.isLast)).toEqual([false, false, false, true])
-
-        // 全チャンクの連結が元配列と厳密一致する (欠落・重複なし)
-        expect(lines.flatMap((line) => line.items)).toEqual(items)
-    })
-
-    it("forceRefresh=true はサービスへ透過する", async () => {
-        const { config, calls } = makeHandlersFixture({ idsStreamItems: makeItems(1) })
-        const { api } = createDailyReportHandlers(config)
-        await (await api.loader(makeApiArgs("ids-stream", { query: "?forceRefresh=true" }))).text()
-        expect(calls.getDailyReportIds).toEqual([[TEST_EXTERNAL_USER_ID, true]])
-    })
-})
-
-describe("ids-stream / カーソル再開", () => {
-    it("中間カーソルからの再開は「厳密に後」の行から欠落・重複なく続く", async () => {
-        const items = makeItems(1100)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-
-        const cursorItem = items[199]
-        // カーソルとトークンは対で送る (トークン無しは安全側 = 先頭からの再送になる)
-        const query = `?cursor_report_hub_id=${cursorItem.reportHubId}&cursor_business_date=${cursorItem.businessDate}&cursor_snapshot=${computeIdsStreamSnapshotToken(items)}`
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream", { query }))))
-
-        const resumed = lines.flatMap((line) => line.items)
-        expect(resumed).toEqual(items.slice(200))
-        // 再開接続でも先頭行に最新の total が載り直す
-        expect(lines[0].total).toBe(1100)
-    })
-
-    it("NULL 営業日領域は cursor_report_hub_id 単独で再開できる", async () => {
-        const dated = makeItems(3)
-        const nullRegion: DailyReportItem[] = [
-            { reportHubId: 900, businessDate: null, sourceType: "NI" },
-            { reportHubId: 800, businessDate: null, sourceType: "NI" },
-            { reportHubId: 700, businessDate: null, sourceType: "NI" },
-        ]
-        const { config } = makeHandlersFixture({ idsStreamItems: [...dated, ...nullRegion] })
-        const { api } = createDailyReportHandlers(config)
-
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream", { query: `?cursor_report_hub_id=900&cursor_snapshot=${computeIdsStreamSnapshotToken([...dated, ...nullRegion])}` }))))
-        expect(lines.flatMap((line) => line.items)).toEqual([
-            { reportHubId: 800, businessDate: null, sourceType: "NI" },
-            { reportHubId: 700, businessDate: null, sourceType: "NI" },
-        ])
-    })
-
-    it("末尾以降を指すカーソルは空チャンク + isLast で正常終端する", async () => {
-        const items = makeItems(5)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const last = items[items.length - 1]
-        const query = `?cursor_report_hub_id=${last.reportHubId}&cursor_business_date=${last.businessDate}&cursor_snapshot=${computeIdsStreamSnapshotToken(items)}`
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream", { query }))))
-        expect(lines).toHaveLength(1)
-        expect(lines[0]).toEqual({ kind: "chunk", items: [], nextCursor: null, isLast: true, total: 5, snapshot: computeIdsStreamSnapshotToken(items) })
-    })
-
-    it.each([
-        ["営業日のみ (位置を決められない)", "?cursor_business_date=2026-07-31"],
-        ["日付形式違反 (スラッシュ)", "?cursor_report_hub_id=10&cursor_business_date=2026/07/31"],
-        ["日付形式違反 (桁欠け)", "?cursor_report_hub_id=10&cursor_business_date=2026-7-31"],
-        ["非整数 ID", "?cursor_report_hub_id=abc"],
-        ["小数 ID", "?cursor_report_hub_id=12.5"],
-        ["ゼロ ID", "?cursor_report_hub_id=0"],
-        ["負数 ID", "?cursor_report_hub_id=-1"],
-        ["先頭ゼロ ID (正規形でない)", "?cursor_report_hub_id=007"],
-    ])("不正カーソル (%s) は 400 で、サービスを呼ばない", async (_label, query) => {
-        const { config, calls } = makeHandlersFixture({ idsStreamItems: makeItems(3) })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream", { query }))
-        expect(response.status).toBe(400)
-        expect(calls.getDailyReportIds).toHaveLength(0)
-    })
-})
-
-describe("ids-stream / 逐次配信", () => {
-    it("チャンクは 1 つの巨大な書き込みではなく複数回の enqueue で届く (pull 単位のバックプレッシャー)", async () => {
-        const items = makeItems(9000)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        const body = response.body
-        if (!body) throw new Error("body must be a stream")
-
-        // reader で読み、read() の回数 (= enqueue の粒度) を数える
-        const reader = body.getReader()
-        const decoder = new TextDecoder()
-        let readCount = 0
-        let text = ""
-        while (true) {
-            const { done, value } = await reader.read()
-            if (done) break
-            readCount += 1
-            text += decoder.decode(value, { stream: true })
-        }
-        // 200/4000/4000/800 の 4 チャンク = 4 回以上の read で届く (全体一括 1 回ではない)
-        expect(readCount).toBeGreaterThanOrEqual(4)
-        expect(text.split("\n").filter((line) => line.trim() !== "")).toHaveLength(4)
-    })
-
-    it("reader.cancel() は例外なく受理される (切断安全)", async () => {
-        const { config } = makeHandlersFixture({ idsStreamItems: makeItems(1100) })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        const reader = response.body?.getReader()
-        if (!reader) throw new Error("body must be a stream")
-        await reader.read()
-        await expect(reader.cancel()).resolves.toBeUndefined()
-    })
-})
-
-describe("ids-stream / 中断", () => {
-    it("送出前に中断済みのリクエストは 1 行も流さずクローズする", async () => {
-        const { config } = makeHandlersFixture({ idsStreamItems: makeItems(50) })
-        const { api } = createDailyReportHandlers(config)
-        const abortController = new AbortController()
-        abortController.abort()
-        const response = await api.loader(makeApiArgs("ids-stream", { signal: abortController.signal }))
-        expect(response.status).toBe(200)
-        expect(await response.text()).toBe("")
-    })
-})
-
-describe("ids-stream / ハートビート", () => {
-    it("次チャンク待ち (全量クエリ確定待ち) が長引く間は空行ハートビートを送る", async () => {
-        vi.useFakeTimers()
-        try {
-            // 全量クエリを保留させ、先頭ページ (200 件) 描画後に無音区間を作る
-            let releaseFull: () => void = () => {}
-            const fullGate = new Promise<void>((resolve) => {
-                releaseFull = resolve
-            })
-            const items = makeItems(400)
-            const { config } = makeHandlersFixture({
-                idsStreamItems: items,
-                idsStreamFirstPageItems: items.slice(0, 200),
-                idsStreamFullGate: fullGate,
-            })
-            const { api } = createDailyReportHandlers(config)
-            const response = await api.loader(makeApiArgs("ids-stream"))
-            const reader = (response.body as ReadableStream<Uint8Array>).getReader()
-            const decoder = new TextDecoder()
-
-            // 先頭ページの最初のチャンク (200 件、isLast 無し)
-            const first = await reader.read()
-            const firstLine = JSON.parse(decoder.decode(first.value).trim()) as DailyReportIdsStreamChunkLine
-            expect(firstLine.items).toHaveLength(200)
-            expect(firstLine.isLast).toBe(false)
-
-            // 全量ゲート未解放のまま 15s 経過 → 接続の生存を示す空行
-            const heartbeatRead = reader.read()
-            await vi.advanceTimersByTimeAsync(15_000)
-            const heartbeat = await heartbeatRead
-            expect(decoder.decode(heartbeat.value)).toBe("\n")
-
-            // 全量を解放すると残りが流れて isLast で閉じる (ハートビートが本体を壊していない)
-            releaseFull()
-            let sawLast = false
-            for (let i = 0; i < 50; i++) {
-                const { done, value } = await reader.read()
-                if (done) break
-                const text = decoder.decode(value).trim()
-                if (text === "") continue
-                for (const raw of text.split("\n")) {
-                    const line = JSON.parse(raw) as DailyReportIdsStreamChunkLine
-                    if (line.isLast) sawLast = true
-                }
-            }
-            expect(sawLast).toBe(true)
-        } finally {
-            vi.useRealTimers()
-        }
-    })
-})
-
-describe("ids-stream / 継ぎ目の閉じ込め (幽霊行と欠損行の構造的排除)", () => {
-    it("全量がキャッシュ由来のときは先頭ページを起動しない (鮮度逆転で作成直後の行を消さない)", async () => {
-        // ❗ バケットヒット・進行中フェッチへの相乗り・refresh-ahead が返す全量配列は
-        //    本リクエストより古くなり得る。そこへ新鮮な先頭ページを重ねると
-        //    「ページに在って全量に無い行 = 削除済み」の判定が反転し、作成直後の日報を消す。
-        //    副次効果として、従来ヒット時に走って捨てられていた TOP-N クエリも消える
-        const items = makeItems(500)
-        const { config, calls } = makeHandlersFixture({ idsStreamItems: items, idsStreamCacheHit: true })
-        const { api } = createDailyReportHandlers(config)
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream"))))
-
-        expect(calls.getDailyReportIdsFirstPage).toHaveLength(0)
-        expect(lines.every((line) => line.provisional === undefined)).toBe(true)
-        expect(lines[0].total).toBe(500)
-        expect(lines.flatMap((line) => line.items)).toEqual(items)
-    })
-
-    it("先頭ページ後に先頭領域へ入った行を取りこぼさない (欠損の構造的排除)", async () => {
-        // 先頭ページ (古いスナップショット) の後、全量 (新しいスナップショット) の先頭に
-        // 新しい行が入っている状況。ページのキーをカーソルにして継続すると、この行は
-        // 先頭領域に居るため丸ごと飛ばされ、その走査では二度と届かない
-        const base = makeItems(100)
-        const inserted = { reportHubId: 99999, businessDate: base[0].businessDate, sourceType: "Internal" }
-        const full = [inserted, ...base]
-        let releaseFull: () => void = () => {}
-        const fullGate = new Promise<void>((resolve) => {
-            releaseFull = resolve
-        })
-        const { config } = makeHandlersFixture({ idsStreamItems: full, idsStreamFirstPageItems: base.slice(0, 30), idsStreamFullGate: fullGate })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        releaseFull()
-        const lines = asChunks(await readNdjsonLines(response))
-
-        const authoritative = lines.filter((line) => line.provisional !== true)
-        expect(authoritative.flatMap((line) => line.items)).toEqual(full)
-        expect(authoritative.flatMap((line) => line.items).some((item) => item.reportHubId === 99999)).toBe(true)
-    })
-
-    it("先頭ページ後に消えた行は権威パスに現れない (幽霊行の消去材料を渡す)", async () => {
-        // ページには居たが全量には居ない行。暫定行は観測集合へ刻まれないため、
-        // クライアントの完走剪定がこの行を正確に落とせる
-        const full = makeItems(100)
-        const ghost = { reportHubId: 88888, businessDate: full[0].businessDate, sourceType: "Internal" }
-        let releaseFull: () => void = () => {}
-        const fullGate = new Promise<void>((resolve) => {
-            releaseFull = resolve
-        })
-        const { config } = makeHandlersFixture({ idsStreamItems: full, idsStreamFirstPageItems: [ghost, ...full.slice(0, 29)], idsStreamFullGate: fullGate })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        releaseFull()
-        const lines = asChunks(await readNdjsonLines(response))
-
-        const provisional = lines.filter((line) => line.provisional === true)
-        const authoritative = lines.filter((line) => line.provisional !== true)
-        expect(provisional.flatMap((line) => line.items).some((item) => item.reportHubId === 88888)).toBe(true)
-        expect(authoritative.flatMap((line) => line.items).some((item) => item.reportHubId === 88888)).toBe(false)
-        expect(authoritative.flatMap((line) => line.items)).toEqual(full)
-    })
-
-    it("先頭ページが上限未満なら権威として完結する (小規模データセットを剪定で全消ししない)", async () => {
-        // ❗ この分岐を provisional にすると、観測集合が空のまま完走し、剪定が全行を落とす
-        const items = makeItems(5)
-        let releaseFull: () => void = () => {}
-        const fullGate = new Promise<void>((resolve) => {
-            releaseFull = resolve
-        })
-        const { config } = makeHandlersFixture({ idsStreamItems: items, idsStreamFullGate: fullGate })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        const lines = asChunks(await readNdjsonLines(response))
-        releaseFull()
-
-        expect(lines).toHaveLength(1)
-        expect(lines[0].provisional).toBeUndefined()
-        expect(lines[0].isLast).toBe(true)
-        expect(lines[0].total).toBe(5)
-    })
-
-    it("暫定ページを出した経路でも権威パスの初回チャンクは大きいまま (行数を無駄に増やさない)", async () => {
-        const items = makeItems(9000)
-        let releaseFull: () => void = () => {}
-        const fullGate = new Promise<void>((resolve) => {
-            releaseFull = resolve
-        })
-        const { config } = makeHandlersFixture({ idsStreamItems: items, idsStreamFullGate: fullGate })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        releaseFull()
-        const lines = asChunks(await readNdjsonLines(response))
-
-        // 30 (暫定) + 4000/4000/1000 (権威・先頭から)
-        expect(lines.map((line) => line.items.length)).toEqual([30, 4000, 4000, 1000])
-    })
-})
-
-describe("ids-stream / スナップショットトークン (resume 継ぎ目の閉じ込め)", () => {
-    it("トークン不一致の再開はカーソルを捨てて先頭から流し直し、先頭行に restarted を立てる", async () => {
-        // ❗ カーソルを作った配列と今の配列が別物なら、カーソルより前に入った行が丸ごと飛ぶ
-        //    (再接続のたびの欠損)。不一致は先頭からの再送で確実に回復する
-        const items = makeItems(100)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const cursorItem = items[10]
-        const staleToken = computeIdsStreamSnapshotToken(items.slice(1)) // 別の配列のトークン
-        const query = `?cursor_report_hub_id=${cursorItem.reportHubId}&cursor_business_date=${cursorItem.businessDate}&cursor_snapshot=${staleToken}`
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream", { query }))))
-
-        expect(lines[0].restarted).toBe(true)
-        expect(lines.slice(1).every((line) => line.restarted === undefined)).toBe(true)
-        expect(lines.flatMap((line) => line.items)).toEqual(items)
-    })
-
-    it("トークン無しの再開 (旧クライアント) も先頭から流し直す", async () => {
-        const items = makeItems(50)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const cursorItem = items[10]
-        const query = `?cursor_report_hub_id=${cursorItem.reportHubId}&cursor_business_date=${cursorItem.businessDate}`
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream", { query }))))
-
-        expect(lines[0].restarted).toBe(true)
-        expect(lines.flatMap((line) => line.items)).toEqual(items)
-    })
-
-    it("不正な形式のトークンは 400 にせず「トークン無し」として扱う", async () => {
-        // 再開の失敗は先頭からの再送で回復できる。接続ごと落とすより常に安全側
-        const items = makeItems(10)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const cursorItem = items[2]
-        const query = `?cursor_report_hub_id=${cursorItem.reportHubId}&cursor_business_date=${cursorItem.businessDate}&cursor_snapshot=NOT-HEX!`
-        const response = await api.loader(makeApiArgs("ids-stream", { query }))
-        expect(response.status).toBe(200)
-        const lines = asChunks(await readNdjsonLines(response))
-        expect(lines[0].restarted).toBe(true)
-    })
-
-    it("トークン一致の再開はカーソル位置から続き、restarted を立てない", async () => {
-        const items = makeItems(50)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const cursorItem = items[9]
-        const query = `?cursor_report_hub_id=${cursorItem.reportHubId}&cursor_business_date=${cursorItem.businessDate}&cursor_snapshot=${computeIdsStreamSnapshotToken(items)}`
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream", { query }))))
-
-        expect(lines.every((line) => line.restarted === undefined)).toBe(true)
-        expect(lines.flatMap((line) => line.items)).toEqual(items.slice(10))
-    })
-
-    it("resume 経路の行にもトークンが載る (再武装 — 2 度目の切断もカーソル再開できる材料)", async () => {
-        // ❗ ここを欠くと最初の再開成功でクライアントのトークンが失われ、
-        //    2 度目以降の切断が全て全量再送 (~22 万行) へ退化する
-        const items = makeItems(50)
-        const { config } = makeHandlersFixture({ idsStreamItems: items })
-        const { api } = createDailyReportHandlers(config)
-        const cursorItem = items[9]
-        const query = `?cursor_report_hub_id=${cursorItem.reportHubId}&cursor_business_date=${cursorItem.businessDate}&cursor_snapshot=${computeIdsStreamSnapshotToken(items)}`
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream", { query }))))
-
-        expect(lines.every((line) => line.snapshot === computeIdsStreamSnapshotToken(items))).toBe(true)
-    })
-
-    it("暫定行にはトークンを載せない (未確認スナップショットを再開起点にしない)", async () => {
-        const items = makeItems(100)
-        let releaseFull: () => void = () => {}
-        const fullGate = new Promise<void>((resolve) => {
-            releaseFull = resolve
-        })
-        const { config } = makeHandlersFixture({ idsStreamItems: items, idsStreamFullGate: fullGate })
-        const { api } = createDailyReportHandlers(config)
-        const response = await api.loader(makeApiArgs("ids-stream"))
-        releaseFull()
-        const lines = asChunks(await readNdjsonLines(response))
-
-        const provisional = lines.filter((line) => line.provisional === true)
-        expect(provisional.length).toBeGreaterThan(0)
-        expect(provisional.every((line) => line.snapshot === undefined)).toBe(true)
-        const authoritative = lines.filter((line) => line.provisional !== true)
-        expect(authoritative.every((line) => line.snapshot === computeIdsStreamSnapshotToken(items))).toBe(true)
-    })
-
-    it("短絡行 (ページ上限未満で完結) にもトークンを載せない (全量配列を代表しない)", async () => {
-        const items = makeItems(5)
-        const { config } = makeHandlersFixture({ idsStreamItems: items, idsStreamFullGate: new Promise<void>(() => {}) })
-        const { api } = createDailyReportHandlers(config)
-        const lines = asChunks(await readNdjsonLines(await api.loader(makeApiArgs("ids-stream"))))
-        expect(lines).toHaveLength(1)
-        expect(lines[0].snapshot).toBeUndefined()
-    })
-})