app

type Adapter interface {
	AppAdapter

	entutils.TxCreator
}

type App interface {
	GetAppBase() AppBase
	GetID() AppID
	GetType() AppType
	GetName() string
	GetDescription() *string
	GetStatus() AppStatus
	GetMetadata() map[string]string
	GetListing() MarketplaceListing

	// ValidateCapabilities validates if the app can run for the given capabilities
	ValidateCapabilities(capabilities ...CapabilityType) error

	// Customer data
	GetCustomerData(ctx context.Context, input GetAppInstanceCustomerDataInput) (CustomerData, error)
	UpsertCustomerData(ctx context.Context, input UpsertAppInstanceCustomerDataInput) error
	DeleteCustomerData(ctx context.Context, input DeleteAppInstanceCustomerDataInput) error
}

type AppAdapter interface {
	// Marketplace
	RegisterMarketplaceListing(input RegisterMarketplaceListingInput) error
	GetMarketplaceListing(ctx context.Context, input MarketplaceGetInput) (RegistryItem, error)
	ListMarketplaceListings(ctx context.Context, input MarketplaceListInput) (pagination.PagedResponse[RegistryItem], error)
	InstallMarketplaceListingWithAPIKey(ctx context.Context, input InstallAppWithAPIKeyInput) (App, error)
	GetMarketplaceListingOauth2InstallURL(ctx context.Context, input GetOauth2InstallURLInput) (GetOauth2InstallURLOutput, error)
	AuthorizeMarketplaceListingOauth2Install(ctx context.Context, input AuthorizeOauth2InstallInput) error

	// Installed app
	CreateApp(ctx context.Context, input CreateAppInput) (AppBase, error)
	GetApp(ctx context.Context, input GetAppInput) (App, error)
	GetDefaultApp(ctx context.Context, input GetDefaultAppInput) (App, error)
	UpdateApp(ctx context.Context, input UpdateAppInput) (App, error)
	ListApps(ctx context.Context, input ListAppInput) (pagination.PagedResponse[App], error)
	UninstallApp(ctx context.Context, input UninstallAppInput) error
	UpdateAppStatus(ctx context.Context, input UpdateAppStatusInput) error

	// Customer data
	ListCustomerData(ctx context.Context, input ListCustomerInput) (pagination.PagedResponse[CustomerApp], error)
	EnsureCustomer(ctx context.Context, input EnsureCustomerInput) error
	DeleteCustomer(ctx context.Context, input DeleteCustomerInput) error
}

type AppBase struct {
	models.ManagedResource

	Type     AppType            `json:"type"`
	Status   AppStatus          `json:"status"`
	Default  bool               `json:"default"`
	Listing  MarketplaceListing `json:"listing"`
	Metadata map[string]string  `json:"metadata,omitempty"`
}

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

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

type AppFactory interface {
	NewApp(context.Context, AppBase) (App, error)
	InstallAppWithAPIKey(ctx context.Context, input AppFactoryInstallAppWithAPIKeyInput) (App, error)
	UninstallApp(ctx context.Context, input UninstallAppInput) error
}

type AppFactoryInstallAppWithAPIKeyInput struct {
	Namespace string
	APIKey    string
	BaseURL   string
	Name      string
}

type AppID struct {
	Namespace string
	ID        string
}

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

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

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

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

type AppService interface {
	// Marketplace
	RegisterMarketplaceListing(input RegisterMarketplaceListingInput) error
	GetMarketplaceListing(ctx context.Context, input MarketplaceGetInput) (RegistryItem, error)
	ListMarketplaceListings(ctx context.Context, input MarketplaceListInput) (pagination.PagedResponse[RegistryItem], error)
	InstallMarketplaceListingWithAPIKey(ctx context.Context, input InstallAppWithAPIKeyInput) (App, error)
	GetMarketplaceListingOauth2InstallURL(ctx context.Context, input GetOauth2InstallURLInput) (GetOauth2InstallURLOutput, error)
	AuthorizeMarketplaceListingOauth2Install(ctx context.Context, input AuthorizeOauth2InstallInput) error

	// Installed app
	CreateApp(ctx context.Context, input CreateAppInput) (AppBase, error)
	GetApp(ctx context.Context, input GetAppInput) (App, error)
	UpdateAppStatus(ctx context.Context, input UpdateAppStatusInput) error
	GetDefaultApp(ctx context.Context, input GetDefaultAppInput) (App, error)
	UpdateApp(ctx context.Context, input UpdateAppInput) (App, error)
	ListApps(ctx context.Context, input ListAppInput) (pagination.PagedResponse[App], error)
	UninstallApp(ctx context.Context, input UninstallAppInput) error

	// Customer data
	ListCustomerData(ctx context.Context, input ListCustomerInput) (pagination.PagedResponse[CustomerApp], error)
	EnsureCustomer(ctx context.Context, input EnsureCustomerInput) error
	DeleteCustomer(ctx context.Context, input DeleteCustomerInput) error
}

type AppStatus string

type AppType string

type AuthorizeOauth2InstallInput struct {
	MarketplaceListingID

	Code string
	// Success response fields
	State string
	// Error response fields
	Error            string
	ErrorDescription string
	ErrorURI         string
}

type Capability struct {
	Type        CapabilityType `json:"type"`
	Key         string         `json:"key"`
	Name        string         `json:"name"`
	Description string         `json:"description"`
}

type CapabilityType string

type CreateAppInput struct {
	// AppID is optional. If not provided, a new AppID will be generated by the database
	ID          *AppID
	Namespace   string
	Name        string
	Description string
	Type        AppType
}

type CustomerApp struct {
	App          App
	CustomerData CustomerData
}

type CustomerData interface {
	Validate() error
}

type DeleteAppInstanceCustomerDataInput struct {
	CustomerID customer.CustomerID
}

type DeleteCustomerInput struct {
	AppID      *AppID
	CustomerID *customer.CustomerID
}

type EnsureCustomerInput struct {
	AppID      AppID
	CustomerID customer.CustomerID
}

type GetAppInput = AppID

type GetAppInstanceCustomerDataInput struct {
	CustomerID customer.CustomerID
}

type GetDefaultAppInput struct {
	Namespace string
	Type      AppType
}

type GetOauth2InstallURLInput = MarketplaceListingID

type GetOauth2InstallURLOutput struct {
	URL string
}

type InstallAppWithAPIKeyInput struct {
	MarketplaceListingID

	Namespace string
	APIKey    string
	Name      string
}

type ListAppInput struct {
	Namespace string
	pagination.Page

	Type           *AppType
	IncludeDeleted bool
	// Only list apps that has data for the given customer
	CustomerID *customer.CustomerID
}

type ListCustomerInput struct {
	pagination.Page
	CustomerID customer.CustomerID
	Type       *AppType
}

type MarketplaceGetInput = MarketplaceListingID

type MarketplaceListInput struct {
	pagination.Page
}

type MarketplaceListing struct {
	Type         AppType      `json:"type"`
	Name         string       `json:"name"`
	Description  string       `json:"description"`
	Capabilities []Capability `json:"capabilities"`
}

type MarketplaceListingID struct {
	Type AppType
}

type RegisterMarketplaceListingInput = RegistryItem

type RegistryItem struct {
	Listing MarketplaceListing
	Factory AppFactory
}

type Service interface {
	AppService
}

type UninstallAppInput = AppID

type UpdateAppInput struct {
	AppID       AppID
	Name        string
	Description *string
	Default     bool
	Metadata    *map[string]string
}

type UpdateAppStatusInput struct {
	ID     AppID
	Status AppStatus
}

type UpsertAppInstanceCustomerDataInput struct {
	CustomerID customer.CustomerID
	Data       CustomerData
}