billing

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

type CheckoutCompleter interface {
	CompleteCheckout(ctx context.Context, ev payforge.Event) error
}

type CheckoutConfig struct {
	// Billing is the payment provider, usually a payforge/stripe client.
	Billing payforge.Billing
	// Connect sells listings for their creator organizations when the spec
	// has a marketplace. Without a marketplace a listing is sold as the
	// platform's own product.
	Connect payforge.Connect
	Spec    *pricingspec.Spec
	Store   *Store
	DB      *ent.Client
	// Listings, when set, enables listing checkout.
	Listings marketplace.ListingService
	// ListingProduct is the spec's seller-set product that a listing is sold
	// as, at the listing's price. Required with Listings.
	ListingProduct string
	// Purchases decides who may buy, and open the billing portal, for an
	// organization, for example marketplace.OrgRolePurchaseAuthorizer. It is
	// required: without it nobody could be allowed, so NewCheckout refuses.
	Purchases marketplace.PurchaseAuthorizer
	// Purchasers, when set, refuses managed principals.
	Purchasers marketplace.PurchaserChecker
	// Locker is held per organization around a listing checkout. Use the
	// lifecycle's Locker. A plan checkout is serialized by the payforge
	// Stripe client's own Config.Locker, which must be the same Locker.
	Locker payforge.Locker
	// Caller identifies the purchaser. It defaults to
	// marketplace.RequestPrincipalCaller.
	Caller marketplace.CallerResolver
	// Organization finds the organization the caller acts for. It defaults
	// to CredentialOrganization.
	Organization OrganizationResolver
	URLs         RedirectURLs
	// AllowedURLHosts are the hosts redirect URLs may name. Give the
	// payforge Stripe client the same list (stripe.Config.AllowedURLHosts),
	// which refuses any other host.
	AllowedURLHosts []string
	// Logger receives the causes of failures. It defaults to slog.Default().
	Logger *slog.Logger
}

type EventHandler interface {
	Handle(ctx context.Context, ev payforge.Event) (payforge.Result, error)
}

type Order struct {
	SessionID      string
	ListingID      uuid.UUID
	OrganizationID uuid.UUID
	PurchaserID    uuid.UUID
	AmountCents    int64
}

type OrganizationResolver func(r *http.Request) (uuid.UUID, error)

type PlanChange struct {
	OrganizationID uuid.UUID
	Entitlement    payforge.Entitlement
	Subscription   *marketplace.Subscription
}

type PlanSyncer interface {
	SyncSubscription(ctx context.Context, sub *marketplace.Subscription) error
}

type RedirectURLs struct {
	PlanSuccess    string
	PlanCancel     string
	ListingSuccess string
	ListingCancel  string
	PortalReturn   string
}

type Seller struct {
	OrganizationID   uuid.UUID
	AccountID        string
	ChargesEnabled   bool
	PayoutsEnabled   bool
	DetailsSubmitted bool
}

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

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

type SinkOption func(*Sink)

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

type StripeConfig struct {
	// SecretKey is the Stripe secret key. Its mode (test or live) is the
	// mode webhook events must match.
	SecretKey string
	// WebhookSecrets are the signing secrets of the webhook endpoints: one,
	// and a second for connected-account events when the spec has a
	// marketplace.
	WebhookSecrets []string
	// AllowedURLHosts are the hosts redirect URLs may name. Required; give
	// CheckoutConfig.AllowedURLHosts the same list.
	AllowedURLHosts []string
	// Locker is held per organization around a plan checkout. Required;
	// give the lifecycle and CheckoutConfig the same Locker.
	Locker payforge.Locker
}

type WebhookConfig struct {
	Reader    WebhookReader
	Lifecycle EventHandler
	// Store is the lifecycle's store. It finds the organization of a
	// checkout that names only a customer, and records completed checkouts
	// as processed.
	Store payforge.Store
	// Locker is held per organization, under payforge.LockKey, around a
	// completed checkout, as the lifecycle holds it around its own events.
	// Use the lifecycle's Locker; it defaults to that of a
	// *payforge.Lifecycle.
	Locker payforge.Locker
	// Checkouts, when set, receives one-time checkouts for marketplace
	// listings. Without it they are acknowledged and not recorded.
	Checkouts CheckoutCompleter
	// App is the pricing spec's app. A checkout for another app is
	// acknowledged and not passed to Checkouts. It defaults to the spec of
	// a *payforge.Lifecycle.
	App string
	// Logger receives one line per event. It defaults to slog.Default().
	Logger *slog.Logger
}

type WebhookReader interface {
	Read(r *http.Request) (payforge.Event, error)
}