@aiquants/daily-report 0.22.1 → 0.24.0

package/dist/server.d.ts

@@ -1,9 +1,19 @@
-import { f as DailyReportInterviewer, e as DailyReportExternalComment, a as DailyReportItem, b as DailyReportDetail, D as DailyReportAttachmentSummary, h as DailyReportPostedComment } from "./types-CqgYQgbH.js";
+import { e as DailyReportInterviewer, d as DailyReportExternalComment, D as DailyReportItem, b as DailyReportDetail, c as DailyReportAttachmentSummary, g as DailyReportPostedComment } from "./types-DkERw8NE.js";
+import { TransactionRetryOptions } from "@aiquants/mssql";
 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";
-import { TransactionRetryOptions } from "@aiquants/mssql";
-import { SQL } from "drizzle-orm";
+interface DailyReportLogger {
+    debug(message?: unknown, ...optionalParams: unknown[]): void;
+    info(message?: unknown, ...optionalParams: unknown[]): void;
+    warn(message?: unknown, ...optionalParams: unknown[]): void;
+    error(message?: unknown, ...optionalParams: unknown[]): void;
+}
+declare const DAILY_REPORT_ATTACHMENT_THUMBNAIL_OUTPUT_MEDIA_TYPES: readonly [
+    "image/webp",
+    "image/jpeg",
+    "image/png"
+];
+declare const DAILY_REPORT_ATTACHMENT_THUMBNAIL_MAX_OUTPUT_BYTES: number;
 type RedisStreamMessage = {
     id: string;
     message: Record<string, string>;
@@ -89,7 +99,29 @@ type DailyReportReadAttachment = (filePath: string, options: {
     maxBytes: number;
     head: boolean;
     principal?: string;
+    signal: AbortSignal;
 }) => Promise<DailyReportAttachmentBytes | DailyReportAttachmentError>;
+type DailyReportAttachmentThumbnailSourceFormat = "png" | "jpeg" | "gif" | "webp";
+type DailyReportAttachmentThumbnailFailure = "unsupported" | "failed";
+type DailyReportAttachmentThumbnailOutputMediaType = (typeof DAILY_REPORT_ATTACHMENT_THUMBNAIL_OUTPUT_MEDIA_TYPES)[number];
+type DailyReportAttachmentThumbnail = {
+    ok: true;
+    bytes: Uint8Array<ArrayBuffer>;
+    contentType: DailyReportAttachmentThumbnailOutputMediaType;
+};
+type DailyReportAttachmentThumbnailError = {
+    ok: false;
+    reason: DailyReportAttachmentThumbnailFailure;
+};
+type DailyReportAttachmentThumbnailRenderer = {
+    readonly id: string;
+    readonly render: (source: Uint8Array<ArrayBuffer>, options: {
+        format: DailyReportAttachmentThumbnailSourceFormat;
+        maxWidth: number;
+        maxHeight: number;
+        signal: AbortSignal;
+    }) => Promise<DailyReportAttachmentThumbnail | DailyReportAttachmentThumbnailError>;
+};
 type SqlResultCacheQueryOptions = {
     forceRefresh?: boolean;
     snapshot?: boolean;
@@ -1392,11 +1424,6 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
     }>;
 };
 type VisibleSourceTypeSet = ReadonlySet<string> | null;
-declare function normalizeVisibleSourceTypes(raw: readonly string[]): ReadonlySet<string>;
-declare function normalizeVisibleSourceTypes(raw: readonly string[] | null | undefined): VisibleSourceTypeSet;
-declare function isSourceTypeVisible(set: VisibleSourceTypeSet, sourceType: string | null | undefined): boolean;
-declare function deniesEverySourceType(set: VisibleSourceTypeSet): boolean;
-declare function buildVisibleSourceTypeCondition(sourceTypeColumn: AnyMsSqlColumn, set: VisibleSourceTypeSet): SQL | undefined;
 declare class DailyReportViewerScope {
     #private;
     private constructor();
@@ -1405,8 +1432,6 @@ declare class DailyReportViewerScope {
     static restrictTo(input: readonly string[] | DailyReportVisibilityDimensions): DailyReportViewerScope;
     static unrestricted(auditReason: string): DailyReportViewerScope;
 }
-declare function computeViewerScopeDigest(scope: DailyReportViewerScope): string;
-declare function computeSourceTypeDigest(set: VisibleSourceTypeSet): string;
 type DailyReportHubRow = {
     id: number;
     sourceType: string;
@@ -1442,16 +1467,6 @@ type DailyReportUserStatusRow = {
     updatedAt: Date | string;
     updatedBy: string;
 };
-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>;
@@ -1504,18 +1519,26 @@ type DailyReportServiceConfig = {
     businessDateTtlMs?: number;
     disableUserIdCache?: boolean;
     attachmentIdCodec?: DailyReportIdCodec;
+    readAttachment?: DailyReportReadAttachment;
+    attachmentThumbnailRenderer?: DailyReportAttachmentThumbnailRenderer;
+    attachmentMaxBytes?: number;
     logger?: DailyReportLogger;
 };
+type DailyReportAttachmentDelivery = {
+    readonly idCodec: DailyReportIdCodec | undefined;
+    readonly readAttachment: DailyReportReadAttachment | undefined;
+    readonly thumbnailRenderer: DailyReportAttachmentThumbnailRenderer | undefined;
+    readonly maxBytes: number;
+};
 type DailyReportService = ReturnType<typeof createDailyReportService>;
 type DailyReportIdsSource = {
     readonly items: DailyReportItem[];
     readonly streamAnchor: string | null;
 };
-type DatePattern = "YYYY-MM-DD HH:mm:ss" | "YYYY-MM-DD";
-declare const formatDateValue: (value: Date | string | null | undefined, pattern: DatePattern) => string | null;
 declare function createDailyReportService(config: DailyReportServiceConfig): {
     streamKey: string;
     streamMaxLen: number;
+    attachmentDelivery: DailyReportAttachmentDelivery;
     clearCache: () => Promise<void>;
     invalidateHubReadCaches: (hubIds: readonly number[], businessDates: readonly string[]) => Promise<void>;
     getUserIdByExternalId: (externalId: string) => Promise<number | null>;
@@ -1567,59 +1590,37 @@ type DailyReportSseReaderConfig = {
 };
 declare class DailyReportSseReader {
     private readonly config;
-    private _emitter;
-    private _state;
-    private _refCount;
+    private _source;
     private _lastId;
-    private _client;
+    private _positioning;
+    private _generation;
     private readonly _logger;
     constructor(config: DailyReportSseReaderConfig);
-    subscribe(onEntry: (entry: StreamEntry) => void, onError?: (err: Error) => void): () => void;
+    ready(): Promise<void>;
+    subscribe(onEntry: (entry: StreamEntry) => void, onError: (err: Error) => void): () => void;
     destroy(): Promise<void>;
-    private _startLoop;
-    private _stopLoop;
-    private _emitError;
+    private _readTail;
+    private _createSource;
+    private _start;
+    private _readLoop;
+    private _invalidateCaches;
 }
-type AuthzResourceItem = {
-    resourceKey: string;
-    name: string;
-    description?: string | null;
-};
-type DailyReportSourceTypeInput = {
-    key: string;
-    name: string;
-    description?: string | null;
-    includeCommentResource?: boolean;
-};
-declare function defineDailyReportAuthzResources(sources?: DailyReportSourceTypeInput[]): AuthzResourceItem[];
-declare function seedDailyReportAuthzResources(db: unknown, authzTables: {
-    TMResource: unknown;
-}, opts: {
-    appKey: string;
-    actor?: string;
-    sources?: DailyReportSourceTypeInput[];
-    resources?: AuthzResourceItem[];
-}): Promise<void>;
-declare const generateETag: (data: unknown) => string;
 type LoaderArgs = {
     request: Request;
     params: Record<string, string | undefined>;
 };
 declare const DAILY_REPORT_SSE_VISIBILITY_REFRESH_MS = 60000;
 declare const DAILY_REPORT_SSE_CATCH_UP_BATCH = 1000;
-declare const sanitizeMediaType: (value: string | null | undefined) => string | null;
-declare const encodeRfc8187: (name: string) => string;
-declare const asciiFallbackFileName: (name: string) => string;
 type DailyReportHandlersConfig = {
     authenticate: DailyReportAuthenticate;
     resolveVisibleSourceTypes?: DailyReportResolveVisibleSourceTypes;
     service: DailyReportService;
     encodeUserId: DailyReportEncodeUserId;
-    attachmentIdCodec?: DailyReportIdCodec;
-    readAttachment?: DailyReportReadAttachment;
-    attachmentMaxBytes?: number;
     attachmentRateLimitPerMinute?: number;
     attachmentConcurrency?: number;
+    attachmentThumbnailRateLimitPerMinute?: number;
+    attachmentThumbnailConcurrency?: number;
+    attachmentThumbnailCacheBytes?: number;
     redis?: DailyReportRedisProvider;
     sseReader: DailyReportSseReader;
     streamKey: string;
@@ -1647,17 +1648,105 @@ declare function createDailyReportHandlers(config: DailyReportHandlersConfig): {
         loader: ({ request, params }: LoaderArgs) => Promise<Response>;
     };
     attachment: {
-        loader: ({ request, params }: LoaderArgs) => Promise<Response>;
+        loader: (args: AttachmentLoaderArgs) => Promise<Response>;
     };
 };
+type AttachmentLoaderArgs = {
+    request: Request;
+    params: Record<string, string | undefined>;
+};
+declare const generateETag: (data: unknown) => string;
 declare const jsonResponseWithETag: (request: Request, cookie: string | null, payload: Record<string, unknown>, status?: number, logger?: DailyReportLogger) => Response;
+type SharpHeaderLike = {
+    width: number;
+    height: number;
+    channels: number;
+    depth: string;
+};
+type SharpPipelineLike = {
+    metadata: () => Promise<SharpHeaderLike>;
+    rotate: () => SharpPipelineLike;
+    resize: (options: {
+        width: number;
+        height: number;
+        fit: "inside";
+        withoutEnlargement: boolean;
+    }) => SharpPipelineLike;
+    flatten: (options: {
+        background: string;
+    }) => SharpPipelineLike;
+    webp: (options: {
+        quality: number;
+        effort: number;
+    }) => SharpPipelineLike;
+    toBuffer: () => Promise<Uint8Array>;
+};
+type SharpLike = {
+    (input: Uint8Array, options: {
+        limitInputPixels: number;
+        animated: boolean;
+    }): SharpPipelineLike;
+    readonly versions: {
+        readonly sharp: string;
+        readonly vips: string;
+    };
+    cache: (enabled: boolean) => unknown;
+    concurrency: (threads: number) => number;
+    block: (options: {
+        operation: string[];
+    }) => void;
+    unblock: (options: {
+        operation: string[];
+    }) => void;
+};
+declare const DAILY_REPORT_SHARP_THUMBNAIL_DECODE_BUDGET_BYTES = 200000000;
+declare const DAILY_REPORT_SHARP_THUMBNAIL_WORKING_SET_MODEL: Readonly<{
+    fixedBytes: number;
+    pipelineRows: 2048;
+    wholeImageBuffer: Readonly<{
+        "jpeg-single-scan": Readonly<{
+            kind: "none";
+        }>;
+        "jpeg-multi-scan": Readonly<{
+            kind: "jpeg-coefficients";
+        }>;
+        png: Readonly<{
+            kind: "none";
+        }>;
+        "png-interlaced": Readonly<{
+            kind: "decoded-raster";
+        }>;
+        gif: Readonly<{
+            kind: "canvas";
+            bytesPerPixel: 4;
+        }>;
+        "webp-lossy": Readonly<{
+            kind: "none";
+        }>;
+        "webp-lossy-alpha": Readonly<{
+            kind: "canvas";
+            bytesPerPixel: 5;
+        }>;
+        "webp-lossless": Readonly<{
+            kind: "canvas";
+            bytesPerPixel: 4;
+        }>;
+        "webp-animated": Readonly<{
+            kind: "canvas";
+            bytesPerPixel: 9;
+        }>;
+    }>;
+}>;
+declare const predictSharpThumbnailWorkingSetBytes: (source: Uint8Array, format: DailyReportAttachmentThumbnailSourceFormat, header: SharpHeaderLike) => number | null;
+declare const createSharpThumbnailRenderer: (sharp: SharpLike) => DailyReportAttachmentThumbnailRenderer;
 type DailyReportServerConfig = Omit<DailyReportServiceConfig, "cache" | "epochs"> & {
     authenticate: DailyReportAuthenticate;
     resolveVisibleSourceTypes?: DailyReportResolveVisibleSourceTypes;
-    readAttachment?: DailyReportReadAttachment;
-    attachmentMaxBytes?: number;
     attachmentRateLimitPerMinute?: number;
     attachmentConcurrency?: number;
+    attachmentThumbnailRateLimitPerMinute?: number;
+    attachmentThumbnailConcurrency?: number;
+    attachmentThumbnailCacheBytes?: number;
     loginRedirectPath?: string;
     enableDevCacheClear?: boolean;
     cacheDefaultTtlMs?: number;
@@ -1695,14 +1784,12 @@ declare function createDailyReportServer(config: DailyReportServerConfig): {
         }) => Promise<Response>;
     };
     attachment: {
-        loader: ({ request, params }: {
-            request: Request;
-            params: Record<string, string | undefined>;
-        }) => Promise<Response>;
+        loader: (args: AttachmentLoaderArgs) => Promise<Response>;
     };
     service: {
         streamKey: string;
         streamMaxLen: number;
+        attachmentDelivery: DailyReportAttachmentDelivery;
         clearCache: () => Promise<void>;
         invalidateHubReadCaches: (hubIds: readonly number[], businessDates: readonly string[]) => Promise<void>;
         getUserIdByExternalId: (externalId: string) => Promise<number | null>;
@@ -1750,4 +1837,4 @@ declare function createDailyReportServer(config: DailyReportServerConfig): {
     streamKey: string;
     knownSourceTypes: readonly string[];
 };
-export { type AuthzResourceItem, DAILY_REPORT_SSE_CATCH_UP_BATCH, DAILY_REPORT_SSE_VISIBILITY_REFRESH_MS, 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 DailyReportIdsSource, type DailyReportInternalRow, type DailyReportInternalTable, type DailyReportLabelTable, type DailyReportReadAttachment, type DailyReportRedisBlockingClient, type DailyReportRedisClient, type DailyReportRedisProvider, type DailyReportResolveUserId, type DailyReportResolveVisibleSourceTypes, type DailyReportServerConfig, type DailyReportService, type DailyReportServiceConfig, type DailyReportSourceTypeInput, DailyReportSseReader, type DailyReportSseReaderConfig, type DailyReportTables, type DailyReportUserStatusRow, type DailyReportUserStatusTable, type DailyReportUserTable, DailyReportViewerScope, type DailyReportVisibilityDimensions, type DailyReportVisibilityResolveContext, type DailyReportVisibilityResolveReason, type DailyReportVisibleSourceTypes, type EpochStore, type ExternalReportFields, type RedisStreamMessage, SqlResultCache, type SqlResultCacheQueryOptions, type StreamEntry, type VisibleSourceTypeSet, asciiFallbackFileName, buildVisibleSourceTypeCondition, computeSourceTypeDigest, computeViewerScopeDigest, createDailyReportHandlers, createDailyReportServer, createDailyReportService, createEpochStore, defineDailyReportAuthzResources, defineDailyReportSchema, deniesEverySourceType, encodeRfc8187, formatDateValue, generateETag, isSourceTypeVisible, isStreamIdLte, jsonResponseWithETag, normalizeVisibleSourceTypes, sanitizeMediaType, seedDailyReportAuthzResources, transformJsonArray };
+export { DAILY_REPORT_ATTACHMENT_THUMBNAIL_MAX_OUTPUT_BYTES, DAILY_REPORT_ATTACHMENT_THUMBNAIL_OUTPUT_MEDIA_TYPES, DAILY_REPORT_SHARP_THUMBNAIL_DECODE_BUDGET_BYTES, DAILY_REPORT_SHARP_THUMBNAIL_WORKING_SET_MODEL, DAILY_REPORT_SSE_CATCH_UP_BATCH, DAILY_REPORT_SSE_VISIBILITY_REFRESH_MS, type DailyReportAttachmentDelivery, type DailyReportAttachmentError, type DailyReportAttachmentFailure, type DailyReportAttachmentThumbnail, type DailyReportAttachmentThumbnailOutputMediaType, type DailyReportAttachmentThumbnailRenderer, type DailyReportAttachmentThumbnailSourceFormat, type DailyReportAuthResult, type DailyReportAuthenticate, type DailyReportDb, type DailyReportIdCodec, type DailyReportReadAttachment, type DailyReportRedisProvider, type DailyReportServerConfig, type DailyReportServiceConfig, DailyReportSseReader, type DailyReportTables, DailyReportViewerScope, type ExternalReportFields, type SharpLike, SqlResultCache, type StreamEntry, createDailyReportHandlers, createDailyReportServer, createDailyReportService, createEpochStore, createSharpThumbnailRenderer, defineDailyReportSchema, generateETag, isStreamIdLte, jsonResponseWithETag, predictSharpThumbnailWorkingSetBytes, transformJsonArray };