session

type Callback struct {
	BeforeRenew func(sessionID string, expire dataType.CustomTime, data any) error
	AfterRenew  func(sessionID string, expire dataType.CustomTime, data any) error
}

type CookieCarrier string

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

type Options struct {
	DisableGc     bool             `json:"disable_gc" yaml:"disable_gc" ini:"disable_gc"`             // 是否禁用session gc
	GcProbability float64          `json:"gc_probability" yaml:"gc_probability" ini:"gc_probability"` // session gc 概率
	CheckInterval time.Duration    `json:"check_interval" yaml:"check_interval" ini:"check_interval"` // session 检测默认有效期
	Carrier       CookieCarrier    `json:"carrier" yaml:"carrier" ini:"carrier"`                      // session 载体，默认cookie
	Cookie        cookiekit.Config `json:"cookie" yaml:"cookie" ini:"cookie"`
}

type Session struct {
	Id         string                `json:"id" gorm:"primaryKey;autoIncrement:false;type:varchar(64);not null;index;comment:Session ID"`
	Name       string                `json:"name" gorm:"primaryKey;autoIncrement:false;type:varchar(128);not null;index;comment:Session的名字"`
	Values     dataType.SessionValue `json:"values" gorm:"comment:session数据"`
	CreateTime dataType.CustomTime   `json:"create_time" gorm:"comment:session 创建时间"`
	ExpireTime dataType.CustomTime   `json:"expire_time" gorm:"not null;index;comment:session 过期时间"`
	Duration   time.Duration         `json:"duration" gorm:"comment:session有效期"`
}

type StorageDriver interface {
	Save(session *Session) error
	Get(sessionId, name string) (*Session, error)
	GetAll(sessionId string) ([]*Session, error)
	Delete(sessionId, name string) error
	DeleteAll(sessionId string) error

	// GC 相关
	GC(ctx context.Context) error
	Close() error
}

type Value struct {
	SessionID string        // 可自定义session id
	Field     string        // session 值字段
	Value     any           // session 值
	TTL       time.Duration // 有效期
}