webx

type AddMemberInput struct {
	WorkspaceID string
	UserID      string
	RoleID      string
	Limits      *PlanLimits // if non-nil, enforce MaxMembers before adding
}

type BillingProvider interface {
	// CreateCustomer creates a billing customer for a workspace.
	CreateCustomer(workspaceID, email string) (customerID string, err error)
	// CreateSubscription starts a subscription for the given tier.
	CreateSubscription(customerID string, tier PlanTier) (subscriptionID string, err error)
	// CancelSubscription cancels the workspace's subscription.
	CancelSubscription(subscriptionID string) error
	// GetPortalURL returns a URL where the user can manage billing.
	GetPortalURL(customerID string) (string, error)
	// ChangePlan upgrades or downgrades to a new tier.
	ChangePlan(subscriptionID string, tier PlanTier) error
}

type CreateWorkspaceInput struct {
	Name       string
	OwnerID    string
	Tier       PlanTier    // stored on the workspace
	Limits     *PlanLimits // if non-nil, enforce MaxWorkspaces before creation
	ProviderID string
	RegionID   string
}

type CreateWorkspaceResult struct {
	Workspace  Workspace
	OwnerRole  Role
	Membership Membership
}

type LimitStatus struct {
	Limit     int // 0 = unlimited
	Used      int
	Remaining int // -1 = unlimited
}

type Membership struct {
	ID          string
	WorkspaceID string
	UserID      string
	RoleID      string
	CreatedAt   time.Time
}

type MembershipStore interface {
	Create(m Membership) error
	Get(id string) (*Membership, error)
	GetByUserAndWorkspace(userID, workspaceID string) (*Membership, error)
	ListByWorkspace(workspaceID string) ([]Membership, error)
	ListByUser(userID string) ([]Membership, error)
	Delete(id string) error
}

type NoopBillingProvider struct{}

type Plan struct {
	ID        string
	Tier      PlanTier
	Name      string // display name, e.g. "Pro Plan"
	Limits    PlanLimits
	CreatedAt time.Time
}

type PlanLimits struct {
	MaxWorkspaces   int      // per user, 0 = unlimited
	MaxMembers      int      // per workspace, 0 = unlimited
	MaxStorageBytes int64    // per workspace, 0 = unlimited
	MaxTokens       int      // per workspace, 0 = unlimited
	AllowSelfHost   bool     // whether self-hosted providers are available
	AllowedRegions  []string // region IDs available; empty = all
}

type PlanTier string

type Provider struct {
	ID          string
	Name        string       // e.g. "AWS", "Google Cloud", "My Home Server"
	Type        ProviderType // app-defined, e.g. "managed" or "selfhosted"
	OwnerID     string       // self-hosted: user who created it (empty for managed)
	PairingCode string       // self-hosted: short code for pairing
	PairedAt    *time.Time   // self-hosted: nil = pending pairing
	CreatedAt   time.Time
}

type ProviderStore interface {
	Create(p Provider) error
	Get(id string) (*Provider, error)
	List() ([]Provider, error)
	ListByType(t ProviderType) ([]Provider, error)
	ListByOwner(ownerID string) ([]Provider, error)
	Update(p Provider) error
	Delete(id string) error
}

type ProviderType string

type Region struct {
	ID         string
	ProviderID string
	Name       string // e.g. "us-east-1"
	Label      string // e.g. "US East (Virginia)"
	CreatedAt  time.Time
}

type RegionStore interface {
	Create(r Region) error
	Get(id string) (*Region, error)
	ListByProvider(providerID string) ([]Region, error)
	Delete(id string) error
}

type Role struct {
	ID           string
	WorkspaceID  string   // empty = global/system role
	Name         string   // e.g. "owner", "editor", "viewer"
	Capabilities []string // e.g. ["invoices:read", "invoices:write"]
	System       bool     // built-in, cannot be deleted
	CreatedAt    time.Time
}

type RoleStore interface {
	Create(r Role) error
	Get(id string) (*Role, error)
	GetByNameAndWorkspace(name, workspaceID string) (*Role, error)
	ListByWorkspace(workspaceID string) ([]Role, error)
	Update(r Role) error
	Delete(id string) error
}

type SessionStore interface {
	Get(sessionID string, key string) (string, error)
	Set(sessionID string, key string, value string) error
	Delete(sessionID string) error
}

type Subscription struct {
	ID             string
	WorkspaceID    string
	CustomerID     string // billing provider customer ID
	SubscriptionID string // billing provider subscription ID
	Tier           PlanTier
	Active         bool
	CreatedAt      time.Time
}

type SubscriptionStore interface {
	Create(s Subscription) error
	Get(id string) (*Subscription, error)
	GetByWorkspace(workspaceID string) (*Subscription, error)
	Update(s Subscription) error
	Delete(id string) error
}

type Token struct {
	Value     string
	Email     string
	Verified  bool
	ExpiresAt time.Time
	CreatedAt time.Time
}

type TokenStore interface {
	Create(email string) (*Token, error)
	Get(value string) (*Token, error)
	MarkVerified(value string) bool
	Delete(value string)
	ListAll() ([]*Token, error)
}

type WebXContext struct {
	ShowDatastarInspector bool
	DatastarPro           bool
	CSRFToken             string
	DevMode               bool
	SessionID             string
	BasePath              string // prefix for all SSE handler routes (e.g. "/showcase")
}

type Workspace struct {
	ID         string
	Name       string
	PlanTier   PlanTier
	ProviderID string
	RegionID   string
	CreatedAt  time.Time
}

type WorkspaceContext struct {
	Workspace    *Workspace
	Membership   *Membership
	Role         *Role
	Capabilities capability.Set
}

type WorkspaceStore interface {
	Create(ws Workspace) error
	Get(id string) (*Workspace, error)
	List() ([]Workspace, error)
	Update(ws Workspace) error
	Delete(id string) error
}