@aiquants/daily-report 0.21.0 → 0.22.0

package/README.md

@@ -25,7 +25,7 @@ External projects:
 pnpm add @aiquants/daily-report react react-dom react-router drizzle-orm zod
 ```
 
-`react` / `react-dom` / `react-router` / `drizzle-orm` / `zod` are **peer dependencies**. Build / test: `pnpm run build` (tsup → dist) / `pnpm run test` (vitest).
+`react` / `react-dom` / `react-router` / `drizzle-orm` / `zod` are **peer dependencies**. `@aiquants/sse` (the SSE wire contract, server response helpers and the reopening client) is a regular **dependency**: it arrives transitively, so consumers do not declare it. Build / test: `pnpm run build` (tsup → dist) / `pnpm run test` (vitest).
 
 ### Tailwind CSS
 
@@ -156,7 +156,7 @@ createDailyReportServer({
 - **How it reaches the service**: the resolved set is wrapped in a `DailyReportViewerScope` and passed as the **first** argument of every gated service method.
   The class is nominal (it holds a private field), so `{ visible: null }`, `{ ...scope, visible: null }` and `new DailyReportViewerScope(...)` are all type errors — the only ways to obtain one are `DailyReportViewerScope.restrictTo(tokens)` — which accepts `readonly string[]` only, so it cannot be handed a nullish value and quietly widen — and `DailyReportViewerScope.unrestricted(auditReason)`.
   Because a bare `null` is not spellable as a visibility value, `grep -rn "DailyReportViewerScope.unrestricted("` enumerates every unfiltered read in a codebase, each carrying a written reason.
-- **Performance**: the port is called once per request on the critical path (cache keys incorporate the resolved set), so keep it fast — cache grants per session/user with a short TTL (≤ 60s). A live SSE connection re-resolves on its existing keep-alive tick (~60s) to bound how long a revoked grant keeps streaming; that call passes `reason: "refresh"` and reuses the connection's original `Request`, so a cache keyed on request identity **must** be bypassed when `reason === "refresh"` or the re-check silently returns the stale set.
+- **Performance**: the port is called once per request on the critical path (cache keys incorporate the resolved set), so keep it fast — cache grants per session/user with a short TTL (≤ 60s). A live SSE connection re-resolves on a dedicated 60 s timer (independent of the heartbeat) to bound how long a revoked grant keeps streaming; that call passes `reason: "refresh"` and reuses the connection's original `Request`, so a cache keyed on request identity **must** be bypassed when `reason === "refresh"` or the re-check silently returns the stale set.
 - **SSE latency**: because a live connection re-resolves periodically, a grant change (in either direction) takes effect for the stream within ~60s. Events dropped before a widening are not replayed; the next read (which re-resolves per request) restores them.
 
 ### Comment visibility
@@ -211,6 +211,7 @@ export default function Route() {
                 user={user}
                 userId={userId}
                 config={{
+                    onSessionExpired: () => navigate(0),    // Required: the host decides the navigation on session expiry
                     renderHeader: ({ title, annotation }) => <YourHeader title={title} annotation={annotation} />,
                     showDevControls: import.meta.env.DEV,   // Toggle SSE subscriptions, etc.
                     draftLabelName: "Draft",                // Label name for draft states (matches target DB; not tied to locale)
@@ -227,6 +228,8 @@ export default function Route() {
 }
 ```
 
+`config` is **required** and so is its `onSessionExpired` port (omitting it is a type error, TS2741; a non-function throws a `TypeError` at render). The package never navigates by itself: when the session is gone — the SSE stream ends with `auth-required`, or the ids stream answers 401 / 403 — it calls `onSessionExpired()` exactly once per occurrence and stops. A typical host reloads the route (`navigate(0)`) so its own loader redirects to the login page. `DailyReportConfigProvider` takes the same required `config`; outside a provider, the default configuration's `onSessionExpired` throws.
+
 `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.
@@ -525,13 +528,54 @@ export default defineConfig({
 
 1. Mutation services publish to Redis Stream (`daily-report:sse-stream`) in sequence: `invalidate -> epoch increment -> SSE publish`.
 2. `DailyReportSseReader` uses a single blocking `xRead` loop to fan-out events to all SSE connections (eliminating per-connection Redis TCP connections).
-3. `sse.loader` implements catch-up (`xRange`) using `Last-Event-ID` / `lastEventId` and 5-second keep-alive pings. `recipientRawUserId` is filtered server-side and removed before transmission to prevent internal ID leaks.
-4. On the client, `useDailyReportSseConnection` handles exponential backoff reconnects, and the action context correlates optimistic updates with SSE echoes using `clientTempId`.
+3. `sse.loader` is built on `@aiquants/sse/server` (`createSseResponse`, `terminalStreamResponse`, `startSseHeartbeat`, `readLastEventId`). Its responses carry only `SSE_RESPONSE_HEADERS` plus the forwarded `Set-Cookie` (no `Connection` or other hop-by-hop header, which HTTP/2 forbids). `recipientRawUserId` is filtered server-side and removed before transmission to prevent internal ID leaks. Catch-up and live entries pass through the same filters (recipient, source-type visibility, comment redaction).
+4. On the client, `useDailyReportSseConnection` runs on `useReopeningEventSource` (`@aiquants/sse/react`): full-jitter backoff from 2 s to 30 s, the failure count reset only after 30 s of healthy open, one native browser reconnect (which carries the cursor in the `Last-Event-ID` header), and a stale watch of 45 s (three heartbeat periods).
+   The action context correlates optimistic updates with SSE echoes using `clientTempId`, and exposes the connection status as `sseStatus` (`DailyReportSseConnectionStatus`: the reopening status, or `{ kind: "resyncing" }` while a `resync-required` waits for a fresh ids anchor).
+
+### SSE wire contract
+
+Stop signals are **in-band**: the server answers 200 and writes `retry: 86400000` before one named terminal event, so a client that does not listen for the event (an older bundle) reconnects at most once a day instead of in a loop. A non-200 response is reserved for a misconfigured endpoint.
+
+| Server-side situation | Response | Client (`useDailyReportSseConnection`) |
+| --- | --- | --- |
+| Not authenticated | 200, `retry: 86400000` → `event: auth-required` (`Set-Cookie` forwarded) | terminated; calls `config.onSessionExpired()` once; never reconnects |
+| Authenticated but no internal user | 200, `retry: 86400000` → `event: forbidden` | terminated; no navigation (a reload cannot fix it); visible through `sseStatus` |
+| Unknown endpoint | 404 | treated as retryable; backoff up to 30 s |
+| Unexpected error before the stream starts (for example the internal-user lookup fails) | 500 with the body `Internal Server Error` (no error detail), `Set-Cookie` forwarded | treated as retryable; backoff up to 30 s |
+| Malformed cursor | 200, `retry: 86400000` → `event: resync-required` | rereads the ids (server cache bypassed) and reopens from the new anchor |
+| Cursor older than the oldest retained entry (the stream is trimmed with `MAXLEN ~ streamMaxLen`) | 200, `connected` → heartbeat → `retry: 86400000` → `event: resync-required` → end | same as above |
+| The start of a catch-up page is trimmed away before the page is read | 200, the entries delivered so far → `retry: 86400000` → `event: resync-required` → end | same as above |
+| Empty stream, or a cursor inside the retained window or in the future | 200, `connected` → heartbeat → catch-up (every entry) → live | continues |
+| Redis failure during the catch-up | the body ends (`producer-failed`) | one native reconnect with `Last-Event-ID`, then the utility's own backoff; the cursor is kept |
+
+- **Resume cursor**: `readLastEventId` reads the `Last-Event-ID` header first, then the `lastEventId` query parameter (`DAILY_REPORT_SSE_CURSOR_PARAM`). The browser's own reconnect reuses the URL it opened with (a stale query) but sends a fresh header, so the header is always the newer value. A cursor must be a Redis stream id of the form `<ms>-<seq>` with 1–15 digits per part (`isDailyReportSseStreamId`); anything else is answered with `resync-required`. The client URL-encodes the cursor.
+- **`connected` frame**: `data: {"type":"connected"}` with `id:` set to the resume position (the cursor, or the newest entry at connect time when there is no cursor). On the cursor path it is written before any Redis round trip.
+  The same frame is used as an anchor-only frame for entries the viewer's filters drop (addressed to another user, or a source type the viewer cannot see), so the client's cursor keeps advancing without receiving their content.
+  Without it, a tab whose visible traffic is quiet while other users' read / star updates flow would keep an old cursor, and its next reconnect would fall outside the retained window (`resync-required`, then an ids rescan that bypasses the server cache).
+- **Catch-up**: entries after the cursor are read in pages of 1,000 (`xRange` is inclusive, so each page skips its start id) until the stream end; every entry is delivered. When a page does not start with its start id, the oldest retained entry is read again: if it is newer than the start id, the range after it may have been trimmed, so the connection ends with `resync-required` instead of silently skipping it (a cursor that is simply not an entry id inside the retained window continues).
+- **Ids on the wire only increase**: live entries that arrive during the catch-up are queued, not written. The catch-up stops in front of the first queued entry (the fan-out reader delivers every entry after it in order), then the queue is written in id order and later live entries are written as they arrive. Writing a live entry first would let a disconnect move the client's resume position past catch-up entries it never received, and an older `report-update` would overwrite a newer one on the client.
+- **Heartbeat**: `startSseHeartbeat` writes a jittered `retry:` (2,000–10,000 ms), an immediate named `event: heartbeat` (`data: {"serverTime":<ms>}`, no `id:`), then one every 15 s (`DAILY_REPORT_SSE_HEARTBEAT_MS`). Named events are ignored by `onmessage`, so old bundles are unaffected.
+- **Stream anchor (`streamAnchor`)**: the ids stream carries the newest SSE entry id on its first authoritative line
+  (the line with `total`, or the short-circuit line when the whole data set fits in the fast first page; never on a
+  provisional line). The service reads it inside the cached fetcher **before** the SQL, so every cache path (bucket hit,
+  joining an in-flight fetch, refresh-ahead) returns an array that already reflects every update up to the anchor. The
+  SSE hook does not connect until an anchor arrives and then uses it as the first cursor, which closes the gap between
+  loading the ids and opening the stream. `null` means "position unknown" (empty stream, no redis, read failure): the
+  hook then opens without a cursor and the server starts from the newest entry at connect time.
+- **Delivery is idempotent**: an anchor can be up to one ids-cache TTL old; replaying from it is safe because `report-*` messages upsert and `comment-add` is matched by comment id.
+- **A resync that gives up is retried**: after `resync-required` the hook asks the ids session for a rescan (`resyncDailyReportIdsStream()`) and does not reconnect until an anchor newer than the one it had arrives. When that rescan gives up (the ids phase stays `complete` with an `error`, which happens after repeated failures during an outage), the hook asks again after a full-jitter backoff from 2 s to 30 s while SSE is enabled, until an anchor arrives. An initial ids scan that ends in `failed` is left to the page's manual retry.
 
 ## API Surface (Summary)
 
-- **server**: `createDailyReportServer` / `createDailyReportService` / `createDailyReportHandlers` / `defineDailyReportSchema` / `DailyReportSseReader` / `SqlResultCache` / `transformJsonArray` / `jsonResponseWithETag` / `generateETag` / `isStreamIdLte`
-- **client**: `DailyReportPage` / `DailyReportResolvedContent` / `DailyReportList` / `DailyReportDetailList` / `DailyReportActionProvider` / `useDailyReportActionContext` / `useDailyReportDetail` / `useDailyReportPrefetch` / `useDailyReportComments` / `useDailyReportSseConnection` / `useDailyReportIdsStream` / `DailyReportIdsStreamStatus` / `DailyReportIdsStreamClient` / `DailyReportConfigProvider` / `useDailyReportConfig` / `defaultDailyReportClientConfig` / `resolveDailyReportLabels` / `DAILY_REPORT_LABEL_CATALOGS` / `DAILY_REPORT_LABEL_KEYS` / `createDailyReportClientLoader` / `dailyReportShouldRevalidate`
-- **shared**: `DailyReportItem` / `DailyReportDetail` / `DailyReportUser` / `dailyReportSseMessageSchema` (8 discriminated union types) / `normalizeBusinessDateKey` / `mergeComments(legacyComments, modernComments, currentUserId, unknownAuthorName)`
+- **server**: `createDailyReportServer` / `createDailyReportService` (`getDailyReportIdsByExternalId` returns `{ items, streamAnchor }`; `readSseStreamAnchor`) / `createDailyReportHandlers` / `DAILY_REPORT_SSE_VISIBILITY_REFRESH_MS` / `DAILY_REPORT_SSE_CATCH_UP_BATCH` / `defineDailyReportSchema` / `DailyReportSseReader` / `SqlResultCache` / `transformJsonArray` / `jsonResponseWithETag` / `generateETag` / `isStreamIdLte`
+- **client**: `DailyReportPage` / `DailyReportResolvedContent` / `DailyReportList` / `DailyReportDetailList` /
+  `DailyReportActionProvider` / `useDailyReportActionContext` (`sseStatus`) / `useDailyReportDetail` /
+  `useDailyReportPrefetch` / `useDailyReportComments` / `useDailyReportSseConnection` (returns
+  `DailyReportSseConnectionStatus`) / `useDailyReportIdsStream` (state carries `streamAnchor`) /
+  `resyncDailyReportIdsStream` / `DailyReportIdsStreamStatus` / `DailyReportIdsStreamClient` (`resync()`) /
+  `DailyReportConfigProvider` / `useDailyReportConfig` / `defaultDailyReportClientConfig` / `resolveDailyReportLabels` /
+  `DAILY_REPORT_LABEL_CATALOGS` / `DAILY_REPORT_LABEL_KEYS` / `createDailyReportClientLoader` /
+  `dailyReportShouldRevalidate`
+- **shared**: `DailyReportItem` / `DailyReportDetail` / `DailyReportUser` / `dailyReportSseMessageSchema` (8 discriminated union types) / `DAILY_REPORT_SSE_TERMINAL_EVENTS` / `DAILY_REPORT_SSE_HEARTBEAT_MS` / `DAILY_REPORT_SSE_CURSOR_PARAM` / `isDailyReportSseStreamId` / `DailyReportSseStreamAnchor` / `normalizeBusinessDateKey` / `mergeComments(legacyComments, modernComments, currentUserId, unknownAuthorName)`
 
 MIT

package/dist/client.d.mts

@@ -2,7 +2,8 @@ import * as react from "react";
 import { RefObject, ReactNode, Context } from "react";
 import { ScrollBarThumbOverlayRenderProps, VirtualScrollLocale, VirtualScrollLabels, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from "@aiquants/virtualscroll";
 import { D as DailyReportAttachmentSummary, a as DailyReportItem, b as DailyReportDetail, c as DailyReportUser } from "./types-CqgYQgbH.mjs";
-import { U as UIComment, D as DailyReportSseMessage } from "./sse-schema-DCxpdETM.mjs";
+import { U as UIComment, D as DailyReportSseTerminalEvent, a as DailyReportSseMessage, b as DailyReportSseStreamAnchor } from "./ids-stream-DCuiaTit.mjs";
+import { UseReopeningEventSourceResult } from "@aiquants/sse/react";
 import { ShouldRevalidateFunction } from "react-router";
 import "zod";
 declare const BusinessDayThumbOverlay: ({ orientation, thumbCenter, label, isDragging, isTapScrollActive, isWheelScrollActive }: ScrollBarThumbOverlayRenderProps & {
@@ -282,15 +283,17 @@ type DailyReportClientConfig = {
     renderHeader: (props: DailyReportHeaderProps) => ReactNode;
     showDevControls: boolean;
     onError?: (info: DailyReportErrorInfo) => void;
+    onSessionExpired: () => void;
 };
-type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "locale" | "labels">> & {
+type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "locale" | "labels" | "onSessionExpired">> & {
     locale?: DailyReportLocale;
     labels?: DailyReportLabelOverrides;
+    onSessionExpired: () => void;
 };
 type DailyReportClientConfigDefaults = Readonly<Pick<DailyReportClientConfig, "apiBasePath" | "ssePath" | "draftLabelName" | "renderHeader" | "showDevControls">>;
 declare const defaultDailyReportClientConfig: DailyReportClientConfigDefaults;
 declare const DailyReportConfigProvider: ({ config, children }: {
-    config?: DailyReportClientConfigInput;
+    config: DailyReportClientConfigInput;
     children: ReactNode;
 }) => react.JSX.Element;
 declare const useDailyReportConfig: () => DailyReportClientConfig;
@@ -300,7 +303,7 @@ declare const DailyReportLoading: () => react.JSX.Element;
 type DailyReportPageProps = {
     user?: DailyReportUser;
     userId?: string | null;
-    config?: DailyReportClientConfigInput;
+    config: DailyReportClientConfigInput;
 };
 declare const DailyReportPage: ({ config, ...rest }: DailyReportPageProps) => react.JSX.Element;
 type DailyReportResolvedContentProps = {
@@ -311,6 +314,16 @@ type UnreadIndicatorProps = {
     className?: string;
 };
 declare const UnreadIndicator: ({ className }: UnreadIndicatorProps) => react.JSX.Element;
+type DailyReportSseConnectionStatus = UseReopeningEventSourceResult<DailyReportSseTerminalEvent>["status"] | {
+    readonly kind: "resyncing";
+};
+type UseDailyReportSseConnectionOptions = {
+    isSseEnabled: boolean;
+    onMessage: (payload: Exclude<DailyReportSseMessage, {
+        type: "connected";
+    }>) => void;
+};
+declare const useDailyReportSseConnection: ({ isSseEnabled, onMessage }: UseDailyReportSseConnectionOptions) => DailyReportSseConnectionStatus;
 type DailyReportActionContextType = {
     user?: DailyReportUser;
     pendingAddCommentIds: React.MutableRefObject<Map<number, Map<number, string>>>;
@@ -322,6 +335,7 @@ type DailyReportActionContextType = {
     items: DailyReportItem[];
     isSseEnabled: boolean;
     toggleSse: () => void;
+    sseStatus: DailyReportSseConnectionStatus;
     addComment: (reportHubId: number, content: string, businessDate: string) => Promise<void>;
     deleteComment: (reportHubId: number, commentId: number, businessDate: string) => Promise<void>;
     toggleStar: (reportHubId: number, isStarred: boolean, businessDate: string) => Promise<void>;
@@ -420,13 +434,6 @@ declare const useDailyReportComments: (report: DailyReportDetail | null, user: U
     setPendingDeleteId: react.Dispatch<react.SetStateAction<string | number | null>>;
     resolvedIdMap: Map<number, number>;
 };
-type UseDailyReportSseConnectionOptions = {
-    isSseEnabled: boolean;
-    onMessage: (payload: Exclude<DailyReportSseMessage, {
-        type: "connected";
-    }>) => void;
-};
-declare const useDailyReportSseConnection: ({ isSseEnabled, onMessage }: UseDailyReportSseConnectionOptions) => void;
 type UseDynamicViewportHeightOptions = {
     enableMutationObserver?: boolean;
     bottomGap?: number;
@@ -456,6 +463,7 @@ type DailyReportIdsStreamState = {
     hasCompletedOnce: boolean;
     completedAt: number | null;
     error: Error | null;
+    streamAnchor: DailyReportSseStreamAnchor | null;
 };
 type DailyReportIdsStreamClientOptions = {
     apiBasePath?: string;
@@ -480,6 +488,7 @@ declare class DailyReportIdsStreamClient {
     private readonly itemMap;
     private readonly listeners;
     private state;
+    private streamAnchorRevision;
     private lastCursor;
     private lastSnapshot;
     private consecutiveFailures;
@@ -503,6 +512,7 @@ declare class DailyReportIdsStreamClient {
     refresh(options?: {
         forceRefresh?: boolean;
     }): void;
+    resync(): void;
     applyExternalUpsert(item: DailyReportItem): void;
     applyExternalRemoval(reportHubId: number): void;
     dispose(): void;
@@ -511,6 +521,7 @@ declare class DailyReportIdsStreamClient {
     private streamOnce;
     private readWithStallGuard;
     private absorbChunkLine;
+    private absorbStreamAnchor;
     private publishItems;
     private schedulePublishItems;
     private cancelScheduledPublishItems;
@@ -518,7 +529,6 @@ declare class DailyReportIdsStreamClient {
     private buildStreamUrl;
     private waitBeforeRetry;
 }
-declare const reloadDocument: () => void;
 declare const ensureDailyReportIdsStreamSession: (options: {
     apiBasePath?: string;
     userKey: string | null;
@@ -531,6 +541,7 @@ declare const primeDailyReportIdsStreamSession: () => void;
 declare const upsertDailyReportIdsStreamItem: (item: DailyReportItem) => void;
 declare const removeDailyReportIdsStreamItem: (reportHubId: number) => void;
 declare const retryDailyReportIdsStream: () => void;
+declare const resyncDailyReportIdsStream: () => void;
 declare const refreshDailyReportIdsStream: (options?: {
     forceRefresh?: boolean;
 }) => void;
@@ -557,4 +568,4 @@ declare const CONTENT_DRAG_POINTER_INPUTS: readonly [
     "pen",
     "touch"
 ];
-export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DAILY_REPORT_LABEL_CATALOGS, DAILY_REPORT_LABEL_KEYS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigDefaults, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, type DailyReportLabelOverrides, type DailyReportLabels, DailyReportList, DailyReportLoadError, DailyReportLoading, type DailyReportLocale, type DailyReportOperation, DailyReportPage, type DailyReportPageProps, DailyReportPostedComment, 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, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveDailyReportLabels, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DAILY_REPORT_LABEL_CATALOGS, DAILY_REPORT_LABEL_KEYS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigDefaults, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, type DailyReportLabelOverrides, type DailyReportLabels, DailyReportList, DailyReportLoadError, DailyReportLoading, type DailyReportLocale, type DailyReportOperation, DailyReportPage, type DailyReportPageProps, DailyReportPostedComment, DailyReportResolvedContent, type DailyReportSseConnectionStatus, 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, type UseDailyReportSseConnectionOptions, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveDailyReportLabels, resolveSourceTypeConfig, resyncDailyReportIdsStream, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };

package/dist/client.d.ts

@@ -2,7 +2,8 @@ import * as react from "react";
 import { RefObject, ReactNode, Context } from "react";
 import { ScrollBarThumbOverlayRenderProps, VirtualScrollLocale, VirtualScrollLabels, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from "@aiquants/virtualscroll";
 import { D as DailyReportAttachmentSummary, a as DailyReportItem, b as DailyReportDetail, c as DailyReportUser } from "./types-CqgYQgbH.js";
-import { U as UIComment, D as DailyReportSseMessage } from "./sse-schema-DoQw8_om.js";
+import { U as UIComment, D as DailyReportSseTerminalEvent, a as DailyReportSseMessage, b as DailyReportSseStreamAnchor } from "./ids-stream-BnM6L-Sk.js";
+import { UseReopeningEventSourceResult } from "@aiquants/sse/react";
 import { ShouldRevalidateFunction } from "react-router";
 import "zod";
 declare const BusinessDayThumbOverlay: ({ orientation, thumbCenter, label, isDragging, isTapScrollActive, isWheelScrollActive }: ScrollBarThumbOverlayRenderProps & {
@@ -282,15 +283,17 @@ type DailyReportClientConfig = {
     renderHeader: (props: DailyReportHeaderProps) => ReactNode;
     showDevControls: boolean;
     onError?: (info: DailyReportErrorInfo) => void;
+    onSessionExpired: () => void;
 };
-type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "locale" | "labels">> & {
+type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "locale" | "labels" | "onSessionExpired">> & {
     locale?: DailyReportLocale;
     labels?: DailyReportLabelOverrides;
+    onSessionExpired: () => void;
 };
 type DailyReportClientConfigDefaults = Readonly<Pick<DailyReportClientConfig, "apiBasePath" | "ssePath" | "draftLabelName" | "renderHeader" | "showDevControls">>;
 declare const defaultDailyReportClientConfig: DailyReportClientConfigDefaults;
 declare const DailyReportConfigProvider: ({ config, children }: {
-    config?: DailyReportClientConfigInput;
+    config: DailyReportClientConfigInput;
     children: ReactNode;
 }) => react.JSX.Element;
 declare const useDailyReportConfig: () => DailyReportClientConfig;
@@ -300,7 +303,7 @@ declare const DailyReportLoading: () => react.JSX.Element;
 type DailyReportPageProps = {
     user?: DailyReportUser;
     userId?: string | null;
-    config?: DailyReportClientConfigInput;
+    config: DailyReportClientConfigInput;
 };
 declare const DailyReportPage: ({ config, ...rest }: DailyReportPageProps) => react.JSX.Element;
 type DailyReportResolvedContentProps = {
@@ -311,6 +314,16 @@ type UnreadIndicatorProps = {
     className?: string;
 };
 declare const UnreadIndicator: ({ className }: UnreadIndicatorProps) => react.JSX.Element;
+type DailyReportSseConnectionStatus = UseReopeningEventSourceResult<DailyReportSseTerminalEvent>["status"] | {
+    readonly kind: "resyncing";
+};
+type UseDailyReportSseConnectionOptions = {
+    isSseEnabled: boolean;
+    onMessage: (payload: Exclude<DailyReportSseMessage, {
+        type: "connected";
+    }>) => void;
+};
+declare const useDailyReportSseConnection: ({ isSseEnabled, onMessage }: UseDailyReportSseConnectionOptions) => DailyReportSseConnectionStatus;
 type DailyReportActionContextType = {
     user?: DailyReportUser;
     pendingAddCommentIds: React.MutableRefObject<Map<number, Map<number, string>>>;
@@ -322,6 +335,7 @@ type DailyReportActionContextType = {
     items: DailyReportItem[];
     isSseEnabled: boolean;
     toggleSse: () => void;
+    sseStatus: DailyReportSseConnectionStatus;
     addComment: (reportHubId: number, content: string, businessDate: string) => Promise<void>;
     deleteComment: (reportHubId: number, commentId: number, businessDate: string) => Promise<void>;
     toggleStar: (reportHubId: number, isStarred: boolean, businessDate: string) => Promise<void>;
@@ -420,13 +434,6 @@ declare const useDailyReportComments: (report: DailyReportDetail | null, user: U
     setPendingDeleteId: react.Dispatch<react.SetStateAction<string | number | null>>;
     resolvedIdMap: Map<number, number>;
 };
-type UseDailyReportSseConnectionOptions = {
-    isSseEnabled: boolean;
-    onMessage: (payload: Exclude<DailyReportSseMessage, {
-        type: "connected";
-    }>) => void;
-};
-declare const useDailyReportSseConnection: ({ isSseEnabled, onMessage }: UseDailyReportSseConnectionOptions) => void;
 type UseDynamicViewportHeightOptions = {
     enableMutationObserver?: boolean;
     bottomGap?: number;
@@ -456,6 +463,7 @@ type DailyReportIdsStreamState = {
     hasCompletedOnce: boolean;
     completedAt: number | null;
     error: Error | null;
+    streamAnchor: DailyReportSseStreamAnchor | null;
 };
 type DailyReportIdsStreamClientOptions = {
     apiBasePath?: string;
@@ -480,6 +488,7 @@ declare class DailyReportIdsStreamClient {
     private readonly itemMap;
     private readonly listeners;
     private state;
+    private streamAnchorRevision;
     private lastCursor;
     private lastSnapshot;
     private consecutiveFailures;
@@ -503,6 +512,7 @@ declare class DailyReportIdsStreamClient {
     refresh(options?: {
         forceRefresh?: boolean;
     }): void;
+    resync(): void;
     applyExternalUpsert(item: DailyReportItem): void;
     applyExternalRemoval(reportHubId: number): void;
     dispose(): void;
@@ -511,6 +521,7 @@ declare class DailyReportIdsStreamClient {
     private streamOnce;
     private readWithStallGuard;
     private absorbChunkLine;
+    private absorbStreamAnchor;
     private publishItems;
     private schedulePublishItems;
     private cancelScheduledPublishItems;
@@ -518,7 +529,6 @@ declare class DailyReportIdsStreamClient {
     private buildStreamUrl;
     private waitBeforeRetry;
 }
-declare const reloadDocument: () => void;
 declare const ensureDailyReportIdsStreamSession: (options: {
     apiBasePath?: string;
     userKey: string | null;
@@ -531,6 +541,7 @@ declare const primeDailyReportIdsStreamSession: () => void;
 declare const upsertDailyReportIdsStreamItem: (item: DailyReportItem) => void;
 declare const removeDailyReportIdsStreamItem: (reportHubId: number) => void;
 declare const retryDailyReportIdsStream: () => void;
+declare const resyncDailyReportIdsStream: () => void;
 declare const refreshDailyReportIdsStream: (options?: {
     forceRefresh?: boolean;
 }) => void;
@@ -557,4 +568,4 @@ declare const CONTENT_DRAG_POINTER_INPUTS: readonly [
     "pen",
     "touch"
 ];
-export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DAILY_REPORT_LABEL_CATALOGS, DAILY_REPORT_LABEL_KEYS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigDefaults, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, type DailyReportLabelOverrides, type DailyReportLabels, DailyReportList, DailyReportLoadError, DailyReportLoading, type DailyReportLocale, type DailyReportOperation, DailyReportPage, type DailyReportPageProps, DailyReportPostedComment, 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, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveDailyReportLabels, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DAILY_REPORT_LABEL_CATALOGS, DAILY_REPORT_LABEL_KEYS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigDefaults, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, type DailyReportLabelOverrides, type DailyReportLabels, DailyReportList, DailyReportLoadError, DailyReportLoading, type DailyReportLocale, type DailyReportOperation, DailyReportPage, type DailyReportPageProps, DailyReportPostedComment, DailyReportResolvedContent, type DailyReportSseConnectionStatus, 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, type UseDailyReportSseConnectionOptions, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveDailyReportLabels, resolveSourceTypeConfig, resyncDailyReportIdsStream, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };