@aiquants/daily-report 0.1.1

package/src/client/ui/input.tsx

@@ -0,0 +1,21 @@
+import type * as React from "react"
+
+import { cn } from "./cn"
+
+function Input({ className, type, ...props }: React.ComponentProps<"input">) {
+    return (
+        <input
+            type={type}
+            data-slot="input"
+            className={cn(
+                "flex h-9 w-full min-w-0 rounded-md border border-input bg-transparent px-3 py-1 text-base shadow-xs outline-none transition-[color,box-shadow] selection:bg-primary selection:text-primary-foreground file:inline-flex file:h-7 file:border-0 file:bg-transparent file:font-medium file:text-foreground file:text-sm placeholder:text-muted-foreground disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:bg-input/30",
+                "focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50",
+                "aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40",
+                className,
+            )}
+            {...props}
+        />
+    )
+}
+
+export { Input }

package/src/client/ui/label.tsx

@@ -0,0 +1,16 @@
+import * as LabelPrimitive from "@radix-ui/react-label"
+import type * as React from "react"
+
+import { cn } from "./cn"
+
+function Label({ className, ...props }: React.ComponentProps<typeof LabelPrimitive.Root>) {
+    return (
+        <LabelPrimitive.Root
+            data-slot="label"
+            className={cn("flex select-none items-center gap-2 font-medium text-sm leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-50 group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50", className)}
+            {...props}
+        />
+    )
+}
+
+export { Label }

package/src/client/ui/switch.tsx

@@ -0,0 +1,19 @@
+import * as SwitchPrimitives from "@radix-ui/react-switch"
+import * as React from "react"
+
+import { cn } from "./cn"
+
+const Switch = React.forwardRef<React.ElementRef<typeof SwitchPrimitives.Root>, React.ComponentPropsWithoutRef<typeof SwitchPrimitives.Root>>(({ className, ...props }, ref) => (
+    <SwitchPrimitives.Root
+        className={cn(
+            "peer inline-flex h-6 w-11 shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=unchecked]:bg-input",
+            className,
+        )}
+        {...props}
+        ref={ref}>
+        <SwitchPrimitives.Thumb className={cn("pointer-events-none block h-5 w-5 rounded-full bg-background shadow-lg ring-0 transition-transform data-[state=checked]:translate-x-5 data-[state=unchecked]:translate-x-0")} />
+    </SwitchPrimitives.Root>
+))
+Switch.displayName = SwitchPrimitives.Root.displayName
+
+export { Switch }

package/src/client/ui/tabs.tsx

@@ -0,0 +1,40 @@
+import * as TabsPrimitive from "@radix-ui/react-tabs"
+import * as React from "react"
+
+import { cn } from "./cn"
+
+const Tabs = TabsPrimitive.Root
+
+const TabsList = React.forwardRef<React.ElementRef<typeof TabsPrimitive.List>, React.ComponentPropsWithoutRef<typeof TabsPrimitive.List>>(({ className, ...props }, ref) => (
+    <TabsPrimitive.List ref={ref} className={cn("inline-flex h-10 items-center justify-center rounded-md bg-muted p-1 text-muted-foreground", className)} {...props} />
+))
+TabsList.displayName = TabsPrimitive.List.displayName
+
+const TabsTrigger = React.forwardRef<React.ElementRef<typeof TabsPrimitive.Trigger>, React.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>>(({ className, ...props }, ref) => (
+    <TabsPrimitive.Trigger
+        ref={ref}
+        className={cn(
+            "inline-flex items-center justify-center whitespace-nowrap rounded-sm px-3 py-1.5 font-medium text-sm ring-offset-background transition-all focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:bg-background data-[state=active]:text-foreground data-[state=active]:shadow-2xs",
+            className,
+        )}
+        {...props}
+    />
+))
+TabsTrigger.displayName = TabsPrimitive.Trigger.displayName
+
+// https://github.com/radix-ui/primitives/issues/2359
+const TabsContent = React.forwardRef<React.ElementRef<typeof TabsPrimitive.Content>, React.ComponentPropsWithoutRef<typeof TabsPrimitive.Content>>(({ className, ...props }, ref) => (
+    <TabsPrimitive.Content
+        ref={ref}
+        // forceMount={true} //<=======Add this line
+        className={cn(
+            "data-[state=inactive]:hidden", //<=========Add this line
+            "mt-2 ring-offset-background focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
+            className,
+        )}
+        {...props}
+    />
+))
+TabsContent.displayName = TabsPrimitive.Content.displayName
+
+export { Tabs, TabsContent, TabsList, TabsTrigger }

package/src/client/ui/textarea.tsx

@@ -0,0 +1,19 @@
+import type * as React from "react"
+
+import { cn } from "./cn"
+
+function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
+    return (
+        <textarea
+            data-slot="textarea"
+            className={cn(
+                "flex min-h-15 w-full rounded-md border border-input bg-transparent px-3 py-2 text-base shadow-xs placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:bg-input/30",
+                "aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40",
+                className,
+            )}
+            {...props}
+        />
+    )
+}
+
+export { Textarea }

package/src/client/utils/constants.ts

@@ -0,0 +1,29 @@
+import { type ScrollBarTapCircleOptions, type ScrollPaneInertiaOptions, tapScrollCircleSampleVisual } from "@aiquants/virtualscroll"
+import type { DailyReportItem } from "../../shared/types"
+import type { DailyReportDetailResource } from "../hooks/use-daily-report"
+
+/**
+ * Shared constants for Daily Report data fetching parameters.
+ * 日報データ取得で利用する共通パラメーター。
+ */
+export const DAILY_REPORT_FETCH_DEBOUNCE_MS = 180
+
+export const DEFAULT_ITEM_HEIGHT = 160
+export const ITEM_VERTICAL_PADDING = 6
+export const ITEM_CONTAINER_HEIGHT = DEFAULT_ITEM_HEIGHT - ITEM_VERTICAL_PADDING
+export const FAST_SCROLL_WHEEL_MULTIPLIER = 0.8
+export const FAST_SCROLL_INERTIA_OPTIONS: ScrollPaneInertiaOptions = { maxVelocity: 18, deceleration: 0.0018, startVelocityThreshold: 0.03 }
+export const PREFETCH_LOOKAHEAD = 20
+export const PREFETCH_MAX_DATES = 6
+export const EMPTY_ITEM: DailyReportItem = { reportHubId: -1, businessDate: null }
+export const EMPTY_DETAIL: DailyReportDetailResource = { report: null, error: null, isLoading: false, isRefetching: false }
+export const WHEEL_RESET_TIMEOUT_MS = 240
+export const VIRTUAL_SCROLL_OVERSCAN_COUNT = 15
+export const SCROLL_BAR_WIDTH = 8
+export const MAX_PREVIEW_LINES = 3
+export const TAP_SCROLL_CIRCLE_OPTIONS: ScrollBarTapCircleOptions = {
+    enabled: true,
+    renderVisual: tapScrollCircleSampleVisual,
+    maxSpeedCurve: { exponentialSteepness: 7.5, exponentialScale: 14, easedOffset: 0.18 },
+    maxSpeedMultiplier: 18,
+}

package/src/client.ts

@@ -0,0 +1,21 @@
+/**
+ * Client entry of @aiquants/daily-report: React components, hooks, and route helpers.
+ * @aiquants/daily-report の client エントリ。React コンポーネント・フック・ルートヘルパーを公開。
+ */
+export * from "./client/components/business-day-thumb-overlay"
+export * from "./client/components/daily-report-comment-item"
+export * from "./client/components/daily-report-comment-section"
+export * from "./client/components/daily-report-detail-list"
+export * from "./client/components/daily-report-edit-form"
+export * from "./client/components/daily-report-list"
+export * from "./client/components/daily-report-page"
+export * from "./client/components/daily-report-resolved-content"
+export * from "./client/components/unread-indicator"
+export * from "./client/config-context"
+export * from "./client/contexts/daily-report-action-context"
+export * from "./client/hooks/use-daily-report"
+export * from "./client/hooks/use-daily-report-comments"
+export * from "./client/hooks/use-daily-report-sse-connection"
+export * from "./client/hooks/use-dynamic-viewport-height"
+export * from "./client/route-helpers"
+export * from "./client/utils/constants"

package/src/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared (isomorphic) entry of @aiquants/daily-report: types, SSE schemas, and pure utilities.
+ * @aiquants/daily-report の共有 (isomorphic) エントリ。型・SSE スキーマ・純粋ユーティリティを公開。
+ */
+export * from "./shared/business-date"
+export * from "./shared/comment-adapter"
+export * from "./shared/logger"
+export * from "./shared/sse-schema"
+export * from "./shared/text-utils"
+export * from "./shared/types"

package/src/server/cache.ts

@@ -0,0 +1,165 @@
+/**
+ * In-memory SQL result cache with TTL, snapshot, and cross-worker epoch (via redis) support.
+ * TTL・スナップショット・クロスワーカー epoch (redis 経由) を備えた SQL 結果のインメモリキャッシュ。
+ *
+ * epoch は任意注入の redis ポート経由で取得・更新する (未注入時は常に 0 = epoch 無効)。
+ */
+import type { DailyReportRedisProvider } from "./ports"
+
+export type SqlResultCacheQueryOptions = {
+    forceRefresh?: boolean
+    snapshot?: boolean
+    ttlMsOverride?: number
+    epochKey?: string
+}
+
+/**
+ * Creates epoch helpers bound to an optional redis provider.
+ * 任意の redis プロバイダーに束縛された epoch ヘルパーを生成する処理。
+ */
+export const createEpochStore = (redis?: DailyReportRedisProvider) => ({
+    /**
+     * Gets the current epoch value from Redis.
+     * Redis からエポック値を取得する。エラー時は 0 を返す (常に re-fetch = safe 方向)。
+     */
+    async getEpoch(epochKey: string): Promise<number> {
+        try {
+            const client = await redis?.getClient()
+            if (!client) return 0
+            const val = await client.get(epochKey)
+            return val ? Number(val) : 0
+        } catch {
+            return 0
+        }
+    },
+    /**
+     * Increments the epoch counter in Redis.
+     * Redis のエポックカウンターをインクリメントする。
+     */
+    async incrementEpoch(epochKey: string): Promise<void> {
+        try {
+            const client = await redis?.getClient()
+            if (!client) return
+            await client.incr(epochKey)
+        } catch {
+            // Redis エラー時は epoch 更新をスキップ (次回 GET で 0 → stale 扱い → re-fetch)
+        }
+    },
+})
+
+export type EpochStore = ReturnType<typeof createEpochStore>
+
+/**
+ * In-memory cache for SQL query results with TTL and snapshot support.
+ * TTLとスナップショット機能を備えたSQLクエリ結果のインメモリキャッシュ。
+ */
+export class SqlResultCache {
+    private readonly buckets = new Map<string, { records: readonly unknown[]; expireAt: number; epoch: number }>()
+    private readonly inFlight = new Map<string, Promise<readonly unknown[]>>()
+
+    constructor(
+        private readonly config: { defaultTtlMs: number },
+        private readonly epochStore: EpochStore,
+    ) {}
+
+    /**
+     * Invalidates a specific cache bucket.
+     * 指定されたキャッシュバケットを無効化します。
+     */
+    invalidate = (cacheKey: string): void => {
+        this.buckets.delete(cacheKey)
+        this.inFlight.delete(cacheKey)
+    }
+
+    /**
+     * Retrieves records from cache or fetches them if expired/missing.
+     * キャッシュからレコードを取得するか、期限切れや未存在の場合はフェッチします。
+     */
+    getOrFetch = async <T>(
+        opts: {
+            cacheKey: string
+            fetcher: () => Promise<readonly T[]>
+        } & SqlResultCacheQueryOptions,
+    ): Promise<readonly T[]> => {
+        const { cacheKey, forceRefresh, snapshot } = opts
+        const bucket = this.buckets.get(cacheKey)
+
+        // 強制リフレッシュ時はキャッシュと進行中のリクエストをクリア
+        if (forceRefresh) {
+            this.buckets.delete(cacheKey)
+            this.inFlight.delete(cacheKey)
+        }
+
+        // 有効なキャッシュがあれば返却 (epoch check 込み)
+        if (!forceRefresh && bucket && bucket.expireAt > Date.now()) {
+            if (opts.epochKey) {
+                // epochKey 指定時は Redis の epoch と比較して stale を検出
+                const currentEpoch = await this.epochStore.getEpoch(opts.epochKey)
+                if (bucket.epoch === currentEpoch) {
+                    return snapshot ? (bucket.records.map((r) => structuredClone(r)) as T[]) : (bucket.records as T[])
+                }
+                // epoch 不一致 → stale bucket を除去して re-fetch へ
+                this.buckets.delete(cacheKey)
+            } else {
+                return snapshot ? (bucket.records.map((r) => structuredClone(r)) as T[]) : (bucket.records as T[])
+            }
+        }
+
+        // 進行中のリクエストがあれば相乗り
+        if (!forceRefresh && this.inFlight.has(cacheKey)) {
+            const shared = (await this.inFlight.get(cacheKey)) as readonly T[]
+            return snapshot ? shared.map((r) => structuredClone(r)) : shared
+        }
+
+        // 新規フェッチとキャッシュ更新
+        // 自己参照 (this.inFlight.get(cacheKey) === promise) のため、定義前参照を回避する確定代入アサーション
+        let promise!: Promise<readonly T[]>
+        promise = (async () => {
+            const records = await opts.fetcher()
+            // invalidation 中に完了したリクエストはキャッシュに書き込まない（レース防止）
+            // ただし forceRefresh の場合は常に書き込む
+            if (forceRefresh || this.inFlight.get(cacheKey) === promise) {
+                const expireAt = Date.now() + (opts.ttlMsOverride ?? this.config.defaultTtlMs)
+                // キャッシュ保存時に現在の epoch を記録
+                const epoch = opts.epochKey ? await this.epochStore.getEpoch(opts.epochKey) : 0
+                this.buckets.set(cacheKey, { records, expireAt, epoch })
+            }
+            return records
+        })()
+
+        if (!forceRefresh) this.inFlight.set(cacheKey, promise as Promise<readonly unknown[]>)
+
+        try {
+            const result = await promise
+            return snapshot ? result.map((r) => structuredClone(r)) : result
+        } finally {
+            this.inFlight.delete(cacheKey)
+        }
+    }
+
+    /**
+     * Clears the cache for a specific key.
+     * 指定されたキーのキャッシュをクリアします。
+     */
+    flush = (cacheKey: string): void => {
+        this.buckets.delete(cacheKey)
+        this.inFlight.delete(cacheKey)
+    }
+
+    /**
+     * Invalidates cache buckets matching a prefix.
+     * 指定されたプレフィックスに一致するキャッシュバケットを無効化します。
+     */
+    invalidatePrefix = (prefix: string): void => {
+        for (const key of this.buckets.keys()) {
+            if (key.startsWith(prefix)) {
+                this.buckets.delete(key)
+            }
+        }
+        for (const key of this.inFlight.keys()) {
+            if (key.startsWith(prefix)) {
+                this.inFlight.delete(key)
+            }
+        }
+    }
+}

package/src/server/etag.ts

@@ -0,0 +1,18 @@
+/**
+ * ETag generation helper for JSON payloads.
+ * JSON ペイロード向けの ETag 生成ヘルパー。
+ */
+import { createHash } from "node:crypto"
+
+/**
+ * Generates a SHA-256 ETag for the given data.
+ * 指定されたデータの SHA-256 ETag を生成します。
+ *
+ * @param data The data to hash (will be JSON stringified).
+ * @returns The ETag string (wrapped in quotes).
+ */
+export const generateETag = (data: unknown): string => {
+    const json = JSON.stringify(data)
+    const hash = createHash("sha256").update(json).digest("hex")
+    return `"${hash}"`
+}

package/src/server/external-source.ts

@@ -0,0 +1,60 @@
+/**
+ * External source adapter contract for legacy/foreign daily-report tables.
+ * レガシー・外部由来の日報テーブルを取り込む外部ソースアダプタ契約。
+ *
+ * DailyReportHub.source_type がアダプタの `sourceType` に一致する行は、
+ * `table` を `Hub.source_id_num = idColumn` で LEFT JOIN し、その行を
+ * `mapRow` で表示フィールドへ変換する (例: 別システムのレガシー日報テーブルの取り込み)。
+ */
+import type { AnyMsSqlColumn } from "drizzle-orm/mssql-core"
+import { createLogger, type DailyReportLogger, LogLevel } from "../shared/logger"
+import type { DailyReportComment, DailyReportInterviewer } from "../shared/types"
+
+/** 外部ソース行から詳細表示へ供給するフィールド群。 */
+export type ExternalReportFields = {
+    content?: string | null
+    employeeName?: string | null
+    category?: string | null
+    creationCategory?: string | null
+    visitTimeFrom?: string | null
+    visitTimeTo?: string | null
+    customerName?: string | null
+    interviewers?: DailyReportInterviewer[]
+    comments?: DailyReportComment[]
+}
+
+/** 外部ソースアダプタ。 */
+export type DailyReportExternalSource = {
+    /** DailyReportHub.source_type の一致値 (例 "legacy")。 */
+    sourceType: string
+    /** LEFT JOIN する drizzle テーブル。 */
+    table: unknown
+    /** Hub.source_id_num と突き合わせる ID 列。 */
+    idColumn: AnyMsSqlColumn
+    /** 結合行を表示フィールドへ変換する処理。 */
+    mapRow: (row: Record<string, unknown>) => ExternalReportFields
+}
+
+const defaultLogger = createLogger(LogLevel.INFO, "[DailyReportExternalSource]")
+
+/**
+ * Parses JSON array payloads and maps each element (fail-soft: returns [] on error).
+ * JSON 配列のペイロードを解析し各要素を変換する処理 (エラー時は空配列)。
+ */
+export const transformJsonArray = <TRaw, TResult>(payload: string | null, label: string, mapper: (raw: TRaw) => TResult | null, logger: DailyReportLogger = defaultLogger): TResult[] => {
+    if (!payload) {
+        return []
+    }
+
+    try {
+        const parsed = JSON.parse(payload)
+        if (!Array.isArray(parsed)) {
+            logger.warn(`Unexpected ${label} format: not an array`)
+            return []
+        }
+        return (parsed as TRaw[]).map(mapper).filter((entry): entry is TResult => entry !== null)
+    } catch (error) {
+        logger.warn(`Failed to parse ${label}:`, error)
+        return []
+    }
+}