@aiquants/daily-report 0.18.0 → 0.18.2

package/README.md

@@ -86,7 +86,7 @@ export const dailyReportServer = createDailyReportServer({
     userTable: Users,                            // { id, displayName }
     resolveUserId: async (externalId) => {/* External ID (e.g., OAuth sub) -> internal numeric ID */},
     encodeUserId: (id) => encodeId(id),          // Internal ID obfuscation (e.g. sqids)
-    authenticate: authenticateInLoader,          // (request, { failureRedirect }) => { user?, cookie? }
+    authenticate: authenticateInLoader,          // DailyReportAuthenticate (overloaded): string mode => { user, cookie? } / null mode => { user?, cookie? }
     redis: redisProvider as unknown as DailyReportRedisProvider, // Optional (disables SSE/epoch)
     externalSources: [                           // Optional: ingest legacy daily report tables from external systems
         { sourceType: "legacy", table: LegacyReport, idColumn: LegacyReport.reportId, mapRow: mapLegacyRow },
@@ -113,7 +113,7 @@ export const loader = (args) => dailyReportServer.sse.loader(args)
 
 ### DI ports
 
-- `authenticate(request, { failureRedirect })` — Session verification. When `failureRedirect: string` is set, throw a redirect on unauthenticated requests.
+- `authenticate(request, { failureRedirect })` — Session verification, declared as the overloaded `DailyReportAuthenticate`. With `failureRedirect: string` the implementation must throw a redirect on unauthenticated requests, so a normal return always carries `user` (typed as required — leaving it optional would force callers to write an unreachable `!user` guard). With `failureRedirect: null` it must not redirect and resolves without `user` instead; forward the returned `cookie` on unauthenticated responses too, otherwise a destroyed session lingers in the browser.
 - `resolveUserId(externalId)` — External ID → internal numeric ID (`null` = unregistered). In-process caching can be disabled with `disableUserIdCache` (useful for testing).
 - `encodeUserId(id)` — Obfuscates IDs sent to the client. Inject app-level implementation to preserve existing ID namespaces.
 - `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.

package/dist/client.d.mts

@@ -139,6 +139,10 @@ declare const DailyReportEditForm: ({ report, onCancel, onPublishSuccess }: Dail
  */
 declare const DailyReportIdsStreamStatus: () => react.JSX.Element | null;
 
+/**
+ * Props for the DailyReportList component.
+ * DailyReportList コンポーネントのプロパティ型定義。
+ */
 type DailyReportListProps = {
     dailyReportItems: DailyReportItem[];
     autoMarkRead?: boolean;
@@ -146,11 +150,10 @@ type DailyReportListProps = {
     onSelectItem: (reportHubId: number | null) => void;
     userId?: string | null;
     /**
+     * Shared slot to preserve scroll position across unmounted tab switches.
      * タブ切替 (アンマウント) をまたいでスクロール位置を持ち回る共有スロット。
-     * 値は VirtualScroll の**論理座標** (inset 非依存。onScroll が配信する座標系)。
+     * 値は VirtualScroll の論理座標 (inset 非依存。onScroll が配信する座標系)。
      * マウント時に一度だけ読み、スクロールのたびに書き戻す。
-     * ❗ 値をレンダー時に読んで props へ焼き込む方式は禁止: 非制御タブでは親が
-     * 再レンダーされず、復帰マウントに古い値が渡る (実測で再現した実害バグ)
      */
     scrollOffsetRef?: RefObject<number>;
 };

package/dist/client.d.ts

@@ -139,6 +139,10 @@ declare const DailyReportEditForm: ({ report, onCancel, onPublishSuccess }: Dail
  */
 declare const DailyReportIdsStreamStatus: () => react.JSX.Element | null;
 
+/**
+ * Props for the DailyReportList component.
+ * DailyReportList コンポーネントのプロパティ型定義。
+ */
 type DailyReportListProps = {
     dailyReportItems: DailyReportItem[];
     autoMarkRead?: boolean;
@@ -146,11 +150,10 @@ type DailyReportListProps = {
     onSelectItem: (reportHubId: number | null) => void;
     userId?: string | null;
     /**
+     * Shared slot to preserve scroll position across unmounted tab switches.
      * タブ切替 (アンマウント) をまたいでスクロール位置を持ち回る共有スロット。
-     * 値は VirtualScroll の**論理座標** (inset 非依存。onScroll が配信する座標系)。
+     * 値は VirtualScroll の論理座標 (inset 非依存。onScroll が配信する座標系)。
      * マウント時に一度だけ読み、スクロールのたびに書き戻す。
-     * ❗ 値をレンダー時に読んで props へ焼き込む方式は禁止: 非制御タブでは親が
-     * 再レンダーされず、復帰マウントに古い値が渡る (実測で再現した実害バグ)
      */
     scrollOffsetRef?: RefObject<number>;
 };