charges

type Adapter interface {
	ChargesSearchAdapter

	entutils.TxCreator
}

type AdvanceChargesEvent struct {
	Namespace  string `json:"namespace"`
	CustomerID string `json:"customer_id"`
}

type AdvanceChargesInput struct {
	Customer customer.CustomerID
}

type ApplyPatchesInput struct {
	CustomerID customer.CustomerID
	Creates    ChargeIntents

	// PatchesByChargeID is a map of charge ID to the patches to apply to the charge. This format is used to make sure
	// there's only a single patch affecting a single charge.
	PatchesByChargeID map[string]Patch
}

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

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

type ChargeIntents []ChargeIntent

type ChargeIntentsByType struct {
	FlatFee        []WithIndex[flatfee.Intent]
	CreditPurchase []WithIndex[creditpurchase.Intent]
	UsageBased     []WithIndex[usagebased.Intent]
}

type ChargeSearchItem struct {
	ID         meta.ChargeID
	Type       meta.ChargeType
	CustomerID string
}

type ChargeSearchItems []ChargeSearchItem

type ChargeService interface {
	GetByID(ctx context.Context, input GetByIDInput) (Charge, error)
	GetByIDs(ctx context.Context, input GetByIDsInput) (Charges, error)
	Create(ctx context.Context, input CreateInput) (Charges, error)
	UpdateSubscriptionItemID(ctx context.Context, charge Charge, newSubscriptionItemID string) (Charge, error)

	AdvanceCharges(ctx context.Context, input AdvanceChargesInput) (Charges, error)
	ListCustomersToAdvance(ctx context.Context, input ListCustomersToAdvanceInput) (pagination.Result[customer.CustomerID], error)
	// ApplyPatches currently returns no affected-charge payload. If exact post-apply
	// results are needed, shrink/extend must first be implemented properly instead of
	// going through the temporary delete+create remap.
	ApplyPatches(ctx context.Context, input ApplyPatchesInput) error
	ListCharges(ctx context.Context, input ListChargesInput) (pagination.Result[Charge], error)
}

type Charges []Charge

type ChargesSearchAdapter interface {
	GetByIDs(ctx context.Context, input GetByIDsInput) (ChargeSearchItems, error)
	ListCharges(ctx context.Context, input ListChargesInput) (pagination.Result[ChargeSearchItem], error)
	ListCustomersToAdvance(ctx context.Context, input ListCustomersToAdvanceInput) (pagination.Result[customer.CustomerID], error)
}

type CreateInput struct {
	Namespace string
	Intents   ChargeIntents
}

type CreditPurchaseFacadeService interface {
	HandleCreditPurchaseExternalPaymentStateTransition(ctx context.Context, input HandleCreditPurchaseExternalPaymentStateTransitionInput) (creditpurchase.Charge, error)
}

type GetByIDInput struct {
	ChargeID meta.ChargeID
	Expands  meta.Expands
}

type GetByIDsInput struct {
	Namespace string
	IDs       []string
	Expands   meta.Expands
}

type HandleCreditPurchaseExternalPaymentStateTransitionInput struct {
	ChargeID meta.ChargeID

	TargetPaymentState payment.Status
}

type ListChargesInput struct {
	pagination.Page

	Namespace       string
	CustomerIDs     []string
	SubscriptionIDs []string
	ChargeTypes     []meta.ChargeType
	StatusIn        []meta.ChargeStatus
	StatusNotIn     []meta.ChargeStatus
	IncludeDeleted  bool

	// OrderBy is the field to sort by. Supported values: id, created_at,
	// service_period.from, billing_period.from.
	// Defaults to created_at when empty.
	OrderBy string
	Order   sortx.Order

	Expands meta.Expands
}

type ListCustomersToAdvanceInput struct {
	pagination.Page

	Namespaces      []string
	AdvanceAfterLTE time.Time
}

type Patch = meta.Patch

type Service interface {
	ChargeService

	// Facade interfaces provide convinience helpers for the API layer.
	CreditPurchaseFacadeService
}

type WithIndex[T any] struct {
	Index int
	Value T
}