subscription

type CancelSubscriptionRequest struct {
	SubID       string `path:"subId"`
	Immediately bool   `json:"immediately"`
}

type ChangePlanRequest struct {
	SubID     string `path:"subId"`
	NewPlanID string `json:"new_plan_id"`
}

type CheckEntitlementRequest struct {
	FeatureKey string `path:"featureKey"`
}

type Config struct {
	// PathPrefix is the HTTP path prefix for billing routes.
	// Defaults to "/v1/billing".
	PathPrefix string

	// DefaultPlanSlug is the plan slug to auto-assign to new tenants.
	// If empty, no auto-subscription occurs unless overridden by settings.
	DefaultPlanSlug string

	// AutoSubscribeOnOrg creates a subscription when an organization is created.
	// Only applies when tenant mode is "organization".
	AutoSubscribeOnOrg bool

	// AutoSubscribeOnUser creates a subscription when a user signs up.
	// Only applies when tenant mode is "user".
	AutoSubscribeOnUser bool

	// TrialDays is the default trial period for new subscriptions.
	// 0 means no trial. Can be overridden by settings.
	TrialDays int

	// AllowSelfService lets users/orgs change their own plan.
	AllowSelfService bool
}

type CouponResponse struct {
	ID             string  `json:"id"`
	Code           string  `json:"code"`
	Name           string  `json:"name"`
	Type           string  `json:"type"`
	Amount         string  `json:"amount,omitempty"`
	Percentage     int     `json:"percentage,omitempty"`
	Currency       string  `json:"currency"`
	MaxRedemptions int     `json:"max_redemptions"`
	TimesRedeemed  int     `json:"times_redeemed"`
	ValidFrom      *string `json:"valid_from,omitempty"`
	ValidUntil     *string `json:"valid_until,omitempty"`
	AppID          string  `json:"app_id"`
}

type CreateCouponRequest struct {
	Code           string  `json:"code"`
	Name           string  `json:"name"`
	Type           string  `json:"type"`
	Amount         int64   `json:"amount"`
	Percentage     int     `json:"percentage"`
	Currency       string  `json:"currency"`
	MaxRedemptions int     `json:"max_redemptions"`
	ValidFrom      *string `json:"valid_from,omitempty"`
	ValidUntil     *string `json:"valid_until,omitempty"`
	AppID          string  `json:"app_id"`
}

type CreatePlanRequest struct {
	Name        string            `json:"name"`
	Slug        string            `json:"slug"`
	Description string            `json:"description"`
	Currency    string            `json:"currency"`
	TrialDays   int               `json:"trial_days"`
	BaseAmount  int64             `json:"base_amount"`
	Period      string            `json:"period"`
	AppID       string            `json:"app_id"`
	IsAddon     bool              `json:"is_addon"`
	Features    []FeatureInput    `json:"features,omitempty"`
	Metadata    map[string]string `json:"metadata,omitempty"`
}

type CreateSubscriptionRequest struct {
	TenantID string `json:"tenant_id"`
	PlanID   string `json:"plan_id"`
	AppID    string `json:"app_id"`
}

type DeleteCouponRequest struct {
	CouponID string `path:"couponId"`
}

type EntitlementResponse struct {
	Allowed   bool   `json:"allowed"`
	Feature   string `json:"feature"`
	Used      int64  `json:"used"`
	Limit     int64  `json:"limit"`
	Remaining int64  `json:"remaining"`
	Reason    string `json:"reason,omitempty"`
}

type FeatureInput struct {
	Key       string `json:"key"`
	Name      string `json:"name"`
	Type      string `json:"type"`
	Limit     int64  `json:"limit"`
	Period    string `json:"period"`
	SoftLimit bool   `json:"soft_limit"`
}

type GetActiveSubRequest struct {
	AppID    string `query:"app_id"`
	TenantID string `query:"tenant_id"`
}

type GetInvoiceRequest struct {
	InvoiceID string `path:"invoiceId"`
}

type GetPlanRequest struct {
	PlanID string `path:"planId"`
}

type InvoiceIDRequest struct {
	InvoiceID string `path:"invoiceId"`
}

type InvoiceResponse struct {
	ID             string `json:"id"`
	TenantID       string `json:"tenant_id"`
	SubscriptionID string `json:"subscription_id"`
	Status         string `json:"status"`
	Currency       string `json:"currency"`
	Total          string `json:"total"`
	PeriodStart    string `json:"period_start"`
	PeriodEnd      string `json:"period_end"`
}

type ListCouponsRequest struct {
	AppID string `query:"app_id"`
}

type ListCouponsResponse struct {
	Coupons []CouponResponse `json:"coupons"`
	Total   int              `json:"total"`
}

type ListInvoicesRequest struct {
	AppID    string `query:"app_id"`
	TenantID string `query:"tenant_id"`
}

type ListInvoicesResponse struct {
	Invoices []InvoiceResponse `json:"invoices"`
	Total    int               `json:"total"`
}

type ListPlansRequest struct {
	AppID string `query:"app_id"`
}

type ListPlansResponse struct {
	Plans []PlanResponse `json:"plans"`
	Total int            `json:"total"`
}

type ListSubscriptionsRequest struct {
	AppID    string `query:"app_id"`
	TenantID string `query:"tenant_id"`
	Status   string `query:"status,omitempty"`
}

type ListSubscriptionsResponse struct {
	Subscriptions []Response `json:"subscriptions"`
	Total         int        `json:"total"`
}

type MarkInvoicePaidRequest struct {
	InvoiceID  string `path:"invoiceId"`
	PaymentRef string `json:"payment_ref"`
}

type PlanIDRequest struct {
	PlanID string `path:"planId"`
}

type PlanResponse struct {
	ID            string            `json:"id"`
	Name          string            `json:"name"`
	Slug          string            `json:"slug"`
	Description   string            `json:"description"`
	Currency      string            `json:"currency"`
	Status        string            `json:"status"`
	TrialDays     int               `json:"trial_days"`
	BaseAmount    string            `json:"base_amount,omitempty"`
	BillingPeriod string            `json:"billing_period,omitempty"`
	FeaturesCount int               `json:"features_count"`
	IsAddon       bool              `json:"is_addon"`
	AppID         string            `json:"app_id"`
	Metadata      map[string]string `json:"metadata,omitempty"`
}

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

type Response struct {
	ID                 string  `json:"id"`
	TenantID           string  `json:"tenant_id"`
	PlanID             string  `json:"plan_id"`
	Status             string  `json:"status"`
	CurrentPeriodStart string  `json:"current_period_start"`
	CurrentPeriodEnd   string  `json:"current_period_end"`
	TrialStart         *string `json:"trial_start,omitempty"`
	TrialEnd           *string `json:"trial_end,omitempty"`
	CanceledAt         *string `json:"canceled_at,omitempty"`
	AppID              string  `json:"app_id"`
}

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

type SubIDRequest struct {
	SubID string `path:"subId"`
}

type UsageItemResponse struct {
	FeatureKey  string `json:"feature_key"`
	FeatureName string `json:"feature_name"`
	FeatureType string `json:"feature_type"`
	Used        int64  `json:"used"`
	Limit       int64  `json:"limit"`
	Remaining   int64  `json:"remaining"`
	Period      string `json:"period"`
}

type UsageSummary struct {
	FeatureKey  string
	FeatureName string
	FeatureType string
	Used        int64
	Limit       int64
	Remaining   int64
	Period      string
}

type UsageSummaryRequest struct {
	AppID    string `query:"app_id"`
	TenantID string `query:"tenant_id"`
}

type UsageSummaryResponse struct {
	Usage []UsageItemResponse `json:"usage"`
}

type VoidInvoiceRequest struct {
	InvoiceID string `path:"invoiceId"`
	Reason    string `json:"reason"`
}