@aiquants/daily-report 0.6.2 → 0.7.0

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-import { e as DailyReportInterviewer, c as DailyReportComment, D as DailyReportItem, a as DailyReportDetail, d as DailyReportCommentItem } from './types-D1PKubyo.mjs';
+import { g as DailyReportInterviewer, e as DailyReportComment, a as DailyReportItem, b as DailyReportDetail, D as DailyReportAttachmentSummary, f as DailyReportCommentItem } from './types-Ct1ggzy-.mjs';
 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.mjs';
@@ -82,6 +82,79 @@ type DailyReportResolveUserId = (externalUserId: string) => Promise<number | nul
  * 内部数値ユーザー ID をクライアント公開用に難読化するポート。
  */
 type DailyReportEncodeUserId = (id: number) => string;
+/**
+ * Reversible obfuscation codec for an internal numeric id exposed to clients.
+ * クライアントへ公開する内部数値 ID の可逆難読化コーデック。
+ *
+ * これは難読化であって認可ではない。トークンを能力 (capability) として扱ってはならず、
+ * 認可は必ずサーバー側の述語で行うこと。ID 空間を混ぜないため、リソース種別ごとに
+ * 別インスタンス (別 alphabet 等) を注入することを推奨する。
+ */
+type DailyReportIdCodec = {
+    /** 内部数値 ID をトークンへ変換する。 */
+    encode: (id: number) => string;
+    /** トークンを内部数値 ID へ戻す。復号できない場合は null。 */
+    decode: (token: string) => number | null;
+};
+/**
+ * Failure kinds a caller maps onto HTTP statuses.
+ * 呼び出し側が HTTP ステータスへ写像する失敗種別。
+ *
+ * - `not_found`: 実体が存在しない (消失・未正規化 URI)
+ * - `denied`: ストレージ側で拒否された (サンドボックス外・ACL)
+ * - `too_large`: 上限超過 (事前サイズ判定またはワイヤ上限)
+ * - `invalid_path`: 受け入れないスキーム・不正なパス (データ不備)
+ * - `unavailable`: ストレージサービスへ到達できない・締め切り超過
+ */
+type DailyReportAttachmentFailure = "not_found" | "denied" | "too_large" | "invalid_path" | "unavailable";
+/** 添付ファイル読み取りの成功結果。 */
+type DailyReportAttachmentBytes = {
+    ok: true;
+    /**
+     * Byte view backed by an `ArrayBuffer`.
+     * `ArrayBuffer` を裏に持つバイトビュー。
+     *
+     * 素の `Uint8Array` と書くと `Uint8Array<ArrayBufferLike>` へ広がり `BodyInit` へ代入できない
+     * (TypeScript 5.7 以降の既定型引数)。`Response` のボディへそのまま渡すため narrow 型で受ける。
+     * `head` が true の呼び出しでは長さ 0 のビューを返してよい (実サイズは `size` で申告する)。
+     */
+    bytes: Uint8Array<ArrayBuffer>;
+    /** バックエンドが申告した MIME 型。判定できない場合は null。 */
+    contentType?: string | null;
+    /**
+     * Entity size in bytes, independent of how many bytes `bytes` actually holds.
+     * 実体のバイト数。`bytes` が実際に保持している長さとは独立に申告する値。
+     *
+     * HEAD 応答の `Content-Length` は同じ URI への GET が返す値と一致しなければならない
+     * (RFC 9110 §9.3.2)。`head` が true の呼び出しは本体を読まないため `bytes` は空になるので、
+     * ここで実サイズを申告しないと HEAD が常に `Content-Length: 0` を返してしまう。
+     * 申告できない場合は省略してよく、そのとき呼び出し側は `bytes.byteLength` を使う。
+     */
+    size?: number;
+};
+/** 添付ファイル読み取りの失敗結果。 */
+type DailyReportAttachmentError = {
+    ok: false;
+    reason: DailyReportAttachmentFailure;
+    /** 診断ログ用の生のストレージエラーコード。HTTP ステータスの決定には使わない。 */
+    code?: string;
+};
+/**
+ * Reads attachment bytes from the host application's storage backend.
+ * ホストアプリのストレージバックエンドから添付ファイルのバイト列を読み取るポート。
+ *
+ * `filePath` はサーバー内部にとどまり、クライアントへは決して渡らない。
+ * 失敗は種別付きで返すこと (例外を投げない・単一の null へ潰さない)。
+ * 種別を潰すと「実体が消えた」「上限超過」「サービス停止」が運用上区別できなくなる。
+ *
+ * `head` が true のときは実体を読まずメタデータのみ取得する。HEAD 要求で本体を読んで
+ * 捨てると、認証済み呼び出し元が任意に転送量とレイテンシを増幅できる経路になる。
+ */
+type DailyReportReadAttachment = (filePath: string, options: {
+    maxBytes: number;
+    head: boolean;
+    principal?: string;
+}) => Promise<DailyReportAttachmentBytes | DailyReportAttachmentError>;
 
 /**
  * In-memory SQL result cache with TTL, snapshot, and cross-worker epoch (via redis) support.
@@ -271,18 +344,48 @@ type DailyReportUserStatusTable = {
     updatedAt: AnyMsSqlColumn;
     updatedBy: AnyMsSqlColumn;
 };
-/** サービスへ注入するテーブル一式 (アプリ既存モデルまたは本ファクトリ生成物)。 */
+/**
+ * DailyReportAttachment テーブルの構造形。
+ *
+ * `uploadedBy` は外部取込ソース由来の行に投稿者が存在しないため NULL 許容。
+ * `sourceKey` は取込の冪等 upsert の自然キー。
+ * `objectCheckedAt` / `objectMissingAt` から実体存在の三値 (unknown / present / absent) を導出する。
+ */
+type DailyReportAttachmentTable = {
+    id: AnyMsSqlColumn;
+    hubId: AnyMsSqlColumn;
+    uploadedBy: AnyMsSqlColumn;
+    sourceKey: AnyMsSqlColumn;
+    fileName: AnyMsSqlColumn;
+    filePath: AnyMsSqlColumn;
+    fileType: AnyMsSqlColumn;
+    fileSize: AnyMsSqlColumn;
+    objectCheckedAt: AnyMsSqlColumn;
+    objectMissingAt: AnyMsSqlColumn;
+    createdAt: AnyMsSqlColumn;
+    createdBy: AnyMsSqlColumn;
+    updatedAt: AnyMsSqlColumn;
+    updatedBy: AnyMsSqlColumn;
+};
+/**
+ * サービスへ注入するテーブル一式 (アプリ既存モデルまたは本ファクトリ生成物)。
+ *
+ * `attachment` のみ任意。添付テーブルを持たない消費アプリでも本パッケージを使えるようにするため。
+ * 未注入時は詳細の `attachments` が常に空配列になり、添付エンドポイントは全トークンで 404 を返す
+ * (意図した縮退動作)。
+ */
 type DailyReportTables = {
     hub: DailyReportHubTable;
     internal: DailyReportInternalTable;
     comment: DailyReportCommentTable;
+    attachment?: DailyReportAttachmentTable;
     label: DailyReportLabelTable;
     hubLabel: DailyReportHubLabelTable;
     userStatus: DailyReportUserStatusTable;
 };
 /**
- * Generic factory: build the six daily-report tables under an arbitrary schema name.
- * 任意のスキーマ名の下に日報 6 テーブルを生成する汎用ファクトリ。
+ * Generic factory: build the seven daily-report tables under an arbitrary schema name.
+ * 任意のスキーマ名の下に日報 7 テーブルを生成する汎用ファクトリ。
  *
  * 制約・索引名は `${schemaName}_<Table>_...` 規約で生成する。
  * ユーザーテーブルへの FK は注入された `userTable` を参照する。
@@ -777,6 +880,237 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
         };
         dialect: "mssql";
     }>;
+    attachment: drizzle_orm_mssql_core.MsSqlTableWithColumns<{
+        name: "DailyReportAttachment";
+        schema: S;
+        columns: {
+            id: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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: "DailyReportAttachment";
+                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;
+            }, {}>;
+            uploadedBy: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            sourceKey: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            fileName: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            filePath: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            fileType: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            fileSize: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            objectCheckedAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            objectMissingAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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;
+            }, {}>;
+            createdAt: drizzle_orm_mssql_core.MsSqlColumn<{
+                name: string;
+                tableName: "DailyReportAttachment";
+                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: "DailyReportAttachment";
+                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: "DailyReportAttachment";
+                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: "DailyReportAttachment";
+                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;
@@ -1222,7 +1556,7 @@ interface DailyReportDb {
 type DailyReportServiceConfig = {
     /** drizzle mssql データベースハンドル。 */
     db: DailyReportDb;
-    /** 日報 6 テーブル (アプリ既存モデルまたは defineDailyReportSchema 生成物)。 */
+    /** 日報 7 テーブル (アプリ既存モデルまたは defineDailyReportSchema 生成物)。`attachment` のみ任意。 */
     tables: DailyReportTables;
     /** 表示名解決に使う外部ユーザーテーブル ({ id, displayName })。 */
     userTable: DailyReportUserTable;
@@ -1254,6 +1588,15 @@ type DailyReportServiceConfig = {
     businessDateTtlMs?: number;
     /** 外部 ID → 内部 ID のプロセス内キャッシュを無効化 (テスト用)。 */
     disableUserIdCache?: boolean;
+    /**
+     * 添付 ID の難読化コーデック。
+     *
+     * 任意にしているのは、添付テーブルを注入しない消費アプリと既存テストのフィクスチャを
+     * 壊さないため。未注入なら添付一覧は常に空になる (縮退動作)。
+     * ユーザー ID 用のコーデックとは **別インスタンス**を渡すこと。同一だと
+     * レスポンス中の `userId` トークンがそのまま添付トークンとして解釈できてしまう。
+     */
+    attachmentIdCodec?: DailyReportIdCodec;
     /** ロガー (既定は console ベース)。 */
     logger?: DailyReportLogger;
 };
@@ -1267,6 +1610,7 @@ declare function createDailyReportService(config: DailyReportServiceConfig): {
     streamKey: string;
     streamMaxLen: number;
     clearCache: () => Promise<void>;
+    invalidateHubReadCaches: (hubIds: readonly number[], businessDates: readonly string[]) => Promise<void>;
     getUserIdByExternalId: (externalId: string) => Promise<number | null>;
     getDailyReportIdsByExternalId: (externalId: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportItem[]>;
     getDailyReportsByBusinessDate: (businessDate: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail[]>;
@@ -1274,6 +1618,15 @@ declare function createDailyReportService(config: DailyReportServiceConfig): {
     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>;
+    getAttachmentsByHubIds: (hubIds: number[]) => Promise<Map<number, DailyReportAttachmentSummary[]>>;
+    getAttachmentForUser: (attachmentId: number, userId: number) => Promise<{
+        fileName: string;
+        filePath: string;
+        fileType: string | null;
+        fileSize: number | null;
+    } | null>;
+    markAttachmentMissing: (attachmentId: number) => Promise<void>;
+    markAttachmentPresent: (attachmentId: number) => Promise<void>;
     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>;
@@ -1406,6 +1759,41 @@ type LoaderArgs = {
     request: Request;
     params: Record<string, string | undefined>;
 };
+/**
+ * Accepts a media type only when it is header-safe and well-formed.
+ * ヘッダー安全かつ MIME 型の形をしている場合のみ採用する処理。
+ *
+ * CR/LF や 0x00-0xFF 外の文字が混ざった値を `new Headers()` へ渡すと TypeError になり、
+ * 認可済みのダウンロードが 500 になる。
+ *
+ * **これは第 2 層である。** 現在の配信経路では、注入値はインライン許可リストに完全一致しないため
+ * 必ず `application/octet-stream` へ落ち、ヘッダーには到達しない。つまり本関数を外しても
+ * 現状の挙動は変わらない (ミューテーションテストで確認済み)。
+ * 許可判定を前方一致や「DB の型を信じる」形へ変えた瞬間に効き始める防御なので、
+ * 到達不能なまま放置せず **直接の単体テストで固定する**目的でエクスポートしている。
+ *
+ * @param value Candidate media type. 候補となる media type。
+ * @returns The value when acceptable, otherwise null. 採用可なら値、それ以外は null。
+ */
+declare const sanitizeMediaType: (value: string | null | undefined) => string | null;
+/**
+ * Percent-encodes a file name for the RFC 8187 `filename*` parameter.
+ * RFC 8187 の `filename*` 用にファイル名をパーセントエンコードする処理。
+ *
+ * `encodeURIComponent` は `'` `(` `)` `*` を残すが、いずれも RFC 8187 の attr-char ではない。
+ *
+ * @param name Raw file name. 生のファイル名。
+ * @returns Encoded value. エンコード済みの値。
+ */
+declare const encodeRfc8187: (name: string) => string;
+/**
+ * Builds the ASCII fallback used by the plain `filename` parameter.
+ * 素の `filename` パラメータ用の ASCII フォールバックを組み立てる処理。
+ *
+ * @param name Raw file name. 生のファイル名。
+ * @returns ASCII-only, quote-free name. ASCII のみで引用符を含まない名前。
+ */
+declare const asciiFallbackFileName: (name: string) => string;
 type DailyReportHandlersConfig = {
     /** リクエスト認証ポート。 */
     authenticate: DailyReportAuthenticate;
@@ -1413,6 +1801,19 @@ type DailyReportHandlersConfig = {
     service: DailyReportService;
     /** 内部数値 ID の難読化ポート。 */
     encodeUserId: DailyReportEncodeUserId;
+    /**
+     * 添付 ID の難読化コーデック。未注入なら添付エンドポイントは常に 404。
+     * ユーザー ID 用とは別インスタンスを渡すこと (ID 空間の分離)。
+     */
+    attachmentIdCodec?: DailyReportIdCodec;
+    /** 添付ファイル読み取りポート。未注入なら添付エンドポイントは常に 404。 */
+    readAttachment?: DailyReportReadAttachment;
+    /** 添付ファイルの最大バイト数 (既定 32 MiB)。サービス側のワイヤ上限より低く保つこと。 */
+    attachmentMaxBytes?: number;
+    /** 添付エンドポイントの 1 分あたり呼び出し上限 (ユーザー単位・既定 60)。 */
+    attachmentRateLimitPerMinute?: number;
+    /** 添付読み取りの同時実行上限 (プロセス単位・既定 4)。 */
+    attachmentConcurrency?: number;
     /** SSE 用 redis プロバイダー (catch-up の xRange / xRevRange に使用)。 */
     redis?: DailyReportRedisProvider;
     /** SSE Fan-Out 共有リーダー。 */
@@ -1447,6 +1848,9 @@ declare function createDailyReportHandlers(config: DailyReportHandlersConfig): {
     sse: {
         loader: ({ request, params }: LoaderArgs) => Promise<Response>;
     };
+    attachment: {
+        loader: ({ request, params }: LoaderArgs) => Promise<Response>;
+    };
 };
 
 /**
@@ -1464,6 +1868,14 @@ declare const jsonResponseWithETag: (request: Request, cookie: string | null, pa
 type DailyReportServerConfig = Omit<DailyReportServiceConfig, "cache" | "epochs"> & {
     /** リクエスト認証ポート。 */
     authenticate: DailyReportAuthenticate;
+    /** 添付ファイル読み取りポート。未注入なら添付エンドポイントは常に 404。 */
+    readAttachment?: DailyReportReadAttachment;
+    /** 添付ファイルの最大バイト数 (既定 32 MiB)。サービス側のワイヤ上限より低く保つこと。 */
+    attachmentMaxBytes?: number;
+    /** 添付エンドポイントの 1 分あたり呼び出し上限 (ユーザー単位・既定 60)。 */
+    attachmentRateLimitPerMinute?: number;
+    /** 添付読み取りの同時実行上限 (プロセス単位・既定 4)。 */
+    attachmentConcurrency?: number;
     /** 未ログイン時のリダイレクト先 (index.loader 用、既定 "/auth/login")。 */
     loginRedirectPath?: string;
     /** SQL 結果キャッシュの既定 TTL (既定 60,000ms)。 */
@@ -1513,11 +1925,18 @@ declare function createDailyReportServer(config: DailyReportServerConfig): {
             params: Record<string, string | undefined>;
         }) => Promise<Response>;
     };
+    attachment: {
+        loader: ({ request, params }: {
+            request: Request;
+            params: Record<string, string | undefined>;
+        }) => Promise<Response>;
+    };
     /** データアクセスサービス (CRUD + キャッシュ + SSE publish)。 */
     service: {
         streamKey: string;
         streamMaxLen: number;
         clearCache: () => Promise<void>;
+        invalidateHubReadCaches: (hubIds: readonly number[], businessDates: readonly string[]) => Promise<void>;
         getUserIdByExternalId: (externalId: string) => Promise<number | null>;
         getDailyReportIdsByExternalId: (externalId: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportItem[]>;
         getDailyReportsByBusinessDate: (businessDate: string, { forceRefresh, snapshot, ttlMsOverride }?: SqlResultCacheQueryOptions) => Promise<DailyReportDetail[]>;
@@ -1525,6 +1944,15 @@ declare function createDailyReportServer(config: DailyReportServerConfig): {
         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>;
+        getAttachmentsByHubIds: (hubIds: number[]) => Promise<Map<number, DailyReportAttachmentSummary[]>>;
+        getAttachmentForUser: (attachmentId: number, userId: number) => Promise<{
+            fileName: string;
+            filePath: string;
+            fileType: string | null;
+            fileSize: number | null;
+        } | null>;
+        markAttachmentMissing: (attachmentId: number) => Promise<void>;
+        markAttachmentPresent: (attachmentId: number) => Promise<void>;
         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>;
@@ -1554,4 +1982,4 @@ declare function createDailyReportServer(config: DailyReportServerConfig): {
     streamKey: string;
 };
 
-export { type AuthzResourceItem, 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, type DailyReportSourceTypeInput, 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, defineDailyReportAuthzResources, defineDailyReportSchema, generateETag, isStreamIdLte, jsonResponseWithETag, seedDailyReportAuthzResources, transformJsonArray };
+export { type AuthzResourceItem, type DailyReportAttachmentBytes, type DailyReportAttachmentError, type DailyReportAttachmentFailure, type DailyReportAttachmentTable, type DailyReportAuthResult, type DailyReportAuthenticate, type DailyReportCommentRow, type DailyReportCommentTable, type DailyReportDb, type DailyReportEncodeUserId, type DailyReportExternalSource, type DailyReportHandlersConfig, type DailyReportHubLabelTable, type DailyReportHubRow, type DailyReportHubTable, type DailyReportIdCodec, type DailyReportInternalRow, type DailyReportInternalTable, type DailyReportLabelTable, type DailyReportReadAttachment, type DailyReportRedisBlockingClient, type DailyReportRedisClient, type DailyReportRedisProvider, type DailyReportResolveUserId, type DailyReportServerConfig, type DailyReportService, type DailyReportServiceConfig, type DailyReportSourceTypeInput, DailyReportSseReader, type DailyReportSseReaderConfig, type DailyReportTables, type DailyReportUserStatusRow, type DailyReportUserStatusTable, type DailyReportUserTable, type EpochStore, type ExternalReportFields, type RedisStreamMessage, SqlResultCache, type SqlResultCacheQueryOptions, type StreamEntry, asciiFallbackFileName, createDailyReportHandlers, createDailyReportServer, createDailyReportService, createEpochStore, defineDailyReportAuthzResources, defineDailyReportSchema, encodeRfc8187, generateETag, isStreamIdLte, jsonResponseWithETag, sanitizeMediaType, seedDailyReportAuthzResources, transformJsonArray };