api

type APIError struct {
	Status  int    `json:"-"`
	Code    string `json:"code"`
	Message string `json:"error"`
	Detail  string `json:"detail"`
}

type APIKey struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Scopes      []string `json:"scopes"`
	CreatedAt   int64    `json:"created_at"`
	ExpiresAt   int64    `json:"expires_at"`
	Revoked     bool     `json:"revoked"`
	TokenPrefix string   `json:"token_prefix"`
	Token       string   `json:"token,omitempty"` // full token, present only on create
}

type AliasCheck struct {
	Available bool   `json:"available"`
	Reason    string `json:"reason"`
}

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

type CreateKeyRequest struct {
	Name        string   `json:"name"`
	Description string   `json:"description,omitempty"`
	Scopes      []string `json:"scopes"`
	ExpiresAt   string   `json:"expires_at,omitempty"` // ISO 8601 or epoch seconds
}

type DNSRecord struct {
	Type  string `json:"type"`
	Name  string `json:"name"`
	Value string `json:"value"`
}

type DeviceTokens struct {
	AccessToken  string `json:"access_token"`
	RefreshToken string `json:"refresh_token"`
	User         User   `json:"user"`
}

type Domain struct {
	ID               string      `json:"id"`
	FQDN             string      `json:"fqdn"`
	Status           string      `json:"status"` // PENDING | ACTIVE | REVOKED
	CreatedAt        string      `json:"created_at"`
	VerifiedAt       string      `json:"verified_at"`
	DNSRecords       []DNSRecord `json:"dns_records"`
	RootRedirect     string      `json:"root_redirect"`
	NotFoundRedirect string      `json:"not_found_redirect"`
}

type DomainDeleteResult struct {
	ID          string `json:"id"`
	FQDN        string `json:"fqdn"`
	Cascade     bool   `json:"cascade"`
	URLsDeleted int    `json:"urls_deleted"`
}

type DomainPage struct {
	Items    []Domain `json:"items"`
	Page     int      `json:"page"`
	PageSize int      `json:"pageSize"`
	Total    int      `json:"total"`
	HasNext  bool     `json:"hasNext"`
}

type InspectResult struct {
	ShortURL    string `json:"short_url"`
	Status      int    `json:"status"`
	Destination string `json:"destination,omitempty"`
}

type ListURLsOptions struct {
	Page      int
	PageSize  int
	SortBy    string // created_at | last_click | total_clicks
	SortOrder string // ascending | descending
	Search    string
	Status    string // ACTIVE | INACTIVE | BLOCKED | EXPIRED
	Domain    string
}

type MetricPoint struct {
	Label string
	Value float64
}

type ShortURL struct {
	ShortURL  string `json:"short_url"`
	Alias     string `json:"alias"`
	LongURL   string `json:"long_url"`
	CreatedAt int64  `json:"created_at"`
	Status    string `json:"status"`
}

type ShortenRequest struct {
	LongURL      string `json:"long_url"`
	Alias        string `json:"alias,omitempty"`
	Password     string `json:"password,omitempty"`
	BlockBots    bool   `json:"block_bots,omitempty"`
	MaxClicks    int    `json:"max_clicks,omitempty"`
	ExpireAfter  string `json:"expire_after,omitempty"` // ISO 8601 or epoch seconds
	PrivateStats bool   `json:"private_stats,omitempty"`
	Domain       string `json:"domain,omitempty"`
}

type StatsQuery struct {
	ShortCode string
	Scope     string // "all" (authed, optional code) or "anon" (code required)
	StartDate string
	EndDate   string
	GroupBy   []string // time, browser, os, country, city, referrer, short_code
	Timezone  string   // IANA name
	// Filters narrows results server-side; keys are the filterable
	// dimensions (browser, os, country, city, referrer, short_code).
	Filters map[string][]string
}

type StatsResponse struct {
	Scope           string                      `json:"scope"`
	ShortCode       string                      `json:"short_code"`
	Summary         StatsSummary                `json:"summary"`
	TimeRange       StatsTimeRange              `json:"time_range"`
	Metrics         map[string][]map[string]any `json:"metrics"`
	ComputedMetrics map[string]float64          `json:"computed_metrics"`
	GeneratedAt     string                      `json:"generated_at"`
}

type StatsSummary struct {
	TotalClicks        int     `json:"total_clicks"`
	UniqueClicks       int     `json:"unique_clicks"`
	FirstClick         string  `json:"first_click"`
	LastClick          string  `json:"last_click"`
	AvgRedirectionTime float64 `json:"avg_redirection_time"`
}

type StatsTimeRange struct {
	StartDate string `json:"start_date"`
	EndDate   string `json:"end_date"`
}

type URLItem struct {
	ID           string `json:"id"`
	Alias        string `json:"alias"`
	LongURL      string `json:"long_url"`
	CreatedAt    string `json:"created_at"`
	LastClick    string `json:"last_click"`
	TotalClicks  int    `json:"total_clicks"`
	Status       string `json:"status"`
	PasswordSet  bool   `json:"password_set"`
	MaxClicks    *int   `json:"max_clicks"`
	ExpireAfter  *int64 `json:"expire_after"` // Unix seconds, null when unset
	PrivateStats bool   `json:"private_stats"`
	BlockBots    bool   `json:"block_bots"`
	Domain       string `json:"domain"`
}

type URLPage struct {
	Items    []URLItem `json:"items"`
	Page     int       `json:"page"`
	PageSize int       `json:"pageSize"`
	Total    int       `json:"total"`
	HasNext  bool      `json:"hasNext"`
}

type UpdatedURL struct {
	ID           string `json:"id"`
	Alias        string `json:"alias"`
	LongURL      string `json:"long_url"`
	Status       string `json:"status"`
	PasswordSet  bool   `json:"password_set"`
	MaxClicks    *int   `json:"max_clicks"`
	ExpireAfter  *int64 `json:"expire_after"`
	BlockBots    bool   `json:"block_bots"`
	PrivateStats bool   `json:"private_stats"`
	Domain       string `json:"domain"`
	UpdatedAt    int64  `json:"updated_at"`
}

type User struct {
	ID            string `json:"id"`
	Email         string `json:"email"`
	EmailVerified bool   `json:"email_verified"`
	Name          string `json:"name"`
	Plan          string `json:"plan"`
}