types

type APIKey struct {
	ID        string         `json:"id"`
	ApiKey    string         `json:"apiKey"`
	PluginID  types.PluginID `json:"pluginId"`
	Status    int64          `json:"status"`
	ExpiresAt *time.Time     `json:"expires_at"`
}

type CreditMetadata struct {
	DebitFeeID      uint64 `json:"debit_fee_id"`     // ID of the debit transaction
	TransactionHash string `json:"transaction_hash"` // Transaction hash in blockchain
	Network         string `json:"network"`          // Blockchain network (e.g., "ethereum", "polygon")
}

type FAQItem struct {
	Question string `json:"question" yaml:"question,omitempty"`
	Answer   string `json:"answer"  yaml:"answer,omitempty"`
}

type FeeAsset struct {
	Symbol   string `json:"symbol"`
	Addr     string `json:"addr"`
	Decimals uint8  `json:"decimals"`
	Network  string `json:"network"`
}

type FeeHistoryPaginatedList struct {
	History    []PluginFeeResponse `json:"history"`
	TotalCount uint32              `json:"total_count"`
}

type FeeWithStatus struct {
	vtypes.Fee
	Status vtypes.FeeStatus
}

type PauseHistoryRecord struct {
	ID                uuid.UUID      `json:"id"`
	PluginID          types.PluginID `json:"plugin_id"`
	Action            string         `json:"action"`
	ReportCountWindow *int           `json:"report_count_window,omitempty"`
	ActiveUsers       *int           `json:"active_users,omitempty"`
	ThresholdRate     *float64       `json:"threshold_rate,omitempty"`
	Reason            *string        `json:"reason,omitempty"`
	TriggeredBy       *string        `json:"triggered_by,omitempty"`
	CreatedAt         time.Time      `json:"created_at"`
}

type Plugin struct {
	ID             types.PluginID  `json:"id" yaml:"id" validate:"required"`
	Title          string          `json:"title" yaml:"title" validate:"required"`
	Description    string          `json:"description" yaml:"description" validate:"required"`
	ServerEndpoint string          `json:"server_endpoint" yaml:"server_endpoint" validate:"required"`
	Category       PluginCategory  `json:"category_id" yaml:"category" validate:"required"`
	CreatedAt      time.Time       `json:"created_at" yaml:"-"`
	UpdatedAt      time.Time       `json:"updated_at" yaml:"-"`
	Pricing        []types.Pricing `json:"pricing,omitempty" yaml:"-"`                             // New field for multiple pricing options
	LogoURL        string          `json:"logo_url,omitempty" yaml:"logo_url,omitempty"`           // New field, should be validated once plugins have this data in db.
	ThumbnailURL   string          `json:"thumbnail_url,omitempty" yaml:"thumbnail_url,omitempty"` // New field, should be validated once plugins have this data in db.
	Images         []PluginImage   `json:"images,omitempty" yaml:"images,omitempty"`               // New field, should be validated once plugins have this data in db.
	FAQs           []FAQItem       `json:"faqs,omitempty" yaml:"faqs,omitempty"`
	Features       []string        `json:"features,omitempty" yaml:"features,omitempty"`
	Audited        bool            `json:"audited" yaml:"audited,omitempty"`
	RatesCount     int             `json:"rates_count" yaml:"-"`
	AvgRating      float64         `json:"avg_rating" yaml:"-"`
	Installations  int             `json:"installations" yaml:"-"`
}

type PluginAvgRatingDto struct {
	PluginID  string  `json:"plugin_id"`
	AvgRating float64 `json:"avg_rating"`
}

type PluginBillingSummary struct {
	PluginID    vtypes.PluginID `json:"plugin_id"`
	AppName     string          `json:"app_name"`
	Pricing     string          `json:"pricing"` // Formatted: "0.50 USDC one-time + 0.01 USDC per transaction"
	StartDate   time.Time       `json:"start_date"`
	NextPayment *time.Time      `json:"next_payment"` // nil for non-recurring
	TotalFees   string          `json:"total_fees"`
}

type PluginBillingSummaryList struct {
	Plugins    []PluginBillingSummary `json:"plugins"`
	TotalCount uint32                 `json:"total_count"`
}

type PluginBillingSummaryRow struct {
	PluginID  string
	StartDate time.Time
	TotalFees uint64
}

type PluginCategory string

type PluginCreateDto struct {
	Type           string                       `json:"type" validate:"required"`
	Title          string                       `json:"title" validate:"required"`
	Description    string                       `json:"description" validate:"required"`
	Metadata       json.RawMessage              `json:"metadata" validate:"required"`
	ServerEndpoint string                       `json:"server_endpoint" validate:"required"`
	LogoURL        string                       `json:"logo_url"`
	CategoryID     uuid.UUID                    `json:"category_id" validate:"required"`
	PricingData    []types.PricingCreateDataDto `json:"pricing_data" validate:"required"`
}

type PluginFeeResponse struct {
	ID              uint64           `json:"id"`
	PluginID        vtypes.PluginID  `json:"plugin_id"`
	AppName         string           `json:"app_name"` // Plugin title for display
	PolicyID        uuid.UUID        `json:"policy_id"`
	PublicKey       string           `json:"public_key"`
	TransactionType string           `json:"transaction_type"` // fee type: installation_fee, subscription_fee, etc.
	Amount          string           `json:"amount"`           // String for consistency with plugin history
	FeeAsset        FeeAsset         `json:"fee_asset"`
	Status          vtypes.FeeStatus `json:"status"`
	CreatedAt       time.Time        `json:"created_at"`
}

type PluginFilters struct {
	Term       *string    `json:"term"`
	TagID      *uuid.UUID `json:"tag_id"`
	CategoryID *string    `json:"category_id"`
}

type PluginImage struct {
	URL       string `json:"url" yaml:"url"`
	Caption   string `json:"caption" yaml:"caption,omitempty"`
	AltText   string `json:"alt_text" yaml:"alt_text,omitempty"`
	SortOrder int    `json:"sort_order" yaml:"sort_order,omitempty"` // for carousels
	ZIndex    int    `json:"z_index" yaml:"z_index,omitempty"`       // for overlays
}

type PluginOwner struct {
	PluginID         vtypes.PluginID     `json:"plugin_id"`
	PublicKey        string              `json:"public_key"`
	Active           bool                `json:"active"`
	Role             PluginOwnerRole     `json:"role"`
	AddedVia         PluginOwnerAddedVia `json:"added_via"`
	AddedByPublicKey string              `json:"added_by_public_key,omitempty"`
	CreatedAt        time.Time           `json:"created_at"`
	UpdatedAt        time.Time           `json:"updated_at"`
}

type PluginOwnerAddedVia string

type PluginOwnerRole string

type PluginPolicyPaginatedList struct {
	Policies   []types.PluginPolicy `json:"policies" validate:"required"`
	TotalCount int                  `json:"total_count" validate:"required"`
}

type PluginPolicySync struct {
	ID         uuid.UUID        `json:"id" validate:"required"`
	PolicyID   uuid.UUID        `json:"policy_id" validate:"required"`
	PluginID   ptypes.PluginID  `json:"plugin_id" validate:"required"`
	Signature  string           `json:"signature" validate:"required"`
	SyncType   PolicySyncType   `json:"sync_type" validate:"required"`
	Status     PolicySyncStatus `json:"status" validate:"required"`
	FailReason string           `json:"fail_reason"` // when synced is false, this field contains the reason for the failure
}

type PluginRating struct {
	PluginID string `json:"plugin_id"`
	Rating   int    `json:"rating"`
	Count    int    `json:"count"`
}

type PluginRatingDto struct {
	Rating int `json:"rating"`
	Count  int `json:"count"`
}

type PluginReport struct {
	PluginID       types.PluginID `json:"plugin_id"`
	ReporterPubKey string         `json:"reporter_public_key"`
	Reason         string         `json:"reason"`
	Details        string         `json:"details"`
	CreatedAt      time.Time      `json:"created_at"`
	LastReportedAt time.Time      `json:"last_reported_at"`
	ReportCount    int            `json:"report_count"`
}

type PluginTotalCount struct {
	ID         types.PluginID `json:"id" validate:"required"`
	TotalCount int            `json:"total_count" validate:"required"`
}

type PluginTransactionResponse struct {
	ID            uuid.UUID            `json:"id"`
	PluginID      vtypes.PluginID      `json:"plugin_id"`
	AppName       string               `json:"app_name"` // Plugin title for display
	PolicyID      uuid.UUID            `json:"policy_id"`
	PublicKey     string               `json:"public_key"` // Matches Fee format (was from_public_key)
	ToPublicKey   string               `json:"to_public_key"`
	Chain         common.Chain         `json:"chain"`
	TokenID       string               `json:"token_id"`
	Amount        *string              `json:"amount"` // Transaction amount in base units
	TxHash        *string              `json:"tx_hash"`
	Status        storage.TxStatus     `json:"status"`
	StatusOnChain *rpc.TxOnChainStatus `json:"status_onchain"`
	CreatedAt     time.Time            `json:"created_at"`
	UpdatedAt     time.Time            `json:"updated_at"`
	BroadcastedAt *time.Time           `json:"broadcasted_at"`
}

type PluginUpdateDto struct {
	Title          string                       `json:"title"`
	Description    string                       `json:"description"`
	Metadata       json.RawMessage              `json:"metadata"`
	ServerEndpoint string                       `json:"server_endpoint"`
	LogoURL        string                       `json:"logo_url"`
	PricingData    []types.PricingCreateDataDto `json:"pricing_data"`
	CategoryID     uuid.UUID                    `json:"category_id"`
}

type PluginWithRatings struct {
	Plugin
	Ratings []PluginRatingDto `json:"ratings,omitempty"`
}

type PluginsPaginatedList struct {
	Plugins    []Plugin `json:"plugins"`
	TotalCount int      `json:"total_count"`
}

type PolicySyncStatus int

type PolicySyncType int

type PricingInfo struct {
	Type      string  // once, recurring, per-tx
	Amount    uint64  // amount in smallest unit
	Asset     string  // usdc
	Frequency *string // daily, weekly, biweekly, monthly (nil for non-recurring)
}

type RecipeFunctions struct {
	ID        string   `json:"id"`
	Functions []string `json:"functions"`
}

type ReportCreateRequest struct {
	Reason  string `json:"reason" validate:"required,max=200"`
	Details string `json:"details" validate:"max=2000"`
}

type ReportSubmitResult struct {
	Status       string `json:"status"`
	PluginPaused bool   `json:"plugin_paused"`
}

type Review struct {
	ID        string    `json:"id" validate:"required"`
	Address   string    `json:"address" validate:"required"`
	Rating    int       `json:"rating" validate:"required,min=1,max=5"`
	Comment   string    `json:"comment,omitempty"`
	CreatedAt time.Time `json:"created_at"`
	PluginId  string    `json:"plugin_id" validate:"required"`
}

type ReviewCreateDto struct {
	Address string `json:"address" validate:"required"`
	Rating  int    `json:"rating" validate:"required"`
	Comment string `json:"comment,omitempty"`
}

type ReviewDto struct {
	ID        string            `json:"id" validate:"required"`
	Address   string            `json:"address" validate:"required"`
	Rating    int               `json:"rating" validate:"required"`
	Comment   string            `json:"comment,omitempty"`
	CreatedAt time.Time         `json:"created_at"`
	PluginId  string            `json:"plugin_id" validate:"required"`
	Ratings   []PluginRatingDto `json:"ratings,omitempty"`
}

type ReviewsDto struct {
	Reviews    []Review `json:"reviews"`
	TotalCount int      `json:"total_count"`
}

type Tag struct {
	ID        string    `json:"id" validate:"required"`
	Name      string    `json:"name" validate:"required,min=2,max=50"`
	CreatedAt time.Time `json:"created_at" validate:"required"`
}

type TimeTrigger struct {
	PolicyID       string            `json:"policy_id"`
	CronExpression string            `json:"cron_expression"`
	StartTime      time.Time         `json:"start_time"`
	EndTime        *time.Time        `json:"end_time"`
	Frequency      string            `json:"frequency"`
	Interval       int               `json:"interval"`
	LastExecution  *time.Time        `json:"last_execution"`
	Status         TimeTriggerStatus `json:"status"`
}

type TimeTriggerStatus string

type TransactionHistoryPaginatedList struct {
	History    []PluginTransactionResponse `json:"history"`
	TotalCount uint32                      `json:"total_count"`
}

type VaultToken struct {
	ID         string     `json:"id"`
	TokenID    string     `json:"token_id"`
	PublicKey  string     `json:"public_key"`
	ExpiresAt  time.Time  `json:"expires_at"`
	CreatedAt  time.Time  `json:"created_at"`
	UpdatedAt  time.Time  `json:"updated_at"`
	LastUsedAt time.Time  `json:"last_used_at"`
	RevokedAt  *time.Time `json:"revoked_at"`
}

type VaultTokenCreate struct {
	PublicKey string    `json:"public_key"`
	TokenID   string    `json:"token_id"`
	ExpiresAt time.Time `json:"expires_at"`
}