api

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

type AggregationResponse struct {
	KeyID            string    `json:"key_id"`
	TenantID         string    `json:"tenant_id"`
	Period           string    `json:"period"`
	PeriodStart      time.Time `json:"period_start"`
	RequestCount     int64     `json:"request_count"`
	ErrorCount       int64     `json:"error_count"`
	ServerErrorCount int64     `json:"server_error_count"`
	TotalLatency     int64     `json:"total_latency_ms"`
	P50Latency       *int64    `json:"p50_latency_ms,omitempty"`
	P99Latency       *int64    `json:"p99_latency_ms,omitempty"`
}

type AssignScopesRequest struct {
	KeyID  string   `path:"keyId" description:"Key ID"`
	Scopes []string `json:"scopes" description:"Scope names to assign"`
}

type CreateKeyRequest struct {
	Name        string         `json:"name" description:"Human-readable key name"`
	Description string         `json:"description" description:"Optional description"`
	Prefix      string         `json:"prefix" description:"Key prefix (e.g., sk, pk)"`
	Environment string         `json:"environment" description:"Environment (live, test, staging)"`
	PolicyID    string         `json:"policy_id" description:"Optional policy ID to attach"`
	Scopes      []string       `json:"scopes" description:"Permission scopes to assign"`
	Metadata    map[string]any `json:"metadata" description:"Arbitrary metadata"`
	ExpiresAt   *time.Time     `json:"expires_at" description:"Optional expiration time"`
}

type CreatePolicyRequest struct {
	Name            string   `json:"name" description:"Policy name"`
	Description     string   `json:"description" description:"Optional description"`
	RateLimit       int      `json:"rate_limit" description:"Max requests per window"`
	RateLimitWindow string   `json:"rate_limit_window" description:"Window duration (e.g., 1m, 1h)"`
	BurstLimit      int      `json:"burst_limit" description:"Burst allowance"`
	AllowedScopes   []string `json:"allowed_scopes" description:"Scopes this policy grants"`
	AllowedIPs      []string `json:"allowed_ips" description:"IP allowlist (CIDR)"`
	AllowedOrigins  []string `json:"allowed_origins" description:"Origin allowlist"`
	MaxKeyLifetime  string   `json:"max_key_lifetime" description:"Max key lifetime (e.g., 90d)"`
	RotationPeriod  string   `json:"rotation_period" description:"Suggested rotation period (e.g., 30d)"`
	GracePeriod     string   `json:"grace_period" description:"Rotated key grace period (e.g., 24h)"`
	DailyQuota      int64    `json:"daily_quota" description:"Max requests per day (0 = unlimited)"`
	MonthlyQuota    int64    `json:"monthly_quota" description:"Max requests per month (0 = unlimited)"`
}

type CreateScopeRequest struct {
	Name        string `json:"name" description:"Scope name (e.g., read:users)"`
	Description string `json:"description" description:"Optional description"`
	Parent      string `json:"parent" description:"Parent scope (e.g., read)"`
}

type DeleteKeyRequest struct {
	KeyID string `path:"keyId" description:"Key ID"`
}

type DeletePolicyRequest struct {
	PolicyID string `path:"policyId" description:"Policy ID"`
}

type DeleteScopeRequest struct {
	ScopeID string `path:"scopeId" description:"Scope ID"`
}

type GetKeyRequest struct {
	KeyID string `path:"keyId" description:"Key ID"`
}

type GetKeyUsageAggregateRequest struct {
	KeyID  string `path:"keyId" description:"Key ID"`
	Period string `query:"period" description:"Aggregation period (hourly, daily, monthly; default daily)"`
	After  string `query:"after" description:"After timestamp (ISO 8601)"`
	Before string `query:"before" description:"Before timestamp (ISO 8601)"`
}

type GetKeyUsageRequest struct {
	KeyID  string `path:"keyId" description:"Key ID"`
	After  string `query:"after" description:"After timestamp (ISO 8601)"`
	Before string `query:"before" description:"Before timestamp (ISO 8601)"`
	Limit  int    `query:"limit" description:"Max results (default: 100)"`
	Offset int    `query:"offset" description:"Number of results to skip"`
}

type GetPolicyRequest struct {
	PolicyID string `path:"policyId" description:"Policy ID"`
}

type KeyCreateResponse struct {
	Key    *KeyResponse `json:"key"`
	RawKey string       `json:"raw_key"`
}

type KeyResponse struct {
	ID          string         `json:"id"`
	TenantID    string         `json:"tenant_id"`
	AppID       string         `json:"app_id"`
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	Prefix      string         `json:"prefix"`
	Hint        string         `json:"hint"`
	Environment string         `json:"environment"`
	State       string         `json:"state"`
	PolicyID    string         `json:"policy_id,omitempty"`
	Scopes      []string       `json:"scopes,omitempty"`
	Metadata    map[string]any `json:"metadata,omitempty"`
	CreatedBy   string         `json:"created_by,omitempty"`
	ExpiresAt   *time.Time     `json:"expires_at,omitempty"`
	LastUsedAt  *time.Time     `json:"last_used_at,omitempty"`
	RotatedAt   *time.Time     `json:"rotated_at,omitempty"`
	RevokedAt   *time.Time     `json:"revoked_at,omitempty"`
	CreatedAt   time.Time      `json:"created_at"`
	UpdatedAt   time.Time      `json:"updated_at"`
}

type ListKeysRequest struct {
	Environment string `query:"environment" description:"Filter by environment"`
	State       string `query:"state" description:"Filter by state (active, revoked, expired)"`
	PolicyID    string `query:"policy_id" description:"Filter by policy ID"`
	Limit       int    `query:"limit" description:"Max results (default: 50)"`
	Offset      int    `query:"offset" description:"Number of results to skip"`
}

type ListPoliciesRequest struct {
	Limit  int `query:"limit" description:"Max results (default: 50)"`
	Offset int `query:"offset" description:"Number of results to skip"`
}

type ListRotationsRequest struct {
	KeyID  string `path:"keyId" description:"Key ID"`
	Limit  int    `query:"limit" description:"Max results (default: 50)"`
	Offset int    `query:"offset" description:"Number of results to skip"`
}

type ListScopesRequest struct {
	Parent string `query:"parent" description:"Filter by parent scope"`
	Limit  int    `query:"limit" description:"Max results (default: 50)"`
	Offset int    `query:"offset" description:"Number of results to skip"`
}

type ListUsageRequest struct {
	Period string `query:"period" description:"Aggregation period (hourly, daily, monthly; default daily)"`
	After  string `query:"after" description:"After timestamp (ISO 8601)"`
	Before string `query:"before" description:"Before timestamp (ISO 8601)"`
}

type PolicyResponse struct {
	ID              string         `json:"id"`
	TenantID        string         `json:"tenant_id"`
	AppID           string         `json:"app_id"`
	Name            string         `json:"name"`
	Description     string         `json:"description,omitempty"`
	RateLimit       int            `json:"rate_limit"`
	RateLimitWindow string         `json:"rate_limit_window"`
	BurstLimit      int            `json:"burst_limit"`
	AllowedScopes   []string       `json:"allowed_scopes,omitempty"`
	AllowedIPs      []string       `json:"allowed_ips,omitempty"`
	AllowedOrigins  []string       `json:"allowed_origins,omitempty"`
	AllowedMethods  []string       `json:"allowed_methods,omitempty"`
	AllowedPaths    []string       `json:"allowed_paths,omitempty"`
	MaxKeyLifetime  string         `json:"max_key_lifetime,omitempty"`
	RotationPeriod  string         `json:"rotation_period,omitempty"`
	GracePeriod     string         `json:"grace_period"`
	DailyQuota      int64          `json:"daily_quota"`
	MonthlyQuota    int64          `json:"monthly_quota"`
	Metadata        map[string]any `json:"metadata,omitempty"`
	CreatedAt       time.Time      `json:"created_at"`
	UpdatedAt       time.Time      `json:"updated_at"`
}

type ReactivateKeyRequest struct {
	KeyID string `path:"keyId" description:"Key ID"`
}

type RemoveScopesRequest struct {
	KeyID  string   `path:"keyId" description:"Key ID"`
	Scopes []string `json:"scopes" description:"Scope names to remove"`
}

type RevokeKeyRequest struct {
	KeyID  string `path:"keyId" description:"Key ID to revoke"`
	Reason string `json:"reason" description:"Revocation reason"`
}

type RotateKeyRequest struct {
	KeyID  string `path:"keyId" description:"Key ID to rotate"`
	Reason string `json:"reason" description:"Rotation reason (manual, compromise, policy)"`
}

type RotationResponse struct {
	ID        string    `json:"id"`
	KeyID     string    `json:"key_id"`
	TenantID  string    `json:"tenant_id"`
	Reason    string    `json:"reason"`
	GraceTTL  string    `json:"grace_ttl"`
	GraceEnds time.Time `json:"grace_ends"`
	RotatedBy string    `json:"rotated_by,omitempty"`
	CreatedAt time.Time `json:"created_at"`
}

type ScopeResponse struct {
	ID          string         `json:"id"`
	TenantID    string         `json:"tenant_id"`
	AppID       string         `json:"app_id"`
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	Parent      string         `json:"parent,omitempty"`
	Metadata    map[string]any `json:"metadata,omitempty"`
	CreatedAt   time.Time      `json:"created_at"`
}

type SuspendKeyRequest struct {
	KeyID string `path:"keyId" description:"Key ID"`
}

type UpdatePolicyRequest struct {
	PolicyID string `path:"policyId" description:"Policy ID"`
	CreatePolicyRequest
}

type UsageResponse struct {
	ID         string         `json:"id"`
	KeyID      string         `json:"key_id"`
	TenantID   string         `json:"tenant_id"`
	Endpoint   string         `json:"endpoint"`
	Method     string         `json:"method"`
	StatusCode int            `json:"status_code"`
	IPAddress  string         `json:"ip_address,omitempty"`
	UserAgent  string         `json:"user_agent,omitempty"`
	LatencyMs  int64          `json:"latency_ms"`
	Metadata   map[string]any `json:"metadata,omitempty"`
	CreatedAt  time.Time      `json:"created_at"`
}

type ValidateKeyRequest struct {
	RawKey string `json:"raw_key" description:"The raw API key to validate"`
}

type ValidationResponse struct {
	Valid  bool         `json:"valid"`
	Key    *KeyResponse `json:"key,omitempty"`
	Scopes []string     `json:"scopes,omitempty"`
}