templates

type AboutPageData struct {
	Freshness DataFreshness
	Privacy   PrivacySync
}

type CampusDetail struct {
	// ID is the campus's PeeringDB identifier.
	ID int
	// Name is the campus's display name.
	Name string
	// NameLong is the campus's long-form name.
	NameLong string
	// AKA is the "also known as" alias.
	AKA string
	// Website is the campus's website URL.
	Website string
	// OrgName is the name of the parent organization.
	OrgName string
	// OrgID is the parent organization's PeeringDB ID.
	OrgID int
	// City is the campus's city.
	City string
	// State is the campus's state or province.
	State string
	// Country is the campus's country code.
	Country string
	// Zipcode is the postal code.
	Zipcode string
	// Notes contains freeform notes.
	Notes string
	// Status is the record status.
	Status string
	// FacCount is the count of facilities (requires query).
	FacCount int
	// Facilities holds eager-loaded facility rows for terminal/JSON rendering. Nil for web UI requests.
	Facilities []CampusFacilityRow `json:"facilities,omitempty"`
}

type CampusFacilityRow struct {
	// FacName is the facility name.
	FacName string
	// FacID is the facility's PeeringDB ID for cross-linking.
	FacID int
	// City is the facility's city.
	City string
	// Country is the facility's country code.
	Country string
	// Latitude is the facility's geographic latitude. Zero means no data.
	Latitude float64
	// Longitude is the facility's geographic longitude. Zero means no data.
	Longitude float64
}

type CarrierDetail struct {
	// ID is the carrier's PeeringDB identifier.
	ID int
	// Name is the carrier's display name.
	Name string
	// NameLong is the carrier's long-form name.
	NameLong string
	// AKA is the "also known as" alias.
	AKA string
	// Website is the carrier's website URL.
	Website string
	// OrgName is the name of the parent organization.
	OrgName string
	// OrgID is the parent organization's PeeringDB ID.
	OrgID int
	// Notes contains freeform notes.
	Notes string
	// Status is the record status.
	Status string
	// FacCount is the pre-computed count of facilities.
	FacCount int
	// Facilities holds eager-loaded facility rows for terminal/JSON rendering. Nil for web UI requests.
	Facilities []CarrierFacilityRow `json:"facilities,omitempty"`
}

type CarrierFacilityRow struct {
	// FacName is the facility name.
	FacName string
	// FacID is the facility's PeeringDB ID for cross-linking.
	FacID int
	// Latitude is the facility's geographic latitude. Zero means no data.
	Latitude float64
	// Longitude is the facility's geographic longitude. Zero means no data.
	Longitude float64
}

type CompareCampus struct {
	// CampusID is the campus's PeeringDB ID for cross-linking.
	CampusID int
	// CampusName is the campus display name.
	CampusName string
	// SharedFacilities lists facilities within this campus where both networks are present.
	SharedFacilities []CompareCampusFacility
}

type CompareCampusFacility struct {
	// FacID is the facility's PeeringDB ID for cross-linking.
	FacID int
	// FacName is the facility display name.
	FacName string
}

type CompareData struct {
	// NetA is the first network's summary info.
	NetA CompareNetwork
	// NetB is the second network's summary info.
	NetB CompareNetwork
	// SharedIXPs lists IXPs where both networks are present.
	SharedIXPs []CompareIXP
	// SharedFacilities lists facilities where both networks are present.
	SharedFacilities []CompareFacility
	// SharedCampuses lists campuses where both networks have facility presence.
	SharedCampuses []CompareCampus
	// AllIXPs lists all IXPs for both networks with a shared flag (for full view).
	AllIXPs []CompareIXP
	// AllFacilities lists all facilities for both networks with shared flag (for full view).
	AllFacilities []CompareFacility
	// ViewMode is "shared" (default) or "full".
	ViewMode string
}

type CompareFacPresence struct {
	// LocalASN is the local ASN used at this facility.
	LocalASN int
}

type CompareFacility struct {
	// FacID is the facility's PeeringDB ID for cross-linking.
	FacID int
	// FacName is the facility display name.
	FacName string
	// City is the facility's city.
	City string
	// Country is the facility's country code.
	Country string
	// Latitude is the facility's geographic latitude. Zero means no data.
	Latitude float64
	// Longitude is the facility's geographic longitude. Zero means no data.
	Longitude float64
	// Shared indicates both networks are present at this facility.
	Shared bool
	// NetA holds network A's presence info (nil if not present).
	NetA *CompareFacPresence
	// NetB holds network B's presence info (nil if not present).
	NetB *CompareFacPresence
}

type CompareIXP struct {
	// IXID is the exchange's PeeringDB ID for cross-linking.
	IXID int
	// IXName is the exchange display name.
	IXName string
	// Shared indicates both networks are present at this IXP.
	Shared bool
	// NetA holds network A's presence details (nil if not present).
	NetA *CompareIXPresence
	// NetB holds network B's presence details (nil if not present).
	NetB *CompareIXPresence
}

type CompareIXPresence struct {
	// Speed is the port speed in Mbps.
	Speed int
	// IPAddr4 is the IPv4 peering address.
	IPAddr4 string
	// IPAddr6 is the IPv6 peering address.
	IPAddr6 string
	// IsRSPeer indicates route server peering.
	IsRSPeer bool
	// Operational indicates whether the connection is operational.
	Operational bool
}

type CompareNetwork struct {
	// ASN is the Autonomous System Number.
	ASN int
	// Name is the network's display name.
	Name string
	// ID is the network's PeeringDB internal identifier.
	ID int
}

type ContactRow struct {
	// Name is the contact's name.
	Name string
	// Role is the contact's role (e.g. "NOC", "Policy").
	Role string
	// Email is the contact's email address.
	Email string
	// Phone is the contact's phone number.
	Phone string
	// URL is the contact's URL.
	URL string
}

type DataFreshness struct {
	Available  bool
	LastSyncAt time.Time
	Age        time.Duration
}

type FacCarrierRow struct {
	// CarrierName is the carrier name.
	CarrierName string
	// CarrierID is the carrier's PeeringDB ID for cross-linking.
	CarrierID int
}

type FacIXRow struct {
	// IXName is the exchange name.
	IXName string
	// IXID is the exchange's PeeringDB ID for cross-linking.
	IXID int
}

type FacNetworkRow struct {
	// NetName is the network's name.
	NetName string
	// ASN is the network's Autonomous System Number.
	ASN int
	// City is the facility network's city (from NetworkFacility computed field).
	City string
	// Country is the facility network's country code (from NetworkFacility computed field).
	Country string
}

type FacilityDetail struct {
	// ID is the facility's PeeringDB identifier.
	ID int
	// Name is the facility's display name.
	Name string
	// NameLong is the facility's long-form name.
	NameLong string
	// AKA is the "also known as" alias.
	AKA string
	// Website is the facility's website URL.
	Website string
	// OrgName is the name of the parent organization.
	OrgName string
	// OrgID is the parent organization's PeeringDB ID.
	OrgID int
	// CampusName is the name of the parent campus, if any.
	CampusName string
	// CampusID is the parent campus's PeeringDB ID.
	CampusID int
	// Address1 is the primary street address.
	Address1 string
	// Address2 is the secondary address line.
	Address2 string
	// City is the facility's city.
	City string
	// State is the facility's state or province.
	State string
	// Country is the facility's country code.
	Country string
	// Zipcode is the postal code.
	Zipcode string
	// RegionContinent is the facility's region/continent.
	RegionContinent string
	// CLLI is the CLLI code.
	CLLI string
	// Notes contains freeform notes.
	Notes string
	// Status is the record status.
	Status string
	// NetCount is the pre-computed count of networks present.
	NetCount int
	// IXCount is the pre-computed count of IXPs present.
	IXCount int
	// CarrierCount is the pre-computed count of carriers.
	CarrierCount int
	// Latitude is the facility's geographic latitude. Zero means no data.
	Latitude float64
	// Longitude is the facility's geographic longitude. Zero means no data.
	Longitude float64
	// Networks holds eager-loaded network rows for terminal/JSON rendering. Nil for web UI requests.
	Networks []FacNetworkRow `json:"networks,omitempty"`
	// IXPs holds eager-loaded IXP rows for terminal/JSON rendering. Nil for web UI requests.
	IXPs []FacIXRow `json:"ixps,omitempty"`
	// Carriers holds eager-loaded carrier rows for terminal/JSON rendering. Nil for web UI requests.
	Carriers []FacCarrierRow `json:"carriers,omitempty"`
}

type IXDetail struct {
	// ID is the IXP's PeeringDB identifier.
	ID int
	// Name is the IXP's display name.
	Name string
	// NameLong is the IXP's long-form name.
	NameLong string
	// AKA is the "also known as" alias.
	AKA string
	// Website is the IXP's website URL.
	Website string
	// OrgName is the name of the parent organization.
	OrgName string
	// OrgID is the parent organization's PeeringDB ID.
	OrgID int
	// City is the IXP's city.
	City string
	// Country is the IXP's country code.
	Country string
	// RegionContinent is the IXP's region/continent.
	RegionContinent string
	// Media is the exchange media type.
	Media string
	// ProtoUnicast indicates unicast support.
	ProtoUnicast bool
	// ProtoMulticast indicates multicast support.
	ProtoMulticast bool
	// ProtoIPv6 indicates IPv6 support.
	ProtoIPv6 bool
	// Notes contains freeform notes.
	Notes string
	// Status is the record status.
	Status string
	// NetCount is the pre-computed count of network participants.
	NetCount int
	// FacCount is the pre-computed count of facilities.
	FacCount int
	// PrefixCount is the count of peering LAN prefixes (requires IxLan traversal).
	PrefixCount int
	// AggregateBW is the total bandwidth in Mbps across all participants (for header display).
	AggregateBW int
	// Participants holds eager-loaded participant rows for terminal/JSON rendering. Nil for web UI requests.
	Participants []IXParticipantRow `json:"participants,omitempty"`
	// Facilities holds eager-loaded facility rows for terminal/JSON rendering. Nil for web UI requests.
	Facilities []IXFacilityRow `json:"facilities,omitempty"`
	// Prefixes holds eager-loaded prefix rows for terminal/JSON rendering. Nil for web UI requests.
	Prefixes []IXPrefixRow `json:"prefixes,omitempty"`
}

type IXFacilityRow struct {
	// FacName is the facility name.
	FacName string
	// FacID is the facility's PeeringDB ID for cross-linking.
	FacID int
	// City is the facility's city.
	City string
	// Country is the facility's country code.
	Country string
	// Latitude is the facility's geographic latitude. Zero means no data.
	Latitude float64
	// Longitude is the facility's geographic longitude. Zero means no data.
	Longitude float64
}

type IXParticipantRow struct {
	// NetName is the participant network's name.
	NetName string
	// ASN is the participant's Autonomous System Number.
	ASN int
	// Speed is the port speed in Mbps.
	Speed int
	// IPAddr4 is the IPv4 peering address.
	IPAddr4 string
	// IPAddr6 is the IPv6 peering address.
	IPAddr6 string
	// IsRSPeer indicates route server peering.
	IsRSPeer bool
}

type IXPrefixRow struct {
	// Prefix is the peering LAN prefix.
	Prefix string
	// Protocol is the address family ("IPv4" or "IPv6").
	Protocol string
	// InDFZ indicates whether the prefix is in the default-free zone.
	InDFZ bool
}

type LayoutOptions struct {
	Title       string
	Description string
	Canonical   string
	NeedsMap    bool
}

type MapMarker struct {
	// Lat is the marker's latitude.
	Lat float64
	// Lng is the marker's longitude.
	Lng float64
	// Name is the display name in the popup.
	Name string
	// Location is the city/country text in the popup.
	Location string
	// NetCount is the network count shown in the popup.
	NetCount int
	// IXCount is the IX count shown in the popup.
	IXCount int
	// DetailURL is the link to the entity detail page.
	DetailURL string
	// Color is the circleMarker fillColor hex (e.g. "#10b981"). Empty for single-pin maps.
	Color string
	// Stroke is the circleMarker stroke hex (e.g. "#059669"). Empty for single-pin maps.
	Stroke string
	// Extra is an additional popup line (e.g. network names for compare maps). Empty if not needed.
	Extra string
}

type NetworkDetail struct {
	// ID is the network's PeeringDB internal identifier.
	ID int
	// ASN is the Autonomous System Number.
	ASN int
	// Name is the network's display name.
	Name string
	// NameLong is the network's long-form name.
	NameLong string
	// AKA is the "also known as" alias.
	AKA string
	// Website is the network's website URL.
	Website string
	// OrgName is the name of the parent organization.
	OrgName string
	// OrgID is the parent organization's PeeringDB ID.
	OrgID int
	// IRRAsSet is the IRR AS-SET identifier.
	IRRAsSet string
	// InfoType is the network type classification.
	InfoType string
	// InfoScope is the geographic scope.
	InfoScope string
	// InfoTraffic is the traffic level.
	InfoTraffic string
	// InfoRatio is the traffic ratio.
	InfoRatio string
	// InfoUnicast indicates unicast support.
	InfoUnicast bool
	// InfoMulticast indicates multicast support.
	InfoMulticast bool
	// InfoIPv6 indicates IPv6 support.
	InfoIPv6 bool
	// InfoPrefixes4 is the IPv4 prefix count.
	InfoPrefixes4 int
	// InfoPrefixes6 is the IPv6 prefix count.
	InfoPrefixes6 int
	// LookingGlass is the looking glass URL.
	LookingGlass string
	// RouteServer is the route server URL.
	RouteServer string
	// PolicyGeneral is the general peering policy.
	PolicyGeneral string
	// PolicyURL is the peering policy URL.
	PolicyURL string
	// Notes contains freeform notes.
	Notes string
	// Status is the record status.
	Status string
	// IXCount is the pre-computed count of IX presences.
	IXCount int
	// FacCount is the pre-computed count of facility presences.
	FacCount int
	// PocCount is the count of contacts (requires query).
	PocCount int
	// AggregateBW is the total bandwidth in Mbps across all IX presences (for header display).
	AggregateBW int
	// IXPresences holds eager-loaded IX presence rows for terminal/JSON rendering.
	// Nil for web UI requests that lazy-load via htmx fragments.
	IXPresences []NetworkIXLanRow `json:"ixPresences,omitempty"`
	// FacPresences holds eager-loaded facility presence rows for terminal/JSON rendering.
	// Nil for web UI requests that lazy-load via htmx fragments.
	FacPresences []NetworkFacRow `json:"facPresences,omitempty"`
}

type NetworkFacRow struct {
	// FacName is the facility name.
	FacName string
	// FacID is the facility's PeeringDB ID for cross-linking.
	FacID int
	// LocalASN is the local ASN at this facility.
	LocalASN int
	// City is the facility's city.
	City string
	// Country is the facility's country code.
	Country string
	// Latitude is the facility's geographic latitude. Zero means no data.
	Latitude float64
	// Longitude is the facility's geographic longitude. Zero means no data.
	Longitude float64
}

type NetworkIXLanRow struct {
	// IXName is the exchange name.
	IXName string
	// IXID is the exchange's PeeringDB ID for cross-linking.
	IXID int
	// Speed is the port speed in Mbps.
	Speed int
	// IPAddr4 is the IPv4 peering address.
	IPAddr4 string
	// IPAddr6 is the IPv6 peering address.
	IPAddr6 string
	// IsRSPeer indicates route server peering.
	IsRSPeer bool
}

type OrgCampusRow struct {
	// CampusName is the campus name.
	CampusName string
	// CampusID is the campus's PeeringDB ID for cross-linking.
	CampusID int
}

type OrgCarrierRow struct {
	// CarrierName is the carrier name.
	CarrierName string
	// CarrierID is the carrier's PeeringDB ID for cross-linking.
	CarrierID int
}

type OrgDetail struct {
	// ID is the organization's PeeringDB identifier.
	ID int
	// Name is the organization's display name.
	Name string
	// NameLong is the organization's long-form name.
	NameLong string
	// AKA is the "also known as" alias.
	AKA string
	// Website is the organization's website URL.
	Website string
	// Address1 is the primary street address.
	Address1 string
	// Address2 is the secondary address line.
	Address2 string
	// City is the organization's city.
	City string
	// State is the organization's state or province.
	State string
	// Country is the organization's country code.
	Country string
	// Zipcode is the postal code.
	Zipcode string
	// Notes contains freeform notes.
	Notes string
	// Status is the record status.
	Status string
	// NetCount is the pre-computed count of networks.
	NetCount int
	// FacCount is the pre-computed count of facilities.
	FacCount int
	// IXCount is the count of IXPs (requires query).
	IXCount int
	// CampusCount is the count of campuses (requires query).
	CampusCount int
	// CarrierCount is the count of carriers (requires query).
	CarrierCount int
	// Networks holds eager-loaded network rows for terminal/JSON rendering. Nil for web UI requests.
	Networks []OrgNetworkRow `json:"networks,omitempty"`
	// IXPs holds eager-loaded IXP rows for terminal/JSON rendering. Nil for web UI requests.
	IXPs []OrgIXRow `json:"ixps,omitempty"`
	// Facs holds eager-loaded facility rows for terminal/JSON rendering. Nil for web UI requests.
	Facs []OrgFacilityRow `json:"facilities,omitempty"`
	// Campuses holds eager-loaded campus rows for terminal/JSON rendering. Nil for web UI requests.
	Campuses []OrgCampusRow `json:"campuses,omitempty"`
	// Carriers holds eager-loaded carrier rows for terminal/JSON rendering. Nil for web UI requests.
	Carriers []OrgCarrierRow `json:"carriers,omitempty"`
}

type OrgFacilityRow struct {
	// FacName is the facility name.
	FacName string
	// FacID is the facility's PeeringDB ID for cross-linking.
	FacID int
	// City is the facility's city.
	City string
	// Country is the facility's country code.
	Country string
	// Latitude is the facility's geographic latitude. Zero means no data.
	Latitude float64
	// Longitude is the facility's geographic longitude. Zero means no data.
	Longitude float64
}

type OrgIXRow struct {
	// IXName is the exchange name.
	IXName string
	// IXID is the exchange's PeeringDB ID for cross-linking.
	IXID int
}

type OrgNetworkRow struct {
	// NetName is the network's name.
	NetName string
	// ASN is the network's Autonomous System Number.
	ASN int
}

type PrivacySync struct {
	// AuthMode is the human-readable label: "Authenticated with PeeringDB
	// API key" or "Anonymous (no key)".
	AuthMode string

	// PublicTier is the lowercase env-var value: "public" or "users".
	// Matches PDBPLUS_PUBLIC_TIER so operators can map the UI back to the
	// deploy config without translating.
	PublicTier string

	// PublicTierExplanation is the one-line plain-language gloss of what
	// PublicTier means for an anonymous caller's data view. Rendered below
	// the PublicTier value on both surfaces.
	PublicTierExplanation string

	// OverrideActive is true when PublicTier == "users". When true, the
	// HTML renders an amber "Override active" badge and the terminal
	// prepends a "! " indicator to the Public Tier line.
	OverrideActive bool
}

type SearchGroup struct {
	// TypeName is the human-readable plural name (e.g. "Networks", "IXPs").
	TypeName string
	// TypeSlug is the short identifier used in URLs (e.g. "net", "ix").
	TypeSlug string
	// AccentColor is the Tailwind color name for visual grouping (e.g. "emerald", "sky").
	AccentColor string
	// Results holds up to 10 matching entities.
	Results []SearchResult
	// HasMore indicates whether additional matches exist beyond the displayed results.
	HasMore bool
	// Total is the exact number of matches across all pages. Equals len(Results)
	// when HasMore is false; drives the "View all N" link when HasMore is true.
	Total int
}

type SearchResult struct {
	// Name is the entity's display name.
	Name string
	// Country is the ISO 3166-1 alpha-2 code; empty if not available.
	Country string
	// City is the city name; empty if not available.
	City string
	// ASN is the AS number; 0 if not applicable (non-network entity).
	ASN int
	// DetailURL is the path to the entity's detail page (e.g. "/ui/asn/13335").
	DetailURL string
}

type SearchTypeView struct {
	// TypeName is the human-readable plural name (e.g. "Networks").
	TypeName string
	// TypeSlug is the short identifier used in URLs (e.g. "net").
	TypeSlug string
	// AccentColor is the Tailwind color name for visual grouping.
	AccentColor string
	// Query is the search term, echoed in the header and pagination links.
	Query string
	// Total is the exact number of matches across all pages.
	Total int
	// Hits holds this page's matching entities.
	Hits []SearchResult
	// HasMore indicates whether matches exist beyond this page.
	HasMore bool
	// NextOffset is the offset for the next "Load more" request.
	NextOffset int
}