core

type CACertConfig struct {
	RSAKeyBits   int          // [RSA] 私钥位数(默认2048, 可选4096)
	DaysValid    int          // 证书有效期(天)
	Subject      Subject      // 证书主题信息
	Key          string       // 私钥
	Cert         string       // 证书
	KeyAlgorithm KeyAlgorithm // 密钥算法(RSA/ECDSA/Ed25519)
	ECDSACurve   ECDSACurve   // [ECDSA] 曲线(P256/P384/P521)
	PathLenZero  bool         // 是否为终端 CA(不能签发下级 CA)
	MaxPathLen   int          // 最大路径长度(-1 表示无限制), 用于限制下级 CA 签发能力
}

type CASignedCertConfig struct {
	CACert       string       // CA 证书
	CAKey        string       // CA 私钥
	Name         string       // 证书名称
	Subject      Subject      // 证书主题
	Cert         string       // 证书
	Key          string       // 私钥
	DaysValid    int          // 证书有效期(天)
	RSAKeyBits   int          // [RSA] 私钥位数(默认2048, 可选4096)
	KeyAlgorithm KeyAlgorithm // 密钥算法(RSA/ECDSA/Ed25519)
	ECDSACurve   ECDSACurve   // [ECDSA] 曲线(P256/P384/P521)
	SAN          SANConfig    // 主题备用名称
	Usage        CertUsage    // 证书用途(服务器/客户端等)
	IsCA         bool         // 是否为中间 CA
	MaxPathLen   int          // 中间 CA 最大路径长度
}

type CRLConfig struct {
	CACert         string     // CA 证书
	CAKey          string     // CA 私钥
	RevokedCerts   []string   // 要吊销的证书列表(PEM 格式)
	ExistingCRL    string     // 现有的 CRL(PEM 格式), 新吊销会合并进去
	SkipExpired    bool       // 跳过已过期的证书(不吊销已过期的证书)
	PruneAfterDays int        // 剔除吊销超过 N 天的历史记录(0 表示不剔除)
	DaysValid      int        // CRL 有效期(天)
	CRL            string     // 生成的 CRL(PEM 格式)
	ThisUpdate     time.Time  // 本次更新时间
	NextUpdate     time.Time  // 下次更新时间
	RevokedSerials []*big.Int // 已吊销证书序列号列表
	SkippedExpired int        // 跳过的已过期证书数量(输出)
	PrunedCount    int        // 剔除的历史记录数量(输出)
}

type CSRConfig struct {
	Subject      Subject      // 证书主题
	RSAKeyBits   int          // [RSA] 私钥位数(默认2048)
	KeyAlgorithm KeyAlgorithm // 密钥算法(RSA/ECDSA/Ed25519)
	ECDSACurve   ECDSACurve   // [ECDSA] 曲线(P256/P384/P521)
	SAN          SANConfig    // 主题备用名称
	CSR          string       // 生成的 CSR(PEM 格式)
	Key          string       // 生成的私钥(PEM 格式)
}

type CSRSignConfig struct {
	CACert    string    // CA 证书
	CAKey     string    // CA 私钥
	CSR       string    // 待签发的 CSR
	DaysValid int       // 证书有效期(天)
	Usage     CertUsage // 证书用途
	IsCA      bool      // 是否为 CA 证书
	Cert      string    // 签发的证书
}

type CertChainConfig struct {
	EndEntityCert   string   // 终端实体证书
	IntermediateCAs []string // 中间 CA 证书列表(从低到高排序)
	RootCA          string   // 根 CA 证书
	FullChain       string   // 完整证书链(PEM 格式)
}

type CertInfo struct {
	SerialNumber string    // 证书序列号
	Subject      string    // 证书主题
	Issuer       string    // 证书颁发者
	NotBefore    time.Time // 生效时间
	NotAfter     time.Time // 过期时间
	IsCA         bool      // 是否为 CA 证书
	KeyAlgorithm string    // 密钥算法
	DNSNames     []string  // DNS 名称列表
	IPAddresses  []string  // IP 地址列表
	ExtKeyUsages []string  // 扩展密钥用途
}

type CertUsage int

type CertValidateConfig struct {
	Cert            string    // 待验证的证书
	CACert          string    // CA 证书(可选, 用于验证签名)
	IntermediateCAs []string  // 中间 CA 证书链
	CheckTime       time.Time // 验证时间点(零值表示当前时间)
	DNSName         string    // 验证 DNS 名称
	Usage           CertUsage // 验证用途
}

type Certificate struct {
	CertPEM      string       // 证书 PEM 格式
	KeyPEM       string       // 私钥 PEM 格式
	KeyAlgorithm KeyAlgorithm // 密钥算法
	// contains filtered or unexported fields
}

type CryptoOperator interface {
	// Sign 使用私钥对数据进行签名.
	Sign(data []byte) ([]byte, error)

	// Verify 使用证书公钥验证签名.
	Verify(data []byte, signature []byte) error

	// HybridEncrypt 混合加密: 结合对称加密和非对称加密.
	// RSA: 使用 RSA 加密 AES 密钥, AES 加密数据.
	// ECDSA/Ed25519: 使用 ECDH 密钥交换派生共享密钥, AES 加密数据.
	// 返回密文和 nonce, 如果 plaintext 为 nil, 则返回 nil 密文和有效的 nonce.
	HybridEncrypt(plaintext []byte) ([]byte, []byte, error)

	// HybridDecrypt 混合解密.
	HybridDecrypt(encryptedPackage []byte) ([]byte, error)

	// GetKeyAlgorithm 获取密钥算法.
	GetKeyAlgorithm() KeyAlgorithm

	// GetCertificate 获取底层证书.
	GetCertificate() *Certificate
}

type ECDSACryptoOperator struct {
	// contains filtered or unexported fields
}

type ECDSACurve string

type Ed25519CryptoOperator struct {
	// contains filtered or unexported fields
}

type KeyAlgorithm string

type PEMBlockType string

type RSACryptoOperator struct {
	// contains filtered or unexported fields
}

type RevokedCertInfo struct {
	SerialNumber   *big.Int  // 证书序列号
	RevocationTime time.Time // 吊销时间
	Reason         int       // 吊销原因
}

type SANConfig struct {
	DNSNames    []string // DNS 名称列表
	IPAddresses []net.IP // IP 地址列表
	EmailAddrs  []string // 电子邮件地址列表
	URIs        []string // URI 列表
}

type Subject struct {
	Country            string // 国家
	State              string // 省份
	Locality           string // 城市
	Organization       string // 组织
	OrganizationalUnit string // 组织单位
	CommonName         string // 通用名称
}