/**
 * 关系与匹配服务（API_INVENTORY 行 48-55, 60-63）
 *
 * 封装：Like/Pass/Block/取消/解除 + Mutual 列表 + Unmatch + 成功牵手双确认。
 * 关键不变量（AGENTS.md）：
 *  - 第 4 条：Block 即时禁止互动——前端调用 block 后必须立即更新本地会话与列表。
 *  - 第 5 条：红娘不可替用户 Like——本层仅供当前用户调用，不接受 matchmakerId 参数。
 *  - 第 6 条：成功牵手必须双确认——success/request 与 success/confirm 分两次调用。
 * 单向意向不泄露：A Like B 但未 Mutual，本层不提供"谁喜欢我"的可识别列表，
 * 仅返回计数 / 是否被 liked 的布尔，详情走 /relations/likers（仅返回匿名化字段）。
 */
const api = require('../utils/api');

/**
 * 表达喜欢（API_INVENTORY 行 48）
 * @param {string} userId
 * @returns {Promise<import('../types').LikeResult>}
 */
function like(userId) {
  const idempotencyKey = `like:${userId}:${Date.now()}`;
  return api.post(`/relations/${encodeURIComponent(userId)}/like`, {}, undefined, idempotencyKey);
}

/**
 * 取消喜欢（API_INVENTORY 行 49）
 * 注意：Mutual 后不可直接取消（后端会返回 MATCH_REQUIRED），前端不应阻断调用。
 * @param {string} userId
 * @returns {Promise<{ relationStatus: import('../types').RelationStatus }>}
 */
function unlike(userId) {
  return api.delete(`/relations/${encodeURIComponent(userId)}/like`, {}, undefined, `unlike:${userId}:${Date.now()}`);
}

/**
 * 表示不合适（API_INVENTORY 行 50）
 * Pass 是单向意向，不会通知对方（AGENTS 第 6 条）。
 * @param {string} userId
 * @returns {Promise<{ relationStatus: 'passed' }>}
 */
function pass(userId) {
  const idempotencyKey = `pass:${userId}:${Date.now()}`;
  return api.post(`/relations/${encodeURIComponent(userId)}/pass`, {}, undefined, idempotencyKey);
}

/**
 * 拉黑用户（API_INVENTORY 行 51，AGENTS 第 4 条：Block 优先级最高）
 * 前端立即停止与该用户的所有互动，从推荐/搜索/会话列表移除。
 * @param {string} userId
 * @param {{ reason?: string }} [payload]
 * @returns {Promise<{ relationStatus: 'blocked' }>}
 */
function block(userId, payload = {}) {
  const idempotencyKey = `block:${userId}:${Date.now()}`;
  return api.post(`/relations/${encodeURIComponent(userId)}/block`, payload, undefined, idempotencyKey);
}

/**
 * 解除拉黑（API_INVENTORY 行 52）
 * @param {string} userId
 * @returns {Promise<{ relationStatus: 'neutral' }>}
 */
function unblock(userId) {
  return api.delete(`/relations/${encodeURIComponent(userId)}/block`, {}, undefined, `unblock:${userId}:${Date.now()}`);
}

/**
 * 获取互相喜欢列表（API_INVENTORY 行 53，即 Mutual Matches）
 * @param {{ cursor?: string, pageSize?: number }} params
 * @returns {Promise<{ items: Array<import('../types').Conversation>, nextCursor: string|null }>}
 */
function getMutualList(params = {}) {
  return api.get('/relations/mutual', params);
}

/**
 * 获取我喜欢的人列表（API_INVENTORY 行 54）
 * @param {{ cursor?: string, pageSize?: number }} params
 * @returns {Promise<{ items: Array<import('../types').User & { likedAt: number }>, nextCursor: string|null }>}
 */
function getLikedByMe(params = {}) {
  return api.get('/relations/liked', params);
}

/**
 * 获取喜欢我的人列表（API_INVENTORY 行 55）
 * 仅返回脱敏字段（昵称/年龄/地区/是否已 Mutual），不泄露对方明示身份。
 * @param {{ cursor?: string, pageSize?: number }} params
 * @returns {Promise<{ items: Array<import('../types').User>, nextCursor: string|null, totalCount: number }>}
 */
function getLikers(params = {}) {
  return api.get('/relations/likers', params);
}

/**
 * 获取黑名单列表（REST §86 章 GET /me/blacklist）
 * 拉黑/解除拉黑统一走 Relationship 接口（block/unblock），本接口仅查询。
 * 返回字段已脱敏（不返回对方手机号/身份证等敏感信息）。
 * @param {{ cursor?: string, pageSize?: number }} params
 * @returns {Promise<{ items: Array<{ userId: string, userName: string, avatarUrl?: string, blockedAt: number, reason?: string }>, nextCursor: string|null }>}
 */
function getBlockedList(params = {}) {
  return api.get('/me/blacklist', params);
}

/**
 * 获取我的匹配列表（API_INVENTORY 行 60）
 * 与 /relations/mutual 区别：matches 包含牵手状态、服务跟进字段，会话列表专用。
 * @param {{ cursor?: string, pageSize?: number }} params
 * @returns {Promise<{ items: Array<import('../types').Conversation>, nextCursor: string|null }>}
 */
function getMatches(params = {}) {
  return api.get('/matches', params);
}

/**
 * 解除匹配（API_INVENTORY 行 61）
 * 解除后双方会话立即停用，AGENTS 第 4 条影响范围仅次于 Block。
 * @param {string} matchId
 * @returns {Promise<{ relationStatus: 'unmatched' }>}
 */
function unmatch(matchId) {
  const idempotencyKey = `unmatch:${matchId}:${Date.now()}`;
  return api.post(`/matches/${encodeURIComponent(matchId)}/unmatch`, {}, undefined, idempotencyKey);
}

/**
 * 发起成功牵手请求（API_INVENTORY 行 62，AGENTS 第 6 条：成功牵手必须双确认）
 * 仅发起方调用一次，需对方在有效期内 confirm。
 * @param {string} matchId
 * @returns {Promise<{ successRequestId: string, expiresAt: number, status: 'pending_confirm' }>}
 */
function requestSuccess(matchId) {
  const idempotencyKey = `success-req:${matchId}:${Date.now()}`;
  return api.post(`/matches/${encodeURIComponent(matchId)}/success/request`, {}, undefined, idempotencyKey);
}

/**
 * 确认成功牵手（API_INVENTORY 行 63）
 * 仅被请求方调用，确认后双方关系置为 matched_successfully。
 * @param {string} matchId
 * @returns {Promise<{ relationshipStatus: 'matched_successfully', confirmedAt: number }>}
 */
function confirmSuccess(matchId) {
  const idempotencyKey = `success-confirm:${matchId}:${Date.now()}`;
  return api.post(`/matches/${encodeURIComponent(matchId)}/success/confirm`, {}, undefined, idempotencyKey);
}

module.exports = {
  like,
  unlike,
  pass,
  block,
  unblock,
  getMutualList,
  getLikedByMe,
  getLikers,
  getBlockedList,
  getMatches,
  unmatch,
  requestSuccess,
  confirmSuccess,
};