@aiquants/daily-report 0.8.0 → 0.9.1

package/README.md

@@ -92,6 +92,7 @@ export const dailyReportServer = createDailyReportServer({
         { sourceType: "legacy", table: LegacyReport, idColumn: LegacyReport.reportId, mapRow: mapLegacyRow },
     ],
     draftLabelNames: ["Draft", "Work in Progress"], // Draft label names (can specify a single string or array of candidates)
+    enableDevCacheClear: import.meta.env.DEV,    // Optional: allow the dev-only `intent=clearCache` (default false → 400)
 })
 ```
 
@@ -118,6 +119,7 @@ export const loader = (args) => dailyReportServer.sse.loader(args)
 - `redis` — `getClient()` (get/incr/xAdd/xRange/xRevRange) + `createClient()` (blocking xRead). Structurally matches a `node-redis` v5 client. If omitted, SSE publishing is skipped (with a warning) and epoch is disabled.
 - `externalSources[]` — When `Hub.source_type` matches, performs a `LEFT JOIN` on `Hub.source_id_num = idColumn` and converts fields via `mapRow`.
 - `draftLabelName` / `draftLabelNames` — Database label names representing draft states (single string or array of candidates like `["Draft", "Work in Progress"]`). Used for server-side cross-user visibility filtering (hiding drafts from other users) and `isDraft` evaluation.
+- `enableDevCacheClear` — Gates the dev-only `POST /action` `intent=clearCache` (flush every worker's cache). Default `false` → the handler returns `400` before touching the service. Wire `import.meta.env.DEV` to enable it only in development (any authenticated user could otherwise flush all caches without limit).
 - Primary tuning parameters: `idsTtlMs` (180s) / `businessDateTtlMs` (300s) / `streamKey` / `streamMaxLen` / `loginRedirectPath`.
 
 ## Client wiring
@@ -143,6 +145,7 @@ export default function Route() {
                     fieldLabels: {                          // Card/detail header labels (customizable per key)
                         businessDate: "Date", content: "Body", comments: "Comments", /* ... override to match app locale */
                     },
+                    onError: (info) => yourToast(info.message), // Optional: route mutation failures to your own toast
                     // apiBasePath: "/daily_report/api", ssePath: "/sse/daily_report/updates"
                 }}
             />
@@ -153,6 +156,8 @@ export default function Route() {
 
 `DailyReportPage` is layout-agnostic (header rendering via `renderHeader` slot, error boundaries/footer control managed by the app). For fine-grained usage, `DailyReportActionProvider`, `DailyReportResolvedContent`, `useDailyReportDetail`, etc. can be imported individually.
 
+Mutation failures (save / publish / delete / comment) are surfaced through an error seam: inject `config.onError(info: DailyReportErrorInfo)` to route them into your own toast/notification system, or omit it to use the package's built-in `role="alert"` banner (auto-dismiss + manual close). Failures on a continuation that resolves after a no-reload user switch are suppressed. If you compose `DailyReportActionProvider` yourself instead of using `DailyReportPage`, wrap it in `DailyReportErrorProvider` (both are exported from `@aiquants/daily-report/client`) so `onError` / the banner work.
+
 The report id list is **not** part of the loader data: a module-resident NDJSON stream session (`GET {apiBasePath}/ids-stream`, resilient client with cursor resume + exponential backoff) supplies it.
 `createDailyReportClientLoader` warms an existing session (`primeDailyReportIdsStreamSession`) and then bootstraps (`bootstrapDailyReportIdsStreamSession`): when no session exists it is **created at loader time** so the stream fetch runs in parallel with hydration (the dominant cold-load optimization); when one exists, the obfuscated user id is reconciled (a different user destroys and recreates the session before render).
 If your app overrides `config.apiBasePath`, pass the same value to `createDailyReportClientLoader({ apiBasePath })` — forgetting it costs one wrong-path request on the very first load, self-healed by the page-mount `ensureDailyReportIdsStreamSession`.

package/dist/client.d.mts

@@ -2,7 +2,7 @@ import * as react from 'react';
 import { ReactNode, Context, RefObject } from 'react';
 import { ScrollBarThumbOverlayRenderProps, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from '@aiquants/virtualscroll';
 import { D as DailyReportAttachmentSummary, a as DailyReportItem, b as DailyReportDetail, c as DailyReportUser } from './types-Ct1ggzy-.mjs';
-import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-Df49KA7B.mjs';
+import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-BiUnufrI.mjs';
 import { ShouldRevalidateFunction } from 'react-router';
 import 'zod';
 
@@ -115,8 +115,6 @@ declare const DailyReportIdsStreamStatus: () => react.JSX.Element | null;
 
 type DailyReportListProps = {
     dailyReportItems: DailyReportItem[];
-    initialSelectedBusinessDate?: string | null;
-    initialSelectedReportHubId?: number | null;
     autoMarkRead?: boolean;
     selectedReportHubId: number | null;
     onSelectItem: (reportHubId: number | null) => void;
@@ -128,7 +126,7 @@ type DailyReportListProps = {
  * Daily report list cards with key metadata and preview content via virtual scrolling.
  * 主なメタデータと内容プレビューを仮想スクロール表示する日報リスト。
  */
-declare const DailyReportList: ({ dailyReportItems, initialSelectedBusinessDate, initialSelectedReportHubId, autoMarkRead, selectedReportHubId, onSelectItem, userId, initialScrollOffset, onScrollOffsetChange }: DailyReportListProps) => react.JSX.Element;
+declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, initialScrollOffset, onScrollOffsetChange }: DailyReportListProps) => react.JSX.Element;
 
 /** ヘッダー描画スロットに渡される引数。 */
 type DailyReportHeaderProps = {
@@ -167,6 +165,18 @@ type DailyReportFieldLabels = {
     tabRelations: string;
     relationsEmpty: string;
 };
+/**
+ * Mutation-failure notification payload (for a host-supplied error surface).
+ * ミューテーション失敗の通知情報 (ホストが独自の通知 UI を出すための口)。
+ */
+type DailyReportErrorInfo = {
+    /** 失敗した操作の種別 (create / update / publish / delete / addComment / deleteComment / toggleStar / toggleRead)。 */
+    operation: string;
+    /** 表示用のメッセージ (パッケージ内蔵バナー用)。 */
+    message: string;
+    /** 元例外 (診断用)。 */
+    cause?: unknown;
+};
 /** データソースごとのバッジ表示設定。 */
 type SourceTypeConfig = {
     label: string;
@@ -192,6 +202,11 @@ type DailyReportClientConfig = {
     renderHeader: (props: DailyReportHeaderProps) => ReactNode;
     /** 開発向けコントロール (SSE 購読トグル等) を表示するか。 */
     showDevControls: boolean;
+    /**
+     * ミューテーション失敗時の通知ポート。未指定ならパッケージ内蔵の role="alert"
+     * バナーで表示する。ホストが独自トースト等を持つ場合はここへ委譲する。
+     */
+    onError?: (info: DailyReportErrorInfo) => void;
 };
 /**
  * Partial client-config override. `fieldLabels` may itself be partially overridden.
@@ -350,6 +365,25 @@ declare const DailyReportActionProvider: ({ children, user, initialItems, userId
     userId?: string | null;
 }) => react.JSX.Element;
 
+type DailyReportErrorSurface = {
+    /** ミューテーション失敗を通知する。 */
+    notifyError: (info: DailyReportErrorInfo) => void;
+};
+/**
+ * Returns the error-surface API (safe no-op outside the provider).
+ * 通知 API を返す処理 (Provider 外では no-op)。
+ */
+declare const useDailyReportErrorSurface: () => DailyReportErrorSurface;
+/**
+ * Provides the mutation error surface and renders the default alert banner.
+ * ミューテーション通知シームを供給し、既定のアラートバナーを描画するプロバイダー。
+ *
+ * `config.onError` があればホストへ委譲し、内蔵バナーは描画しない (二重表示防止)。
+ */
+declare const DailyReportErrorProvider: ({ children }: {
+    children: ReactNode;
+}) => react.JSX.Element;
+
 /**
  * Animates numeric changes with ease-out cubic.
  * 数値変化をイーズアウト 3 次で補間するフック。
@@ -468,7 +502,21 @@ declare const registerRecentDeletion: (cId: number) => Map<number, number>;
  * 解除関数を返す。
  */
 declare const subscribeCacheReady: (reportHubId: number, callback: () => void) => (() => void);
-declare const applyDailyReportServerUpdates: (_reportHubIdd: number, report: DailyReportDetail) => void;
+declare const applyDailyReportServerUpdates: (_reportHubId: number, report: DailyReportDetail) => void;
+/**
+ * Applies a broadcast (cross-user SSE) report while preserving the viewer's own per-viewer state.
+ * 全ユーザー放送 (SSE) の report を、受信者自身の per-viewer 状態を保持したまま反映する処理。
+ *
+ * SSE の report-create/update/publish が運ぶ isRead/isStarred は**操作した本人の状態**。
+ * そのまま書くと受信者の既読/スター表示が他人の状態で上書きされる。共有フィールドだけを
+ * 取り込み、per-viewer フィールドは受信者のキャッシュ値を保持する。ローカルに無い日報は
+ * 種まきしない (送信者の per-viewer 値で汚すより、次のフェッチが受信者視点の正しい値を
+ * 取るのに任せるほうが安全)。
+ *
+ * ❗ 信頼できる経路 (自分の HTTP 応答・recipient フィルタ済みの自分宛 status-update) は
+ * {@link applyDailyReportServerUpdates} を使うこと — そちらは値をそのまま書く。
+ */
+declare const applyBroadcastReportUpdate: (report: DailyReportDetail) => void;
 type DailyReportDetailResource = {
     report: DailyReportDetail | null;
     error: Error | null;
@@ -616,6 +664,13 @@ type DailyReportIdsStreamClientOptions = {
     /** タイマー実装 (既定 setTimeout / clearTimeout)。 */
     setTimeoutFn?: (handler: () => void, ms: number) => ReturnType<typeof setTimeout>;
     clearTimeoutFn?: (id: ReturnType<typeof setTimeout>) => void;
+    /**
+     * 1 回の read が無音でいられる上限 (ms)。0 以下で無効。
+     * これを超えたら接続を half-open とみなして中断し、retryable として
+     * カーソル再開へ倒す。サーバーのハートビート間隔より必ず長く取る
+     * (生きているが遅いだけの全量クエリ待ちを誤って切らないため)。
+     */
+    readStallTimeoutMs?: number;
     /** 警告ロガー (既定 console.warn)。 */
     warn?: (...args: unknown[]) => void;
     /**
@@ -636,6 +691,8 @@ declare class DailyReportIdsStreamClient {
     private readonly setTimeoutFn;
     private readonly clearTimeoutFn;
     private readonly warn;
+    /** 1 回の read が無音でいられる上限 (ms)。0 以下で無効。 */
+    private readonly readStallTimeoutMs;
     /** reportHubId → アイテム。挿入順を保ち、再開の重複到着を吸収する。 */
     private readonly itemMap;
     private readonly listeners;
@@ -755,6 +812,19 @@ declare class DailyReportIdsStreamClient {
      * 1 回のストリーミング試行を実行し、結末を分類する処理。
      */
     private streamOnce;
+    /**
+     * Reads one chunk, racing the read against a stall watchdog.
+     * 1 チャンクを読む処理。読み取りを stall ウォッチドッグと競争させる。
+     *
+     * サーバーが無音のまま接続を half-open で放置しても (NAT/プロキシのアイドル切断・
+     * VPN 断・スリープ)、`reader.read()` は永久に保留したままになる。これを検知するため
+     * read とタイマーを競争させ、無音が上限を超えたら番兵を返す。生きているが遅いだけの
+     * 全量クエリ待ちはサーバーのハートビート (空行) が read を解決するので誤検知しない。
+     * `readStallTimeoutMs <= 0` のときは素の read (タイマーを張らない・テスト用)。
+     *
+     * @returns 読み取り結果、または stall を表す番兵。read の reject はそのまま伝播する。
+     */
+    private readWithStallGuard;
     /**
      * Merges chunk items into the dedupe map.
      * チャンクのアイテム群を重複排除 Map へ取り込む処理。
@@ -905,7 +975,16 @@ declare const resetDailyReportIdsStreamSessionForTesting: () => void;
  * Shared constants for Daily Report data fetching parameters.
  * 日報データ取得で利用する共通パラメーター。
  */
-declare const DAILY_REPORT_FETCH_DEBOUNCE_MS = 180;
+declare const DAILY_REPORT_FETCH_DEBOUNCE_MS = 120;
+/**
+ * Delay before the provider auto-connects SSE, freeing a browser connection slot for first paint.
+ * SSE を自動接続するまでの遅延。初回描画とその中身フェッチへ接続枠を譲るための猶予。
+ *
+ * HTTP/1.1 のオリジン当たり 6 接続のうち、ids ストリームと SSE で 2 枠を常時占有する。
+ * SSE 接続を初回描画直後まで遅らせ、その 1 枠を初回の中身フェッチ (`/business-date`) に回す。
+ * リアルタイム更新の初動がこの分だけ遅れるが、その間の状態はストリーム / SWR が担保する。
+ */
+declare const SSE_INITIAL_CONNECT_DEFER_MS = 1000;
 declare const DEFAULT_ITEM_HEIGHT = 160;
 declare const ITEM_VERTICAL_PADDING = 6;
 declare const ITEM_CONTAINER_HEIGHT: number;
@@ -964,4 +1043,4 @@ declare const TAP_SCROLL_CIRCLE_OPTIONS: ScrollBarTapCircleOptions;
  */
 declare const CONTENT_DRAG_POINTER_INPUTS: readonly ["pen", "touch"];
 
-export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailResource, DailyReportEditForm, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, SSE_INITIAL_CONNECT_DEFER_MS, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import * as react from 'react';
 import { ReactNode, Context, RefObject } from 'react';
 import { ScrollBarThumbOverlayRenderProps, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from '@aiquants/virtualscroll';
 import { D as DailyReportAttachmentSummary, a as DailyReportItem, b as DailyReportDetail, c as DailyReportUser } from './types-Ct1ggzy-.js';
-import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-RHckD7TS.js';
+import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-YZh7Pz7i.js';
 import { ShouldRevalidateFunction } from 'react-router';
 import 'zod';
 
@@ -115,8 +115,6 @@ declare const DailyReportIdsStreamStatus: () => react.JSX.Element | null;
 
 type DailyReportListProps = {
     dailyReportItems: DailyReportItem[];
-    initialSelectedBusinessDate?: string | null;
-    initialSelectedReportHubId?: number | null;
     autoMarkRead?: boolean;
     selectedReportHubId: number | null;
     onSelectItem: (reportHubId: number | null) => void;
@@ -128,7 +126,7 @@ type DailyReportListProps = {
  * Daily report list cards with key metadata and preview content via virtual scrolling.
  * 主なメタデータと内容プレビューを仮想スクロール表示する日報リスト。
  */
-declare const DailyReportList: ({ dailyReportItems, initialSelectedBusinessDate, initialSelectedReportHubId, autoMarkRead, selectedReportHubId, onSelectItem, userId, initialScrollOffset, onScrollOffsetChange }: DailyReportListProps) => react.JSX.Element;
+declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, initialScrollOffset, onScrollOffsetChange }: DailyReportListProps) => react.JSX.Element;
 
 /** ヘッダー描画スロットに渡される引数。 */
 type DailyReportHeaderProps = {
@@ -167,6 +165,18 @@ type DailyReportFieldLabels = {
     tabRelations: string;
     relationsEmpty: string;
 };
+/**
+ * Mutation-failure notification payload (for a host-supplied error surface).
+ * ミューテーション失敗の通知情報 (ホストが独自の通知 UI を出すための口)。
+ */
+type DailyReportErrorInfo = {
+    /** 失敗した操作の種別 (create / update / publish / delete / addComment / deleteComment / toggleStar / toggleRead)。 */
+    operation: string;
+    /** 表示用のメッセージ (パッケージ内蔵バナー用)。 */
+    message: string;
+    /** 元例外 (診断用)。 */
+    cause?: unknown;
+};
 /** データソースごとのバッジ表示設定。 */
 type SourceTypeConfig = {
     label: string;
@@ -192,6 +202,11 @@ type DailyReportClientConfig = {
     renderHeader: (props: DailyReportHeaderProps) => ReactNode;
     /** 開発向けコントロール (SSE 購読トグル等) を表示するか。 */
     showDevControls: boolean;
+    /**
+     * ミューテーション失敗時の通知ポート。未指定ならパッケージ内蔵の role="alert"
+     * バナーで表示する。ホストが独自トースト等を持つ場合はここへ委譲する。
+     */
+    onError?: (info: DailyReportErrorInfo) => void;
 };
 /**
  * Partial client-config override. `fieldLabels` may itself be partially overridden.
@@ -350,6 +365,25 @@ declare const DailyReportActionProvider: ({ children, user, initialItems, userId
     userId?: string | null;
 }) => react.JSX.Element;
 
+type DailyReportErrorSurface = {
+    /** ミューテーション失敗を通知する。 */
+    notifyError: (info: DailyReportErrorInfo) => void;
+};
+/**
+ * Returns the error-surface API (safe no-op outside the provider).
+ * 通知 API を返す処理 (Provider 外では no-op)。
+ */
+declare const useDailyReportErrorSurface: () => DailyReportErrorSurface;
+/**
+ * Provides the mutation error surface and renders the default alert banner.
+ * ミューテーション通知シームを供給し、既定のアラートバナーを描画するプロバイダー。
+ *
+ * `config.onError` があればホストへ委譲し、内蔵バナーは描画しない (二重表示防止)。
+ */
+declare const DailyReportErrorProvider: ({ children }: {
+    children: ReactNode;
+}) => react.JSX.Element;
+
 /**
  * Animates numeric changes with ease-out cubic.
  * 数値変化をイーズアウト 3 次で補間するフック。
@@ -468,7 +502,21 @@ declare const registerRecentDeletion: (cId: number) => Map<number, number>;
  * 解除関数を返す。
  */
 declare const subscribeCacheReady: (reportHubId: number, callback: () => void) => (() => void);
-declare const applyDailyReportServerUpdates: (_reportHubIdd: number, report: DailyReportDetail) => void;
+declare const applyDailyReportServerUpdates: (_reportHubId: number, report: DailyReportDetail) => void;
+/**
+ * Applies a broadcast (cross-user SSE) report while preserving the viewer's own per-viewer state.
+ * 全ユーザー放送 (SSE) の report を、受信者自身の per-viewer 状態を保持したまま反映する処理。
+ *
+ * SSE の report-create/update/publish が運ぶ isRead/isStarred は**操作した本人の状態**。
+ * そのまま書くと受信者の既読/スター表示が他人の状態で上書きされる。共有フィールドだけを
+ * 取り込み、per-viewer フィールドは受信者のキャッシュ値を保持する。ローカルに無い日報は
+ * 種まきしない (送信者の per-viewer 値で汚すより、次のフェッチが受信者視点の正しい値を
+ * 取るのに任せるほうが安全)。
+ *
+ * ❗ 信頼できる経路 (自分の HTTP 応答・recipient フィルタ済みの自分宛 status-update) は
+ * {@link applyDailyReportServerUpdates} を使うこと — そちらは値をそのまま書く。
+ */
+declare const applyBroadcastReportUpdate: (report: DailyReportDetail) => void;
 type DailyReportDetailResource = {
     report: DailyReportDetail | null;
     error: Error | null;
@@ -616,6 +664,13 @@ type DailyReportIdsStreamClientOptions = {
     /** タイマー実装 (既定 setTimeout / clearTimeout)。 */
     setTimeoutFn?: (handler: () => void, ms: number) => ReturnType<typeof setTimeout>;
     clearTimeoutFn?: (id: ReturnType<typeof setTimeout>) => void;
+    /**
+     * 1 回の read が無音でいられる上限 (ms)。0 以下で無効。
+     * これを超えたら接続を half-open とみなして中断し、retryable として
+     * カーソル再開へ倒す。サーバーのハートビート間隔より必ず長く取る
+     * (生きているが遅いだけの全量クエリ待ちを誤って切らないため)。
+     */
+    readStallTimeoutMs?: number;
     /** 警告ロガー (既定 console.warn)。 */
     warn?: (...args: unknown[]) => void;
     /**
@@ -636,6 +691,8 @@ declare class DailyReportIdsStreamClient {
     private readonly setTimeoutFn;
     private readonly clearTimeoutFn;
     private readonly warn;
+    /** 1 回の read が無音でいられる上限 (ms)。0 以下で無効。 */
+    private readonly readStallTimeoutMs;
     /** reportHubId → アイテム。挿入順を保ち、再開の重複到着を吸収する。 */
     private readonly itemMap;
     private readonly listeners;
@@ -755,6 +812,19 @@ declare class DailyReportIdsStreamClient {
      * 1 回のストリーミング試行を実行し、結末を分類する処理。
      */
     private streamOnce;
+    /**
+     * Reads one chunk, racing the read against a stall watchdog.
+     * 1 チャンクを読む処理。読み取りを stall ウォッチドッグと競争させる。
+     *
+     * サーバーが無音のまま接続を half-open で放置しても (NAT/プロキシのアイドル切断・
+     * VPN 断・スリープ)、`reader.read()` は永久に保留したままになる。これを検知するため
+     * read とタイマーを競争させ、無音が上限を超えたら番兵を返す。生きているが遅いだけの
+     * 全量クエリ待ちはサーバーのハートビート (空行) が read を解決するので誤検知しない。
+     * `readStallTimeoutMs <= 0` のときは素の read (タイマーを張らない・テスト用)。
+     *
+     * @returns 読み取り結果、または stall を表す番兵。read の reject はそのまま伝播する。
+     */
+    private readWithStallGuard;
     /**
      * Merges chunk items into the dedupe map.
      * チャンクのアイテム群を重複排除 Map へ取り込む処理。
@@ -905,7 +975,16 @@ declare const resetDailyReportIdsStreamSessionForTesting: () => void;
  * Shared constants for Daily Report data fetching parameters.
  * 日報データ取得で利用する共通パラメーター。
  */
-declare const DAILY_REPORT_FETCH_DEBOUNCE_MS = 180;
+declare const DAILY_REPORT_FETCH_DEBOUNCE_MS = 120;
+/**
+ * Delay before the provider auto-connects SSE, freeing a browser connection slot for first paint.
+ * SSE を自動接続するまでの遅延。初回描画とその中身フェッチへ接続枠を譲るための猶予。
+ *
+ * HTTP/1.1 のオリジン当たり 6 接続のうち、ids ストリームと SSE で 2 枠を常時占有する。
+ * SSE 接続を初回描画直後まで遅らせ、その 1 枠を初回の中身フェッチ (`/business-date`) に回す。
+ * リアルタイム更新の初動がこの分だけ遅れるが、その間の状態はストリーム / SWR が担保する。
+ */
+declare const SSE_INITIAL_CONNECT_DEFER_MS = 1000;
 declare const DEFAULT_ITEM_HEIGHT = 160;
 declare const ITEM_VERTICAL_PADDING = 6;
 declare const ITEM_CONTAINER_HEIGHT: number;
@@ -964,4 +1043,4 @@ declare const TAP_SCROLL_CIRCLE_OPTIONS: ScrollBarTapCircleOptions;
  */
 declare const CONTENT_DRAG_POINTER_INPUTS: readonly ["pen", "touch"];
 
-export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailResource, DailyReportEditForm, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, SSE_INITIAL_CONNECT_DEFER_MS, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };