#!/usr/bin/env bash
#
# 发布 MMail —— 单文件、不含运行环境,版本号由 git 自动推算。
#
# 用法:
#   ./scripts/publish.sh                    # 开发构建,默认 linux-x64
#   ./scripts/publish.sh win-x64            # 交叉编译 Windows
#   ./scripts/publish.sh --release          # 发布构建(要求干净工作区 + HEAD 上有 tag)
#   ./scripts/publish.sh --release linux-x64
#
# 产物输出到 publish/,运行 ./publish/MMail.Client 即可(目标机需装 .NET 10 运行时)。
#
# 与 build.sh 的分工:build.sh 只编译,用来快速确认代码能不能过;本脚本产出
# 可分发的产物。不必先跑 build.sh——dotnet publish 自带编译,跑了也是编译两遍。
# 版本号只在本脚本里注入:编译产物不需要版本号,只有要分发的东西才需要
# 回答「这对应哪个 commit」。
#
# ---------------------------------------------------------------------------
# 版本号怎么来的
# ---------------------------------------------------------------------------
# 不手写、不维护版本文件,一律从 git 推算,这样「代码管理平台上的 tag」与
# 「产物自称的版本」天然是同一个东西——发布之后要在部署实例上检查更新,
# 靠的就是这层对应。
#
#   HEAD 正好在 tag 上        → 该 tag 的版本           0.1.0
#   tag 之后还有 N 个提交     → 下一个 patch 的预发布    0.1.1-alpha.N+2252afa
#   仓库还没有任何 tag        → 0.0.1-alpha.{总提交数}  0.0.1-alpha.20+2252afa
#
# 为什么第二种情形是「下一个 patch」而不是「当前 tag + alpha」:
#   0.1.0-alpha.5 在 SemVer 里小于 0.1.0,检查更新时会得出「比已发布的版本还旧」,
#   而它实际是 0.1.0 之后的代码。0.1.1-alpha.5 才正确表达「在 0.1.0 之后、尚未发布」。
#
# commit 与 dirty 标记放在 SourceRevisionId 里(SemVer 的 build metadata),
# 由 SDK 拼成 InformationalVersion 的 + 后缀:0.1.1-alpha.5+2252afa.dirty
# ---------------------------------------------------------------------------
# 关于「单文件」的边界,以及为什么 publish 里还有一个 appsettings.json
# ---------------------------------------------------------------------------
# wwwroot 已被嵌入可执行文件(csproj 里仅 PublishSingleFile 时转为嵌入资源,
# 由 Program.cs 的 ResolveWebRootFileProvider 从程序集读出)。
# 这不是 PublishSingleFile 自带的能力——单文件模式不会带上 wwwroot,
# 缺了它的表现很难排查:请求不会被静态文件中间件处理,一路走到登录中间件才被拦下,
# /index.html 返回 401 而不是 404,看上去像「认证坏了」而不是「文件没了」。
#
# appsettings.json 是刻意留下的唯一外部文件:用户要用它换数据库、调日志级别;
# 更要紧的是 Kestrel 端口写在里面,移走它启动会退到默认的 5000,
# 而 OAuth2 回调地址是按真实监听端口推算的,届时与服务商登记的对不上。
#
# 另外清理 staticwebassets.endpoints.json 与 .pdb,留着只会让人误以为运行必需。
# ---------------------------------------------------------------------------
set -euo pipefail

# 从脚本自身位置推导项目根,这样从任何目录下调用都成立
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
PROJECT="$ROOT/src/MMail.Client/MMail.Client.csproj"
OUT="$ROOT/publish"

RELEASE_MODE=0
if [[ "${1:-}" == "--release" ]]; then
  RELEASE_MODE=1
  shift
fi

# 目标平台。默认 linux-x64,交叉编译直接传 RID
RID="${1:-linux-x64}"

if [[ ! -f "$PROJECT" ]]; then
  echo "错误:找不到项目文件 $PROJECT" >&2
  exit 1
fi

cd "$ROOT"

if ! git rev-parse --git-dir >/dev/null 2>&1; then
  echo "错误:不在 git 仓库中,无法推算版本号。" >&2
  exit 1
fi

# ---- 版本推算 ----
SHORT_HASH="$(git rev-parse --short HEAD)"
FULL_HASH="$(git rev-parse HEAD)"
COMMIT_SUBJECT="$(git log -1 --format=%s)"

if [[ -n "$(git status --porcelain)" ]]; then
  IS_DIRTY=1
else
  IS_DIRTY=0
fi

# 只认 v 开头的数字 tag,避免把别的用途的 tag 当成版本号
DESCRIBE="$(git describe --tags --match 'v[0-9]*' --long 2>/dev/null || true)"

if [[ -z "$DESCRIBE" ]]; then
  # 仓库还没有任何版本 tag
  COMMITS="$(git rev-list --count HEAD)"
  BASE="0.0.1"
  PRERELEASE="alpha.$COMMITS"
  DISTANCE="$COMMITS"
else
  BASE="$(printf '%s' "$DESCRIBE" | sed -E 's/-[0-9]+-g[0-9a-f]+$//')"
  DISTANCE="$(printf '%s' "$DESCRIBE" | sed -nE 's/^.*-([0-9]+)-g[0-9a-f]+$/\1/p')"
  BASE="${BASE#v}"

  # 补成 x.y.z,缺段按 0 处理
  IFS='.' read -r MAJOR MINOR PATCH <<<"$BASE"
  MINOR="${MINOR:-0}"
  PATCH="${PATCH:-0}"

  if [[ "$DISTANCE" == "0" ]]; then
    PRERELEASE=""
  else
    PRERELEASE="alpha.$DISTANCE"
    PATCH=$((PATCH + 1))
  fi
  BASE="$MAJOR.$MINOR.$PATCH"
fi

if [[ -n "$PRERELEASE" ]]; then
  VERSION="$BASE-$PRERELEASE"
else
  VERSION="$BASE"
fi

# dirty 一并写进 build metadata:这样「产物自称对应某个 commit」就不会有歧义
if [[ "$IS_DIRTY" == "1" ]]; then
  SOURCE_REVISION="$SHORT_HASH.dirty"
  DISPLAY_VERSION="$VERSION+$SHORT_HASH.dirty"
else
  SOURCE_REVISION="$SHORT_HASH"
  DISPLAY_VERSION="$VERSION+$SHORT_HASH"
fi

# ---- 发布前的防呆 ----
# 要发到代码管理平台的东西必须能对应到确定的 commit,否则 tag 与产物对不上,
# 部署实例上「检查更新」就无从判断自己跑的是什么。
if [[ "$RELEASE_MODE" == "1" ]]; then
  if [[ "$IS_DIRTY" == "1" ]]; then
    echo "错误:发布构建要求干净工作区,当前有未提交的改动。" >&2
    echo "      git status --short" >&2
    exit 1
  fi

  if ! git describe --tags --match 'v[0-9]*' --exact-match >/dev/null 2>&1; then
    echo "错误:发布构建要求 HEAD 上打有版本 tag,当前没有。" >&2
    echo "      下一个版本将是 $BASE,先执行(确认无误后):" >&2
    echo "        git tag -a v$BASE -m 'v$BASE' && git push origin v$BASE" >&2
    exit 1
  fi

  EXACT_TAG="$(git describe --tags --match 'v[0-9]*' --exact-match)"
  EXPECTED="${EXACT_TAG#v}"
  if [[ "$VERSION" != "$EXPECTED" ]]; then
    echo "错误:tag 与推算出的版本不一致(tag=$EXPECTED,推算=$VERSION)。" >&2
    exit 1
  fi
fi

echo "==> 版本:     $DISPLAY_VERSION"
echo "==> 目标平台: $RID"
echo "==> 输出目录: $OUT"

# 先清空:残留的旧产物不会被人误当成本次的构建结果
rm -rf "$OUT"

# 构建时间(UTC ISO 8601):给产物打上时间戳。多人在不同时区、用 CI 各自构建时,
# 这个时间比「文件 mtime」更可靠
BUILD_TIME="$(date -u +%Y-%m-%dT%H:%M:%SZ)"

dotnet publish "$PROJECT" \
  --configuration Release \
  --runtime "$RID" \
  --self-contained false \
  --output "$OUT" \
  -p:PublishSingleFile=true \
  -p:IncludeNativeLibrariesForSelfExtract=true \
  -p:DebugType=none \
  -p:Version="$VERSION" \
  -p:SourceRevisionId="$SOURCE_REVISION" \
  -p:MMailBuildTime="$BUILD_TIME" \
  -p:MMailRid="$RID" \
  -p:MMailCommitsSinceTag="$DISTANCE" \
  -p:MMailTag="${EXACT_TAG:-}"

cd "$OUT"

# 清理发布期遗留、运行时并不需要的东西
rm -f ./*.staticwebassets.endpoints.json
rm -f ./*.pdb

# 不启动程序也能看清这个产物是什么:服务起不来时尤其用得上
cat >VERSION.txt <<EOF
版本       : $DISPLAY_VERSION
commit     : $FULL_HASH
提交说明   : $COMMIT_SUBJECT
构建时间   : $(date '+%Y-%m-%d %H:%M:%S %z')
运行时标识 : $RID
目标框架   : net10.0
工作区     : $([[ "$IS_DIRTY" == "1" ]] && echo '有未提交改动(产物与任何 tag 都不完全对应)' || echo '干净')
构建模式   : $([[ "$RELEASE_MODE" == "1" ]] && echo '发布构建' || echo '开发构建')
EOF

echo ""
echo "==> 产物清单"

if [[ "$RID" == win-* ]]; then
  EXE="MMail.Client.exe"
else
  EXE="MMail.Client"
fi

for f in "$EXE" appsettings.json VERSION.txt; do
  if [[ -e "$f" ]]; then
    printf "      %-18s %s\n" "$f" "$(du -sh "$f" | cut -f1)"
  else
    printf "      %-18s 【缺失】\n" "$f" >&2
  fi
done

# wwwroot 本不该出现在输出里:它已经被嵌入可执行文件
if [[ -d wwwroot ]]; then
  printf "      %-18s 【警告】残留目录,静态资源可能没有被嵌入\n" "wwwroot" >&2
fi

echo ""
echo "==> 完成。运行方式:"
echo "      cd publish && ./$EXE"
echo ""
echo "    注意:不含运行环境,目标机需要已安装 .NET 10 运行时。"
echo "    当前版本会显示在设置页顶部,可在那里检查更新。"

if [[ "$RELEASE_MODE" != "1" && "$DISTANCE" != "0" ]]; then
  echo ""
  echo "    提示:这是开发构建(距上一个 tag 有 $DISTANCE 个提交)。"
  echo "          发到代码管理平台前请用 --release 重新构建。"
fi