cookies

type Action int

type C struct {
	Name   string
	Value  string
	Domain string
	Path   string

	Expires  time.Time // if zero, has no expiration
	Created  time.Time
	Flags    Flags
	SameSite SameSite
}

type Editor interface {
	// Get returns a format-independent representation of the receiver.
	Get() C

	// Set updates the contents of the receiver to match c.
	// It reports an error if c cannot be represented in the format.
	Set(c C) error
}

type Flags struct {
	Secure   bool // only send this cookie on an encrypted connection
	HTTPOnly bool // do not expose this cookie to scripts
}

type SameSite int

type ScanFunc func(Editor) (Action, error)

type Store interface {
	// Scan calls f for each cookie in the store.
	//
	// If f reports an error, scanning stops and that error is returned to the
	// caller of Scan. Otherwise, the cookie is handled according to the Action
	// reported by f.
	//
	// if f returns Discard, the cookie is removed from the store.
	//
	// If f returns Update, the cookie is updated with any modifications made by
	// f via the Editor interface.
	//
	// If f returns Keep, the cookie is retained as-presented, and any
	// modifications made by f are discarded.
	//
	// If f returns an unknown Action value, Scan must report an error.
	Scan(f ScanFunc) error

	// Commit commits any pending modifications to persistent storage.
	Commit() error
}