@aiquants/daily-report 0.1.1

package/src/shared/sse-schema.ts

@@ -0,0 +1,147 @@
+/**
+ * Zod schemas for daily-report SSE messages (client/server shared contract).
+ * 日報 SSE メッセージの zod スキーマ (client / server 共有契約)。
+ */
+import { z } from "zod"
+import type { DailyReportCommentItem as DeclaredComment, DailyReportDetail as DeclaredDetail } from "./types"
+
+// --- サブスキーマ（types.ts の型と構造的に一致させる） ---
+
+export const dailyReportInterviewerSchema = z.object({
+    name: z.string(),
+    affiliation: z.string().nullable(),
+})
+
+export const dailyReportCommentSchema = z.object({
+    name: z.string().nullable(),
+    text: z.string().nullable(),
+    color: z.string().nullable(),
+})
+
+export const dailyReportLabelDefSchema = z.object({
+    id: z.number(),
+    name: z.string(),
+    color: z.string().nullable(),
+})
+
+export const dailyReportCommentItemSchema = z.object({
+    id: z.number(),
+    userId: z.string(),
+    userName: z.string(),
+    content: z.string(),
+    createdAt: z.string(),
+    isMine: z.boolean(),
+})
+
+export const dailyReportDetailSchema = z.object({
+    reportHubId: z.number(),
+    date: z.string().nullable(),
+    createdAt: z.string().nullable(),
+    author: z.string(),
+    userId: z.string(),
+    employeeName: z.string().nullable(),
+    updatedBy: z.string().nullable(),
+    updatedAt: z.string().nullable(),
+    category: z.string().nullable(),
+    creationCategory: z.string().nullable(),
+    visitTimeFrom: z.string().nullable(),
+    visitTimeTo: z.string().nullable(),
+    customerName: z.string().nullable(),
+    interviewers: z.array(dailyReportInterviewerSchema),
+    subject: z.string().nullable(),
+    content: z.string().nullable(),
+    comments: z.array(dailyReportCommentSchema),
+    isRead: z.boolean(),
+    isStarred: z.boolean(),
+    labels: z.array(dailyReportLabelDefSchema),
+    commentItems: z.array(dailyReportCommentItemSchema),
+})
+
+// --- SSE メッセージスキーマ（8種） ---
+
+export const connectedMessageSchema = z.object({
+    type: z.literal("connected"),
+})
+
+export const statusUpdateMessageSchema = z.object({
+    type: z.literal("status-update"),
+    reportHubId: z.number(),
+    statusType: z.enum(["star", "read"]),
+    value: z.boolean(),
+    clientTempId: z.string(),
+    // recipientRawUserId はサーバーサイドフィルタリング専用。
+    // SSE ルートが raw JSON から取得してフィルタ後に除去する。
+    // クライアントには到達しないが、サーバー側の publish で .parse() を通すため定義が必要。
+    recipientRawUserId: z.number().optional(),
+})
+
+export const commentAddMessageSchema = z.object({
+    type: z.literal("comment-add"),
+    reportHubId: z.number(),
+    comment: dailyReportCommentItemSchema,
+    clientTempId: z.string(),
+})
+
+export const commentDeleteMessageSchema = z.object({
+    type: z.literal("comment-delete"),
+    reportHubId: z.number(),
+    commentId: z.number(),
+    clientTempId: z.string(),
+})
+
+export const reportCreateMessageSchema = z.object({
+    type: z.literal("report-create"),
+    reportHubId: z.number(),
+    report: dailyReportDetailSchema,
+    clientTempId: z.string(),
+    recipientRawUserId: z.number().optional(),
+})
+
+export const reportUpdateMessageSchema = z.object({
+    type: z.literal("report-update"),
+    reportHubId: z.number(),
+    report: dailyReportDetailSchema,
+    clientTempId: z.string(),
+    recipientRawUserId: z.number().optional(),
+})
+
+export const reportPublishMessageSchema = z.object({
+    type: z.literal("report-publish"),
+    reportHubId: z.number(),
+    report: dailyReportDetailSchema,
+    clientTempId: z.string(),
+})
+
+export const reportDeleteMessageSchema = z.object({
+    type: z.literal("report-delete"),
+    reportHubId: z.number(),
+    clientTempId: z.string(),
+})
+
+// --- Discriminated Union ---
+
+export const dailyReportSseMessageSchema = z.discriminatedUnion("type", [
+    connectedMessageSchema,
+    statusUpdateMessageSchema,
+    commentAddMessageSchema,
+    commentDeleteMessageSchema,
+    reportCreateMessageSchema,
+    reportUpdateMessageSchema,
+    reportPublishMessageSchema,
+    reportDeleteMessageSchema,
+])
+
+// --- 型エクスポート ---
+
+export type DailyReportSseMessage = z.infer<typeof dailyReportSseMessageSchema>
+
+// --- コンパイル時の型互換チェック ---
+// Zod推論型が既存の型定義に代入可能であることを保証する。
+// ここでエラーが出たらスキーマと types.ts がずれている。
+
+type _AssertDetailCompat = z.infer<typeof dailyReportDetailSchema> extends DeclaredDetail ? true : never
+type _AssertCommentCompat = z.infer<typeof dailyReportCommentItemSchema> extends DeclaredComment ? true : never
+const _detailCheck: _AssertDetailCompat = true
+const _commentCheck: _AssertCommentCompat = true
+void _detailCheck
+void _commentCheck

package/src/shared/text-utils.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared text helpers for daily report view components.
+ * 日報ビューコンポーネント向けの共通テキストヘルパー。
+ */
+
+/**
+ * Normalizes nullable text by trimming whitespace and applying fallback.
+ * null 許容の文字列をトリムしつつフォールバック値を適用する関数。
+ */
+export const fallbackText = (value: string | null | undefined): string => {
+    if (!value) {
+        return "-"
+    }
+    const trimmed = value.trim()
+    return trimmed === "" ? "-" : trimmed
+}
+
+/**
+ * Formats a date string to ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss).
+ * 日付文字列を ISO 8601 形式 (YYYY-MM-DD または YYYY-MM-DDTHH:mm:ss) に整形する関数。
+ */
+export const formatToIsoDate = (value: unknown): string => {
+    if (!value) {
+        return "-"
+    }
+    if (typeof value !== "string") {
+        // If value is not a string (e.g. Date object), try to convert it to string or handle it
+        if (value instanceof Date) {
+            return formatToIsoDate(value.toISOString())
+        }
+        return String(value)
+    }
+    const trimmed = value.trim()
+    if (trimmed === "") {
+        return "-"
+    }
+
+    const date = new Date(trimmed)
+    if (Number.isNaN(date.getTime())) {
+        return trimmed
+    }
+
+    const year = date.getFullYear()
+    const month = String(date.getMonth() + 1).padStart(2, "0")
+    const day = String(date.getDate()).padStart(2, "0")
+
+    const hasTime = trimmed.includes(":") || trimmed.includes("T")
+
+    if (hasTime) {
+        const hours = String(date.getHours()).padStart(2, "0")
+        const minutes = String(date.getMinutes()).padStart(2, "0")
+        const seconds = String(date.getSeconds()).padStart(2, "0")
+        return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}`
+    }
+
+    return `${year}-${month}-${day}`
+}

package/src/shared/types.ts

@@ -0,0 +1,76 @@
+/**
+ * Core data types shared by the daily-report client and server layers.
+ * 日報機能の client / server 層で共有するコアデータ型定義。
+ */
+
+/** 日報一覧の 1 アイテム (詳細は遅延読み込み)。 */
+export type DailyReportItem = {
+    reportHubId: number
+    businessDate: string | null
+}
+
+/** 面談者情報。 */
+export type DailyReportInterviewer = {
+    name: string
+    affiliation: string | null
+}
+
+/** レガシー形式 (JSON 埋め込み) のコメント。 */
+export type DailyReportComment = {
+    name: string | null
+    text: string | null
+    color: string | null
+}
+
+/** ラベル定義。 */
+export type DailyReportLabelDef = {
+    id: number
+    name: string
+    color: string | null
+}
+
+/** リレーショナルコメント 1 件。`userId` は難読化済み文字列。 */
+export type DailyReportCommentItem = {
+    id: number
+    userId: string
+    userName: string
+    content: string
+    createdAt: string
+    isMine: boolean
+}
+
+/** 日報詳細 (一覧アイテムの遅延解決結果)。`userId` は難読化済み文字列。 */
+export type DailyReportDetail = {
+    reportHubId: number
+    date: string | null
+    createdAt: string | null
+    author: string
+    userId: string
+    employeeName: string | null
+    updatedBy: string | null
+    updatedAt: string | null
+    category: string | null
+    creationCategory: string | null
+    visitTimeFrom: string | null
+    visitTimeTo: string | null
+    customerName: string | null
+    interviewers: DailyReportInterviewer[]
+    subject: string | null
+    content: string | null
+    comments: DailyReportComment[]
+    isRead: boolean
+    isStarred: boolean
+    labels: DailyReportLabelDef[]
+    commentItems: DailyReportCommentItem[]
+}
+
+/**
+ * Minimal display-user shape consumed by the client layer.
+ * client 層が表示に使う最小ユーザー形状 (Google プロフィール等と構造互換)。
+ */
+export type DailyReportUser = {
+    id: string
+    displayName?: string
+    name?: { familyName?: string; givenName?: string }
+    emails?: { value: string }[]
+}