@aiquants/daily-report 0.12.4 → 0.13.0

package/src/server/test-helpers/handlers-config.ts

@@ -8,9 +8,10 @@
  * 本番コードからは import されない (テスト専用)。
  */
 import type { DailyReportHandlersConfig } from "../handlers"
-import type { DailyReportAttachmentBytes, DailyReportAttachmentError, DailyReportIdCodec } from "../ports"
+import type { DailyReportAttachmentBytes, DailyReportAttachmentError, DailyReportIdCodec, DailyReportResolveVisibleSourceTypes, DailyReportVisibilityResolveContext, DailyReportVisibilityResolveReason } from "../ports"
 import type { DailyReportService } from "../service"
-import type { DailyReportSseReader } from "../sse-reader"
+import type { DailyReportSseReader, StreamEntry } from "../sse-reader"
+import type { VisibleSourceTypeSet } from "../visibility"
 
 /** 既定の外部ユーザー ID (認証済みユーザーを表す)。 */
 export const TEST_EXTERNAL_USER_ID = "external-user"
@@ -53,6 +54,10 @@ export type HandlersFixtureOptions = {
     attachmentConcurrency?: number
     /** `intent=clearCache` (開発用の全キャッシュ破棄) を許可するか。 */
     enableDevCacheClear?: boolean
+    /** 可視 sourceType リゾルバ (未指定なら未注入 = 無制限)。 */
+    resolveVisibleSourceTypes?: DailyReportResolveVisibleSourceTypes
+    /** ミューテーション stub に投げさせる例外 (区分ゲート相当の検証用)。 */
+    mutationError?: Error
     /** ids ストリームが返すアイテム一覧 (ストリーム順で渡す)。 */
     idsStreamItems?: Array<{ reportHubId: number; businessDate: string | null; sourceType?: string }>
     /** ids 取得 (全量・先頭ページの両方) を失敗させるエラー。 */
@@ -76,6 +81,19 @@ export type HandlersFixtureCalls = {
     getDailyReportIds: Array<[string, boolean]>
     /** `service.getDailyReportIdsFirstPageByExternalId` が受け取った `(externalId, limit)`。 */
     getDailyReportIdsFirstPage: Array<[string, number]>
+    /**
+     * 各サービス呼び出しが受け取った可視集合。
+     *
+     * 記録しないと「ハンドラが可視集合を渡し忘れた」欠陥がテストに一切映らない
+     * (サービスは stub なので実際の絞り込みは起きず、素通りが成功に見える)。
+     */
+    visibleArgs: Array<{ method: string; visible: VisibleSourceTypeSet }>
+    /** `resolveVisibleSourceTypes` ポートの呼び出し回数。 */
+    resolveVisibleSourceTypes: number
+    /** ポートが受け取った解決理由の並び (initial / refresh の別を検証する)。 */
+    visibilityResolveReasons: DailyReportVisibilityResolveReason[]
+    /** ミューテーションが受け取った `(reportHubId, visible)`。 */
+    mutations: Array<{ method: string; reportHubId: number; visible: VisibleSourceTypeSet }>
 }
 
 /**
@@ -85,8 +103,20 @@ export type HandlersFixtureCalls = {
  * @param options Fixture adjustments. フィクスチャの調整点。
  * @returns The config and its call log. 設定と呼び出し記録。
  */
-export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { config: DailyReportHandlersConfig; calls: HandlersFixtureCalls } => {
-    const calls: HandlersFixtureCalls = { clearCache: 0, getAttachmentForUser: [], readAttachment: [], markAttachmentMissing: [], markAttachmentPresent: [], getDailyReportIds: [], getDailyReportIdsFirstPage: [] }
+export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { config: DailyReportHandlersConfig; calls: HandlersFixtureCalls; pushSseEntry: (entry: StreamEntry) => void } => {
+    const calls: HandlersFixtureCalls = {
+        clearCache: 0,
+        getAttachmentForUser: [],
+        readAttachment: [],
+        markAttachmentMissing: [],
+        markAttachmentPresent: [],
+        getDailyReportIds: [],
+        getDailyReportIdsFirstPage: [],
+        visibleArgs: [],
+        resolveVisibleSourceTypes: 0,
+        visibilityResolveReasons: [],
+        mutations: [],
+    }
 
     const user = options.user === undefined ? { id: TEST_EXTERNAL_USER_ID } : options.user
     const internalUserId = options.internalUserId === undefined ? TEST_INTERNAL_USER_ID : options.internalUserId
@@ -98,22 +128,52 @@ export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { con
         clearCache: async () => {
             calls.clearCache += 1
         },
-        getDailyReportIdsByExternalId: async (externalId: string, opts?: { forceRefresh?: boolean }) => {
+        getDailyReportIdsByExternalId: async (externalId: string, opts: { forceRefresh?: boolean } | undefined, visible: VisibleSourceTypeSet) => {
             calls.getDailyReportIds.push([externalId, opts?.forceRefresh ?? false])
+            calls.visibleArgs.push({ method: "getDailyReportIdsByExternalId", visible })
             if (options.idsStreamError) throw options.idsStreamError
             if (options.idsStreamFullGate) await options.idsStreamFullGate
             return options.idsStreamItems ?? []
         },
-        getDailyReportIdsFirstPageByExternalId: async (externalId: string, limit: number) => {
+        getDailyReportIdsFirstPageByExternalId: async (externalId: string, limit: number, visible: VisibleSourceTypeSet) => {
             calls.getDailyReportIdsFirstPage.push([externalId, limit])
+            calls.visibleArgs.push({ method: "getDailyReportIdsFirstPageByExternalId", visible })
             if (options.idsStreamError) throw options.idsStreamError
             return options.idsStreamFirstPageItems ?? (options.idsStreamItems ?? []).slice(0, limit)
         },
-        getAttachmentForUser: async (attachmentId: number, viewerUserId: number) => {
+        getAttachmentForUser: async (attachmentId: number, viewerUserId: number, visible: VisibleSourceTypeSet) => {
             // 引数を記録する。記録しないと「閲覧者 ID を渡し忘れた」欠陥がテストに映らない
             calls.getAttachmentForUser.push([attachmentId, viewerUserId])
+            calls.visibleArgs.push({ method: "getAttachmentForUser", visible })
             return attachment
         },
+        getDailyReportsByBusinessDateByExternalId: async (_businessDate: string, _externalId: string, _opts: unknown, visible: VisibleSourceTypeSet) => {
+            calls.visibleArgs.push({ method: "getDailyReportsByBusinessDateByExternalId", visible })
+            return []
+        },
+        getDailyReportDetailByIdByExternalId: async (_reportHubId: number, _externalId: string, _opts: unknown, visible: VisibleSourceTypeSet) => {
+            calls.visibleArgs.push({ method: "getDailyReportDetailByIdByExternalId", visible })
+            return null
+        },
+        setStarStatus: async (_userId: number, reportHubId: number, _businessDate: string | null, _value: boolean, _clientTempId: string, visible: VisibleSourceTypeSet) => {
+            calls.mutations.push({ method: "setStarStatus", reportHubId, visible })
+            if (options.mutationError) throw options.mutationError
+            return { hubId: reportHubId, userId: internalUserId ?? 0, isRead: false, isStarred: true, createdAt: "", createdBy: "", updatedAt: "", updatedBy: "" }
+        },
+        setReadStatus: async (_userId: number, reportHubId: number, _businessDate: string | null, _value: boolean, _clientTempId: string, visible: VisibleSourceTypeSet) => {
+            calls.mutations.push({ method: "setReadStatus", reportHubId, visible })
+            if (options.mutationError) throw options.mutationError
+            return { hubId: reportHubId, userId: internalUserId ?? 0, isRead: true, isStarred: false, createdAt: "", createdBy: "", updatedAt: "", updatedBy: "" }
+        },
+        addComment: async (_userId: number, reportHubId: number, _content: string, _businessDate: string | null, _clientTempId: string, visible: VisibleSourceTypeSet) => {
+            calls.mutations.push({ method: "addComment", reportHubId, visible })
+            if (options.mutationError) throw options.mutationError
+            return { id: 1, userId: "ENC1", userName: "u", content: "c", createdAt: "", isMine: true }
+        },
+        deleteComment: async (_userId: number, reportHubId: number, _commentId: number, _businessDate: string | null, _clientTempId: string, visible: VisibleSourceTypeSet) => {
+            calls.mutations.push({ method: "deleteComment", reportHubId, visible })
+            if (options.mutationError) throw options.mutationError
+        },
         markAttachmentMissing: async (id: number) => {
             calls.markAttachmentMissing.push(id)
         },
@@ -122,11 +182,34 @@ export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { con
         },
     } as unknown as DailyReportService
 
+    // 捕捉した onEntry を露出し、テストから任意の Stream エントリを流し込めるようにする。
+    // 露出しないと SSE の受信側フィルタ (区分・宛先) を一切検証できない
+    const sseSubscribers: Array<(entry: StreamEntry) => void> = []
+    /** 購読中の SSE ハンドラ全員へエントリを流し込む (テスト用の注入口)。 */
+    const pushSseEntry = (entry: StreamEntry) => {
+        for (const onEntry of [...sseSubscribers]) onEntry(entry)
+    }
+
     const base: DailyReportHandlersConfig = {
         authenticate: async () => ({ user: user ?? undefined, cookie: options.cookie }),
+        resolveVisibleSourceTypes: options.resolveVisibleSourceTypes
+            ? async (request: Request, context: DailyReportVisibilityResolveContext) => {
+                  calls.resolveVisibleSourceTypes += 1
+                  calls.visibilityResolveReasons.push(context.reason)
+                  return options.resolveVisibleSourceTypes?.(request, context)
+              }
+            : undefined,
         service,
         encodeUserId: (id) => `ENC${id}`,
-        sseReader: { subscribe: () => () => undefined } as unknown as DailyReportSseReader,
+        sseReader: {
+            subscribe: (onEntry: (entry: StreamEntry) => void) => {
+                sseSubscribers.push(onEntry)
+                return () => {
+                    const index = sseSubscribers.indexOf(onEntry)
+                    if (index >= 0) sseSubscribers.splice(index, 1)
+                }
+            },
+        } as unknown as DailyReportSseReader,
         streamKey: "test-stream",
         attachmentMaxBytes: options.attachmentMaxBytes,
         attachmentRateLimitPerMinute: options.attachmentRateLimitPerMinute,
@@ -135,7 +218,7 @@ export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { con
     }
 
     if (options.omitPorts) {
-        return { config: base, calls }
+        return { config: base, calls, pushSseEntry }
     }
 
     return {
@@ -153,6 +236,7 @@ export const makeHandlersFixture = (options: HandlersFixtureOptions = {}): { con
             },
         },
         calls,
+        pushSseEntry,
     }
 }
 

package/src/server/visibility.spec.ts

@@ -0,0 +1,142 @@
+/**
+ * Unit tests for the source-type visibility helpers.
+ * sourceType 可視性ヘルパーの単体テスト。
+ *
+ * ここで固定するのは「無制限 (null) と全拒否 (空集合) を決して取り違えない」という不変条件であり、
+ * 取り違えは情報漏洩 (全件配信) か機能停止 (0 件) に直結する。
+ */
+import { describe, expect, it } from "vitest"
+import { computeSourceTypeDigest, isSourceTypeVisible, normalizeVisibleSourceTypes } from "./visibility"
+
+describe("normalizeVisibleSourceTypes", () => {
+    it("undefined と null は無制限 (null) になる", () => {
+        expect(normalizeVisibleSourceTypes(undefined)).toBeNull()
+        expect(normalizeVisibleSourceTypes(null)).toBeNull()
+    })
+
+    it("空配列は空集合 (0 件) であり、無制限へは倒れない", () => {
+        const result = normalizeVisibleSourceTypes([])
+        // ❗ ここが null になると「権限なし」が「全件可視」へ反転する
+        expect(result).not.toBeNull()
+        expect(result?.size).toBe(0)
+    })
+
+    it("大小文字を畳み込み、前後空白を除去し、重複と空文字を落とす", () => {
+        const result = normalizeVisibleSourceTypes(["NI", " ni ", "kintone", "", "   ", "Kintone"])
+        expect([...(result ?? [])].sort()).toEqual(["kintone", "ni"])
+    })
+
+    it("非文字列要素は可視性を広げずに捨てられる", () => {
+        const raw = ["NI", 42, null, undefined, {}] as unknown as readonly string[]
+        const result = normalizeVisibleSourceTypes(raw)
+        expect([...(result ?? [])]).toEqual(["ni"])
+    })
+
+    it("配列以外 (契約違反の文字列) は文字反復せず全拒否になる", () => {
+        // `for...of "NI"` が文字単位で回ると {"n","i"} という誤った可視集合になる
+        const result = normalizeVisibleSourceTypes("NI" as unknown as readonly string[])
+        expect(result?.size).toBe(0)
+    })
+})
+
+describe("isSourceTypeVisible", () => {
+    it("無制限 (null) は sourceType を問わず常に可視", () => {
+        expect(isSourceTypeVisible(null, "NI")).toBe(true)
+        expect(isSourceTypeVisible(null, null)).toBe(true)
+        expect(isSourceTypeVisible(null, undefined)).toBe(true)
+    })
+
+    it("限定時は大小文字を無視して一致判定する", () => {
+        const set = normalizeVisibleSourceTypes(["ni", "kintone"])
+        expect(isSourceTypeVisible(set, "NI")).toBe(true)
+        expect(isSourceTypeVisible(set, "Kintone")).toBe(true)
+        // 列値のトリムは行わない (SQL 述語と揃えるため。詳細は「JS 判定と SQL 述語の対称性」)
+        expect(isSourceTypeVisible(set, " ni ")).toBe(false)
+    })
+
+    it("限定時に集合外の区分は不可視", () => {
+        const set = normalizeVisibleSourceTypes(["kintone"])
+        expect(isSourceTypeVisible(set, "NI")).toBe(false)
+        expect(isSourceTypeVisible(set, "Internal")).toBe(false)
+    })
+
+    it("限定時に区分不明 (null / undefined) は不可視 (fail-close)", () => {
+        const set = normalizeVisibleSourceTypes(["ni"])
+        expect(isSourceTypeVisible(set, null)).toBe(false)
+        expect(isSourceTypeVisible(set, undefined)).toBe(false)
+    })
+
+    it("空集合はいかなる区分も不可視", () => {
+        const set = normalizeVisibleSourceTypes([])
+        expect(isSourceTypeVisible(set, "NI")).toBe(false)
+        expect(isSourceTypeVisible(set, "Internal")).toBe(false)
+    })
+})
+
+describe("computeSourceTypeDigest", () => {
+    it("無制限と全拒否は互いに異なる固定値になる", () => {
+        expect(computeSourceTypeDigest(null)).toBe("all")
+        expect(computeSourceTypeDigest(normalizeVisibleSourceTypes([]))).toBe("none")
+    })
+
+    it("正規化後に等価な集合は同一ダイジェストになる", () => {
+        const a = computeSourceTypeDigest(normalizeVisibleSourceTypes(["NI"]))
+        const b = computeSourceTypeDigest(normalizeVisibleSourceTypes([" ni "]))
+        expect(a).toBe(b)
+    })
+
+    it("要素順に依存しない", () => {
+        const a = computeSourceTypeDigest(normalizeVisibleSourceTypes(["ni", "kintone"]))
+        const b = computeSourceTypeDigest(normalizeVisibleSourceTypes(["kintone", "ni"]))
+        expect(a).toBe(b)
+    })
+
+    it("論理的に異なる集合は必ず別のダイジェストになる (相互汚染の防止)", () => {
+        const digests = [
+            computeSourceTypeDigest(null),
+            computeSourceTypeDigest(normalizeVisibleSourceTypes([])),
+            computeSourceTypeDigest(normalizeVisibleSourceTypes(["ni"])),
+            computeSourceTypeDigest(normalizeVisibleSourceTypes(["kintone"])),
+            computeSourceTypeDigest(normalizeVisibleSourceTypes(["internal"])),
+            computeSourceTypeDigest(normalizeVisibleSourceTypes(["ni", "kintone"])),
+            computeSourceTypeDigest(normalizeVisibleSourceTypes(["ni", "internal"])),
+            computeSourceTypeDigest(normalizeVisibleSourceTypes(["ni", "kintone", "internal"])),
+        ]
+        expect(new Set(digests).size).toBe(digests.length)
+    })
+
+    it("巨大な集合はハッシュへ退避しつつキー長が有界になる", () => {
+        const many = Array.from({ length: 200 }, (_, index) => `source-type-${index}`)
+        const digest = computeSourceTypeDigest(normalizeVisibleSourceTypes(many))
+        expect(digest.startsWith("h:")).toBe(true)
+        expect(digest.length).toBeLessThanOrEqual(16)
+    })
+
+    it("退避したハッシュも生連結と衝突しない接頭辞を持つ", () => {
+        const many = Array.from({ length: 200 }, (_, index) => `source-type-${index}`)
+        const hashed = computeSourceTypeDigest(normalizeVisibleSourceTypes(many))
+        const raw = computeSourceTypeDigest(normalizeVisibleSourceTypes(["ni"]))
+        expect(hashed).not.toBe(raw)
+        expect(raw.startsWith("h:")).toBe(false)
+    })
+})
+
+describe("JS 判定と SQL 述語の対称性", () => {
+    // 同じ 3 入力に対し、両者が同じ三値意味を返すことを固定する。
+    // どちらか一方だけ畳み込み規則を変えると、SSE (JS 判定) と読み取り (SQL 判定) で
+    // 同じ行の可視性が食い違い、SSE 側が fail-open へずれる
+    it("列値は両側ともトリムしない (空白混じりの値は双方で不可視 = fail-close)", () => {
+        const set = normalizeVisibleSourceTypes(["NI"])
+        // JS 判定: 前後空白付きの列値は一致しない
+        expect(isSourceTypeVisible(set, " NI")).toBe(false)
+        expect(isSourceTypeVisible(set, "NI ")).toBe(false)
+        // 空白なしは一致する (大小文字は無視)
+        expect(isSourceTypeVisible(set, "ni")).toBe(true)
+    })
+
+    it("リゾルバのトークン側だけは前後空白を吸収する", () => {
+        const set = normalizeVisibleSourceTypes([" NI "])
+        expect(isSourceTypeVisible(set, "NI")).toBe(true)
+        expect([...(set ?? [])]).toEqual(["ni"])
+    })
+})

package/src/server/visibility.ts

@@ -0,0 +1,189 @@
+/**
+ * Source-type visibility set: normalization, digest, and predicate helpers.
+ * sourceType 可視集合の正規化・ダイジェスト・判定ヘルパー群。
+ *
+ * 中立文字列 (`DailyReportHub.sourceType` の値) のみを扱い、いかなる認可パッケージの型にも
+ * 依存しない。可視集合は 2 状態を厳密に区別する:
+ *
+ * - `null`  = 無制限 (全件)。ポート未注入時の既定であり、現行互換の意味を持つ。
+ * - `Set`   = その集合に限定。**空集合は 0 件 (fail-close)** であって無制限ではない。
+ *
+ * この 2 状態の取り違えは情報漏洩か機能停止に直結するため、判定・畳み込み・キー生成を
+ * 本ファイルへ一元化し、ハンドラ層とサービス層の双方がここだけを参照する。
+ */
+import { inArray, type SQL, sql } from "drizzle-orm"
+import type { AnyMsSqlColumn } from "drizzle-orm/mssql-core"
+import type { DailyReportVisibleSourceTypes } from "./ports"
+
+/**
+ * Normalized visible set. null = unrestricted (all rows), ReadonlySet = restricted (empty = zero rows).
+ * 正規化済みの可視集合。null は無制限 (全件)、ReadonlySet は限定 (空集合は 0 件)。
+ */
+export type VisibleSourceTypeSet = ReadonlySet<string> | null
+
+/**
+ * Separator for digest concatenation; never occurs inside a sourceType value.
+ * ダイジェスト連結用の区切り文字。sourceType の値には決して現れない制御文字。
+ */
+const DIGEST_SEPARATOR = "\u0001"
+
+/**
+ * Maximum digest length before falling back to a hash.
+ * ハッシュへ退避する前のダイジェスト最大長。
+ *
+ * キャッシュキーが際限なく伸びるのを防ぐだけの閾値であり、通常の区分数 (数個) では到達しない。
+ */
+const DIGEST_RAW_MAX_LENGTH = 64
+
+/**
+ * Folds a stored sourceType value into its comparison key (case-insensitive only).
+ * 格納済みの sourceType 値を比較キーへ畳み込む処理 (大小文字非依存のみ)。
+ *
+ * ❗ ここで `trim()` してはならない。SQL 側の述語は `LOWER(source_type)` だけを掛けており
+ * 列値をトリムしないため、JS 側だけ切り詰めると同じ行について SSE (JS 判定) は可視・
+ * 読み取り (SQL 判定) は不可視という乖離が生まれる (SSE が fail-open 側へずれる)。
+ * 両者を「列値は畳み込むだけ」に揃え、空白混じりの値は双方で不可視 = fail-close とする。
+ */
+const foldStoredSourceType = (raw: string): string => raw.toLowerCase()
+
+/**
+ * Folds a resolver-supplied token into its comparison key (trimmed, case-insensitive).
+ * リゾルバ由来のトークンを比較キーへ畳み込む処理 (前後空白除去・大小文字非依存)。
+ *
+ * トークンは人手で設定された設定値であり、前後の空白は書き間違いとして吸収してよい。
+ * 一方で列値 ({@link foldStoredSourceType}) は DB のデータなので勝手に切り詰めない。
+ */
+const foldResolverToken = (raw: string): string => raw.trim().toLowerCase()
+
+/**
+ * Normalizes a raw resolver return into a VisibleSourceTypeSet.
+ * ポートの生戻り値を正規化済み可視集合へ変換する処理。
+ *
+ * `null` / `undefined` は無制限 (`null`) へ。配列は各要素を畳み込み・空文字除去・重複排除して
+ * `Set` 化する。**空配列は空 `Set` (0 件) を返し、`null` (無制限) へは決して倒さない** —
+ * この取り違えが情報漏洩か機能停止に直結するため。
+ *
+ * @param raw Raw resolver return value. ポートの生戻り値。
+ * @returns Normalized visible set. 正規化済みの可視集合。
+ */
+export function normalizeVisibleSourceTypes(raw: DailyReportVisibleSourceTypes): VisibleSourceTypeSet {
+    if (raw == null) {
+        return null
+    }
+    // 配列以外 (契約違反。例: リゾルバが誤って文字列 "NI" を返す) は fail-close で空集合にする。
+    // ガードが無いと `for...of "NI"` が文字単位で反復し {"n","i"} という誤った可視集合になる
+    if (!Array.isArray(raw)) {
+        return new Set<string>()
+    }
+    const set = new Set<string>()
+    for (const token of raw) {
+        // 非文字列要素は黙って捨てる (可視性を広げる方向には決して働かない)
+        if (typeof token !== "string") {
+            continue
+        }
+        const folded = foldResolverToken(token)
+        if (folded.length > 0) {
+            set.add(folded)
+        }
+    }
+    return set
+}
+
+/**
+ * Tests whether a report's sourceType is visible under the given set.
+ * ある日報の sourceType が可視集合に含まれるかの三値判定。
+ *
+ * - 無制限 (`null`): 常に `true`。
+ * - 限定 + sourceType 判明: 畳み込み一致で判定。
+ * - 限定 + sourceType 不明 (`null` / `undefined`): `false` — 制限された閲覧者は「不明な区分」を
+ *   見られない。区分を運ばない旧 SSE エントリ等を fail-close 側へ倒すための規則。
+ *
+ * @param set Normalized visible set. 正規化済みの可視集合。
+ * @param sourceType The row's source type, if known. 判明していれば当該行のソース種別。
+ * @returns True when visible. 可視なら true。
+ */
+export function isSourceTypeVisible(set: VisibleSourceTypeSet, sourceType: string | null | undefined): boolean {
+    if (set === null) {
+        return true
+    }
+    if (sourceType == null) {
+        return false
+    }
+    return set.has(foldStoredSourceType(sourceType))
+}
+
+/**
+ * Tells whether the set denies everything (zero rows).
+ * 可視集合が全拒否 (0 件) を意味するかを判定する処理。
+ *
+ * 真のとき呼び出し側は DB へ問い合わせず即座に空を返してよい (無駄クエリの排除)。
+ * これは性能上の短絡であり、認可の防御そのものは {@link buildVisibleSourceTypeCondition} が担う。
+ *
+ * @param set Normalized visible set. 正規化済みの可視集合。
+ * @returns True when nothing is visible. 何も可視でないなら true。
+ */
+export function deniesEverySourceType(set: VisibleSourceTypeSet): boolean {
+    return set !== null && set.size === 0
+}
+
+/**
+ * Builds the SQL condition restricting rows to the visible source types.
+ * 可視 sourceType へ行を限定する SQL 条件を生成する処理 (三値)。
+ *
+ * {@link isSourceTypeVisible} の SQL 版であり、同じ三値を同じ向きへ写像する:
+ *
+ * - 無制限 (`null`): `undefined` を返す。drizzle の `and(...)` は `undefined` を無視するため、
+ *   既存の述語がそのまま残る (現行互換)。
+ * - 全拒否 (空集合): `1 = 0` を返す。**決して `undefined` へ倒さない** — 呼び出し側の短絡漏れが
+ *   あっても生成器自身が fail-close する二重防御であり、ここを緩めると認可が反転する。
+ * - 限定: `LOWER(<column>) IN (...)`。トークンは正規化時に小文字畳み込み済みなので両辺が小文字となり、
+ *   DB の照合順序 (collation) に依存せず決定的に大小文字非依存で一致する。
+ *
+ * @param sourceTypeColumn The source-type column to constrain. 制限対象の sourceType 列。
+ * @param set Normalized visible set. 正規化済みの可視集合。
+ * @returns Condition, or undefined when unrestricted. 条件 (無制限なら undefined)。
+ */
+export function buildVisibleSourceTypeCondition(sourceTypeColumn: AnyMsSqlColumn, set: VisibleSourceTypeSet): SQL | undefined {
+    if (set === null) {
+        return undefined
+    }
+    if (set.size === 0) {
+        return sql`1 = 0`
+    }
+    return inArray(sql`LOWER(${sourceTypeColumn})`, [...set])
+}
+
+/**
+ * Computes a stable, bounded, collision-free cache-key digest of the set.
+ * 可視集合から安定・有界・衝突不能なキャッシュキー用ダイジェストを算出する処理。
+ *
+ * 無制限は `"all"`、空集合は `"none"`、それ以外は**畳み込み済みトークンを昇順にそのまま連結**する。
+ * 生連結のため、論理的に等価な集合は必ず同一の、論理的に異なる集合は必ず別のダイジェストになる
+ * (ハッシュ衝突で別権限のキャッシュ行を配信する事故が原理的に起きない)。権限が安定している間は
+ * キーが不変になるため、キャッシュは完全に再利用される (性能無退行)。
+ * 区分数が異常に多い場合だけキー長を抑えるため FNV-1a 32bit へ退避し、`h:` 接頭辞で生連結と区別する。
+ *
+ * @param set Normalized visible set. 正規化済みの可視集合。
+ * @returns Digest usable as a cache-key component. キャッシュキー構成要素として使えるダイジェスト。
+ */
+export function computeSourceTypeDigest(set: VisibleSourceTypeSet): string {
+    if (set === null) {
+        return "all"
+    }
+    if (set.size === 0) {
+        return "none"
+    }
+    // 昇順ソートで要素順に依存しないキーにする (同じ集合は常に同じダイジェスト)
+    const joined = [...set].sort().join(DIGEST_SEPARATOR)
+    if (joined.length <= DIGEST_RAW_MAX_LENGTH) {
+        return joined
+    }
+    // 長大キーの退避のみハッシュ化する。衝突しても影響は同一ユーザーのキャッシュ再利用に限られ、
+    // かつ TTL で失効するが、生連結と混同しないよう接頭辞で区別する
+    let hash = 0x811c9dc5
+    for (let i = 0; i < joined.length; i++) {
+        hash ^= joined.charCodeAt(i)
+        hash = Math.imul(hash, 0x01000193)
+    }
+    return `h:${(hash >>> 0).toString(16)}`
+}

package/src/server.spec.ts

@@ -47,3 +47,75 @@ describe("createDailyReportServer: enableDevCacheClear の結線", () => {
         expect(res.status).toBe(200)
     })
 })
+
+describe("createDailyReportServer: resolveVisibleSourceTypes の結線", () => {
+    /** ポートを注入したファサードを組み立てる。 */
+    const makeServerWithPort = (resolveVisibleSourceTypes?: () => Promise<string[]>) =>
+        createDailyReportServer({
+            db: noopDb,
+            tables,
+            userTable: testUsers,
+            resolveUserId: async () => 8,
+            encodeUserId: (id) => `ENC${id}`,
+            authenticate: async () => ({ user: { id: "ext-8" }, cookie: null }),
+            draftLabelName: "draft",
+            resolveVisibleSourceTypes,
+        })
+
+    /** 読み取り API の引数。 */
+    const readArgs = () => ({
+        request: new Request("http://localhost/daily_report/api/business-date?businessDate=2099-01-05"),
+        params: { endpoint: "business-date" } as Record<string, string | undefined>,
+    })
+
+    it("注入したポートがハンドラまで伝播して呼ばれる", async () => {
+        // ❗ createDailyReportServer の明示列挙からこの 1 行が落ちると、アプリがポートを
+        //    注入しても黙って捨てられ、区分フィルタが効かないまま全件配信になる (認可バイパス)
+        let calls = 0
+        const server = makeServerWithPort(async () => {
+            calls += 1
+            return ["NI"]
+        })
+
+        await server.api.loader(readArgs())
+
+        expect(calls).toBe(1)
+    })
+
+    // 未注入時に無制限 (null) が全経路へ渡ることは handlers.visibility.spec.ts が
+    // サービス受領引数レベルで固定しているため、ここでは転送の有無だけを見る
+})
+
+describe("createDailyReportServer: knownSourceTypes", () => {
+    it("externalSources の sourceType と Internal を重複なく公開する", () => {
+        const server = createDailyReportServer({
+            db: noopDb,
+            tables,
+            userTable: testUsers,
+            resolveUserId: async () => 8,
+            encodeUserId: (id) => `ENC${id}`,
+            authenticate: async () => ({ user: { id: "ext-8" }, cookie: null }),
+            draftLabelName: "draft",
+            externalSources: [
+                { sourceType: "NI", table: {}, idColumn: tables.hub.id, mapRow: () => ({}) },
+                { sourceType: "kintone", table: {}, idColumn: tables.hub.id, mapRow: () => ({}) },
+            ],
+        })
+
+        expect([...server.knownSourceTypes].sort()).toEqual(["Internal", "NI", "kintone"].sort())
+    })
+
+    it("externalSources 未注入でも Internal だけは必ず含む", () => {
+        const server = createDailyReportServer({
+            db: noopDb,
+            tables,
+            userTable: testUsers,
+            resolveUserId: async () => 8,
+            encodeUserId: (id) => `ENC${id}`,
+            authenticate: async () => ({ user: { id: "ext-8" }, cookie: null }),
+            draftLabelName: "draft",
+        })
+
+        expect([...server.knownSourceTypes]).toEqual(["Internal"])
+    })
+})

package/src/server.ts

@@ -5,7 +5,7 @@
 import { createEpochStore, SqlResultCache } from "./server/cache"
 import type { DailyReportExternalSource } from "./server/external-source"
 import { createDailyReportHandlers } from "./server/handlers"
-import type { DailyReportAuthenticate, DailyReportReadAttachment } from "./server/ports"
+import type { DailyReportAuthenticate, DailyReportReadAttachment, DailyReportResolveVisibleSourceTypes } from "./server/ports"
 import { createDailyReportService, type DailyReportServiceConfig } from "./server/service"
 import { DailyReportSseReader } from "./server/sse-reader"
 
@@ -19,11 +19,20 @@ export * from "./server/response"
 export * from "./server/schema"
 export * from "./server/service"
 export * from "./server/sse-reader"
+export * from "./server/visibility"
 
 /** createDailyReportServer の設定 (サービス設定 + 認証ポート + ハンドラ設定)。 */
 export type DailyReportServerConfig = Omit<DailyReportServiceConfig, "cache" | "epochs"> & {
     /** リクエスト認証ポート。 */
     authenticate: DailyReportAuthenticate
+    /**
+     * 可視 sourceType リゾルバ。未注入なら全件 (現行互換)。
+     *
+     * サーバー側の全データ経路 (一覧 / 詳細 / コメント / 添付 / SSE) に一貫して効く。
+     * 戻り値は `DailyReportHub.sourceType` の値 (`knownSourceTypes` 参照) であり、認可リソースキーではない。
+     * `undefined` / `null` は無制限、空配列は 0 件、例外は全拒否 (fail-close)。
+     */
+    resolveVisibleSourceTypes?: DailyReportResolveVisibleSourceTypes
     /** 添付ファイル読み取りポート。未注入なら添付エンドポイントは常に 404。 */
     readAttachment?: DailyReportReadAttachment
     /** 添付ファイルの最大バイト数 (既定 32 MiB)。サービス側のワイヤ上限より低く保つこと。 */
@@ -75,6 +84,9 @@ export function createDailyReportServer(config: DailyReportServerConfig) {
     //    アプリが注入しても黙って捨てられ、添付エンドポイントは永久に 404 を返す。
     const handlers = createDailyReportHandlers({
         authenticate: config.authenticate,
+        // ❗ 明示列挙。ここへ足し忘れると注入されたポートが黙って捨てられ、区分フィルタが
+        //    一切効かないまま全件配信になる (認可バイパス)。server.spec.ts が配線を gate する
+        resolveVisibleSourceTypes: config.resolveVisibleSourceTypes,
         service,
         encodeUserId: config.encodeUserId,
         attachmentIdCodec: config.attachmentIdCodec,
@@ -101,6 +113,13 @@ export function createDailyReportServer(config: DailyReportServerConfig) {
         sseReader,
         /** SSE Redis Stream キー。 */
         streamKey: service.streamKey,
+        /**
+         * 既知の正準 sourceType 集合 (注入した `externalSources` の全 sourceType + `"Internal"`)。
+         *
+         * `resolveVisibleSourceTypes` が返すべき語彙そのものであり、消費側は起動時にこの集合と
+         * 自前のマッピングを突き合わせて誤トークン (無診断で 0 件になる) を検出できる。
+         */
+        knownSourceTypes: [...new Set(["Internal", ...(config.externalSources ?? []).map((source) => source.sourceType)])] as readonly string[],
         ...handlers,
     }
 }