appstripe

type Adapter interface {
	AppStripeAdapter

	entutils.TxCreator
}

type App struct {
	Meta

	Logger *slog.Logger `json:"-"`

	AppService             app.Service                         `json:"-"`
	BillingService         billing.Service                     `json:"-"`
	StripeAppClientFactory stripeclient.StripeAppClientFactory `json:"-"`
	StripeAppService       Service                             `json:"-"`
	SecretService          secret.Service                      `json:"-"`
}

type AppBase struct {
	app.AppBase
	AppData
}

type AppCheckoutSessionEvent struct {
	SessionID  string  `json:"sessionId"`
	Namespace  string  `json:"namespace"`
	AppID      string  `json:"appId"`
	CustomerID string  `json:"customerId"`
	UserID     *string `json:"userId,omitempty"`
}

type AppData struct {
	StripeAccountID string                `json:"stripeAccountId"`
	Livemode        bool                  `json:"livemode"`
	APIKey          secretentity.SecretID `json:"-"`
	MaskedAPIKey    string                `json:"maskedApiKey"`
	StripeWebhookID string                `json:"stripeWebhookId"`
	WebhookSecret   secretentity.SecretID `json:"-"`
}

type AppFactoryService interface {
	// App Factory methods
	NewApp(ctx context.Context, appBase app.AppBase) (app.App, error)
	InstallAppWithAPIKey(ctx context.Context, input app.AppFactoryInstallAppWithAPIKeyInput) (app.App, error)
	UninstallApp(ctx context.Context, input app.UninstallAppInput) error
}

type AppStripeAdapter interface {
	GetStripeClientFactory() client.StripeClientFactory
	GetStripeAppClientFactory() client.StripeAppClientFactory

	UpdateAPIKey(ctx context.Context, input UpdateAPIKeyAdapterInput) error
	CreateCheckoutSession(ctx context.Context, input CreateCheckoutSessionInput) (CreateCheckoutSessionOutput, error)
	GetWebhookSecret(ctx context.Context, input GetWebhookSecretInput) (GetWebhookSecretOutput, error)
	// App
	CreateStripeApp(ctx context.Context, input CreateAppStripeInput) (AppBase, error)
	GetStripeAppData(ctx context.Context, input GetStripeAppDataInput) (AppData, error)
	DeleteStripeAppData(ctx context.Context, input DeleteStripeAppDataInput) error
	// Billing
	GetSupplierContact(ctx context.Context, input GetSupplierContactInput) (billing.SupplierContact, error)
	GetStripeInvoice(ctx context.Context, input GetStripeInvoiceInput) (*stripe.Invoice, error)
	// Customer
	GetStripeCustomerData(ctx context.Context, input GetStripeCustomerDataInput) (CustomerData, error)
	UpsertStripeCustomerData(ctx context.Context, input UpsertStripeCustomerDataInput) error
	DeleteStripeCustomerData(ctx context.Context, input DeleteStripeCustomerDataInput) error
	SetCustomerDefaultPaymentMethod(ctx context.Context, input SetCustomerDefaultPaymentMethodInput) (SetCustomerDefaultPaymentMethodOutput, error)
	// Portal
	CreatePortalSession(ctx context.Context, input CreateStripePortalSessionInput) (StripePortalSession, error)
}

type BillingService interface {
	GetSupplierContact(ctx context.Context, input GetSupplierContactInput) (billing.SupplierContact, error)

	// Invoice webhook handlers
	HandleInvoiceStateTransition(ctx context.Context, input HandleInvoiceStateTransitionInput) error
	HandleInvoiceSentEvent(ctx context.Context, input HandleInvoiceSentEventInput) error
}

type Configuration struct {
	SecretAPIKey *string
}

type CreateAppStripeInput struct {
	app.CreateAppInput

	StripeAccountID string
	Livemode        bool
	APIKey          secretentity.SecretID
	MaskedAPIKey    string
	StripeWebhookID string
	WebhookSecret   secretentity.SecretID
}

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

type CreateCheckoutSessionOutput struct {
	AppID            app.AppID
	CustomerID       customer.CustomerID
	StripeCustomerID string

	client.StripeCheckoutSession
}

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

	Name  *string
	Email *string
}

type CreateStripeCustomerOutput struct {
	StripeCustomerID string
}

type CreateStripePortalSessionInput struct {
	AppID           app.AppID
	CustomerID      customer.CustomerID
	Locale          *string
	ConfigurationID *string
	ReturnURL       *string
}

type CustomerData struct {
	StripeCustomerID             string
	StripeDefaultPaymentMethodID *string
}

type CustomerService interface {
	GetStripeCustomerData(ctx context.Context, input GetStripeCustomerDataInput) (CustomerData, error)
	UpsertStripeCustomerData(ctx context.Context, input UpsertStripeCustomerDataInput) error
	DeleteStripeCustomerData(ctx context.Context, input DeleteStripeCustomerDataInput) error
	HandleSetupIntentSucceeded(ctx context.Context, input HandleSetupIntentSucceededInput) (HandleSetupIntentSucceededOutput, error)

	CreateCheckoutSession(ctx context.Context, input CreateCheckoutSessionInput) (CreateCheckoutSessionOutput, error)
	CreatePortalSession(ctx context.Context, input CreateStripePortalSessionInput) (StripePortalSession, error)
}

type DeleteStripeAppDataInput struct {
	AppID app.AppID
}

type DeleteStripeCustomerDataInput struct {
	AppID      *app.AppID
	CustomerID *customer.CustomerID
}

type GetAppInput = app.AppID

type GetStripeAppDataInput struct {
	AppID app.AppID
}

type GetStripeCustomerDataInput struct {
	AppID      app.AppID
	CustomerID customer.CustomerID
}

type GetStripeInvoiceInput struct {
	AppID           app.AppID
	StripeInvoiceID string
}

type GetSupplierContactInput struct {
	AppID app.AppID
}

type GetWebhookSecretInput struct {
	AppID string
}

type GetWebhookSecretOutput = secretentity.Secret

type HandleInvoiceSentEventInput struct {
	AppID   app.AppID
	Invoice stripe.Invoice
	SentAt  int64
}

type HandleInvoiceStateTransitionInput struct {
	AppID   app.AppID
	Invoice stripe.Invoice

	// Trigger is the state machine trigger that will be used to transition the invoice
	Trigger billing.InvoiceTrigger
	// TargetStatus specifies the expected status of the invoice after the transition, needed to filter
	// for duplicate events as the state machine doesn't allow transition into the same state
	TargetStatuses []billing.StandardInvoiceStatus

	// IgnoreInvoiceInStatus is a list of invoice statuses. If the invoice is in this status we ignore the event
	// this allows to filter for out of order events.
	IgnoreInvoiceInStatus []billing.StandardInvoiceStatusMatcher
	// ShouldTriggerOnEvent gets the *current* stripe invoice and returns true if the state machine should be triggered
	// useful for filtering late events based on the current state (optional)
	ShouldTriggerOnEvent func(*stripe.Invoice) (bool, error)

	// Validation errors
	// GetValidationErrors is invoked with the current stripe invoice and returns the validation errors if any
	GetValidationErrors func(*stripe.Invoice) (*ValidationErrorsInput, error)
}

type HandleSetupIntentSucceededInput struct {
	SetCustomerDefaultPaymentMethodInput

	PaymentIntentMetadata map[string]string
}

type HandleSetupIntentSucceededOutput struct {
	CustomerID customer.CustomerID
}

type Meta struct {
	app.AppBase
	AppData
}

type Service interface {
	AppFactoryService
	StripeAppService
	CustomerService
	BillingService
}

type SetCustomerDefaultPaymentMethodInput struct {
	AppID            app.AppID
	StripeCustomerID string
	PaymentMethodID  string
}

type SetCustomerDefaultPaymentMethodOutput struct {
	CustomerID customer.CustomerID
}

type StripeAppService interface {
	UpdateAPIKey(ctx context.Context, input UpdateAPIKeyInput) error
	GetStripeAppData(ctx context.Context, input GetStripeAppDataInput) (AppData, error)
	GetWebhookSecret(ctx context.Context, input GetWebhookSecretInput) (GetWebhookSecretOutput, error)
}

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

type StripeInvoiceLineOperationParams interface {
	stripe.InvoiceItemParams | stripeclient.StripeInvoiceItemWithID
}

type StripePortalSession 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 UpdateAPIKeyAdapterInput struct {
	UpdateAPIKeyInput

	MaskedAPIKey string
}

type UpdateAPIKeyInput struct {
	AppID  app.AppID
	APIKey string
}

type UpsertStripeCustomerDataInput struct {
	AppID                        app.AppID
	CustomerID                   customer.CustomerID
	StripeCustomerID             string
	StripeDefaultPaymentMethodID *string
}

type ValidationErrorsInput struct {
	Op     billing.StandardInvoiceOperation
	Errors []*stripe.Error
}