32 lines
1.5 KiB
TypeScript
32 lines
1.5 KiB
TypeScript
|
// services/api/src/shared/ov-browse-key.ts —— ov 侧浏览图对象键的单一推导
|
|||
|
|
// 实现（P4a Task 4 自 public-ov.service 抽出）：公开读（列表/单图 browse 现签）
|
|||
|
|
// 与下载端点（variant=browse 的下载键）必须落同一对象——水印开启时两者都是
|
|||
|
|
// 模式键（watermarkVariantObjectKey），关闭时都是 photos_ov 内联 browse 键。
|
|||
|
|
// 键由 (albumId, photoId, 有效版本) 确定性构成（ov 无变体副本表）；对象存在性
|
|||
|
|
// 由 cn 侧 done 任务收尾不变量保证（见 packages/contracts/src/watermark.ts 与
|
|||
|
|
// public-ov.service 头注）。
|
|||
|
|
import { watermarkVariantObjectKey } from '@photo/storage';
|
|||
|
|
|
|||
|
|
/** 相册级水印服务上下文（albums_ov 副本位 + 归属 albumId）。 */
|
|||
|
|
export interface WatermarkContextOv {
|
|||
|
|
albumId: string;
|
|||
|
|
enabled: boolean;
|
|||
|
|
configVersion: number;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* ov 浏览图对象键：水印开启（enabled && 有效版本 > 0）→ 模式键
|
|||
|
|
* variants/{photoId}/{有效版本}/watermark.jpg（cn worker 直写同一对象空间，
|
|||
|
|
* 失败照片由任务收尾回退拷贝旧图——键恒有对象）；否则 → photos_ov 内联
|
|||
|
|
* browse 键（disable 版任务完成后回落，水印键对象保留历史可溯）。
|
|||
|
|
*/
|
|||
|
|
export function ovBrowseKey(
|
|||
|
|
watermark: WatermarkContextOv,
|
|||
|
|
photoId: string,
|
|||
|
|
browseObjectKey: string,
|
|||
|
|
): string {
|
|||
|
|
return watermark.enabled && watermark.configVersion > 0
|
|||
|
|
? watermarkVariantObjectKey(watermark.albumId, photoId, watermark.configVersion)
|
|||
|
|
: browseObjectKey;
|
|||
|
|
}
|