@aiquants/daily-report 0.1.1

package/dist/server.d.ts

@@ -0,0 +1,1515 @@
+import { e as DailyReportInterviewer, c as DailyReportComment, D as DailyReportItem, a as DailyReportDetail, d as DailyReportCommentItem } from './types-CVhwLhSN.js';
+import * as drizzle_orm_mssql_core from 'drizzle-orm/mssql-core';
+import { AnyMsSqlColumn } from 'drizzle-orm/mssql-core';
+import { D as DailyReportLogger } from './logger-D3krZrNK.js';
+
+/**
+ * DI ports (structural interfaces) consumed by the daily-report server layer.
+ * daily-report サーバー層が消費する DI ポート (構造的インターフェース) 群。
+ *
+ * redis / 認証 / ユーザー解決 / ID 難読化はすべてアプリ実装を注入する。
+ * redis の型は `redis` パッケージへ依存しないよう、使用する最小面のみ構造定義する。
+ */
+/** Redis Stream の 1 エントリ (xRead / xRange の結果要素)。 */
+type RedisStreamMessage = {
+    id: string;
+    message: Record<string, string>;
+};
+/** 通常操作用 Redis クライアントの最小面 (共有クライアント)。 */
+type DailyReportRedisClient = {
+    get(key: string): Promise<string | null>;
+    incr(key: string): Promise<number>;
+    xAdd(key: string, id: string, message: Record<string, string>, options?: unknown): Promise<string>;
+    xRange(key: string, start: string, end: string, options?: {
+        COUNT?: number;
+    }): Promise<RedisStreamMessage[]>;
+    xRevRange(key: string, start: string, end: string, options?: {
+        COUNT?: number;
+    }): Promise<RedisStreamMessage[]>;
+};
+/** ブロッキング xRead 用 Redis クライアントの最小面 (SSE リーダー専用接続)。 */
+type DailyReportRedisBlockingClient = {
+    isOpen: boolean;
+    on(event: "error", listener: (err: Error) => void): unknown;
+    xRead(streams: Array<{
+        key: string;
+        id: string;
+    }>, options?: {
+        BLOCK?: number;
+        COUNT?: number;
+    }): Promise<Array<{
+        name: string;
+        messages: RedisStreamMessage[];
+    }> | null>;
+    quit(): Promise<unknown>;
+};
+/**
+ * Redis provider port: shared client for commands + dedicated client factory for blocking reads.
+ * Redis プロバイダーポート。コマンド用共有クライアントと、ブロッキング読み取り用専用クライアント生成を提供する。
+ */
+type DailyReportRedisProvider = {
+    /** 共有クライアントを取得する (未接続・失敗時は undefined)。 */
+    getClient(): Promise<DailyReportRedisClient | undefined>;
+    /** ブロッキング xRead 用の専用クライアントを生成する (失敗時は undefined)。 */
+    createClient(): Promise<DailyReportRedisBlockingClient | undefined>;
+};
+/** 認証結果 (ユーザーは外部 ID を持つ最小形状)。 */
+type DailyReportAuthResult = {
+    user?: {
+        id: string;
+    };
+    cookie?: string;
+};
+/**
+ * Request authentication port (e.g. session/OpenID check in the host app).
+ * リクエスト認証ポート (ホストアプリのセッション / OpenID 検証)。
+ *
+ * `failureRedirect` が文字列の場合、未認証時は実装側で redirect を throw すること。
+ * null の場合は throw せず `user` 無しで解決する。
+ */
+type DailyReportAuthenticate = (request: Request, options: {
+    failureRedirect: string;
+} | {
+    failureRedirect: null;
+}) => Promise<DailyReportAuthResult>;
+/**
+ * Resolves an external user id (e.g. Google sub) to the internal numeric user id.
+ * 外部ユーザー ID (例: Google sub) を内部数値ユーザー ID へ解決するポート。
+ */
+type DailyReportResolveUserId = (externalUserId: string) => Promise<number | null>;
+/**
+ * Obfuscates an internal numeric user id for client exposure.
+ * 内部数値ユーザー ID をクライアント公開用に難読化するポート。
+ */
+type DailyReportEncodeUserId = (id: number) => string;
+
+/**
+ * In-memory SQL result cache with TTL, snapshot, and cross-worker epoch (via redis) support.
+ * TTL・スナップショット・クロスワーカー epoch (redis 経由) を備えた SQL 結果のインメモリキャッシュ。
+ *
+ * epoch は任意注入の redis ポート経由で取得・更新する (未注入時は常に 0 = epoch 無効)。
+ */
+
+type SqlResultCacheQueryOptions = {
+    forceRefresh?: boolean;
+    snapshot?: boolean;
+    ttlMsOverride?: number;
+    epochKey?: string;
+};
+/**
+ * Creates epoch helpers bound to an optional redis provider.
+ * 任意の redis プロバイダーに束縛された epoch ヘルパーを生成する処理。
+ */
+declare const createEpochStore: (redis?: DailyReportRedisProvider) => {
+    /**
+     * Gets the current epoch value from Redis.
+     * Redis からエポック値を取得する。エラー時は 0 を返す (常に re-fetch = safe 方向)。
+     */
+    getEpoch(epochKey: string): Promise<number>;
+    /**
+     * Increments the epoch counter in Redis.
+     * Redis のエポックカウンターをインクリメントする。
+     */
+    incrementEpoch(epochKey: string): Promise<void>;
+};
+type EpochStore = ReturnType<typeof createEpochStore>;
+/**
+ * In-memory cache for SQL query results with TTL and snapshot support.
+ * TTLとスナップショット機能を備えたSQLクエリ結果のインメモリキャッシュ。
+ */
+declare class SqlResultCache {
+    private readonly config;
+    private readonly epochStore;
+    private readonly buckets;
+    private readonly inFlight;
+    constructor(config: {
+        defaultTtlMs: number;
+    }, epochStore: EpochStore);
+    /**
+     * Invalidates a specific cache bucket.
+     * 指定されたキャッシュバケットを無効化します。
+     */
+    invalidate: (cacheKey: string) => void;
+    /**
+     * Retrieves records from cache or fetches them if expired/missing.
+     * キャッシュからレコードを取得するか、期限切れや未存在の場合はフェッチします。
+     */
+    getOrFetch: <T>(opts: {
+        cacheKey: string;
+        fetcher: () => Promise<readonly T[]>;
+    } & SqlResultCacheQueryOptions) => Promise<readonly T[]>;
+    /**
+     * Clears the cache for a specific key.
+     * 指定されたキーのキャッシュをクリアします。
+     */
+    flush: (cacheKey: string) => void;
+    /**
+     * Invalidates cache buckets matching a prefix.
+     * 指定されたプレフィックスに一致するキャッシュバケットを無効化します。
+     */
+    invalidatePrefix: (prefix: string) => void;
+}
+
+/**
+ * External source adapter contract for legacy/foreign daily-report tables.
+ * レガシー・外部由来の日報テーブルを取り込む外部ソースアダプタ契約。
+ *
+ * DailyReportHub.source_type がアダプタの `sourceType` に一致する行は、
+ * `table` を `Hub.source_id_num = idColumn` で LEFT JOIN し、その行を
+ * `mapRow` で表示フィールドへ変換する (例: 別システムのレガシー日報テーブルの取り込み)。
+ */
+
+/** 外部ソース行から詳細表示へ供給するフィールド群。 */
+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[];
+};
+/** 外部ソースアダプタ。 */
+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;
+};
+/**
+ * Parses JSON array payloads and maps each element (fail-soft: returns [] on error).
+ * JSON 配列のペイロードを解析し各要素を変換する処理 (エラー時は空配列)。
+ */
+declare const transformJsonArray: <TRaw, TResult>(payload: string | null, label: string, mapper: (raw: TRaw) => TResult | null, logger?: DailyReportLogger) => TResult[];
+
+/** 注入する外部ユーザーテーブルの最小形 (id / display_name)。 */
+type DailyReportUserTable = {
+    id: AnyMsSqlColumn;
+    displayName: AnyMsSqlColumn;
+};
+/** DailyReportHub テーブルの構造形。 */
+type DailyReportHubTable = {
+    id: AnyMsSqlColumn;
+    sourceType: AnyMsSqlColumn;
+    sourceId: AnyMsSqlColumn;
+    sourceIdNum: AnyMsSqlColumn;
+    businessDate: AnyMsSqlColumn;
+    userId: AnyMsSqlColumn;
+    title: AnyMsSqlColumn;
+    summary: AnyMsSqlColumn;
+    createdAt: AnyMsSqlColumn;
+    createdBy: AnyMsSqlColumn;
+    updatedAt: AnyMsSqlColumn;
+    updatedBy: AnyMsSqlColumn;
+    deletedAt: AnyMsSqlColumn;
+    deletedBy: AnyMsSqlColumn;
+};
+/** DailyReportInternal テーブルの構造形。 */
+type DailyReportInternalTable = {
+    hubId: AnyMsSqlColumn;
+    body: AnyMsSqlColumn;
+    metadata: AnyMsSqlColumn;
+    createdAt: AnyMsSqlColumn;
+    createdBy: AnyMsSqlColumn;
+    updatedAt: AnyMsSqlColumn;
+    updatedBy: AnyMsSqlColumn;
+};
+/** DailyReportComment テーブルの構造形。 */
+type DailyReportCommentTable = {
+    id: AnyMsSqlColumn;
+    hubId: AnyMsSqlColumn;
+    userId: AnyMsSqlColumn;
+    body: AnyMsSqlColumn;
+    createdAt: AnyMsSqlColumn;
+    createdBy: AnyMsSqlColumn;
+    updatedAt: AnyMsSqlColumn;
+    updatedBy: AnyMsSqlColumn;
+};
+/** DailyReportLabel テーブルの構造形。 */
+type DailyReportLabelTable = {
+    id: AnyMsSqlColumn;
+    userId: AnyMsSqlColumn;
+    name: AnyMsSqlColumn;
+    color: AnyMsSqlColumn;
+    sortOrder: AnyMsSqlColumn;
+    createdAt: AnyMsSqlColumn;
+    createdBy: AnyMsSqlColumn;
+    updatedAt: AnyMsSqlColumn;
+    updatedBy: AnyMsSqlColumn;
+};
+/** DailyReportHub_Label 中間テーブルの構造形。 */
+type DailyReportHubLabelTable = {
+    hubId: AnyMsSqlColumn;
+    labelId: AnyMsSqlColumn;
+    createdAt: AnyMsSqlColumn;
+    createdBy: AnyMsSqlColumn;
+};
+/** DailyReportUserStatus テーブルの構造形。 */
+type DailyReportUserStatusTable = {
+    hubId: AnyMsSqlColumn;
+    userId: AnyMsSqlColumn;
+    isRead: AnyMsSqlColumn;
+    isStarred: AnyMsSqlColumn;
+    createdAt: AnyMsSqlColumn;
+    createdBy: AnyMsSqlColumn;
+    updatedAt: AnyMsSqlColumn;
+    updatedBy: AnyMsSqlColumn;
+};
+/** サービスへ注入するテーブル一式 (アプリ既存モデルまたは本ファクトリ生成物)。 */
+type DailyReportTables = {
+    hub: DailyReportHubTable;
+    internal: DailyReportInternalTable;
+    comment: DailyReportCommentTable;
+    label: DailyReportLabelTable;
+    hubLabel: DailyReportHubLabelTable;
+    userStatus: DailyReportUserStatusTable;
+};
+/**
+ * Generic factory: build the six daily-report tables under an arbitrary schema name.
+ * 任意のスキーマ名の下に日報 6 テーブルを生成する汎用ファクトリ。
+ *
+ * 制約・索引名は `${schemaName}_<Table>_...` 規約で生成する。
+ * ユーザーテーブルへの FK は注入された `userTable` を参照する。
+ */
+declare function defineDailyReportSchema<S extends string>(schemaName: S, opts: {
+    userTable: DailyReportUserTable;
+}): {
+    hub: drizzle_orm_mssql_core.MsSqlTableWithColumns<{
+        name: "DailyReportHub";
+        schema: S;
+        columns: {
+            id: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: {};
+            }, {}>;
+            sourceType: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            sourceId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            sourceIdNum: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: false;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: {
+                    type: "always";
+                };
+            }, {}>;
+            businessDate: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            userId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            title: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            summary: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            deletedAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            deletedBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+        };
+        dialect: "mssql";
+    }>;
+    internal: drizzle_orm_mssql_core.MsSqlTableWithColumns<{
+        name: "DailyReportInternal";
+        schema: S;
+        columns: {
+            hubId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportInternal";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            body: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportInternal";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            metadata: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportInternal";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportInternal";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportInternal";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportInternal";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportInternal";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+        };
+        dialect: "mssql";
+    }>;
+    comment: drizzle_orm_mssql_core.MsSqlTableWithColumns<{
+        name: "DailyReportComment";
+        schema: S;
+        columns: {
+            id: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: {};
+            }, {}>;
+            hubId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            userId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            body: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportComment";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+        };
+        dialect: "mssql";
+    }>;
+    label: drizzle_orm_mssql_core.MsSqlTableWithColumns<{
+        name: "DailyReportLabel";
+        schema: S;
+        columns: {
+            id: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: {};
+            }, {}>;
+            userId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            name: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            color: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            sortOrder: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "number int32";
+                data: number;
+                driverParam: number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportLabel";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+        };
+        dialect: "mssql";
+    }>;
+    hubLabel: drizzle_orm_mssql_core.MsSqlTableWithColumns<{
+        name: "DailyReportHub_Label";
+        schema: S;
+        columns: {
+            hubId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub_Label";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            labelId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub_Label";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub_Label";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportHub_Label";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+        };
+        dialect: "mssql";
+    }>;
+    userStatus: drizzle_orm_mssql_core.MsSqlTableWithColumns<{
+        name: "DailyReportUserStatus";
+        schema: S;
+        columns: {
+            hubId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            userId: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "number int53";
+                data: number;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            isRead: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "boolean";
+                data: boolean;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            isStarred: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "boolean";
+                data: boolean;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            createdBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "object date";
+                data: Date;
+                driverParam: string | Date;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+            updatedBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportUserStatus";
+                dataType: "string";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}>;
+        };
+        dialect: "mssql";
+    }>;
+};
+
+/** DailyReportHub の行型。 */
+type DailyReportHubRow = {
+    id: number;
+    sourceType: string;
+    sourceId: string;
+    sourceIdNum: number | null;
+    businessDate: Date | string | null;
+    userId: number | null;
+    title: string | null;
+    summary: string | null;
+    createdAt: Date | string;
+    createdBy: string;
+    updatedAt: Date | string;
+    updatedBy: string;
+    deletedAt: Date | string | null;
+    deletedBy: string | null;
+};
+/** DailyReportInternal の行型。 */
+type DailyReportInternalRow = {
+    hubId: number;
+    body: string | null;
+    metadata: string | null;
+    createdAt: Date | string;
+    createdBy: string;
+    updatedAt: Date | string;
+    updatedBy: string;
+};
+/** DailyReportUserStatus の行型。 */
+type DailyReportUserStatusRow = {
+    hubId: number;
+    userId: number;
+    isRead: boolean;
+    isStarred: boolean;
+    createdAt: Date | string;
+    createdBy: string;
+    updatedAt: Date | string;
+    updatedBy: string;
+};
+/** DailyReportComment の行型。 */
+type DailyReportCommentRow = {
+    id: number;
+    hubId: number;
+    userId: number;
+    body: string;
+    createdAt: Date | string;
+    createdBy: string;
+    updatedAt: Date | string;
+    updatedBy: string;
+};
+type Rows<T> = PromiseLike<T[]>;
+interface SelectChain<T> extends Rows<T> {
+    from(t: unknown): SelectChain<T>;
+    innerJoin(t: unknown, on: unknown): SelectChain<T>;
+    leftJoin(t: unknown, on: unknown): SelectChain<T>;
+    where(cond: unknown): SelectChain<T>;
+    orderBy(...cols: unknown[]): SelectChain<T>;
+    top(n: number): SelectChain<T>;
+}
+interface InsertChain<T> {
+    output(): {
+        values(v: unknown): PromiseLike<T[]>;
+    };
+    values(v: unknown): PromiseLike<unknown>;
+}
+interface UpdateChain<T> {
+    set(v: unknown): {
+        where(cond: unknown): PromiseLike<unknown>;
+        output(): {
+            where(cond: unknown): PromiseLike<T[]>;
+        };
+    };
+}
+interface DeleteChain {
+    where(cond: unknown): PromiseLike<unknown>;
+}
+/** サービスが要求する drizzle mssql データベースの最小面 (トランザクション込み)。 */
+interface DailyReportDb {
+    select<T = Record<string, unknown>>(fields?: unknown): SelectChain<T>;
+    insert<T = Record<string, unknown>>(t: unknown): InsertChain<T>;
+    update<T = Record<string, unknown>>(t: unknown): UpdateChain<T>;
+    delete(t: unknown): DeleteChain;
+    transaction<T>(fn: (tx: DailyReportDb) => Promise<T>, config?: unknown): Promise<T>;
+}
+type DailyReportServiceConfig = {
+    /** drizzle mssql データベースハンドル。 */
+    db: DailyReportDb;
+    /** 日報 6 テーブル (アプリ既存モデルまたは defineDailyReportSchema 生成物)。 */
+    tables: DailyReportTables;
+    /** 表示名解決に使う外部ユーザーテーブル ({ id, displayName })。 */
+    userTable: DailyReportUserTable;
+    /** 外部ユーザー ID → 内部数値 ID の解決ポート。 */
+    resolveUserId: DailyReportResolveUserId;
+    /** 内部数値 ID の難読化ポート。 */
+    encodeUserId: DailyReportEncodeUserId;
+    /** SSE publish / epoch 用 redis (省略時は SSE publish スキップ・epoch 無効)。 */
+    redis?: DailyReportRedisProvider;
+    /** レガシー等の外部ソースアダプタ群。 */
+    externalSources?: DailyReportExternalSource[];
+    /** SQL 結果キャッシュ (facade が生成して注入)。 */
+    cache: SqlResultCache;
+    /** クロスワーカー epoch ストア (facade が生成して注入)。 */
+    epochs: EpochStore;
+    /**
+     * 下書きラベル名 (必須)。ドラフトのクロスユーザー可視性フィルタに使うため、
+     * サイレントな既定値を持たせず消費アプリが自 DB のラベル名を必ず注入する。
+     */
+    draftLabelName: string;
+    /** SSE Redis Stream キー (既定 "daily-report:sse-stream")。 */
+    streamKey?: string;
+    /** SSE Stream の MAXLEN (既定 10000)。 */
+    streamMaxLen?: number;
+    /** IDs 一覧キャッシュ TTL (既定 180,000ms)。 */
+    idsTtlMs?: number;
+    /** 営業日別キャッシュ TTL (既定 300,000ms)。 */
+    businessDateTtlMs?: number;
+    /** 外部 ID → 内部 ID のプロセス内キャッシュを無効化 (テスト用)。 */
+    disableUserIdCache?: boolean;
+    /** ロガー (既定は console ベース)。 */
+    logger?: DailyReportLogger;
+};
+/** createDailyReportService の返却型。 */
+type DailyReportService = ReturnType<typeof createDailyReportService>;
+/**
+ * Creates the daily-report data-access service bound to the injected dependencies.
+ * 注入された依存に束縛された日報データアクセスサービスを生成する処理。
+ */
+declare function createDailyReportService(config: DailyReportServiceConfig): {
+    streamKey: string;
+    streamMaxLen: number;
+    getUserIdByExternalId: (externalId: string) => Promise<number | null>;
+    getDailyReportIdsByExternalId: (externalId: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportItem[]>;
+    getDailyReportsByBusinessDate: (businessDate: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail[]>;
+    getDailyReportsByBusinessDateByExternalId: (businessDate: string, externalId: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail[]>;
+    getDailyReportDetailById: (reportHubId: number, userId: number, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail | null>;
+    getDailyReportDetailByIdByExternalId: (reportHubId: number, externalId: string, options?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail | null>;
+    getDraftLabelId: () => Promise<number | null>;
+    setStarStatus: (userId: number, reportHubId: number, businessDate: string | null, isStarred: boolean, clientTempId: string) => Promise<DailyReportUserStatusRow>;
+    setReadStatus: (userId: number, reportHubId: number, businessDate: string | null, isRead: boolean, clientTempId: string) => Promise<DailyReportUserStatusRow>;
+    addComment: (userId: number, reportHubId: number, content: string, businessDate: string | null, clientTempId: string) => Promise<DailyReportCommentItem>;
+    deleteComment: (userId: number, reportHubId: number, commentId: number, businessDate: string | null, clientTempId: string) => Promise<void>;
+    createDailyReport: (userId: number, businessDate: string, clientTempId: string) => Promise<DailyReportDetail>;
+    updateDailyReport: (reportHubId: number, userId: number, data: {
+        title?: string;
+        content?: string;
+    }, clientTempId: string) => Promise<void>;
+    publishDailyReport: (reportHubId: number, userId: number, clientTempId: string) => Promise<DailyReportDetail | null>;
+    deleteDailyReport: (reportHubId: number, userId: number, clientTempId: string) => Promise<void>;
+    findDailyReportHubById: (tx: DailyReportDb, reportHubId: number) => Promise<DailyReportHubRow[]>;
+    updateDailyReportHub: (tx: DailyReportDb, reportHubId: number, data: Partial<DailyReportHubRow>) => Promise<void>;
+    updateDailyReportInternal: (tx: DailyReportDb, hubId: number, data: Partial<DailyReportInternalRow>) => Promise<void>;
+    deleteDailyReportLabel: (tx: DailyReportDb, hubId: number, labelId: number) => Promise<void>;
+};
+
+/**
+ * Fan-Out shared reader for the daily report SSE Redis Stream.
+ * 日報 SSE 用 Redis Stream の共有リーダーモジュール。
+ *
+ * 単一の xRead BLOCK ループで全接続にメッセージをブロードキャストし、
+ * 接続ごとに Redis TCP を張る問題を解消する。
+ */
+
+/**
+ * Compares two Redis Stream IDs numerically.
+ * Redis Stream ID を数値比較し、a <= b なら true を返す。
+ *
+ * Stream ID は `<timestamp_ms>-<sequence>` 形式。
+ * 辞書順比較では sequence が可変長のとき不正確になるため、数値分割で比較する。
+ */
+declare const isStreamIdLte: (a: string, b: string) => boolean;
+/** xRead 結果の 1 エントリに相当する型。 */
+type StreamEntry = {
+    id: string;
+    message: Record<string, string>;
+};
+type DailyReportSseReaderConfig = {
+    /** ブロッキング xRead 用の専用クライアントを生成する redis プロバイダー。 */
+    redis?: DailyReportRedisProvider;
+    /** SSE Redis Stream キー。 */
+    streamKey: string;
+    /** 受信メッセージに応じてローカル SQL キャッシュを無効化する対象キャッシュ。 */
+    cache: SqlResultCache;
+    /** ロガー (既定は console ベース)。 */
+    logger?: DailyReportLogger;
+};
+/**
+ * Shared xRead loop that fans out entries to all active SSE connections.
+ * 全 SSE 接続に対してメッセージをファンアウトする共有 xRead ループ。
+ *
+ * - "entry" イベント: 新着エントリ (StreamEntry) をブロードキャスト
+ * - "error" イベント: 回復不能エラーをブロードキャスト
+ * */
+declare class DailyReportSseReader {
+    private readonly config;
+    private _emitter;
+    private _state;
+    private _refCount;
+    private _lastId;
+    private _client;
+    private readonly _logger;
+    constructor(config: DailyReportSseReaderConfig);
+    /**
+     * Subscribes to the shared reader. Starts the loop on first subscriber.
+     * 共有リーダーを購読する。最初の購読者でループを開始する。
+     *
+     * @param onEntry - 新着エントリのコールバック
+     * @param onError - 回復不能エラーのコールバック (省略可)
+     * @returns unsubscribe 関数。呼び出すと両リスナーを解除し、最後の購読者解除でループを停止する。
+     */
+    subscribe(onEntry: (entry: StreamEntry) => void, onError?: (err: Error) => void): () => void;
+    /**
+     * Destroys the reader for test cleanup.
+     * テストクリーンアップ用のデストラクタ。
+     */
+    destroy(): Promise<void>;
+    /**
+     * Internal xRead BLOCK loop.
+     * 内部 xRead BLOCK ループ。
+     */
+    private _startLoop;
+    /**
+     * Stops the xRead loop by closing the client.
+     * クライアントを閉じて xRead ループを停止する。
+     */
+    private _stopLoop;
+}
+
+/**
+ * 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).
+ */
+declare const generateETag: (data: unknown) => string;
+
+type LoaderArgs = {
+    request: Request;
+    params: Record<string, string | undefined>;
+};
+type DailyReportHandlersConfig = {
+    /** リクエスト認証ポート。 */
+    authenticate: DailyReportAuthenticate;
+    /** データアクセスサービス。 */
+    service: DailyReportService;
+    /** 内部数値 ID の難読化ポート。 */
+    encodeUserId: DailyReportEncodeUserId;
+    /** SSE 用 redis プロバイダー (catch-up の xRange / xRevRange に使用)。 */
+    redis?: DailyReportRedisProvider;
+    /** SSE Fan-Out 共有リーダー。 */
+    sseReader: DailyReportSseReader;
+    /** SSE Redis Stream キー。 */
+    streamKey: string;
+    /** 未ログイン時のリダイレクト先 (index.loader 用、既定 "/auth/login")。 */
+    loginRedirectPath?: string;
+    /** ロガー (既定は console ベース)。 */
+    logger?: DailyReportLogger;
+};
+/**
+ * Creates the daily-report loaders/actions bound to the injected dependencies.
+ * 注入依存に束縛された日報 loader / action 群を生成する処理。
+ */
+declare function createDailyReportHandlers(config: DailyReportHandlersConfig): {
+    index: {
+        loader: ({ request }: LoaderArgs) => Promise<{
+            data: {
+                user: {
+                    id: string;
+                } | undefined;
+                userId: string | null;
+            };
+            headers: Headers;
+        }>;
+    };
+    api: {
+        loader: ({ request, params }: LoaderArgs) => Promise<Response>;
+        action: ({ request, params }: LoaderArgs) => Promise<Response>;
+    };
+    sse: {
+        loader: ({ request, params }: LoaderArgs) => Promise<Response>;
+    };
+};
+
+/**
+ * JSON response helper with shared security headers and ETag support.
+ * 共有セキュリティヘッダーと ETag 対応を備えた JSON レスポンスヘルパー。
+ */
+
+/**
+ * Creates JSON response with shared security headers and ETag support.
+ * 共有のセキュリティヘッダーと ETag サポート付き JSON レスポンスを生成。
+ */
+declare const jsonResponseWithETag: (request: Request, cookie: string | null, payload: Record<string, unknown>, status?: number, logger?: DailyReportLogger) => Response;
+
+/** createDailyReportServer の設定 (サービス設定 + 認証ポート + ハンドラ設定)。 */
+type DailyReportServerConfig = Omit<DailyReportServiceConfig, "cache" | "epochs"> & {
+    /** リクエスト認証ポート。 */
+    authenticate: DailyReportAuthenticate;
+    /** 未ログイン時のリダイレクト先 (index.loader 用、既定 "/auth/login")。 */
+    loginRedirectPath?: string;
+    /** SQL 結果キャッシュの既定 TTL (既定 60,000ms)。 */
+    cacheDefaultTtlMs?: number;
+    /** 外部ソースアダプタ群 (レガシー日報テーブル等)。 */
+    externalSources?: DailyReportExternalSource[];
+};
+/**
+ * One-stop factory wiring cache, service, SSE fan-out reader, and route handlers.
+ * キャッシュ・サービス・SSE Fan-Out リーダー・ルートハンドラを一括結線するファクトリ。
+ *
+ * @example
+ * const server = createDailyReportServer({ db, tables, userTable, resolveUserId, encodeUserId, authenticate, redis })
+ * // routes:
+ * //   daily_report._index      → server.index.loader (+ data() ラップ)
+ * //   daily_report.api.$endpoint → server.api.loader / server.api.action
+ * //   sse.daily_report.$endpoint → server.sse.loader
+ */
+declare function createDailyReportServer(config: DailyReportServerConfig): {
+    index: {
+        loader: ({ request }: {
+            request: Request;
+            params: Record<string, string | undefined>;
+        }) => Promise<{
+            data: {
+                user: {
+                    id: string;
+                } | undefined;
+                userId: string | null;
+            };
+            headers: Headers;
+        }>;
+    };
+    api: {
+        loader: ({ request, params }: {
+            request: Request;
+            params: Record<string, string | undefined>;
+        }) => Promise<Response>;
+        action: ({ request, params }: {
+            request: Request;
+            params: Record<string, string | undefined>;
+        }) => Promise<Response>;
+    };
+    sse: {
+        loader: ({ request, params }: {
+            request: Request;
+            params: Record<string, string | undefined>;
+        }) => Promise<Response>;
+    };
+    /** データアクセスサービス (CRUD + キャッシュ + SSE publish)。 */
+    service: {
+        streamKey: string;
+        streamMaxLen: number;
+        getUserIdByExternalId: (externalId: string) => Promise<number | null>;
+        getDailyReportIdsByExternalId: (externalId: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportItem[]>;
+        getDailyReportsByBusinessDate: (businessDate: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail[]>;
+        getDailyReportsByBusinessDateByExternalId: (businessDate: string, externalId: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail[]>;
+        getDailyReportDetailById: (reportHubId: number, userId: number, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail | null>;
+        getDailyReportDetailByIdByExternalId: (reportHubId: number, externalId: string, options?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail | null>;
+        getDraftLabelId: () => Promise<number | null>;
+        setStarStatus: (userId: number, reportHubId: number, businessDate: string | null, isStarred: boolean, clientTempId: string) => Promise<DailyReportUserStatusRow>;
+        setReadStatus: (userId: number, reportHubId: number, businessDate: string | null, isRead: boolean, clientTempId: string) => Promise<DailyReportUserStatusRow>;
+        addComment: (userId: number, reportHubId: number, content: string, businessDate: string | null, clientTempId: string) => Promise<DailyReportCommentItem>;
+        deleteComment: (userId: number, reportHubId: number, commentId: number, businessDate: string | null, clientTempId: string) => Promise<void>;
+        createDailyReport: (userId: number, businessDate: string, clientTempId: string) => Promise<DailyReportDetail>;
+        updateDailyReport: (reportHubId: number, userId: number, data: {
+            title?: string;
+            content?: string;
+        }, clientTempId: string) => Promise<void>;
+        publishDailyReport: (reportHubId: number, userId: number, clientTempId: string) => Promise<DailyReportDetail | null>;
+        deleteDailyReport: (reportHubId: number, userId: number, clientTempId: string) => Promise<void>;
+        findDailyReportHubById: (tx: DailyReportDb, reportHubId: number) => Promise<DailyReportHubRow[]>;
+        updateDailyReportHub: (tx: DailyReportDb, reportHubId: number, data: Partial<DailyReportHubRow>) => Promise<void>;
+        updateDailyReportInternal: (tx: DailyReportDb, hubId: number, data: Partial<DailyReportInternalRow>) => Promise<void>;
+        deleteDailyReportLabel: (tx: DailyReportDb, hubId: number, labelId: number) => Promise<void>;
+    };
+    /** SQL 結果キャッシュ (サービス・SSE リーダー共有インスタンス)。 */
+    cache: SqlResultCache;
+    /** クロスワーカー epoch ストア。 */
+    epochs: {
+        getEpoch(epochKey: string): Promise<number>;
+        incrementEpoch(epochKey: string): Promise<void>;
+    };
+    /** SSE Fan-Out 共有リーダー。 */
+    sseReader: DailyReportSseReader;
+    /** SSE Redis Stream キー。 */
+    streamKey: string;
+};
+
+export { type DailyReportAuthResult, type DailyReportAuthenticate, type DailyReportCommentRow, type DailyReportCommentTable, type DailyReportDb, type DailyReportEncodeUserId, type DailyReportExternalSource, type DailyReportHandlersConfig, type DailyReportHubLabelTable, type DailyReportHubRow, type DailyReportHubTable, type DailyReportInternalRow, type DailyReportInternalTable, type DailyReportLabelTable, type DailyReportRedisBlockingClient, type DailyReportRedisClient, type DailyReportRedisProvider, type DailyReportResolveUserId, type DailyReportServerConfig, type DailyReportService, type DailyReportServiceConfig, DailyReportSseReader, type DailyReportSseReaderConfig, type DailyReportTables, type DailyReportUserStatusRow, type DailyReportUserStatusTable, type DailyReportUserTable, type EpochStore, type ExternalReportFields, type RedisStreamMessage, SqlResultCache, type SqlResultCacheQueryOptions, type StreamEntry, createDailyReportHandlers, createDailyReportServer, createDailyReportService, createEpochStore, defineDailyReportSchema, generateETag, isStreamIdLte, jsonResponseWithETag, transformJsonArray };