pkg/sms 提供短信服务商抽象、验证码生成与校验能力，并内置阿里云、腾讯云提供者。

• 统一短信发送接口 SMSProvider。
• 支持全局默认服务商初始化，便于与 Engine 集成。
• 提供验证码生成、内存存储、失败计数、锁定与自动过期清理。

• type SMSConfig
  • Provider：aliyun / tencent
  • AccessKey / SecretKey
  • SignName
  • Region
  • AppID：腾讯云必填
• type SMSProvider interface
  • Send(mobile, templateID string, params map[string]string) error

• RegisterProvider(name, factory)
• InitDefaultProvider(cfg)
• DefaultProvider()
• GetConfig()

• SendSMS(mobile, templateID, params)：直接发送短信
• SendCode(mobile, opts...)：生成验证码，可选自动短信发送
• VerifyCode(mobile, code)：校验后即删除，一次性使用
• IsLocked(mobile)：检查手机号是否被锁定
• Unlock(mobile)：手动解锁
• GetFailures(mobile)：获取失败次数
• GetCode(mobile)：测试辅助
• DeleteCode(mobile)：删除验证码

• WithCodeLength
• WithCodeExpiry
• WithCodeType
• WithTemplateID
• WithTemplateParams
• WithMaxFailures
• WithLockDuration

• Provider：服务商名称，必填
• AccessKey / SecretKey：服务商凭证，必填
• SignName：短信签名，必填
• Region：区域，可按服务商配置

• 默认区域：cn-hangzhou
• 使用 TemplateCode 与 JSON TemplateParam
• 通过签名串调用 https://dysmsapi.aliyuncs.com/

• AppID 必填
• 默认区域：ap-guangzhou
• 国内号码走 sms.tencentcloudapi.com
• 非 +86 国际号码走 sms.intl.tencentcloudapi.com

• 长度：6
• 类型：numeric
• 过期时间：5m
• 最大失败次数：5
• 锁定时长：15m

import (
    "github.com/darkit/gin/pkg/sms"
    _ "github.com/darkit/gin/pkg/sms/providers"
)

cfg := sms.SMSConfig{
    Provider:  "aliyun",
    AccessKey: "ak",
    SecretKey: "sk",
    SignName:  "Demo",
    Region:    "cn-hangzhou",
}

if err := sms.InitDefaultProvider(cfg); err != nil {
    panic(err)
}

err := sms.SendSMS("13800138000", "SMS_123456", map[string]string{
    "name": "Alice",
})

code, err := sms.SendCode(
    "13800138000",
    sms.WithTemplateID("SMS_LOGIN_CODE"),
    sms.WithTemplateParams(map[string]string{"product": "Demo"}),
    sms.WithCodeLength(6),
    sms.WithCodeExpiry(5*time.Minute),
)
_ = code
_ = err

ok := sms.VerifyCode("13800138000", "123456")
if !ok && sms.IsLocked("13800138000") {
    _ = sms.Unlock("13800138000")
}

• gin.WithSMS(cfg)：初始化 Engine 时保存配置，并调用 sms.InitDefaultProvider。
• 业务代码通常只需在启动阶段完成一次 provider 注册与配置。
• 若使用阿里云或腾讯云，请记得 side-effect import：
  • _ "github.com/darkit/gin/pkg/sms/providers"

e := gin.New(
    gin.WithSMS(sms.SMSConfig{
        Provider:  "tencent",
        AccessKey: "ak",
        SecretKey: "sk",
        SignName:  "Demo",
        AppID:     "1400000000",
    }),
)

• 验证码存储当前为内存实现，服务重启后会丢失。
• VerifyCode 成功后会立即删除验证码。
• 连续失败会触发锁定；生产环境建议再叠加发送频率限制。