@aiquants/daily-report 0.20.1 → 0.22.0

package/dist/client.d.mts

@@ -1,8 +1,9 @@
 import * as react from "react";
 import { RefObject, ReactNode, Context } from "react";
-import { ScrollBarThumbOverlayRenderProps, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from "@aiquants/virtualscroll";
+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-ChSFm-4q.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 & {
@@ -78,35 +79,192 @@ type DailyReportListProps = {
     scrollOffsetRef?: RefObject<number>;
 };
 declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, scrollOffsetRef }: DailyReportListProps) => react.JSX.Element;
+type DailyReportLocale = VirtualScrollLocale;
+type DailyReportOperation = "create" | "update" | "publish" | "delete" | "addComment" | "deleteComment" | "toggleStar" | "toggleRead";
+type DailyReportLabels = VirtualScrollLabels & {
+    readonly id: string;
+    readonly businessDate: string;
+    readonly author: string;
+    readonly visitTime: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly updatedBy: string;
+    readonly category: string;
+    readonly categoryInfo: string;
+    readonly creationCategory: string;
+    readonly customer: string;
+    readonly subject: string;
+    readonly content: string;
+    readonly interviewers: string;
+    readonly comments: string;
+    readonly attachments: string;
+    readonly attachmentMissing: string;
+    readonly attachmentDownload: string;
+    readonly tabArticle: string;
+    readonly tabRelations: string;
+    readonly relationsEmpty: string;
+    readonly title: string;
+    readonly tabList: string;
+    readonly tabTree: string;
+    readonly tabDetailList: string;
+    readonly treeComingSoon: string;
+    readonly totalCountLoading: string;
+    readonly createReport: string;
+    readonly createReportTitle: string;
+    readonly devControls: string;
+    readonly devSseToggle: string;
+    readonly devReload: string;
+    readonly devClearCache: string;
+    readonly autoRead: string;
+    readonly autoReadTitle: string;
+    readonly loadErrorBadge: string;
+    readonly loadError: string;
+    readonly reload: string;
+    readonly loadingIds: string;
+    readonly streamFailed: string;
+    readonly streamRetry: string;
+    readonly streamRevalidating: string;
+    readonly listEmpty: string;
+    readonly selectPrompt: string;
+    readonly loading: string;
+    readonly reportNotFound: string;
+    readonly contentEmpty: string;
+    readonly contentEmptyPreview: string;
+    readonly confirmDelete: string;
+    readonly deleteFailed: string;
+    readonly starAdd: string;
+    readonly starRemove: string;
+    readonly markRead: string;
+    readonly markUnread: string;
+    readonly deleteReport: string;
+    readonly resizeHandle: string;
+    readonly overlayBackdrop: string;
+    readonly overlayDialog: string;
+    readonly close: string;
+    readonly formTitle: string;
+    readonly formTitlePlaceholder: string;
+    readonly formContent: string;
+    readonly formContentPlaceholder: string;
+    readonly formCancel: string;
+    readonly formSave: string;
+    readonly formPublish: string;
+    readonly commentPlaceholder: string;
+    readonly commentSend: string;
+    readonly commentDelete: string;
+    readonly commentDeleteConfirm: string;
+    readonly unknownUser: string;
+    readonly sourceInternal: string;
+    readonly totalCount: (count: number) => string;
+    readonly debounce: (milliseconds: number) => string;
+    readonly streamProgressCount: (loaded: number) => string;
+    readonly streamProgressRatio: (loaded: number, total: number, percent: number) => string;
+    readonly streamRetrying: (loaded: number) => string;
+    readonly reportLoadFailed: (reportHubId: number) => string;
+    readonly reportSummaryLoadFailed: (reportHubId: number) => string;
+    readonly interviewerWithAffiliation: (name: string, affiliation: string) => string;
+    readonly operationFailed: (operation: DailyReportOperation) => string;
+};
+type DailyReportLabelOverrides = {
+    readonly [K in keyof DailyReportLabels]?: DailyReportLabels[K];
+};
+declare const DAILY_REPORT_LABEL_KEYS: readonly [
+    "scrollUp",
+    "scrollDown",
+    "scrollLeft",
+    "scrollRight",
+    "scrollToTop",
+    "scrollToBottom",
+    "noItems",
+    "id",
+    "businessDate",
+    "author",
+    "visitTime",
+    "createdAt",
+    "updatedAt",
+    "updatedBy",
+    "category",
+    "categoryInfo",
+    "creationCategory",
+    "customer",
+    "subject",
+    "content",
+    "interviewers",
+    "comments",
+    "attachments",
+    "attachmentMissing",
+    "attachmentDownload",
+    "tabArticle",
+    "tabRelations",
+    "relationsEmpty",
+    "title",
+    "tabList",
+    "tabTree",
+    "tabDetailList",
+    "treeComingSoon",
+    "totalCountLoading",
+    "createReport",
+    "createReportTitle",
+    "devControls",
+    "devSseToggle",
+    "devReload",
+    "devClearCache",
+    "autoRead",
+    "autoReadTitle",
+    "loadErrorBadge",
+    "loadError",
+    "reload",
+    "loadingIds",
+    "streamFailed",
+    "streamRetry",
+    "streamRevalidating",
+    "listEmpty",
+    "selectPrompt",
+    "loading",
+    "reportNotFound",
+    "contentEmpty",
+    "contentEmptyPreview",
+    "confirmDelete",
+    "deleteFailed",
+    "starAdd",
+    "starRemove",
+    "markRead",
+    "markUnread",
+    "deleteReport",
+    "resizeHandle",
+    "overlayBackdrop",
+    "overlayDialog",
+    "close",
+    "formTitle",
+    "formTitlePlaceholder",
+    "formContent",
+    "formContentPlaceholder",
+    "formCancel",
+    "formSave",
+    "formPublish",
+    "commentPlaceholder",
+    "commentSend",
+    "commentDelete",
+    "commentDeleteConfirm",
+    "unknownUser",
+    "sourceInternal",
+    "totalCount",
+    "debounce",
+    "streamProgressCount",
+    "streamProgressRatio",
+    "streamRetrying",
+    "reportLoadFailed",
+    "reportSummaryLoadFailed",
+    "interviewerWithAffiliation",
+    "operationFailed"
+];
+declare const DAILY_REPORT_LABEL_CATALOGS: Readonly<Record<DailyReportLocale, DailyReportLabels>>;
+declare const resolveDailyReportLabels: (locale: DailyReportLocale | undefined, overrides: DailyReportLabelOverrides | undefined) => DailyReportLabels;
 type DailyReportHeaderProps = {
     title: string;
     annotation?: ReactNode;
 };
-type DailyReportFieldLabels = {
-    id: string;
-    businessDate: string;
-    author: string;
-    visitTime: string;
-    createdAt: string;
-    updatedAt: string;
-    updatedBy: string;
-    category: string;
-    categoryInfo: string;
-    creationCategory: string;
-    customer: string;
-    subject: string;
-    content: string;
-    interviewers: string;
-    comments: string;
-    attachments: string;
-    attachmentMissing: string;
-    attachmentDownload: string;
-    tabArticle: string;
-    tabRelations: string;
-    relationsEmpty: string;
-};
 type DailyReportErrorInfo = {
-    operation: string;
+    operation: DailyReportOperation;
     message: string;
     cause?: unknown;
 };
@@ -116,24 +274,26 @@ type SourceTypeConfig = {
     allowComment?: boolean;
 };
 type DailyReportClientConfig = {
-    title: string;
     apiBasePath: string;
     ssePath: string;
     draftLabelName: string;
-    fieldLabels: DailyReportFieldLabels;
-    sourceTypeConfigs?: Record<string, SourceTypeConfig>;
+    locale: DailyReportLocale;
+    labels: DailyReportLabels;
+    sourceTypeConfigs: Record<string, SourceTypeConfig>;
     renderHeader: (props: DailyReportHeaderProps) => ReactNode;
     showDevControls: boolean;
     onError?: (info: DailyReportErrorInfo) => void;
+    onSessionExpired: () => void;
 };
-type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "fieldLabels">> & {
-    fieldLabels?: Partial<DailyReportFieldLabels>;
-    sourceTypeConfigs?: Record<string, SourceTypeConfig>;
+type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "locale" | "labels" | "onSessionExpired">> & {
+    locale?: DailyReportLocale;
+    labels?: DailyReportLabelOverrides;
+    onSessionExpired: () => void;
 };
-declare const defaultDailyReportFieldLabels: DailyReportFieldLabels;
-declare const defaultDailyReportClientConfig: DailyReportClientConfig;
+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;
@@ -143,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 = {
@@ -154,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>>>;
@@ -165,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>;
@@ -263,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;
@@ -299,6 +463,7 @@ type DailyReportIdsStreamState = {
     hasCompletedOnce: boolean;
     completedAt: number | null;
     error: Error | null;
+    streamAnchor: DailyReportSseStreamAnchor | null;
 };
 type DailyReportIdsStreamClientOptions = {
     apiBasePath?: string;
@@ -323,6 +488,7 @@ declare class DailyReportIdsStreamClient {
     private readonly itemMap;
     private readonly listeners;
     private state;
+    private streamAnchorRevision;
     private lastCursor;
     private lastSnapshot;
     private consecutiveFailures;
@@ -346,6 +512,7 @@ declare class DailyReportIdsStreamClient {
     refresh(options?: {
         forceRefresh?: boolean;
     }): void;
+    resync(): void;
     applyExternalUpsert(item: DailyReportItem): void;
     applyExternalRemoval(reportHubId: number): void;
     dispose(): void;
@@ -354,6 +521,7 @@ declare class DailyReportIdsStreamClient {
     private streamOnce;
     private readWithStallGuard;
     private absorbChunkLine;
+    private absorbStreamAnchor;
     private publishItems;
     private schedulePublishItems;
     private cancelScheduledPublishItems;
@@ -361,7 +529,6 @@ declare class DailyReportIdsStreamClient {
     private buildStreamUrl;
     private waitBeforeRetry;
 }
-declare const reloadDocument: () => void;
 declare const ensureDailyReportIdsStreamSession: (options: {
     apiBasePath?: string;
     userKey: string | null;
@@ -374,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;
@@ -400,4 +568,4 @@ 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, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, 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, 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 };
+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 };