// 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;
}