contract

type ActivatePlanInput struct {
	ID string `json:"id"`
}

type ArchivePlanInput struct {
	ID string `json:"id"`
}

type Deps struct {
	Engine  *authsome.Engine
	Service SubscriptionService
	Usage   func(context.Context, string, string) ([]UsageSummary, error)

	// CanManageBilling reports whether userID holds manage/billing. The
	// plugin passes its own check so both surfaces fail closed the same way.
	// Every intent here refuses a caller it says no to, and a nil func says
	// no to everyone.
	CanManageBilling func(ctx context.Context, userID id.UserID) bool
}

type GetPlanInput struct {
	ID string `json:"id"`
}

type PlanDetail struct {
	PlanSummary
	Features []PlanFeature      `json:"features,omitempty"`
	Tiers    []PriceTierSummary `json:"tiers,omitempty"`
}

type PlanFeature struct {
	ID        string `json:"id,omitempty"`
	Key       string `json:"key"`
	Name      string `json:"name"`
	Type      string `json:"type"`
	Limit     int64  `json:"limit"`
	Period    string `json:"period"`
	SoftLimit bool   `json:"softLimit"`
	CatalogID string `json:"catalogId,omitempty"`
}

type PlanSummary struct {
	ID            string `json:"id"`
	Name          string `json:"name"`
	Slug          string `json:"slug"`
	Description   string `json:"description,omitempty"`
	Currency      string `json:"currency,omitempty"`
	Status        string `json:"status"`
	TrialDays     int    `json:"trialDays,omitempty"`
	BaseAmount    int64  `json:"baseAmount"`
	BillingPeriod string `json:"billingPeriod,omitempty"`
}

type PlansListResponse struct {
	Plans []PlanSummary `json:"plans"`
}

type PriceTierSummary struct {
	FeatureKey string `json:"featureKey"`
	Type       string `json:"type"`
	UpTo       int64  `json:"upTo"`
	UnitAmount int64  `json:"unitAmount"`
	FlatAmount int64  `json:"flatAmount"`
}

type SubscriptionService interface {
	ListPlans(ctx context.Context, appID string) ([]*plan.Plan, error)
	GetPlan(ctx context.Context, planID ledgerid.PlanID) (*plan.Plan, error)
	CreatePlan(ctx context.Context, p *plan.Plan) error
	UpdatePlan(ctx context.Context, p *plan.Plan) error
	ArchivePlan(ctx context.Context, planID ledgerid.PlanID) error
	ActivatePlan(ctx context.Context, planID ledgerid.PlanID) error
	ListSubscriptions(ctx context.Context, tenantID, appID string, opts subscription.ListOpts) ([]*subscription.Subscription, error)
	GetSubscription(ctx context.Context, subID ledgerid.SubscriptionID) (*subscription.Subscription, error)
	GetActiveSubscription(ctx context.Context, tenantID, appID string) (*subscription.Subscription, error)
	Subscribe(ctx context.Context, tenantID string, planID ledgerid.PlanID, appID string) (*subscription.Subscription, error)
	ChangePlan(ctx context.Context, subID ledgerid.SubscriptionID, newPlanID ledgerid.PlanID) error
	PauseSubscription(ctx context.Context, subID ledgerid.SubscriptionID) error
	ResumeSubscription(ctx context.Context, subID ledgerid.SubscriptionID) error
	CancelSubscription(ctx context.Context, subID ledgerid.SubscriptionID, immediately bool) error
	ListAllInvoices(ctx context.Context, appID string) ([]*invoice.Invoice, error)
	ListInvoices(ctx context.Context, tenantID, appID string) ([]*invoice.Invoice, error)
	GetInvoice(ctx context.Context, invID ledgerid.InvoiceID) (*invoice.Invoice, error)
	GenerateInvoice(ctx context.Context, subID ledgerid.SubscriptionID) (*invoice.Invoice, error)
	MarkInvoicePaid(ctx context.Context, invID ledgerid.InvoiceID, paymentRef string) error
	MarkInvoiceVoided(ctx context.Context, invID ledgerid.InvoiceID, reason string) error
	ListCoupons(ctx context.Context, appID string) ([]*coupon.Coupon, error)
	GetCoupon(ctx context.Context, code, appID string) (*coupon.Coupon, error)
	CreateCoupon(ctx context.Context, c *coupon.Coupon) error
	DeleteCoupon(ctx context.Context, couponID ledgerid.CouponID) error
	ListCatalogFeatures(ctx context.Context, appID string) ([]*feature.Feature, error)
	GetCatalogFeature(ctx context.Context, featureID ledgerid.FeatureID) (*feature.Feature, error)
	CreateCatalogFeature(ctx context.Context, f *feature.Feature) error
	UpdateCatalogFeature(ctx context.Context, f *feature.Feature) error
	ArchiveCatalogFeature(ctx context.Context, featureID ledgerid.FeatureID) error
}

type SubscriptionSummary struct {
	ID                 string `json:"id"`
	TenantID           string `json:"tenantId"`
	PlanID             string `json:"planId"`
	Status             string `json:"status"`
	CurrentPeriodStart string `json:"currentPeriodStart,omitempty"`
	CurrentPeriodEnd   string `json:"currentPeriodEnd,omitempty"`
	CancelAt           string `json:"cancelAt,omitempty"`
}

type SubscriptionsListInput struct {
	TenantID string `json:"tenantId"`
}

type SubscriptionsListResponse struct {
	Subscriptions []SubscriptionSummary `json:"subscriptions"`
}

type UsageSummary struct {
	FeatureKey  string `json:"featureKey"`
	FeatureName string `json:"featureName"`
	FeatureType string `json:"featureType"`
	Used        int64  `json:"used"`
	Limit       int64  `json:"limit"`
	Remaining   int64  `json:"remaining"`
	Period      string `json:"period"`
}