asepharyana
bd4cf8b285
- upload-file use-case is now the single save path with dedup policy (hash / bucket-key / none), partPrefix + signatureBuffer inputs, fileHash in UploadOutput, and owned temp-file cleanup; pass temp path (not open stream) to telegram service for testability - upload-controller (multipart + JSON) and web-api upload delegate to the use-case; JSON body via JsonUploadPayloadSchema; responses built from use-case output via buildUploadResponse - web-api download 302 redirect -> proxy stream (closes bot_token leak); shared CORS + sanitizeFilenameHeader - file-controller drops double file-info cache layer (pool caches) - bot handler uses DI singletons instead of direct construction - get-file RedirectRetrieval.redirectUrl marked deprecated, URL via shared builder; chunked-storage URL via buildTelegramFileUrl (no inline api.telegram.org/file/bot left in src/)
69 lines
2.3 KiB
TypeScript
69 lines
2.3 KiB
TypeScript
/**
|
|
* Deduplication policy for the upload file use case.
|
|
* - `hash`: look up an existing record by content SHA-256 first (default).
|
|
* - `bucket-key`: idempotent lookup by `(bucketId, s3Key)`; never re-uploads.
|
|
* - `none`: store unconditionally.
|
|
*/
|
|
export type UploadDedupPolicy = 'hash' | 'bucket-key' | 'none';
|
|
|
|
/**
|
|
* Input for the upload file use case.
|
|
* Carries all metadata needed to persist an uploaded file,
|
|
* including its temporary location on disk and optional bucket/S3 context.a
|
|
*/
|
|
export interface UploadInput {
|
|
/** Absolute path to the temporary file on disk */
|
|
tempPath: string;
|
|
/** SHA-256 hex digest of the file content */
|
|
fileHash: string;
|
|
/** Original file name (may include extension) */
|
|
fileName: string;
|
|
/** MIME type detected from content inspection or request header */
|
|
mimeType: string;
|
|
/**
|
|
* High-level file category (e.g. "document", "photo", "video").
|
|
* Optional — when omitted the use case derives it from MIME type + file name.
|
|
*/
|
|
fileType?: string;
|
|
/** File size in bytes */
|
|
sizeBytes: number;
|
|
/** Telegram user ID of the uploader; 0 when unknown or system */
|
|
uploaderId?: number;
|
|
/** Target bucket UUID for S3-compatible storage; null when un-bucketed */
|
|
bucketId?: string | null;
|
|
/** Object key within the bucket for S3-compatible storage; null when un-bucketed */
|
|
s3Key?: string | null;
|
|
/** Deduplication policy; defaults to `'hash'` when omitted */
|
|
dedup?: UploadDedupPolicy;
|
|
/** Prefix for chunked part file names; defaults to `direct-<hash16>` */
|
|
partPrefix?: string;
|
|
/**
|
|
* First bytes of the file for magic-byte detection.
|
|
* When omitted the use case reads them from `tempPath`.
|
|
*/
|
|
signatureBuffer?: Buffer;
|
|
}
|
|
|
|
/**
|
|
* Output from the upload file use case.
|
|
* Contains the public-facing file metadata returned to the caller.
|
|
*/
|
|
export interface UploadOutput {
|
|
/** Public, shareable identifier (nanoid) */
|
|
publicId: string;
|
|
/** Stored file name (may have been normalized with extension) */
|
|
fileName: string;
|
|
/** MIME type of the stored file */
|
|
mimeType: string;
|
|
/** File size in bytes */
|
|
sizeBytes: number;
|
|
/** High-level file category */
|
|
fileType: string;
|
|
/** ISO-8601 timestamp of when the file record was created */
|
|
createdAt: Date;
|
|
/** Public download URL */
|
|
downloadUrl: string;
|
|
/** SHA-256 hex digest of the stored content */
|
|
fileHash: string | null;
|
|
}
|