s0_udp 0.1.0

use strum::FromRepr;

/// 协议版本号
pub const PROTO_VERSION: u8 = 2;

/// 对等控制面请求/响应魔数 `"S0P2"` (LE)
pub const P2P_MAGIC: u32 = 0x3250_3053;

/// 订阅/群组实时推送帧魔数 `"S0B2"` (LE)
pub const SUB_MAGIC: u32 = 0x3242_3053;

/// 节点自签名名片魔数 `"S0C1"` (LE)
pub const PROFILE_MAGIC: u32 = 0x3143_3053;

/// 内容寻址清单魔数 `"S0M2"`
pub const MANIFEST_MAGIC: [u8; 4] = *b"S0M2";

/// `iroh` QUIC 对等控制面 ALPN 标识
pub const ALPN_P2P: &[u8] = b"s0/p2p/1";

/// 节点自签名名片 Ed25519 域分隔前缀
pub const PROFILE_SIG_DOMAIN: &[u8] = b"s0/profile/v1";

/// 用户名最大字符数（Unicode 标量值个数）
pub const MAX_NAME_CHARS: usize = 64;

/// 邮箱最大字节长度
pub const MAX_EMAIL_LEN: usize = 128;

/// 网址最大字节长度
pub const MAX_URL_LEN: usize = 256;

/// 个性签名最大字符数（Unicode 标量值个数）
pub const MAX_BIO_CHARS: usize = 256;

/// `u15` 变长整数最大值 (`32767`)
pub const U15_MAX: u16 = 0x7FFF;

/// 请求/推送标志位：镜像清理多余文件
pub const FLAG_DELETE: u8 = 1 << 0;

/// 请求/推送标志位：增量路径子集更新（不触发全目录清理）
pub const FLAG_PARTIAL: u8 = 1 << 1;

/// 请求标志位：指定块区间 `[blk_lo, blk_hi)` 与快照 `root_hash`
pub const FLAG_RANGE: u8 = 1 << 2;

/// 请求标志位：声明请求方开启本地 UDP P2P 供块服务
pub const FLAG_SEED: u8 = 1 << 3;

/// 请求标志位：携带读写能力令牌或请求读写权限
pub const FLAG_RW: u8 = 1 << 4;

/// 缺失块位图全 1 标记（表示接收方已拥有全部块，0 字节位图负载）
pub const HAVE_ALL_ONES: u32 = 0xFFFF_FFFF;

/// 原生 UDP 数据包头固定长度（20 字节）
pub const DATA_HDR_LEN: usize = 20;

/// 默认单包 UDP 分片有效载荷字节数
pub const DEFAULT_SEG_PAYLOAD: usize = 1380;

/// 单包 UDP 接收缓冲区大小
pub const MAX_UDP_PKT: usize = 1500;

/// UDP 反馈包类型：缺失块 NACK
pub const PKT_NACK: u8 = 0x81;

/// UDP 反馈包类型：区间完成 ACK
pub const PKT_ACK: u8 = 0x82;

/// UDP 打洞探测包类型
pub const PKT_PUNCH: u8 = 0x83;

/// FastCDC 最小分块大小（16 KiB）
pub const CDC_MIN_CHUNK: u32 = 16 * 1024;

/// FastCDC 平均分块大小（32 KiB）
pub const CDC_AVG_CHUNK: u32 = 32 * 1024;

/// FastCDC 最大分块大小（64 KiB）
pub const CDC_MAX_CHUNK: u32 = 64 * 1024;

/// 原生 UDP 块载荷是否经 Zstd 压缩标志位（复用 `DataHeader.seg_cnt` bit 15）
pub const DATA_FLAG_ZSTD: u16 = 0x8000;

/// 清单分片包 32 位小端魔数（`0x4D44_3053` = `"S0DM"`）
pub const DIR_MAGIC: u32 = u32::from_le_bytes(*b"S0DM");
/// 清单确认包 32 位小端魔数（`0x4144_3053` = `"S0DA"`）
pub const DIR_ACK_MAGIC: u32 = u32::from_le_bytes(*b"S0DA");
/// 传输完成包 32 位小端魔数（`0x4642_3053` = `"S0BF"`）
pub const FIN_MAGIC: u32 = u32::from_le_bytes(*b"S0BF");
/// 双栈竞速探测包 32 位小端魔数（`0x4250_3053` = `"S0PB"`）
pub const PROBE_MAGIC: u32 = u32::from_le_bytes(*b"S0PB");
/// 双栈竞速探测回包 32 位小端魔数（`0x4150_3053` = `"S0PA"`）
pub const PROBE_ACK_MAGIC: u32 = u32::from_le_bytes(*b"S0PA");
/// `iroh` 发现帧双栈候选地址魔数（`0x4441_3053` = `"S0AD"`）
pub const ADDR_MAGIC: u32 = u32::from_le_bytes(*b"S0AD");
/// 双栈竞速 IPv6 优先裕度（5 ms = 5000 µs）
pub const V6_PREFER_MARGIN_US: u64 = 5_000;

/// 会话包头长度（12 B）
pub const SESSION_HLEN: usize = 12;
/// 高速流数据包头长度（20 B）
pub const DATA_HLEN: usize = 20;
/// 双栈竞速探测包长度（12 B：`magic u32 ‖ ts_us u64`）
pub const PROBE_LEN: usize = 12;
/// 清单分片包头长度（12 B：`magic u32 ‖ total_len u32 ‖ idx u32`）
pub const DIR_HDR_LEN: usize = 12;
/// 清单确认包头长度（8 B：`magic u32 ‖ chunks u32`）
pub const DIR_ACK_HDR_LEN: usize = 8;

/// UDP 最大报文缓冲长度（2048 B）
pub const MAX_DATAGRAM: usize = 2048;
/// 默认单包载荷长度（1400 B）
pub const DEFAULT_PKT: usize = 1400;
/// 最小单包载荷长度（1024 B）
pub const MIN_PKT: usize = 1024;
/// 默认数据块字节上限（128 KiB）
pub const MAX_BLOCK: usize = 128 * 1024;
/// 单块最大分片槽位数（`128 KiB / 1400 = 94`，向上取整留余量）
pub const MAX_CNT: usize = 96;
/// 发送/接收滑动窗口块数（512 块 = 64 MiB）
pub const WINDOW_BLOCKS: u32 = 512;

/// 会话包标志位：密钥相位
pub const PHASE: u8 = 1;
/// 数据包标志位：重传包
pub const RETX: u8 = 1 << 1;
/// 数据包标志位：本块经 Zstd 压缩
pub const ZSTD: u8 = 1 << 2;
/// 数据包标志位：Reed-Solomon 校验包
pub const PAR: u8 = 1 << 3;
/// 数据包标志位：校验包数偏移（bit 4..7）
pub const R_SHIFT: u8 = 4;
/// 数据包标志位：校验包数掩码
pub const R_MASK: u8 = 0xF0;

/// 清单单包分片载荷长度（1200 B）
pub const MANIFEST_CHUNK: usize = 1200;
/// 清单块 / `have_bits` 压缩标记位（bit 31）
pub const MANIFEST_ZSTD: u32 = 1 << 31;
/// `DIR_ACK` `have_bits` 全 1 游程标记位（bit 30：100% 命中本地基准块，0 字节载荷）
pub const HAVE_ALL_ONES_BIT: u32 = 1 << 30;
/// 清单头部标记：请求接收端清理不在清单中的多余文件（bit 31）
pub const MANIFEST_DELETE: u32 = 1 << 31;
/// 清单头部标记：当前清单仅为增量文件子集（bit 30）
pub const MANIFEST_PARTIAL: u32 = 1 << 30;
/// 清单条目 `nchunks` 删除墓碑特殊标记值
pub const TOMBSTONE_NCHUNKS: u16 = 0xFFFE;
/// 默认 Zstd 压缩级别
pub const ZSTD_DEFAULT_LEVEL: i32 = 3;

/// `ACK.delay` 时间单位（8 µs）
pub const ACK_DELAY_US: u64 = 8;
/// 单包 `ACK` 携带的最大连续确认区间数
pub const MAX_RANGES: usize = 255;
/// 单包 `ACK` 携带的最大未完成块位图数
pub const ACK_BLOCKS: usize = 8;
/// 接收端扫描未完成块位图的窗口上界
pub const ACK_SCAN_BLOCKS: u32 = 64;

/// TACK 最小周期（2 ms = 2000 µs）
pub const MIN_TACK_US: u64 = 2_000;
/// TACK 最大周期（20 ms = 20000 µs）
pub const MAX_TACK_US: u64 = 20_000;
/// RTO 下限（5 ms）
pub const MIN_RTO_US: u64 = 5_000;
/// RTO 上限（2 s）
pub const MAX_RTO_US: u64 = 2_000_000;
/// RACK 乱序窗口上限（250 ms）
pub const MAX_REO_US: u64 = 250_000;
/// 未验证源地址的抗反射放大倍数上限（3×）
pub const DEFAULT_AMP_FACTOR: u64 = 3;

/// 传输端点角色（数值枚举）
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
#[repr(u8)]
pub enum Role {
  Send = 0,
  Recv = 1,
}

impl Role {
  #[inline]
  pub const fn code(self) -> u8 {
    self as u8
  }

  #[inline]
  pub const fn as_str(self) -> &'static str {
    match self {
      Self::Send => "send",
      Self::Recv => "recv",
    }
  }
}

/// 对等网络控制面数值操作码
#[repr(u8)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, FromRepr)]
pub enum Op {
  /// 拉取单文件、单目录、路径前缀或指定块区间 `[blk_lo, blk_hi)`
  Pull = 1,
  /// 向拥有写权限的对等节点推送单文件或目录变更
  Push = 2,
  /// 查询目标 Share + 路径的 `Manifest`、`root_hash`、节点名片及可用 P2P 节点列表
  Stat = 3,
  /// 长连接订阅 Share 更新（全量 `""` 或路径前缀 `"sub/dir"`），同时注册为 P2P 分发节点
  Sub = 4,
  /// 订阅/群组节点上报已完成校验的 `root_hash` 与块区间 `[blk_lo, blk_hi)`
  Have = 5,
  /// 加入群组相互备份，通告本节点名片、导出的 Share 及备份前缀策略
  GroupJoin = 6,
}

/// 对等网络控制面数值响应状态码
#[repr(u8)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, FromRepr)]
pub enum Status {
  /// 成功
  Ok = 0,
  /// 未授权（开启认证且 `EndpointId` / 令牌不匹配）
  Unauth = 1,
  /// 权限不足（只读权限尝试 `Push` 或 `FLAG_DELETE`）
  Forbidden = 2,
  /// 请求的 Share 或子路径不存在
  NotFound = 3,
  /// 请求的 `root_hash` 快照已过期或不一致
  Conflict = 4,
  /// 协议格式或路径参数非法
  BadReq = 5,
}

/// 节点自签名名片属性键数字常量
#[repr(u8)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, FromRepr)]
pub enum AttrKey {
  /// 用户名（UTF-8，最长 64 字符）
  Name = 1,
  /// 邮箱（UTF-8，最长 128 字节）
  Email = 2,
  /// 网址（UTF-8，最长 256 字节）
  Url = 3,
  /// 城市级地域数字常量（2 字节小端 `u16`，对应 `s0_region::Region`）
  Region = 4,
  /// 个性签名（UTF-8，最长 256 字符）
  Bio = 5,
}

/// 对等分享访问权限
#[repr(u8)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, FromRepr)]
pub enum Perm {
  /// 只读（允许 `Stat`、`Pull`、`Sub`、`Have`）
  Ro = 1,
  /// 读写（额外允许 `Push` 与 `FLAG_DELETE`）
  Rw = 2,
}