stripe

type BillingPortalSession struct {
	URL string `json:"url"`
}

type CheckoutSession struct {
	SessionID string `json:"session_id"`
	URL       string `json:"url"`
}

type Config struct {
	// APIKey is the secret Stripe API key (e.g. sk_test_... or sk_live_...).
	APIKey string

	// WebhookSecret is the secret used to verify webhook signatures (whsec_...).
	WebhookSecret string

	// AutoCreateCustomerOnSignUp automatically provisions a Stripe Customer when a new user registers.
	AutoCreateCustomerOnSignUp bool

	// AutoCreateCustomerOnOrgCreation automatically provisions a Stripe Customer when a new organization is created.
	AutoCreateCustomerOnOrgCreation bool
}

type CreateCheckoutInput struct {
	Target     TargetReference `json:"target"`
	PriceID    string          `json:"price_id"`
	SuccessURL string          `json:"success_url"`
	CancelURL  string          `json:"cancel_url"`
	Mode       string          `json:"mode,omitempty"` // "subscription" or "payment"
	Seats      int64           `json:"seats,omitempty"`
	Metadata   map[string]any  `json:"metadata,omitempty"`
}

type Customer struct {
	ID               string         `json:"id"`
	ReferenceID      string         `json:"reference_id"`
	ReferenceType    ReferenceType  `json:"reference_type"`
	StripeCustomerID string         `json:"stripe_customer_id"`
	Email            string         `json:"email"`
	Metadata         map[string]any `json:"metadata,omitempty"`
	CreatedAt        time.Time      `json:"created_at"`
	UpdatedAt        time.Time      `json:"updated_at"`
}

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

type Option func(*Config)

type ReferenceType string

type Stripe interface {
	// GetCustomer retrieves the customer mapped to the target reference (user or organization).
	GetCustomer(ctx context.Context, target TargetReference) (*Customer, error)

	// CreateCustomer explicitly provisions a customer on Stripe and stores the local mapping.
	CreateCustomer(ctx context.Context, target TargetReference) (*Customer, error)

	// CreateCheckoutSession generates a Stripe Checkout Session for subscription or payment.
	CreateCheckoutSession(ctx context.Context, in CreateCheckoutInput) (*CheckoutSession, error)

	// CreateBillingPortalSession generates a customer portal URL for self-service subscription management.
	CreateBillingPortalSession(ctx context.Context, target TargetReference, returnURL string) (*BillingPortalSession, error)

	// GetActiveSubscription retrieves the current active subscription for the given target reference.
	GetActiveSubscription(ctx context.Context, target TargetReference) (*Subscription, error)

	// HasActiveSubscription reports whether the target identity has an active subscription matching any of the given price IDs.
	// If no price IDs are specified, any active subscription is accepted.
	HasActiveSubscription(ctx context.Context, target TargetReference, priceIDs ...string) (bool, error)

	// HandleWebhook processes an incoming Stripe webhook payload and verifies its signature in a transport-agnostic manner.
	HandleWebhook(ctx context.Context, payload []byte, signature string) (*WebhookEvent, error)
}

type Subscription struct {
	ID                   string             `json:"id"`
	CustomerID           string             `json:"customer_id"`
	ReferenceID          string             `json:"reference_id"`
	ReferenceType        ReferenceType      `json:"reference_type"`
	StripeSubscriptionID string             `json:"stripe_subscription_id"`
	StripePriceID        string             `json:"stripe_price_id"`
	Status               SubscriptionStatus `json:"status"`
	Seats                int64              `json:"seats,omitempty"`
	CancelAtPeriodEnd    bool               `json:"cancel_at_period_end"`
	CurrentPeriodStart   time.Time          `json:"current_period_start"`
	CurrentPeriodEnd     time.Time          `json:"current_period_end"`
	Metadata             map[string]any     `json:"metadata,omitempty"`
	CreatedAt            time.Time          `json:"created_at"`
	UpdatedAt            time.Time          `json:"updated_at"`
}

type SubscriptionStatus string

type TargetReference struct {
	Type ReferenceType `json:"type"`
	ID   string        `json:"id"`
}

type WebhookEvent struct {
	ID        string         `json:"id"`
	Type      string         `json:"type"`
	Data      map[string]any `json:"data"`
	HandledAt time.Time      `json:"handled_at"`
}