launchnotice

type DatedJob struct {
	Store  DatedStore
	Mailer Mailer
	Now    func() time.Time
	Logger *slog.Logger
	// Skip excludes accounts (the demo and auth-bypass users).
	Skip map[uuid.UUID]bool
	// OnExtend is told after an account's founding year was extended (invalidate the plan cache).
	OnExtend func(uid uuid.UUID)
	// Observe counts an outcome ("sent", "failed", "in_app", "skipped", "late").
	Observe func(kind, outcome string)
}

type DatedStats struct {
	Considered, InApp, Sent, Failed, Skipped int
	Late                                     int           // years that had to be extended
	WorstShortfall                           time.Duration // the largest shortfall among them
}

type DatedStore interface {
	// FoundingCandidates lists accounts whose founding year ends within SendFrom and that still need a notice (or, for a verified address, an email).
	FoundingCandidates(ctx context.Context, now time.Time) ([]FoundingCandidate, error)
	// PrepareFounding, in one transaction, extends a year that is under 30 days from ending to now + 30 days, fixes the notice's dates in
	// account_notices and (when wantEmail) claims the email. Nothing is changed when the email is wanted but cannot be claimed.
	PrepareFounding(ctx context.Context, c FoundingCandidate, now time.Time, wantEmail bool) (Prepared, error)
	MarkSent(ctx context.Context, uid uuid.UUID, kind string) error
	ReleaseClaim(ctx context.Context, uid uuid.UUID, kind string) error
}

type FoundingCandidate struct {
	UserID     uuid.UUID
	Email      string
	Verified   bool
	End        time.Time  // the founding row's current_period_end
	Subscribed bool       // a paid subscription that outlasts the founding year
	NextCharge *time.Time // that subscription's current period end, when it has one
}

type FoundingParams struct {
	End string `json:"end"` // the founding year's last day, YYYY-MM-DD
	// ExtendedFrom, when set, is the end date before the account's year was extended to give 30 days' notice.
	ExtendedFrom string `json:"extended_from,omitempty"`
	// Subscribed: a paid subscription outlasts the founding year, so nothing changes for the account on that date.
	Subscribed bool `json:"subscribed,omitempty"`
	// NextCharge is, for a subscribed account, the subscription's current period end (YYYY-MM-DD): the date of its next charge. Empty when
	// the subscription has no end date to state.
	NextCharge string `json:"next_charge,omitempty"`
}

type InApp struct {
	Title string `json:"title"`
	Body  string `json:"body"`
	Links []Link `json:"links"`
}

type Link struct {
	Label string `json:"label"`
	Href  string `json:"href"`
}

type Mailer interface {
	Send(ctx context.Context, m email.Message) error
}

type Notice struct {
	Kind string
	// Params are the launch notice's dates (empty for other kinds); Raw is the stored JSON of any kind.
	Params     Params
	Raw        json.RawMessage
	ShowsUntil time.Time
	CreatedAt  time.Time
	EmailSent  *time.Time
	Dismissed  *time.Time
}

type PGDated struct{ DB *sql.DB }

type Params struct {
	Launch         string `json:"launch"`          // LAUNCH_DATE: the hosted service has a free tier and Pro from here
	FoundingEnd    string `json:"founding_end"`    // FOUNDING_END_DATE: launch + 1 year, when the free Pro year ends
	TermsEffective string `json:"terms_effective"` // TERMS_EFFECTIVE_EXISTING: launch + 30 days, when the new Terms bind existing accounts
}

type Prepared struct {
	Params FoundingParams
	// Claimed: the account's email is ours to send (false for an account with no email to send, or one another run holds).
	Claimed bool
	// Extended: the year was extended to give 30 days' notice; Shortfall is how many days short it would have been.
	Extended  bool
	Shortfall time.Duration
}

type Renewal struct {
	UserID     uuid.UUID
	Email      string
	Verified   bool
	RenewsOn   time.Time
	PriceLabel string // "$34.99 a year"
}

type RenewalJob struct {
	Source RenewalSource
	Store  Store
	Mailer Mailer
	Now    func() time.Time
	Logger *slog.Logger
	Skip   map[uuid.UUID]bool
	// Observe counts an outcome (one of Outcomes) under the kind KindAnnualRenewal.
	Observe func(kind, outcome string)
}

type RenewalParams struct {
	RenewsOn   string `json:"renews_on"`
	PriceLabel string `json:"price"`
}

type RenewalSource interface {
	AnnualRenewals(ctx context.Context, from, to time.Time) ([]Renewal, error)
}

type State struct {
	Exists    bool
	EmailSent bool
	Params    Params
	CreatedAt time.Time
}

type Store struct{ DB *sql.DB }