limits

type Counter interface {
	CountAgentsByUser(ctx context.Context, userID string) (int, error)
	CountDomainsByUser(ctx context.Context, userID string) (int, error)
	MessagesThisMonth(ctx context.Context, userID string) (int, error)
	GetStorageBytes(ctx context.Context, userID string) (int64, error)
}

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

type Defaults struct {
	PlanCode         string
	MaxAgents        int
	MaxDomains       int
	MaxMessagesMonth int
	MaxStorageBytes  int64
}

type Enforcer interface {
	// Get returns the resolved Limits for the user. Never returns
	// ErrLimitExceeded; that error is reserved for the Check methods.
	Get(ctx context.Context, userID string) (Limits, error)

	// CheckAgentCreate returns nil if the user may create another agent,
	// or *LimitExceededError if they have already hit the cap.
	CheckAgentCreate(ctx context.Context, userID string) error

	// CheckDomainCreate returns nil if the user may register another
	// domain, or *LimitExceededError if they have already hit the cap.
	CheckDomainCreate(ctx context.Context, userID string) error

	// CheckMessageSend returns nil if the user may send/receive another
	// message this calendar month, or *LimitExceededError if they have
	// already hit the cap. Counts inbound+outbound in the current UTC
	// month against MaxMessagesMonth.
	CheckMessageSend(ctx context.Context, userID string) error

	// Invalidate evicts the user's cached Limits so the next Get/Check
	// re-reads from the database. Called by the limits-invalidate HTTP
	// endpoint when an external writer (e.g. billing sidecar) has just
	// updated account_limits.
	Invalidate(userID string)
}

type LimitErrorBody struct {
	Error    string `json:"error"`    // human-readable message
	Resource string `json:"resource"` // "agents" | "domains" | "messages" | "storage"
	// Limit + Current are RAW counts in the resource's natural unit:
	// integer count for agents/domains/messages, **bytes** for storage.
	// SDK consumers should treat them as opaque and format per
	// resource. An earlier revision returned storage values in KB,
	// which is inconsistent with every other resource — fixed in
	// favor of bytes-everywhere.
	Limit      int    `json:"limit"`
	Current    int    `json:"current"`
	PlanCode   string `json:"plan_code"`   // opaque label from account_limits
	UpgradeURL string `json:"upgrade_url"` // optional URL to surface in the dashboard
}

type LimitExceededError struct {
	Resource string // "agents" | "domains" | "messages"
	Limit    int    // the cap that was hit
	Current  int    // the user's current count (counts vary by resource)
	Limits   Limits // full resolved limits for upgrade-URL rendering
}

type Limits struct {
	PlanCode         string `json:"plan_code"`
	MaxAgents        int    `json:"max_agents"`
	MaxDomains       int    `json:"max_domains"`
	MaxMessagesMonth int    `json:"max_messages_month"`
	MaxStorageBytes  int64  `json:"max_storage_bytes"`
	UpgradeURL       string `json:"upgrade_url"`
}

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