client

type AddInvoiceLinesInput struct {
	StripeInvoiceID string
	Lines           []*stripe.InvoiceItemParams
}

type CreateCheckoutSessionInput struct {
	AppID            app.AppID
	CustomerID       customer.CustomerID
	StripeCustomerID string
	Options          api.CreateStripeCheckoutSessionRequestOptions
}

type CreateInvoiceInput struct {
	AppID                        app.AppID
	CustomerID                   customer.CustomerID
	InvoiceID                    string
	AutomaticTaxEnabled          bool
	CollectionMethod             billing.CollectionMethod
	Currency                     currencyx.Code
	DaysUntilDue                 *int64
	StatementDescriptor          *string
	StripeCustomerID             string
	StripeDefaultPaymentMethodID *string
}

type CreatePortalSessionInput struct {
	StripeCustomerID string
	ConfigurationID  *string
	ReturnURL        *string
	Locale           *string
}

type CreateStripeCustomerInput struct {
	AppID      app.AppID
	CustomerID customer.CustomerID

	Name  *string
	Email *string
}

type DeleteInvoiceInput struct {
	StripeInvoiceID string
}

type DeleteWebhookInput struct {
	AppID           app.AppID
	StripeWebhookID string
}

type FinalizeInvoiceInput struct {
	StripeInvoiceID string
	AutoAdvance     bool
}

type GetInvoiceInput struct {
	StripeInvoiceID string
}

type PortalSession struct {
	// The ID of the customer portal session.
	// See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-id
	ID string

	// Configuration Configuration used to customize the customer portal.
	// See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-configuration
	Configuration    *stripe.BillingPortalConfiguration
	CreatedAt        time.Time
	StripeCustomerID string

	// Livemode Livemode.
	Livemode bool

	// Locale Status.
	// The IETF language tag of the locale customer portal is displayed in.
	// See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-locale
	Locale string

	// ReturnUrl Return URL.
	// See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-return_url
	ReturnURL string

	// The URL to redirect the customer to after they have completed
	// their requested actions.
	URL string
}

type RemoveInvoiceLinesInput struct {
	StripeInvoiceID string
	Lines           []string
}

type SetupWebhookInput struct {
	AppID      app.AppID
	WebhookURL string
}

type StripeAccount struct {
	StripeAccountID string
	BusinessProfile *stripe.AccountBusinessProfile
	Country         models.CountryCode
}

type StripeAppClient interface {
	DeleteWebhook(ctx context.Context, input DeleteWebhookInput) error
	GetAccount(ctx context.Context) (StripeAccount, error)
	GetCustomer(ctx context.Context, stripeCustomerID string) (StripeCustomer, error)
	CreateCustomer(ctx context.Context, input CreateStripeCustomerInput) (StripeCustomer, error)
	CreateCheckoutSession(ctx context.Context, input CreateCheckoutSessionInput) (StripeCheckoutSession, error)
	GetPaymentMethod(ctx context.Context, stripePaymentMethodID string) (StripePaymentMethod, error)
	CreatePortalSession(ctx context.Context, input CreatePortalSessionInput) (PortalSession, error)
	// Invoice
	GetInvoice(ctx context.Context, input GetInvoiceInput) (*stripe.Invoice, error)
	CreateInvoice(ctx context.Context, input CreateInvoiceInput) (*stripe.Invoice, error)
	UpdateInvoice(ctx context.Context, input UpdateInvoiceInput) (*stripe.Invoice, error)
	DeleteInvoice(ctx context.Context, input DeleteInvoiceInput) error
	FinalizeInvoice(ctx context.Context, input FinalizeInvoiceInput) (*stripe.Invoice, error)
	// Invoice Line
	ListInvoiceLineItems(ctx context.Context, stripeInvoiceID string) ([]*stripe.InvoiceLineItem, error)
	AddInvoiceLines(ctx context.Context, input AddInvoiceLinesInput) ([]StripeInvoiceItemWithLineID, error)
	UpdateInvoiceLines(ctx context.Context, input UpdateInvoiceLinesInput) ([]*stripe.InvoiceItem, error)
	RemoveInvoiceLines(ctx context.Context, input RemoveInvoiceLinesInput) error
}

type StripeAppClientConfig struct {
	AppService app.Service
	AppID      app.AppID
	APIKey     string
	Logger     *slog.Logger
}

type StripeAppClientFactory = func(config StripeAppClientConfig) (StripeAppClient, error)

type StripeCheckoutSession struct {
	CancelURL         *string
	ClientSecret      *string
	ClientReferenceID *string
	CustomerEmail     *string
	Currency          *currencyx.Code
	CreatedAt         time.Time
	ExpiresAt         *time.Time
	Mode              stripe.CheckoutSessionMode
	Metadata          *map[string]string
	ReturnURL         *string
	SessionID         string
	SetupIntentID     string
	Status            *stripe.CheckoutSessionStatus
	SuccessURL        *string
	URL               *string
}

type StripeClient interface {
	GetAccount(ctx context.Context) (StripeAccount, error)
	SetupWebhook(ctx context.Context, input SetupWebhookInput) (StripeWebhookEndpoint, error)
}

type StripeClientConfig struct {
	Namespace string
	APIKey    string
	Logger    *slog.Logger
}

type StripeClientFactory = func(config StripeClientConfig) (StripeClient, error)

type StripeCustomer struct {
	StripeCustomerID string
	Name             *string
	Currency         *string
	Email            *string
	// ID of a payment method that’s attached to the customer,
	// to be used as the customer’s default payment method for invoices.
	DefaultPaymentMethod *StripePaymentMethod
	Tax                  *StripeCustomerTax
}

type StripeCustomerAutomaticTax string

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

type StripeCustomerTax struct {
	AutomaticTax StripeCustomerAutomaticTax
}

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

type StripeInvoiceItemWithID struct {
	*stripe.InvoiceItemParams

	ID string
}

type StripeInvoiceItemWithLineID struct {
	*stripe.InvoiceItem

	LineID string
}

type StripePaymentMethod struct {
	ID               string
	StripeCustomerID *string
	Name             string
	Email            string
	BillingAddress   *models.Address
}

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

type StripeWebhookEndpoint struct {
	EndpointID string
	Secret     string
}

type UpdateInvoiceInput struct {
	AutomaticTaxEnabled bool
	StripeInvoiceID     string
	StatementDescriptor *string
}

type UpdateInvoiceLinesInput struct {
	StripeInvoiceID string
	Lines           []*StripeInvoiceItemWithID
}