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)
	CreatePendingInvoiceLines(ctx context.Context, input CreatePendingInvoiceLinesInput) (*CreatePendingInvoiceLinesResult, 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 CreatePendingInvoiceLinesInput = billing.CreatePendingInvoiceLinesInput

type CreatePendingInvoiceLinesResult = billing.CreatePendingInvoiceLinesResult

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 ListChargesDeletedAtFilter string

type ListChargesInput struct {
	pagination.Page

	Namespace       string
	CustomerIDs     []string
	SubscriptionIDs []string
	ChargeTypes     []meta.ChargeType
	StatusIn        []meta.ChargeStatus
	StatusNotIn     []meta.ChargeStatus
	IncludeDeleted  bool
	// DeletedAtFilter selects which deleted-at field is used when IncludeDeleted is false.
	// Empty defaults to effective charge deletion.
	DeletedAtFilter ListChargesDeletedAtFilter

	// 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
}