generated

type AdminAuditLogEntry struct {
	// Action The admin action performed
	//
	// Example: disable_user
	Action string `json:"action"`

	// AdminEmail Email of the admin who performed the action (if the account still exists)
	AdminEmail *openapi_types.Email `json:"adminEmail,omitempty"`

	// AdminName Display name of the admin who performed the action (if the account still exists)
	AdminName   *string            `json:"adminName,omitempty"`
	AdminUserId openapi_types.UUID `json:"adminUserId"`
	CreatedAt   time.Time          `json:"createdAt"`

	// Details Additional details about the action (JSON)
	Details *map[string]interface{} `json:"details,omitempty"`
	Id      openapi_types.UUID      `json:"id"`

	// TargetUserEmail Email of the target user (if any, and if the account still exists)
	TargetUserEmail *openapi_types.Email `json:"targetUserEmail,omitempty"`

	// TargetUserId The user affected by the action (if any)
	TargetUserId *openapi_types.UUID `json:"targetUserId,omitempty"`

	// TargetUserName Display name of the target user (if any, and if the account still exists)
	TargetUserName *string `json:"targetUserName,omitempty"`
}

type AdminConfig struct {
	// AdminEmailConfigured Whether ADMIN_EMAIL is set
	AdminEmailConfigured bool `json:"adminEmailConfigured"`

	// AirportDatabaseSize Number of airports loaded
	//
	// Example: 29331
	AirportDatabaseSize int `json:"airportDatabaseSize"`

	// AirportDatabaseUpdatedAt When the airport database was last loaded from the upstream sources; null when it never loaded
	AirportDatabaseUpdatedAt *time.Time `json:"airportDatabaseUpdatedAt,omitempty"`

	// AppVersion Version this API binary was stamped with at build time, falling back to APP_VERSION. `dev` for an unstamped build.
	//
	// Example: v1.3.4
	AppVersion *string `json:"appVersion,omitempty"`

	// AuthMode Active authentication mode (oidc when OIDC_ISSUER is set)
	AuthMode *AdminConfigAuthMode `json:"authMode,omitempty"`

	// CloudBackupProviders Names of registered cloud backup providers (e.g. s3, sftp, webdav). Empty when cloud backups are disabled.
	//
	// Example: ["s3","sftp","webdav"]
	CloudBackupProviders []string `json:"cloudBackupProviders"`

	// CloudBackupsConfigured Whether cloud backups are enabled (BACKUP_CREDENTIALS_KEY is set)
	CloudBackupsConfigured bool `json:"cloudBackupsConfigured"`

	// CorsOrigins Configured CORS allowed origins
	CorsOrigins []string `json:"corsOrigins"`

	// DocumentFilesEnabled Whether licence/credential reference files are enabled (DOCUMENT_FILES_ENABLED is not "false")
	DocumentFilesEnabled *bool `json:"documentFilesEnabled,omitempty"`

	// EmailSuppressedCount Addresses currently suppressed after a permanent delivery failure.
	EmailSuppressedCount *int `json:"emailSuppressedCount,omitempty"`

	// GoVersion Example: go1.23.0
	GoVersion string `json:"goVersion"`

	// MaxSessionsPerUser Concurrent sessions kept per user (MAX_SESSIONS_PER_USER) before the least recently used is evicted
	//
	// Example: 5
	MaxSessionsPerUser *int `json:"maxSessionsPerUser,omitempty"`

	// MigrationVersion Current database migration version
	//
	// Example: 28
	MigrationVersion int `json:"migrationVersion"`

	// OidcIssuer Configured OIDC issuer URL. Present only in oidc mode; the client ID and secret are never exposed.
	OidcIssuer *string `json:"oidcIssuer,omitempty"`

	// OidcNativeRedirect Where a native-client login finishes, from OIDC_NATIVE_POST_LOGIN_REDIRECT. Present only in oidc mode.
	//
	// Example: ninerlog://auth/callback
	OidcNativeRedirect *string `json:"oidcNativeRedirect,omitempty"`

	// RateLimitAdmin Admin endpoint rate limit
	//
	// Example: 30 req/min
	RateLimitAdmin string `json:"rateLimitAdmin"`

	// RateLimitAuth Auth endpoint rate limit
	//
	// Example: 10 req/min
	RateLimitAuth string `json:"rateLimitAuth"`

	// RefreshReuseGrace How long a rotated refresh token stays usable (REFRESH_REUSE_GRACE)
	//
	// Example: 30s
	RefreshReuseGrace *string `json:"refreshReuseGrace,omitempty"`

	// RegistrationPrefixCount Number of ICAO aircraft nationality marks in the vendored registration table
	//
	// Example: 210
	RegistrationPrefixCount int `json:"registrationPrefixCount"`

	// RegistrationPrefixesReviewed When the vendored nationality mark table was last checked against ICAO's published nationality marks. The table is vendored rather than fetched, so this is the only signal that it may be stale.
	//
	// Example: 2026-08-17
	RegistrationPrefixesReviewed openapi_types.Date `json:"registrationPrefixesReviewed"`

	// ServerUptime Human-readable uptime
	//
	// Example: 2d 5h 30m
	ServerUptime string `json:"serverUptime"`

	// SmtpConfigured Whether SMTP is configured
	SmtpConfigured bool `json:"smtpConfigured"`

	// UnverifiedCleanupDisabledReason Why the cleanup is not running, absent when it is. `oidc_mode` is not
	// configurable: with an identity provider in charge, an unverified
	// account is one the provider did not assert `email_verified` for — not
	// an abandoned signup — so reaping is refused outright.
	UnverifiedCleanupDisabledReason *AdminConfigUnverifiedCleanupDisabledReason `json:"unverifiedCleanupDisabledReason,omitempty"`

	// UnverifiedCleanupEnabled Whether unverified accounts are reminded and then deleted. Requires
	// SMTP to be configured; without it, registration marks accounts
	// verified immediately and nothing is reaped. Always false in OIDC
	// mode.
	UnverifiedCleanupEnabled *bool `json:"unverifiedCleanupEnabled,omitempty"`

	// UnverifiedReminderAfter How long after signup the verification reminder is sent.
	//
	// Example: 24h0m0s
	UnverifiedReminderAfter *string `json:"unverifiedReminderAfter,omitempty"`

	// UnverifiedRetention How long an account survives, unverified, after that reminder before
	// it is deleted.
	//
	//
	// Example: 720h0m0s
	UnverifiedRetention *string `json:"unverifiedRetention,omitempty"`

	// UpdateCheckEnabled Whether the deployment checks GitHub for newer releases (UPDATE_CHECK_ENABLED)
	UpdateCheckEnabled *bool `json:"updateCheckEnabled,omitempty"`

	// UpdateCheckInterval How often the release check runs. Absent when the check is disabled.
	//
	// Example: 24h0m0s
	UpdateCheckInterval *string `json:"updateCheckInterval,omitempty"`
}

type AdminConfigAuthMode string

type AdminConfigUnverifiedCleanupDisabledReason string

type AdminStats struct {
	// ActiveSessions Live sessions across all users. A session is live while it holds an unrevoked, unexpired refresh token, so this counts signed-in devices rather than users.
	ActiveSessions int `json:"activeSessions"`

	// CloudBackupDestinations Counts of user-configured cloud backup destinations.
	CloudBackupDestinations struct {
		// ByProvider Number of destinations grouped by provider name (e.g. {"s3": 3, "sftp": 1}). Providers with zero destinations are omitted.
		//
		// Example: {"s3":3,"sftp":1}
		ByProvider map[string]int `json:"byProvider"`

		// Total Total number of cloud backup destinations configured across all users.
		Total int `json:"total"`
	} `json:"cloudBackupDestinations"`
	DisabledAccounts int `json:"disabledAccounts"`
	FlightsThisMonth int `json:"flightsThisMonth"`

	// ImportsByFormat Completed imports grouped by the detected source format, i.e. which logbook pilots are migrating from. Keys are ImportFormat values; formats nobody has imported are omitted.
	//
	// Example: {"CSV":2,"FOREFLIGHT_CSV":12,"MYFLIGHTBOOK_CSV":4}
	ImportsByFormat  map[string]int `json:"importsByFormat"`
	LockedAccounts   int            `json:"lockedAccounts"`
	NewUsersThisWeek int            `json:"newUsersThisWeek"`
	TotalAircraft    int            `json:"totalAircraft"`

	// TotalContacts Contacts across all users. Grows on its own as flights are logged, since crew names are turned into contacts automatically.
	TotalContacts    int `json:"totalContacts"`
	TotalCredentials int `json:"totalCredentials"`

	// TotalFlights Flights across all users. Excludes FSTD sessions and passenger flights, which are counted separately.
	TotalFlights int `json:"totalFlights"`
	TotalImports int `json:"totalImports"`

	// TotalPassengerFlights Flights across all users whose owner was carried as a passenger rather than crewing. Recorded separately and never summed into flight time.
	TotalPassengerFlights int `json:"totalPassengerFlights"`

	// TotalSimulatorSessions FSTD (simulator) sessions across all users. Recorded separately from flights and never summed into flight time (EASA AMC1 FCL.050).
	TotalSimulatorSessions int `json:"totalSimulatorSessions"`
	TotalUsers             int `json:"totalUsers"`
}

type AdminUser struct {
	// AircraftCount Number of aircraft in database
	AircraftCount int       `json:"aircraftCount"`
	CreatedAt     time.Time `json:"createdAt"`

	// Disabled Whether the account is disabled by admin
	Disabled bool                `json:"disabled"`
	Email    openapi_types.Email `json:"email"`

	// EmailSuppressed Whether this address is on the suppression list after a permanent
	// delivery failure. A suppressed address receives no further mail, so
	// an unverified account with this flag set will never verify.
	EmailSuppressed *bool `json:"emailSuppressed,omitempty"`

	// EmailVerified Whether the user has verified their email address and completed sign-up
	EmailVerified bool `json:"emailVerified"`

	// FlightCount Total number of flights logged
	FlightCount int                `json:"flightCount"`
	Id          openapi_types.UUID `json:"id"`

	// LastLoginAt Last successful sign-in. Recorded for every path that issues a session: password login, the second factor, a passkey, OIDC, and the sign-up verification link (following it signs the new account in). Not updated by a token refresh.
	LastLoginAt *time.Time `json:"lastLoginAt,omitempty"`

	// Locked Whether the account is locked due to brute-force protection
	Locked *bool `json:"locked,omitempty"`

	// LockedUntil When the brute-force lock expires
	LockedUntil *time.Time `json:"lockedUntil,omitempty"`
	Name        string     `json:"name"`

	// ScheduledDeletionAt When this unverified account will be deleted if the address is still
	// not confirmed. Absent for verified accounts and for accounts that
	// have not been reminded yet.
	ScheduledDeletionAt *time.Time `json:"scheduledDeletionAt,omitempty"`
	TwoFactorEnabled    bool       `json:"twoFactorEnabled"`

	// VerificationReminderSentAt When the follow-up email-verification reminder was sent. Absent when
	// the account is verified, or when the reminder is not due yet. This
	// timestamp starts the retention clock: an account still unverified
	// once the retention window has elapsed from here is deleted.
	VerificationReminderSentAt *time.Time `json:"verificationReminderSentAt,omitempty"`
}

type Aircraft struct {
	// AircraftClass Aircraft class (e.g., SEP_LAND, MEP_LAND, TMG, or any custom value)
	//
	// Example: SEP_LAND
	AircraftClass *string `json:"aircraftClass,omitempty"`

	// CreatedAt Example: 2026-01-15T10:00:00Z
	CreatedAt time.Time `json:"createdAt"`

	// DefaultArrivalIcao Default arrival location (ICAO code or free-text place name) prefilled when logging a flight with this aircraft
	//
	// Example: LSZH
	DefaultArrivalIcao *string `json:"defaultArrivalIcao,omitempty"`

	// DefaultDepartureIcao Default departure location (ICAO code or free-text place name) prefilled when logging a flight with this aircraft
	//
	// Example: LSZH
	DefaultDepartureIcao *string `json:"defaultDepartureIcao,omitempty"`

	// Id Example: 770e8400-e29b-41d4-a716-446655440002
	Id openapi_types.UUID `json:"id"`

	// IsActive Whether aircraft is still active in the user's fleet
	//
	// Example: true
	IsActive *bool `json:"isActive,omitempty"`

	// IsComplex Whether aircraft has retractable gear, flaps, and constant speed propeller
	//
	// Example: false
	IsComplex *bool `json:"isComplex,omitempty"`

	// IsHighPerformance Whether aircraft has more than 200 HP
	//
	// Example: false
	IsHighPerformance *bool `json:"isHighPerformance,omitempty"`

	// IsMultiPilot Whether the type is certificated for a minimum crew of two pilots. Co-pilot time is loggable only on such an aircraft.
	//
	// Example: false
	IsMultiPilot *bool `json:"isMultiPilot,omitempty"`

	// IsTailwheel Whether aircraft has tailwheel (conventional gear)
	//
	// Example: false
	IsTailwheel *bool `json:"isTailwheel,omitempty"`

	// Make Aircraft manufacturer
	//
	// Example: Cessna
	Make string `json:"make"`

	// Model Aircraft model name
	//
	// Example: 172 Skyhawk
	Model string `json:"model"`

	// Notes Additional notes about the aircraft
	//
	// Example: Club aircraft, requires checkout
	Notes *string `json:"notes,omitempty"`

	// Registration Aircraft registration/tail number. Normalised on write into the canonical notation of its state of registry: the nationality mark is matched against the ICAO table and the hyphen inserted, moved or removed to suit (`deabc` and `DE-ABC` both become `D-EABC`; `N-12345` becomes `N12345`). A registration whose nationality mark is not recognised is stored uppercased and trimmed, but otherwise unchanged.
	//
	// Example: D-EFGH
	Registration string `json:"registration"`

	// Type Aircraft type designation (e.g., C172, PA28, ASK21)
	//
	// Example: C172
	Type string `json:"type"`

	// UpdatedAt Example: 2026-02-01T14:30:00Z
	UpdatedAt time.Time `json:"updatedAt"`

	// UserId Example: 550e8400-e29b-41d4-a716-446655440000
	UserId openapi_types.UUID `json:"userId"`
}

type AircraftCreate struct {
	// AircraftClass Aircraft class (e.g., SEP_LAND, MEP_LAND, TMG, or any custom value)
	//
	// Example: SEP_LAND
	AircraftClass *string `json:"aircraftClass,omitempty"`

	// DefaultArrivalIcao Default arrival location (ICAO code or free-text place name) prefilled when logging a flight with this aircraft
	//
	// Example: LSZH
	DefaultArrivalIcao *string `json:"defaultArrivalIcao,omitempty"`

	// DefaultDepartureIcao Default departure location (ICAO code or free-text place name) prefilled when logging a flight with this aircraft
	//
	// Example: LSZH
	DefaultDepartureIcao *string `json:"defaultDepartureIcao,omitempty"`

	// IsComplex Example: false
	IsComplex *bool `json:"isComplex,omitempty"`

	// IsHighPerformance Example: false
	IsHighPerformance *bool `json:"isHighPerformance,omitempty"`

	// IsMultiPilot Whether the type is certificated for a minimum crew of two pilots. Co-pilot time is loggable only on such an aircraft.
	//
	// Example: false
	IsMultiPilot *bool `json:"isMultiPilot,omitempty"`

	// IsTailwheel Example: false
	IsTailwheel *bool `json:"isTailwheel,omitempty"`

	// Make Aircraft manufacturer
	//
	// Example: Cessna
	Make string `json:"make"`

	// Model Aircraft model name
	//
	// Example: 172 Skyhawk
	Model string `json:"model"`

	// Notes Example: Club aircraft, requires checkout
	Notes *string `json:"notes,omitempty"`

	// Registration Aircraft registration/tail number. Normalised on write into the canonical notation of its state of registry: the nationality mark is matched against the ICAO table and the hyphen inserted, moved or removed to suit (`deabc` and `DE-ABC` both become `D-EABC`; `N-12345` becomes `N12345`). A registration whose nationality mark is not recognised is stored uppercased and trimmed, but otherwise unchanged.
	//
	// Example: D-EFGH
	Registration string `json:"registration"`

	// Type Aircraft type designation
	//
	// Example: C172
	Type string `json:"type"`
}

type AircraftId = openapi_types.UUID

type AircraftStats struct {
	// FirstFlightDate Date (YYYY-MM-DD) of the first logged flight with this registration
	//
	// Example: 2024-03-02
	FirstFlightDate *string `json:"firstFlightDate,omitempty"`

	// LandingsDay Total day landings with this registration
	//
	// Example: 55
	LandingsDay int `json:"landingsDay"`

	// LandingsLast90Days Total landings with this registration in the preceding 90 days
	//
	// Example: 5
	LandingsLast90Days int `json:"landingsLast90Days"`

	// LandingsNight Total night landings with this registration
	//
	// Example: 4
	LandingsNight int `json:"landingsNight"`

	// LastFlightDate Date (YYYY-MM-DD) of the most recent logged flight with this registration
	//
	// Example: 2026-06-14
	LastFlightDate *string `json:"lastFlightDate,omitempty"`

	// RecencyLapsesOn Informational 90-day recency (styled after EASA FCL.060(b) day recency, 3 landings in 90 days): last date on which the 90-day landing count is still 3 or more. Only set while the count is currently 3 or more.
	//
	// Example: 2026-09-03
	RecencyLapsesOn *string `json:"recencyLapsesOn,omitempty"`

	// Registration Aircraft registration the statistics are aggregated for
	//
	// Example: D-EFGH
	Registration string `json:"registration"`

	// TotalFlights Number of logged flights with this registration
	//
	// Example: 42
	TotalFlights int `json:"totalFlights"`

	// TotalMinutes Total flight time in minutes with this registration
	//
	// Example: 2530
	TotalMinutes int `json:"totalMinutes"`
}

type AircraftTypeStats struct {
	// AircraftType Aircraft type/model designation the statistics are aggregated for
	//
	// Example: C172
	AircraftType string `json:"aircraftType"`

	// FirstFlightDate Date (YYYY-MM-DD) of the first logged flight on this type
	//
	// Example: 2024-03-02
	FirstFlightDate *string `json:"firstFlightDate,omitempty"`

	// LandingsDay Total day landings on this type
	//
	// Example: 55
	LandingsDay int `json:"landingsDay"`

	// LandingsLast90Days Total landings on this type in the preceding 90 days
	//
	// Example: 5
	LandingsLast90Days int `json:"landingsLast90Days"`

	// LandingsNight Total night landings on this type
	//
	// Example: 4
	LandingsNight int `json:"landingsNight"`

	// LastFlightDate Date (YYYY-MM-DD) of the most recent logged flight on this type
	//
	// Example: 2026-06-14
	LastFlightDate *string `json:"lastFlightDate,omitempty"`

	// RecencyLapsesOn Informational 90-day recency (styled after EASA FCL.060(b) day recency, 3 landings in 90 days): last date on which the 90-day landing count is still 3 or more. Only set while the count is currently 3 or more.
	//
	// Example: 2026-09-03
	RecencyLapsesOn *string `json:"recencyLapsesOn,omitempty"`

	// TotalFlights Number of logged flights on this type
	//
	// Example: 42
	TotalFlights int `json:"totalFlights"`

	// TotalMinutes Total flight time in minutes on this type
	//
	// Example: 2530
	TotalMinutes int `json:"totalMinutes"`
}

type AircraftUpdate struct {
	// AircraftClass Aircraft class (e.g., SEP_LAND, MEP_LAND, TMG, or any custom value)
	//
	// Example: SEP_LAND
	AircraftClass nullable.Nullable[string] `json:"aircraftClass,omitempty"`

	// DefaultArrivalIcao Default arrival location (ICAO code or free-text place name) prefilled when logging a flight with this aircraft
	//
	// Example: LSZH
	DefaultArrivalIcao nullable.Nullable[string] `json:"defaultArrivalIcao,omitempty"`

	// DefaultDepartureIcao Default departure location (ICAO code or free-text place name) prefilled when logging a flight with this aircraft
	//
	// Example: LSZH
	DefaultDepartureIcao nullable.Nullable[string] `json:"defaultDepartureIcao,omitempty"`

	// IsActive Example: true
	IsActive *bool `json:"isActive,omitempty"`

	// IsComplex Example: false
	IsComplex *bool `json:"isComplex,omitempty"`

	// IsHighPerformance Example: false
	IsHighPerformance *bool `json:"isHighPerformance,omitempty"`

	// IsMultiPilot Whether the type is certificated for a minimum crew of two pilots. Co-pilot time is loggable only on such an aircraft.
	//
	// Example: false
	IsMultiPilot *bool `json:"isMultiPilot,omitempty"`

	// IsTailwheel Example: false
	IsTailwheel *bool `json:"isTailwheel,omitempty"`

	// Make Example: Cessna
	Make *string `json:"make,omitempty"`

	// Model Example: 172 Skyhawk
	Model *string `json:"model,omitempty"`

	// Notes Example: Club aircraft, requires checkout
	Notes nullable.Nullable[string] `json:"notes,omitempty"`

	// Registration Example: D-EFGH
	Registration *string `json:"registration,omitempty"`

	// RenameFlights When true and the registration is being changed, logged flights that reference the old registration are updated to the new one.
	//
	// Example: false
	RenameFlights *bool `json:"renameFlights,omitempty"`

	// Type Example: C172
	Type *string `json:"type,omitempty"`
}

type Airport struct {
	// Country Country code (ISO 3166-1 alpha-2)
	//
	// Example: DE
	Country *string `json:"country,omitempty"`

	// Elevation Airport elevation in feet
	//
	// Example: 364
	Elevation *int `json:"elevation,omitempty"`

	// Icao ICAO airport code
	//
	// Example: EDDF
	Icao string `json:"icao"`

	// Latitude Latitude in decimal degrees
	//
	// Example: 50.033333
	Latitude float64 `json:"latitude"`

	// Longitude Longitude in decimal degrees
	//
	// Example: 8.570556
	Longitude float64 `json:"longitude"`

	// Name Airport name
	//
	// Example: Frankfurt am Main
	Name string `json:"name"`
}

type AirportPackStatus struct {
	// Count Number of airports in the pack
	//
	// Example: 29331
	Count int `json:"count"`

	// Etag Content identifier of the current pack (hex SHA-256 over the
	// airport data). Changes only when the merged dataset changes.
	//
	//
	// Example: 3f6b1c9a2d4e5f60
	Etag string `json:"etag"`

	// GeneratedAt When the live airport snapshot was loaded from the upstream sources
	GeneratedAt time.Time `json:"generatedAt"`

	// SizeBytes Size of the gzip-compressed pack in bytes
	//
	// Example: 745211
	SizeBytes int `json:"sizeBytes"`
}

type AirportStats struct {
	// Arrivals Number of arrivals to this airport
	Arrivals int `json:"arrivals"`

	// Departures Number of departures from this airport
	Departures int `json:"departures"`

	// Icao Example: EDDF
	Icao      string  `json:"icao"`
	Latitude  float64 `json:"latitude"`
	Longitude float64 `json:"longitude"`

	// Name Example: Frankfurt am Main
	Name string `json:"name"`

	// TotalFlights Total flights (departures + arrivals)
	TotalFlights int `json:"totalFlights"`
}

type AnalyticsAircraftRow struct {
	DistanceNm      float64 `json:"distanceNm"`
	DualMinutes     int     `json:"dualMinutes"`
	FirstFlightDate *string `json:"firstFlightDate,omitempty"`
	Flights         int     `json:"flights"`
	IfrMinutes      int     `json:"ifrMinutes"`

	// Label Aircraft type designation, or registration for byRegistration rows.
	//
	// Example: C172
	Label          string  `json:"label"`
	Landings       int     `json:"landings"`
	LastFlightDate *string `json:"lastFlightDate,omitempty"`
	NightMinutes   int     `json:"nightMinutes"`
	PicMinutes     int     `json:"picMinutes"`

	// SubLabel Aircraft type for byRegistration rows, or make/model where known.
	//
	// Example: Cessna 172S
	SubLabel     *string `json:"subLabel,omitempty"`
	TotalMinutes int     `json:"totalMinutes"`
}

type AnalyticsAirportRow struct {
	Arrivals int `json:"arrivals"`

	// Country Example: DE
	Country    *string `json:"country,omitempty"`
	Departures int     `json:"departures"`

	// Flights Flights touching this airport. A local flight departing and arriving here counts once.
	Flights int `json:"flights"`

	// Icao Example: EDNY
	Icao      string   `json:"icao"`
	Latitude  *float64 `json:"latitude,omitempty"`
	Longitude *float64 `json:"longitude,omitempty"`

	// Name Null when the code does not resolve against the airport database.
	//
	// Example: Friedrichshafen Airport
	Name *string `json:"name,omitempty"`
}

type AnalyticsApproachTypeRow struct {
	Count int `json:"count"`

	// Type Example: ILS
	Type string `json:"type"`
}

type AnalyticsBucketRow struct {
	Flights int `json:"flights"`

	// Key Bucket index. Day of week 1–7 (Monday first), hour of day 0–23 UTC, month of year 1–12, duration bucket 0–5.
	//
	// Example: 1
	Key int `json:"key"`

	// Label Stable machine label for the bucket. Clients localize by key.
	//
	// Example: <30m
	Label        string `json:"label"`
	TotalMinutes int    `json:"totalMinutes"`
}

type AnalyticsCountryRow struct {
	// Airports Distinct airports visited in this country.
	Airports int `json:"airports"`

	// Country ISO 3166-1 alpha-2 country code from the airport database.
	//
	// Example: DE
	Country string `json:"country"`
	Flights int    `json:"flights"`
}

type AnalyticsFlightRef struct {
	AircraftReg  *string `json:"aircraftReg,omitempty"`
	AircraftType *string `json:"aircraftType,omitempty"`
	ArrivalIcao  *string `json:"arrivalIcao,omitempty"`

	// Date Example: 2026-05-17
	Date          string             `json:"date"`
	DepartureIcao *string            `json:"departureIcao,omitempty"`
	DistanceNm    float64            `json:"distanceNm"`
	Id            openapi_types.UUID `json:"id"`
	TotalMinutes  int                `json:"totalMinutes"`
}

type AnalyticsGroupRow struct {
	DualMinutes int `json:"dualMinutes"`
	Flights     int `json:"flights"`

	// Label Example: SEP_LAND
	Label        string `json:"label"`
	Landings     int    `json:"landings"`
	PicMinutes   int    `json:"picMinutes"`
	TotalMinutes int    `json:"totalMinutes"`
}

type AnalyticsMonthPoint struct {
	// CumulativeMinutes Running total of block time from the very first logged flight up to and including this month, so the curve reflects true career hours even when the timeframe starts later.
	CumulativeMinutes int     `json:"cumulativeMinutes"`
	DistanceNm        float64 `json:"distanceNm"`
	DualGivenMinutes  int     `json:"dualGivenMinutes"`
	DualMinutes       int     `json:"dualMinutes"`
	Flights           int     `json:"flights"`
	IfrMinutes        int     `json:"ifrMinutes"`
	LandingsDay       int     `json:"landingsDay"`
	LandingsNight     int     `json:"landingsNight"`

	// Month Calendar month, YYYY-MM.
	//
	// Example: 2026-07
	Month        string `json:"month"`
	NightMinutes int    `json:"nightMinutes"`
	PicMinutes   int    `json:"picMinutes"`
	SicMinutes   int    `json:"sicMinutes"`
	SoloMinutes  int    `json:"soloMinutes"`
	TotalMinutes int    `json:"totalMinutes"`
}

type AnalyticsPersonRow struct {
	// ContactId The contact the person's crew entries are linked to, when they are
	// linked to one. byCrew rows only.
	ContactId      *openapi_types.UUID `json:"contactId,omitempty"`
	Flights        int                 `json:"flights"`
	LastFlightDate *string             `json:"lastFlightDate,omitempty"`

	// Name Example: J. Smith
	Name string `json:"name"`

	// Role The role this person most flies with you as (by time), for byCrew
	// rows only.
	//
	//
	// Example: PIC
	Role *string `json:"role,omitempty"`

	// Roles Every role this person has held across the logbook, most time
	// first. byCrew rows only.
	Roles        *[]string `json:"roles,omitempty"`
	TotalMinutes int       `json:"totalMinutes"`
}

type AnalyticsRange struct {
	// AllTime True when the payload covers the entire logbook.
	AllTime bool `json:"allTime"`

	// From First date included in the timeframe. Null when allTime is true.
	//
	// Example: 2025-08-01
	From *string `json:"from,omitempty"`

	// Months Requested timeframe in months. 0 means all time.
	//
	// Example: 12
	Months int `json:"months"`

	// To Last date included in the timeframe (the current date).
	//
	// Example: 2026-07-27
	To *string `json:"to,omitempty"`
}

type AnalyticsRecords struct {
	// ActiveMonths Number of calendar months in the timeframe with at least one flight.
	ActiveMonths int `json:"activeMonths"`

	// BusiestDay Date with the most flights logged.
	//
	// Example: 2026-05-17
	BusiestDay        *string `json:"busiestDay,omitempty"`
	BusiestDayFlights int     `json:"busiestDayFlights"`

	// BusiestMonth Calendar month with the most block time.
	//
	// Example: 2026-05
	BusiestMonth        *string `json:"busiestMonth,omitempty"`
	BusiestMonthMinutes *int    `json:"busiestMonthMinutes,omitempty"`

	// BusiestYear Example: 2026
	BusiestYear        *int `json:"busiestYear,omitempty"`
	BusiestYearMinutes *int `json:"busiestYearMinutes,omitempty"`

	// CurrentStreakMonths Consecutive months with at least one flight ending at the current month.
	CurrentStreakMonths int `json:"currentStreakMonths"`

	// DaysSinceLastFlight Null when the logbook is empty.
	DaysSinceLastFlight *int                 `json:"daysSinceLastFlight,omitempty"`
	FarthestAirport     *AnalyticsAirportRow `json:"farthestAirport,omitempty"`

	// FarthestAirportNm Great-circle distance from the home base to the farthest visited airport.
	FarthestAirportNm *float64 `json:"farthestAirportNm,omitempty"`

	// HomeBase Most-visited airport, used as the reference point for farthestAirport.
	//
	// Example: EDNY
	HomeBase              *string             `json:"homeBase,omitempty"`
	LongestDistanceFlight *AnalyticsFlightRef `json:"longestDistanceFlight,omitempty"`
	LongestFlight         *AnalyticsFlightRef `json:"longestFlight,omitempty"`

	// LongestStreakMonths Longest run of consecutive calendar months with at least one flight, within the timeframe.
	LongestStreakMonths int `json:"longestStreakMonths"`
}

type AnalyticsRouteRow struct {
	// ArrivalIcao Example: LSZH
	ArrivalIcao string `json:"arrivalIcao"`

	// DepartureIcao Example: EDNY
	DepartureIcao string `json:"departureIcao"`

	// DistanceNm Great-circle distance of a single leg on this route.
	DistanceNm   float64 `json:"distanceNm"`
	Flights      int     `json:"flights"`
	TotalMinutes int     `json:"totalMinutes"`
}

type AnalyticsTotals struct {
	ActualInstrumentMinutes int `json:"actualInstrumentMinutes"`
	Approaches              int `json:"approaches"`
	CrossCountryMinutes     int `json:"crossCountryMinutes"`

	// DistanceNm Great-circle distance summed over all flights with known departure and arrival airports.
	//
	// Example: 18422.5
	DistanceNm float64 `json:"distanceNm"`

	// DistinctAirports Unique airports visited as either departure or arrival.
	DistinctAirports int `json:"distinctAirports"`

	// DistinctCountries Unique countries of the visited airports that resolve against the airport database.
	DistinctCountries     int `json:"distinctCountries"`
	DistinctRegistrations int `json:"distinctRegistrations"`
	DistinctTypes         int `json:"distinctTypes"`

	// DualGivenMinutes Instruction given as an instructor.
	DualGivenMinutes int `json:"dualGivenMinutes"`

	// DualMinutes Dual instruction received.
	DualMinutes int `json:"dualMinutes"`

	// ExaminerMinutes Time conducting checks as examiner.
	ExaminerMinutes int `json:"examinerMinutes"`

	// FirstFlightDate Example: 2024-03-02
	FirstFlightDate *string `json:"firstFlightDate,omitempty"`

	// GroundTrainingMinutes Ground instruction. Not included in totalMinutes.
	GroundTrainingMinutes int `json:"groundTrainingMinutes"`
	Holds                 int `json:"holds"`
	IfrMinutes            int `json:"ifrMinutes"`
	LandingsDay           int `json:"landingsDay"`
	LandingsNight         int `json:"landingsNight"`

	// LastFlightDate Example: 2026-07-14
	LastFlightDate *string `json:"lastFlightDate,omitempty"`

	// MultiPilotMinutes EASA AMC1 FCL.050 column 10.
	MultiPilotMinutes int `json:"multiPilotMinutes"`
	NightMinutes      int `json:"nightMinutes"`
	PicMinutes        int `json:"picMinutes"`

	// PicusMinutes PIC under supervision (PICUS) time.
	PicusMinutes int `json:"picusMinutes"`

	// ReliefMinutes Cruise relief co-pilot time.
	ReliefMinutes int `json:"reliefMinutes"`
	SicMinutes    int `json:"sicMinutes"`

	// SimulatedFlightMinutes FSTD/simulator time. Not included in totalMinutes.
	SimulatedFlightMinutes int `json:"simulatedFlightMinutes"`

	// SimulatedInstrumentMinutes Hood/simulated instrument time in an aircraft.
	SimulatedInstrumentMinutes int `json:"simulatedInstrumentMinutes"`
	SoloMinutes                int `json:"soloMinutes"`

	// SpicMinutes Student pilot-in-command (SPIC) time.
	SpicMinutes   int `json:"spicMinutes"`
	TakeoffsDay   int `json:"takeoffsDay"`
	TakeoffsNight int `json:"takeoffsNight"`

	// TotalFlights Example: 214
	TotalFlights int `json:"totalFlights"`

	// TotalMinutes Total block time.
	//
	// Example: 23480
	TotalMinutes int `json:"totalMinutes"`
}

type AnalyticsYearPoint struct {
	DistanceNm   float64 `json:"distanceNm"`
	DualMinutes  int     `json:"dualMinutes"`
	Flights      int     `json:"flights"`
	IfrMinutes   int     `json:"ifrMinutes"`
	Landings     int     `json:"landings"`
	NightMinutes int     `json:"nightMinutes"`
	PicMinutes   int     `json:"picMinutes"`
	TotalMinutes int     `json:"totalMinutes"`

	// Year Example: 2026
	Year int `json:"year"`
}

type Announcement struct {
	CreatedAt *time.Time `json:"createdAt,omitempty"`

	// ExpiresAt When this announcement auto-expires (null = permanent until deleted)
	ExpiresAt *time.Time `json:"expiresAt,omitempty"`

	// Id Unique identifier: a UUID for operator-authored announcements, a stable string key for hints. A hint's id doubles as its client-side localisation key — `message` is the English source text, to be used as a fallback. Operator announcements carry author-written text in `message` and are never translated.
	Id string `json:"id"`

	// Message Example: Scheduled maintenance on Tuesday 8pm-10pm UTC
	Message string `json:"message"`

	// Severity Display severity:
	// - info: blue — neutral information
	// - success: green — positive suggestions (e.g. enable 2FA)
	// - warning: orange — important notices (e.g. maintenance)
	// - critical: red — urgent alerts
	Severity AnnouncementSeverity `json:"severity"`
}

type AnnouncementSeverity string

type ApproachEntry struct {
	// Airport ICAO code of the airport where the approach was performed
	//
	// Example: EDDF
	Airport *string `json:"airport,omitempty"`

	// Runway Runway designation for the approach
	//
	// Example: 09L
	Runway *string `json:"runway,omitempty"`

	// Type Type of instrument approach procedure
	Type ApproachType `json:"type"`
}

type ApproachEntryInput struct {
	// Airport ICAO code of the airport
	Airport *string `json:"airport,omitempty"`

	// Runway Runway designation
	Runway *string `json:"runway,omitempty"`

	// Type Type of instrument approach procedure
	Type ApproachType `json:"type"`
}

type ApproachType string

type AuthProviders struct {
	// Mode The active authentication mode
	Mode AuthProvidersMode `json:"mode"`
	Oidc struct {
		// AuthorizeUrl Where to send the browser to start the login. A redirect endpoint, not a JSON API — navigate to it, do not fetch it.
		//
		// Example: /api/v1/auth/oidc/authorize
		AuthorizeUrl *string `json:"authorizeUrl,omitempty"`

		// Enabled Whether OIDC single sign-on is configured
		Enabled bool `json:"enabled"`

		// Name Display name for the sign-in button, from OIDC_PROVIDER_NAME
		//
		// Example: Authentik
		Name *string `json:"name,omitempty"`

		// NativeAuthorizeUrl Where a native app sends its in-app browser to start the login. The same redirect endpoint, flagged so the callback finishes at `nativeRedirectUri` instead of the web frontend.
		//
		// Example: /api/v1/auth/oidc/authorize?native=1
		NativeAuthorizeUrl *string `json:"nativeAuthorizeUrl,omitempty"`

		// NativeRedirectUri Where the callback sends the browser after a login started at `nativeAuthorizeUrl`, carrying the same `oidc_code` or `oidc_error` parameter. A custom scheme, which a native app can intercept without an associated domain. From OIDC_NATIVE_POST_LOGIN_REDIRECT.
		//
		// Example: ninerlog://auth/callback
		NativeRedirectUri *string `json:"nativeRedirectUri,omitempty"`
	} `json:"oidc"`

	// PasswordLoginEnabled Whether email/password sign-in is accepted
	PasswordLoginEnabled bool `json:"passwordLoginEnabled"`

	// RegistrationEnabled Whether self-service registration is accepted
	RegistrationEnabled bool `json:"registrationEnabled"`

	// TwoFactorEnabled Whether users can set up TOTP two-factor authentication
	TwoFactorEnabled bool `json:"twoFactorEnabled"`

	// WebauthnEnabled Whether passkey registration and login are available
	WebauthnEnabled bool `json:"webauthnEnabled"`
}

type AuthProvidersMode string

type AuthResponse struct {
	// AccessToken JWT access token (15 minutes validity)
	//
	// Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
	AccessToken string `json:"accessToken"`

	// ExpiresIn Access token expiry in seconds
	//
	// Example: 900
	ExpiresIn int `json:"expiresIn"`

	// RefreshToken JWT refresh token (7 days validity)
	//
	// Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
	RefreshToken string `json:"refreshToken"`
	User         User   `json:"user"`
}

type AuthorizeOidcParams struct {
	// Native Finish the login at the app's native redirect URI. Any affirmative value (`1`, `true`, `yes`) selects native mode.
	Native *string `form:"native,omitempty" json:"native,omitempty"`
}

type BackupDestination struct {
	// Config Provider-specific non-secret configuration (e.g. bucket, region, prefix).
	Config              map[string]interface{} `json:"config"`
	ConsecutiveFailures *int                   `json:"consecutiveFailures,omitempty"`
	CreatedAt           time.Time              `json:"createdAt"`

	// CredentialHint Non-sensitive hint about the stored credential (e.g. last 4 of access key).
	CredentialHint *string            `json:"credentialHint,omitempty"`
	DisplayName    string             `json:"displayName"`
	Enabled        bool               `json:"enabled"`
	Id             openapi_types.UUID `json:"id"`
	LastError      *string            `json:"lastError,omitempty"`
	LastRunAt      *time.Time         `json:"lastRunAt,omitempty"`
	LastSuccessAt  *time.Time         `json:"lastSuccessAt,omitempty"`

	// Provider Example: s3
	Provider string `json:"provider"`

	// RetentionCount Number of historical backups to retain. 0 means keep all.
	RetentionCount int `json:"retentionCount"`

	// Schedule Cadence at which scheduled runs fire (UTC). 'manual' disables scheduling.
	Schedule BackupSchedule `json:"schedule"`

	// ScheduleDayOfMonth Day of month for monthly schedule. Capped at 28 to avoid month-end edge cases.
	ScheduleDayOfMonth *int `json:"scheduleDayOfMonth,omitempty"`

	// ScheduleDayOfWeek 0=Sunday, 6=Saturday. Required when schedule=weekly.
	ScheduleDayOfWeek *int `json:"scheduleDayOfWeek,omitempty"`
	ScheduleHourUtc   *int `json:"scheduleHourUtc,omitempty"`

	// Status Operational status of a destination. 'error' is set automatically after 3 consecutive run failures.
	Status    BackupStatus       `json:"status"`
	UpdatedAt time.Time          `json:"updatedAt"`
	UserId    openapi_types.UUID `json:"userId"`
}

type BackupDestinationCreate struct {
	Config map[string]interface{} `json:"config"`

	// Credentials Secret fields. Stored encrypted at rest (AES-256-GCM) and never returned in any response.
	Credentials map[string]interface{} `json:"credentials"`
	DisplayName string                 `json:"displayName"`
	Enabled     *bool                  `json:"enabled,omitempty"`

	// Provider Example: s3
	Provider       string `json:"provider"`
	RetentionCount *int   `json:"retentionCount,omitempty"`

	// Schedule Cadence at which scheduled runs fire (UTC). 'manual' disables scheduling.
	Schedule           BackupSchedule `json:"schedule"`
	ScheduleDayOfMonth *int           `json:"scheduleDayOfMonth,omitempty"`
	ScheduleDayOfWeek  *int           `json:"scheduleDayOfWeek,omitempty"`
	ScheduleHourUtc    *int           `json:"scheduleHourUtc,omitempty"`
}

type BackupDestinationId = openapi_types.UUID

type BackupDestinationUpdate struct {
	DisplayName    *string `json:"displayName,omitempty"`
	Enabled        *bool   `json:"enabled,omitempty"`
	RetentionCount *int    `json:"retentionCount,omitempty"`

	// Schedule Cadence at which scheduled runs fire (UTC). 'manual' disables scheduling.
	Schedule           *BackupSchedule `json:"schedule,omitempty"`
	ScheduleDayOfMonth *int            `json:"scheduleDayOfMonth,omitempty"`
	ScheduleDayOfWeek  *int            `json:"scheduleDayOfWeek,omitempty"`
	ScheduleHourUtc    *int            `json:"scheduleHourUtc,omitempty"`
}

type BackupField struct {
	Description *string `json:"description,omitempty"`

	// Label Human-readable label.
	Label string `json:"label"`

	// Name Stable field key sent back as part of the config or credentials map.
	Name        string  `json:"name"`
	Placeholder *string `json:"placeholder,omitempty"`
	Required    bool    `json:"required"`

	// Type Hint for rendering provider config/credential form fields.
	Type BackupFieldType `json:"type"`
}

type BackupFieldSchema struct {
	Fields []BackupField `json:"fields"`
}

type BackupFieldType string

type BackupProvider struct {
	ConfigSchema     BackupFieldSchema `json:"configSchema"`
	CredentialSchema BackupFieldSchema `json:"credentialSchema"`
	Description      *string           `json:"description,omitempty"`

	// DisplayName Example: Amazon S3 (and compatible)
	DisplayName string `json:"displayName"`

	// Name Example: s3
	Name string `json:"name"`
}

type BackupRun struct {
	AircraftCount   *int               `json:"aircraftCount,omitempty"`
	CompletedAt     *time.Time         `json:"completedAt,omitempty"`
	CreatedAt       time.Time          `json:"createdAt"`
	CredentialCount *int               `json:"credentialCount,omitempty"`
	DestinationId   openapi_types.UUID `json:"destinationId"`
	DurationMs      *int               `json:"durationMs,omitempty"`
	ErrorMessage    *string            `json:"errorMessage,omitempty"`
	FlightCount     *int               `json:"flightCount,omitempty"`
	Id              openapi_types.UUID `json:"id"`
	LicenseCount    *int               `json:"licenseCount,omitempty"`
	RemotePath      *string            `json:"remotePath,omitempty"`
	Sha256          *string            `json:"sha256,omitempty"`
	SizeBytes       *int64             `json:"sizeBytes,omitempty"`
	StartedAt       time.Time          `json:"startedAt"`
	Status          BackupRunStatus    `json:"status"`
	Trigger         *BackupRunTrigger  `json:"trigger,omitempty"`
	UserId          openapi_types.UUID `json:"userId"`
}

type BackupRunStatus string

type BackupRunTrigger string

type BackupSchedule string

type BackupStatus string

type BackupTestResult struct {
	Message *string `json:"message,omitempty"`
	Success bool    `json:"success"`
}

type BadRequest = Error

type ChangePasswordJSONBody struct {
	// CurrentPassword The user's current password
	CurrentPassword string `json:"currentPassword"`

	// NewPassword The new password. 12–72 characters, containing at least one lowercase letter, one uppercase letter, one digit and one special character.
	NewPassword string `json:"newPassword"`
}

type ChangePasswordJSONRequestBody ChangePasswordJSONBody

type ClassRating struct {
	// ClassType Aircraft class rating type:
	// - SEP_LAND/SEP_SEA: Single Engine Piston (Land/Sea)
	// - MEP_LAND/MEP_SEA: Multi Engine Piston (Land/Sea)
	// - SET_LAND/SET_SEA: Single Engine Turboprop (Land/Sea)
	// - TMG: Touring Motor Glider
	// - IR: Instrument Rating
	// - OTHER: Other rating type
	ClassType ClassType `json:"classType"`
	CreatedAt time.Time `json:"createdAt"`

	// ExpiryDate Null if rating doesn't expire (e.g., FAA ratings)
	//
	// Example: 2026-03-15
	ExpiryDate *openapi_types.Date `json:"expiryDate,omitempty"`
	Id         openapi_types.UUID  `json:"id"`

	// IssueDate Example: 2024-03-15
	IssueDate openapi_types.Date `json:"issueDate"`
	LicenseId openapi_types.UUID `json:"licenseId"`

	// Notes Optional notes about this rating
	Notes     *string   `json:"notes,omitempty"`
	UpdatedAt time.Time `json:"updatedAt"`
}

type ClassRatingCreate struct {
	// ClassType Aircraft class rating type:
	// - SEP_LAND/SEP_SEA: Single Engine Piston (Land/Sea)
	// - MEP_LAND/MEP_SEA: Multi Engine Piston (Land/Sea)
	// - SET_LAND/SET_SEA: Single Engine Turboprop (Land/Sea)
	// - TMG: Touring Motor Glider
	// - IR: Instrument Rating
	// - OTHER: Other rating type
	ClassType  ClassType           `json:"classType"`
	ExpiryDate *openapi_types.Date `json:"expiryDate,omitempty"`
	IssueDate  openapi_types.Date  `json:"issueDate"`
	Notes      *string             `json:"notes,omitempty"`
}

type ClassRatingCurrency struct {
	ClassRatingId openapi_types.UUID `json:"classRatingId"`

	// ClassType Aircraft class rating type:
	// - SEP_LAND/SEP_SEA: Single Engine Piston (Land/Sea)
	// - MEP_LAND/MEP_SEA: Multi Engine Piston (Land/Sea)
	// - SET_LAND/SET_SEA: Single Engine Turboprop (Land/Sea)
	// - TMG: Touring Motor Glider
	// - IR: Instrument Rating
	// - OTHER: Other rating type
	ClassType ClassType `json:"classType"`

	// ExpiryDate Class rating expiry date
	ExpiryDate *openapi_types.Date `json:"expiryDate,omitempty"`

	// LaunchMethodCurrency SPL launch method currency per FCL.140.S(b)(1) — 5 launches per method in 24 months
	LaunchMethodCurrency *[]LaunchMethodCurrency `json:"launchMethodCurrency,omitempty"`
	LicenseId            openapi_types.UUID      `json:"licenseId"`

	// LicenseType Type from the parent license
	LicenseType *string `json:"licenseType,omitempty"`

	// MessageKey Stable key identifying which statement is true, for client-side localisation. Catalogued in docs/CURRENCY_MESSAGES.md.
	//
	// Example: rating.revalidation_current
	MessageKey *string `json:"messageKey,omitempty"`

	// MessageParams Variable parts of a localised message that are not already fields on the enclosing object. Which fields are present is determined by messageKey; see docs/CURRENCY_MESSAGES.md for the per-key contract.
	MessageParams *MessageParams `json:"messageParams,omitempty"`

	// Progress Progress metrics toward currency requirements (authority-specific)
	Progress *struct {
		// Approaches Number of instrument approaches in the evaluation period
		Approaches  *int `json:"approaches,omitempty"`
		DayLandings *int `json:"dayLandings,omitempty"`

		// Flights Number of flights in class in the evaluation period
		Flights *int `json:"flights,omitempty"`

		// Holds Number of holding procedures in the evaluation period
		Holds *int `json:"holds,omitempty"`

		// IfrMinutes IFR time in minutes in the evaluation period
		IfrMinutes *int `json:"ifrMinutes,omitempty"`

		// InstructorMinutes Time with instructor (dual received) in minutes in the evaluation period
		InstructorMinutes *int `json:"instructorMinutes,omitempty"`

		// Landings Total landings in class in the evaluation period
		Landings      *int `json:"landings,omitempty"`
		NightLandings *int `json:"nightLandings,omitempty"`

		// NightMinutes Night time in minutes in the evaluation period
		NightMinutes *int `json:"nightMinutes,omitempty"`

		// PicMinutes PIC time in class in minutes in the evaluation period
		PicMinutes *int `json:"picMinutes,omitempty"`

		// RequiredLandings Required landings for currency
		RequiredLandings *int `json:"requiredLandings,omitempty"`

		// RequiredMinutes Required time in minutes for currency (authority-specific)
		RequiredMinutes *int `json:"requiredMinutes,omitempty"`

		// TotalMinutes Total time in class in minutes in the evaluation period
		TotalMinutes *int `json:"totalMinutes,omitempty"`
	} `json:"progress,omitempty"`

	// RegulatoryAuthority Authority from the parent license (determines which currency rules apply)
	RegulatoryAuthority string `json:"regulatoryAuthority"`

	// Requirements Per-requirement breakdown showing progress toward each currency requirement
	Requirements *[]CurrencyRequirement `json:"requirements,omitempty"`

	// RuleDescription Regulatory reference for the rule that was applied
	RuleDescription *string `json:"ruleDescription,omitempty"`

	// RuleDescriptionKey Stable key for the applied rule, for client-side localisation of ruleDescription
	//
	// Example: easa_sep_tmg
	RuleDescriptionKey *string `json:"ruleDescriptionKey,omitempty"`

	// Status Currency status:
	// - current: All requirements met
	// - expiring: Rating expiry approaching (within 90 days)
	// - expired: Rating has expired or currency requirements not met
	// - unknown: Authority not supported for auto-calculation
	Status ClassRatingCurrencyStatus `json:"status"`

	// WindowOpen Only meaningful when `windowOpensAt` is set. True if the
	// revalidation experience window is currently open
	// (now >= windowOpensAt). When false, flight experience accrued
	// today does not yet count toward this rating's revalidation, so
	// `requirements` is omitted and `status` stays `current` until the
	// window opens.
	WindowOpen *bool `json:"windowOpen,omitempty"`

	// WindowOpensAt For ratings whose experience window is anchored to expiry (EASA
	// FCL.740.A SEP/TMG/MEP/SET and FCL.625.A IR), the date on which
	// the 12-month experience-counting window opens (expiry − 12
	// months). Omitted for rolling-window rules (LAPL FCL.140.A,
	// SPL FCL.140.S) and for expiry-only ratings.
	WindowOpensAt *openapi_types.Date `json:"windowOpensAt,omitempty"`
}

type ClassRatingCurrencyStatus string

type ClassRatingUpdate struct {
	ExpiryDate nullable.Nullable[openapi_types.Date] `json:"expiryDate,omitempty"`
	IssueDate  *openapi_types.Date                   `json:"issueDate,omitempty"`
	Notes      nullable.Nullable[string]             `json:"notes,omitempty"`
}

type ClassType string

type CompletePublicSignatureJSONRequestBody = CompleteSignatureRequest

type CompleteSignatureRequest struct {
	CredentialNumber *string `json:"credentialNumber,omitempty"`

	// SignatureImage PNG-encoded signature image, base64. Max 500KB decoded.
	SignatureImage []byte `json:"signatureImage"`
	SignerName     string `json:"signerName"`
}

type ConfirmImportJSONRequestBody = ImportConfirmRequest

type Conflict = Error

type Contact struct {
	CreatedAt time.Time            `json:"createdAt"`
	Email     *openapi_types.Email `json:"email,omitempty"`
	Id        openapi_types.UUID   `json:"id"`

	// Name Example: John Smith
	Name      string             `json:"name"`
	Notes     *string            `json:"notes,omitempty"`
	Phone     *string            `json:"phone,omitempty"`
	UpdatedAt time.Time          `json:"updatedAt"`
	UserId    openapi_types.UUID `json:"userId"`
}

type ContactCreate struct {
	Email *openapi_types.Email `json:"email,omitempty"`

	// Name Example: John Smith
	Name  string  `json:"name"`
	Notes *string `json:"notes,omitempty"`
	Phone *string `json:"phone,omitempty"`
}

type CreateAircraftJSONRequestBody = AircraftCreate

type CreateAnnouncementJSONBody struct {
	// ExpiresAt Auto-expire the announcement at this time (optional)
	ExpiresAt *time.Time `json:"expiresAt,omitempty"`

	// Message Example: Scheduled maintenance on Tuesday 8pm-10pm UTC
	Message string `json:"message"`

	// Severity Example: warning
	Severity CreateAnnouncementJSONBodySeverity `json:"severity"`
}

type CreateAnnouncementJSONBodySeverity string

type CreateAnnouncementJSONRequestBody CreateAnnouncementJSONBody

type CreateBackupDestinationJSONRequestBody = BackupDestinationCreate

type CreateClassRatingJSONRequestBody = ClassRatingCreate

type CreateContactJSONRequestBody = ContactCreate

type CreateCredentialJSONRequestBody = CredentialCreate

type CreateCustomCurrencyRuleJSONRequestBody = CustomCurrencyRuleInput

type CreateFlightJSONRequestBody = FlightCreate

type CreateLicenseJSONRequestBody = LicenseCreate

type CreateLiveSignatureRequest struct {
	// CredentialNumber e.g. CFI certificate number
	CredentialNumber *string `json:"credentialNumber,omitempty"`

	// SignatureImage PNG-encoded signature image, base64. Max 500KB decoded.
	SignatureImage []byte `json:"signatureImage"`

	// SignerName Example: Jane Instructor
	SignerName string `json:"signerName"`
}

type CreateSignatureRequestJSONRequestBody = CreateSignatureRequestRequest

type CreateSignatureRequestRequest struct {
	// ExpiresInHours Clamped server-side to [1, 720] hours (30 days max). Defaults to 168 (7 days).
	ExpiresInHours *int `json:"expiresInHours,omitempty"`

	// InstructorEmail If supplied, the request email is sent immediately. Omit to create a pending-and-unsent request.
	InstructorEmail *openapi_types.Email `json:"instructorEmail,omitempty"`
}

type Credential struct {
	CreatedAt time.Time `json:"createdAt"`

	// CredentialNumber Official credential number/reference
	//
	// Example: MED-2026-001
	CredentialNumber *string `json:"credentialNumber,omitempty"`

	// CredentialType Credential type:
	// - EASA_CLASS1_MEDICAL: EASA Class 1 Medical Certificate
	// - EASA_CLASS2_MEDICAL: EASA Class 2 Medical Certificate
	// - EASA_LAPL_MEDICAL: EASA LAPL Medical Certificate
	// - FAA_CLASS1_MEDICAL: FAA First-Class Medical Certificate
	// - FAA_CLASS2_MEDICAL: FAA Second-Class Medical Certificate
	// - FAA_CLASS3_MEDICAL: FAA Third-Class Medical Certificate
	// - LANG_ICAO_LEVEL4: Language Proficiency ICAO Level 4
	// - LANG_ICAO_LEVEL5: Language Proficiency ICAO Level 5
	// - LANG_ICAO_LEVEL6: Language Proficiency ICAO Level 6 (Expert)
	// - SEC_CLEARANCE_ZUP: Security Clearance ZÜP (Germany)
	// - SEC_CLEARANCE_ZUBB: Security Clearance ZüBB (Germany)
	// - RADIO_BZF2: Beschränktes Sprechfunkzeugnis II (Germany, VFR, German only)
	// - RADIO_BZF1: Beschränktes Sprechfunkzeugnis I (Germany, VFR, German and English)
	// - RADIO_AZF: Allgemeines Sprechfunkzeugnis (Germany, VFR and IFR)
	// - OTHER: Other credential
	CredentialType CredentialType `json:"credentialType"`

	// ExpiryDate Null if credential doesn't expire
	//
	// Example: 2027-01-15
	ExpiryDate *openapi_types.Date `json:"expiryDate,omitempty"`
	Id         openapi_types.UUID  `json:"id"`

	// IssueDate Example: 2026-01-15
	IssueDate openapi_types.Date `json:"issueDate"`

	// IssuingAuthority Authority or examiner that issued the credential
	//
	// Example: EASA AME
	IssuingAuthority string `json:"issuingAuthority"`

	// Notes Example: Annual renewal required
	Notes     *string            `json:"notes,omitempty"`
	UpdatedAt time.Time          `json:"updatedAt"`
	UserId    openapi_types.UUID `json:"userId"`
}

type CredentialCreate struct {
	CredentialNumber *string `json:"credentialNumber,omitempty"`

	// CredentialType Credential type:
	// - EASA_CLASS1_MEDICAL: EASA Class 1 Medical Certificate
	// - EASA_CLASS2_MEDICAL: EASA Class 2 Medical Certificate
	// - EASA_LAPL_MEDICAL: EASA LAPL Medical Certificate
	// - FAA_CLASS1_MEDICAL: FAA First-Class Medical Certificate
	// - FAA_CLASS2_MEDICAL: FAA Second-Class Medical Certificate
	// - FAA_CLASS3_MEDICAL: FAA Third-Class Medical Certificate
	// - LANG_ICAO_LEVEL4: Language Proficiency ICAO Level 4
	// - LANG_ICAO_LEVEL5: Language Proficiency ICAO Level 5
	// - LANG_ICAO_LEVEL6: Language Proficiency ICAO Level 6 (Expert)
	// - SEC_CLEARANCE_ZUP: Security Clearance ZÜP (Germany)
	// - SEC_CLEARANCE_ZUBB: Security Clearance ZüBB (Germany)
	// - RADIO_BZF2: Beschränktes Sprechfunkzeugnis II (Germany, VFR, German only)
	// - RADIO_BZF1: Beschränktes Sprechfunkzeugnis I (Germany, VFR, German and English)
	// - RADIO_AZF: Allgemeines Sprechfunkzeugnis (Germany, VFR and IFR)
	// - OTHER: Other credential
	CredentialType CredentialType `json:"credentialType"`

	// ExpiryDate Must be after issueDate when provided
	ExpiryDate       *openapi_types.Date `json:"expiryDate,omitempty"`
	IssueDate        openapi_types.Date  `json:"issueDate"`
	IssuingAuthority string              `json:"issuingAuthority"`
	Notes            *string             `json:"notes,omitempty"`
}

type CredentialId = openapi_types.UUID

type CredentialType string

type CredentialUpdate struct {
	CredentialNumber nullable.Nullable[string] `json:"credentialNumber,omitempty"`

	// CredentialType Credential type:
	// - EASA_CLASS1_MEDICAL: EASA Class 1 Medical Certificate
	// - EASA_CLASS2_MEDICAL: EASA Class 2 Medical Certificate
	// - EASA_LAPL_MEDICAL: EASA LAPL Medical Certificate
	// - FAA_CLASS1_MEDICAL: FAA First-Class Medical Certificate
	// - FAA_CLASS2_MEDICAL: FAA Second-Class Medical Certificate
	// - FAA_CLASS3_MEDICAL: FAA Third-Class Medical Certificate
	// - LANG_ICAO_LEVEL4: Language Proficiency ICAO Level 4
	// - LANG_ICAO_LEVEL5: Language Proficiency ICAO Level 5
	// - LANG_ICAO_LEVEL6: Language Proficiency ICAO Level 6 (Expert)
	// - SEC_CLEARANCE_ZUP: Security Clearance ZÜP (Germany)
	// - SEC_CLEARANCE_ZUBB: Security Clearance ZüBB (Germany)
	// - RADIO_BZF2: Beschränktes Sprechfunkzeugnis II (Germany, VFR, German only)
	// - RADIO_BZF1: Beschränktes Sprechfunkzeugnis I (Germany, VFR, German and English)
	// - RADIO_AZF: Allgemeines Sprechfunkzeugnis (Germany, VFR and IFR)
	// - OTHER: Other credential
	CredentialType *CredentialType `json:"credentialType,omitempty"`

	// ExpiryDate Must be after issueDate when provided
	ExpiryDate       nullable.Nullable[openapi_types.Date] `json:"expiryDate,omitempty"`
	IssueDate        *openapi_types.Date                   `json:"issueDate,omitempty"`
	IssuingAuthority *string                               `json:"issuingAuthority,omitempty"`
	Notes            nullable.Nullable[string]             `json:"notes,omitempty"`
}

type CrewRole string

type Currency struct {
	// DaysCurrent Day currency status
	//
	// Example: true
	DaysCurrent bool `json:"daysCurrent"`

	// ExpiryDate License expiry date if applicable
	//
	// Example: 2025-01-15
	ExpiryDate *openapi_types.Date `json:"expiryDate,omitempty"`

	// IsCurrent Overall currency status
	//
	// Example: true
	IsCurrent  bool `json:"isCurrent"`
	Last90Days struct {
		// DayLandings Day landings in last 90 days
		//
		// Example: 12
		DayLandings int `json:"dayLandings"`

		// Flights Number of flights in last 90 days
		//
		// Example: 8
		Flights int `json:"flights"`

		// NightLandings Night landings in last 90 days
		//
		// Example: 3
		NightLandings int `json:"nightLandings"`

		// TotalLandings Total landings in last 90 days
		//
		// Example: 15
		TotalLandings int `json:"totalLandings"`
	} `json:"last90Days"`

	// LicenseId Example: 660e8400-e29b-41d4-a716-446655440001
	LicenseId openapi_types.UUID `json:"licenseId"`

	// NightsCurrent Night currency status (FAA requires separate tracking)
	//
	// Example: false
	NightsCurrent    bool `json:"nightsCurrent"`
	RequiredLandings *struct {
		// Day Required day landings for currency
		//
		// Example: 3
		Day int `json:"day"`

		// Night Required night landings for night currency
		//
		// Example: 3
		Night int `json:"night"`
	} `json:"requiredLandings,omitempty"`
}

type CurrencyRequirement struct {
	// Current Current progress value
	Current float32 `json:"current"`

	// MessageKey Stable key for the progress text. `requirement.progress` (the common case) is rendered by the client from current/required/unit.
	//
	// Example: requirement.progress
	MessageKey string `json:"messageKey"`

	// MessageParams Variable parts of a localised message that are not already fields on the enclosing object. Which fields are present is determined by messageKey; see docs/CURRENCY_MESSAGES.md for the per-key contract.
	MessageParams *MessageParams `json:"messageParams,omitempty"`

	// Met Whether this requirement is currently satisfied
	Met bool `json:"met"`

	// Name Author-supplied requirement name. Present only for custom currency rules, where the name is user data; regulatory requirements carry nameKey instead.
	Name *string `json:"name,omitempty"`

	// NameKey Stable key for the requirement name, for client-side localisation. Absent on custom currency rules, where `name` is user data and must be rendered as-is.
	//
	// Example: requirement.refresher_training
	NameKey *string `json:"nameKey,omitempty"`

	// Required Required value to meet this requirement
	Required float32 `json:"required"`

	// Unit Unit of measurement (e.g., "landings", "hours", "flights")
	Unit string `json:"unit"`
}

type CurrencyStatusResponse struct {
	FlightReview *FlightReviewStatus `json:"flightReview,omitempty"`

	// PassengerCurrency Tier 2: Passenger currency — determines whether the pilot can carry passengers (rolling from now, separate from rating validity)
	PassengerCurrency []PassengerCurrency `json:"passengerCurrency"`

	// Ratings Tier 1: Rating/license currency — determines whether the pilot can fly at all in each class
	Ratings []ClassRatingCurrency `json:"ratings"`
}

type CustomCurrencyEnabledRequest struct {
	Enabled bool `json:"enabled"`
}

type CustomCurrencyEvaluation struct {
	EvaluatedAt time.Time `json:"evaluatedAt"`

	// ExpiresOn The last date the rule stays current assuming no further flights. Set only when the rule is currently met and a lapse date is computable.
	ExpiresOn    *openapi_types.Date            `json:"expiresOn,omitempty"`
	Requirements []CurrencyRequirement          `json:"requirements"`
	Status       CustomCurrencyEvaluationStatus `json:"status"`

	// WindowLabel Example: last 90 days
	WindowLabel string `json:"windowLabel"`
}

type CustomCurrencyEvaluationStatus string

type CustomCurrencyFilter struct {
	// Field Example: aircraft_class
	Field CustomCurrencyFilterField `json:"field"`

	// Op Example: eq
	Op CustomCurrencyFilterOp `json:"op"`

	// Value The value to match when `op` is `eq`
	//
	// Example: SEP_LAND
	Value *string `json:"value,omitempty"`

	// Values The values to match when `op` is `in`
	Values *[]string `json:"values,omitempty"`
}

type CustomCurrencyFilterField string

type CustomCurrencyFilterOp string

type CustomCurrencyNotifyRequest struct {
	Notify bool `json:"notify"`
}

type CustomCurrencyPreviewRequest struct {
	// Definition The declarative rule document: a lookback window, filters selecting which flights count, and requirements measured against the aggregated flight metrics.
	Definition CustomCurrencyRuleBody `json:"definition"`
}

type CustomCurrencyRule struct {
	CreatedAt time.Time `json:"createdAt"`

	// Definition The declarative rule document: a lookback window, filters selecting which flights count, and requirements measured against the aggregated flight metrics.
	Definition  CustomCurrencyRuleBody `json:"definition"`
	Description *string                `json:"description,omitempty"`

	// Emoji Example: 🌙
	Emoji *string `json:"emoji,omitempty"`

	// Enabled A paused rule is kept and listed but not evaluated.
	Enabled bool               `json:"enabled"`
	Id      openapi_types.UUID `json:"id"`

	// ImportedFrom The source rule this one was imported from, when applicable.
	ImportedFrom *openapi_types.UUID `json:"importedFrom,omitempty"`
	IsShared     bool                `json:"isShared"`

	// Name Example: Night landings
	Name string `json:"name"`

	// Notify Per-rule opt-in to expiry and lapse notification emails.
	Notify bool `json:"notify"`

	// ShareToken Present once sharing has been enabled at least once.
	ShareToken *string            `json:"shareToken,omitempty"`
	UpdatedAt  time.Time          `json:"updatedAt"`
	UserId     openapi_types.UUID `json:"userId"`
}

type CustomCurrencyRuleBody struct {
	Filters      *[]CustomCurrencyFilter   `json:"filters,omitempty"`
	Requirements []CustomCurrencyThreshold `json:"requirements"`

	// Window Rolling lookback anchored at the moment of evaluation: only flights on or after (now − amount × unit) count.
	Window CustomCurrencyWindow `json:"window"`
}

type CustomCurrencyRuleId = openapi_types.UUID

type CustomCurrencyRuleInput struct {
	// Definition The declarative rule document: a lookback window, filters selecting which flights count, and requirements measured against the aggregated flight metrics.
	Definition  CustomCurrencyRuleBody `json:"definition"`
	Description *string                `json:"description,omitempty"`

	// Emoji Example: 🌙
	Emoji *string `json:"emoji,omitempty"`

	// Name Example: Night landings
	Name string `json:"name"`
}

type CustomCurrencyRuleWithStatus struct {
	// Evaluation The result of evaluating a rule definition against the caller's flights.
	Evaluation CustomCurrencyEvaluation `json:"evaluation"`

	// Rule A stored, user-authored currency definition. Rules are private by default; enabling sharing exposes a read-only copy at a share token that other users can import.
	Rule CustomCurrencyRule `json:"rule"`
}

type CustomCurrencyShareToken = string

type CustomCurrencyThreshold struct {
	// Label Optional display label for this requirement
	//
	// Example: 3 landings in 90 days
	Label *string `json:"label,omitempty"`

	// Metric Time metrics (`unit` applies): `total_time`, `pic_time`,
	// `picus_time`, `spic_time`, `examiner_time`, `relief_time`,
	// `dual_time`, `night_time`, `ifr_time`, `cross_country_time`.
	// Count metrics (`unit` ignored): `flights`, `landings`,
	// `day_landings`, `night_landings`, `takeoffs`, `day_takeoffs`,
	// `night_takeoffs`, `approaches`, `holds`.
	//
	//
	// Example: landings
	Metric CustomCurrencyThresholdMetric `json:"metric"`

	// Min The threshold the metric must reach
	//
	// Example: 3
	Min float64 `json:"min"`

	// Unit How `min` is expressed, for time metrics only. Defaults to hours. Rejected on count metrics.
	Unit *CustomCurrencyThresholdUnit `json:"unit,omitempty"`
}

type CustomCurrencyThresholdMetric string

type CustomCurrencyThresholdUnit string

type CustomCurrencyWindow struct {
	// Amount Example: 90
	Amount int `json:"amount"`

	// Unit Example: days
	Unit CustomCurrencyWindowUnit `json:"unit"`
}

type CustomCurrencyWindowUnit string

type DeleteCurrentUserJSONBody struct {
	// ConfirmEmail The account's own email address, typed as confirmation. Required in OIDC mode, where no local password exists.
	ConfirmEmail *openapi_types.Email `json:"confirmEmail,omitempty"`

	// Password Current password for confirmation (local mode)
	Password *string `json:"password,omitempty"`
}

type DeleteCurrentUserJSONRequestBody DeleteCurrentUserJSONBody

type Deletion struct {
	// DeletedAt When the record was deleted
	//
	// Example: 2026-08-05T11:12:13.456789Z
	DeletedAt time.Time `json:"deletedAt"`

	// Entity Which collection the deleted record belonged to
	//
	// Example: flight
	Entity DeletionEntity `json:"entity"`

	// Id Id of the deleted record, as it was reported by the list endpoints
	//
	// Example: 660e8400-e29b-41d4-a716-446655440001
	Id openapi_types.UUID `json:"id"`
}

type DeletionEntity string

type DeletionFeed struct {
	// Data Deletions after the watermark, oldest first
	Data       []Deletion `json:"data"`
	Pagination struct {
		// Page Current page (1-indexed)
		//
		// Example: 1
		Page int `json:"page"`

		// PageSize Items per page
		//
		// Example: 100
		PageSize int `json:"pageSize"`

		// Total Total number of deletions after the watermark
		//
		// Example: 3
		Total int `json:"total"`

		// TotalPages Total number of pages
		//
		// Example: 1
		TotalPages int `json:"totalPages"`
	} `json:"pagination"`

	// RetentionDays How long a tombstone is kept before it is swept
	//
	// Example: 90
	RetentionDays int `json:"retentionDays"`

	// WatermarkExpired True when `since` predates the retention horizon. Tombstones older than that may already have been swept, so this page is not a complete account of what was deleted and the client must fall back to a full ID-set reconciliation.
	//
	// Example: false
	WatermarkExpired bool `json:"watermarkExpired"`
}

type Disable2FAJSONBody struct {
	Password string `json:"password"`
}

type Disable2FAJSONRequestBody Disable2FAJSONBody

type DocumentFile struct {
	// ByteSize Size of the stored image in bytes
	//
	// Example: 1843200
	ByteSize int `json:"byteSize"`

	// Caption Example: Front page
	Caption *string `json:"caption,omitempty"`

	// ContentType Determined from the stored bytes, not from what the uploader declared
	ContentType DocumentFileContentType `json:"contentType"`
	CreatedAt   time.Time               `json:"createdAt"`

	// CredentialId Set when the image belongs to a credential; null otherwise
	CredentialId *openapi_types.UUID `json:"credentialId,omitempty"`

	// Filename Original filename, sanitized to a basename. Display only.
	//
	// Example: licence-front.jpg
	Filename *string `json:"filename,omitempty"`

	// Height Pixel height; null for formats without intrinsic dimensions, such as PDF
	//
	// Example: 1536
	Height *int               `json:"height,omitempty"`
	Id     openapi_types.UUID `json:"id"`

	// LicenseId Set when the image belongs to a licence; null otherwise
	LicenseId *openapi_types.UUID `json:"licenseId,omitempty"`
	UpdatedAt time.Time           `json:"updatedAt"`

	// Width Pixel width; null for formats without intrinsic dimensions, such as PDF
	//
	// Example: 2048
	Width *int `json:"width,omitempty"`
}

type DocumentFileContentType string

type DocumentFileId = openapi_types.UUID

type DocumentFileLimitReached = Error

type DocumentFileUpload struct {
	// Caption Optional short label shown with the image
	Caption *string `json:"caption,omitempty"`

	// File JPEG, PNG or PDF, at most 5 MB
	File openapi_types.File `json:"file"`
}

type DocumentFilesDisabled = Error

type EmailDeliveryEvent struct {
	CreatedAt time.Time `json:"createdAt"`

	// Detail Server reply text or internal reason, for operators.
	Detail *string `json:"detail,omitempty"`

	// EmailType What the message was for, e.g. verify_email, verification_reminder.
	EmailType string              `json:"emailType"`
	Id        openapi_types.UUID  `json:"id"`
	Recipient openapi_types.Email `json:"recipient"`

	// SmtpCode SMTP reply code, absent when there was no conversation.
	SmtpCode *int `json:"smtpCode,omitempty"`

	// Status What the SMTP conversation said. `delivered` means the receiving
	// server accepted the message — not that it reached an inbox, which an
	// SMTP client cannot observe. `hard_bounce` is a permanent refusal of
	// the recipient itself and is the only status that suppresses an
	// address; `rejected` and `server_error` blame the message or our own
	// mail setup and never do.
	Status EmailDeliveryEventStatus `json:"status"`

	// UserId Account the address belonged to when sent, if any.
	UserId *openapi_types.UUID `json:"userId,omitempty"`
}

type EmailDeliveryEventStatus string

type EmailSuppression struct {
	BounceCount    int                 `json:"bounceCount"`
	Detail         *string             `json:"detail,omitempty"`
	Email          openapi_types.Email `json:"email"`
	FirstBouncedAt time.Time           `json:"firstBouncedAt"`
	LastBouncedAt  time.Time           `json:"lastBouncedAt"`

	// Reason Delivery status that caused the suppression.
	Reason   string `json:"reason"`
	SmtpCode *int   `json:"smtpCode,omitempty"`
}

type Error struct {
	// Code Optional machine-readable error code, used by clients to distinguish
	// between conditions that share an HTTP status (e.g. `email_not_verified`
	// vs `account_disabled` for 403 on /auth/login).
	//
	//
	// Example: email_not_verified
	Code *string `json:"code,omitempty"`

	// Details Detailed validation errors
	Details *[]struct {
		// Field Example: totalTime
		Field *string `json:"field,omitempty"`

		// Message Example: Must be greater than 0
		Message *string `json:"message,omitempty"`
	} `json:"details,omitempty"`

	// Error Error message
	//
	// Example: Validation failed
	Error string `json:"error"`
}

type ExchangeOidcCodeJSONBody struct {
	// Code The single-use code from the `oidc_code` query parameter
	Code string `json:"code"`
}

type ExchangeOidcCodeJSONRequestBody ExchangeOidcCodeJSONBody

type ExportFlightsCSVParams struct {
	// Format CSV column format — easa, faa, or standard (ForeFlight-compatible default)
	Format *ExportFlightsCSVParamsFormat `form:"format,omitempty" json:"format,omitempty"`
}

type ExportFlightsCSVParamsFormat string

type ExportFlightsPDFParams struct {
	// LogbookLicenseId Filter flights for a specific logbook license
	LogbookLicenseId *openapi_types.UUID `form:"logbookLicenseId,omitempty" json:"logbookLicenseId,omitempty"`

	// Format PDF format — easa (AMC1 FCL.050 columns), faa (14 CFR § 61.51 / ASA-Jeppesen columns), or summary (simplified totals)
	Format *ExportFlightsPDFParamsFormat `form:"format,omitempty" json:"format,omitempty"`

	// PageSize Page size for the generated PDF. All sizes are rendered in landscape orientation.
	PageSize *ExportFlightsPDFParamsPageSize `form:"page_size,omitempty" json:"page_size,omitempty"`

	// Layout Page layout. `spread` (default) lays the logbook out as a book-style two-page spread (left + right facing pages) intended for double-sided printing, in any page size; intentionally-blank filler pages (one at the start, one before the totals summary) keep each spread on facing pages when printed duplex. `single` renders all columns on one landscape page per batch of flights — designed for single-page A4 landscape printing. Ignored for the summary format.
	Layout *ExportFlightsPDFParamsLayout `form:"layout,omitempty" json:"layout,omitempty"`

	// RowsPerPage Number of flight rows per logbook page. When set, the row height — and, for dense layouts, the body font — scales dynamically so the rows fill the page: fewer rows give an airier, larger-print logbook, more rows a denser one. Values are clamped to what stays legible on the chosen page size; omitted, the row count is derived from the page size's default row height. Ignored for the summary format.
	RowsPerPage *int `form:"rows_per_page,omitempty" json:"rows_per_page,omitempty"`
}

type ExportFlightsPDFParamsFormat string

type ExportFlightsPDFParamsLayout string

type ExportFlightsPDFParamsPageSize string

type Features struct {
	DocumentFiles struct {
		// AllowedContentTypes Example: ["image/jpeg","image/png","application/pdf"]
		AllowedContentTypes []string `json:"allowedContentTypes"`

		// Enabled When false, every /files endpoint answers 403 — uploads and downloads alike
		Enabled bool `json:"enabled"`

		// MaxBytes Maximum size of a single image in bytes
		//
		// Example: 5242880
		MaxBytes int `json:"maxBytes"`

		// MaxPerDocument Maximum number of files per licence or credential
		//
		// Example: 5
		MaxPerDocument int `json:"maxPerDocument"`
	} `json:"documentFiles"`
}

type Flight struct {
	// ActualInstrumentTime Actual instrument flight time in minutes (under IMC or simulated IMC with view-limiting device)
	//
	// Example: 30
	ActualInstrumentTime *int `json:"actualInstrumentTime,omitempty"`

	// AircraftReg Aircraft registration
	//
	// Example: D-EFGH
	AircraftReg string `json:"aircraftReg"`

	// AircraftType Aircraft type
	//
	// Example: C172
	AircraftType string `json:"aircraftType"`

	// AllLandings Total landings (day + night). Auto-calculated by the server.
	//
	// Example: 4
	AllLandings int `json:"allLandings"`

	// Approaches Structured instrument approach details (FAA §61.51(g)(3)) — type, airport, and runway for each approach
	Approaches *[]ApproachEntry `json:"approaches,omitempty"`

	// ApproachesCount Number of instrument approaches performed
	//
	// Example: 2
	ApproachesCount *int `json:"approachesCount,omitempty"`

	// ArrivalAirportName Airport name resolved live from the airport database for display. Not stored with the flight. Null when arrivalIcao does not resolve against the airport database (e.g. a free-text off-airport site).
	//
	// Example: Hamburg Airport
	ArrivalAirportName *string `json:"arrivalAirportName,omitempty"`

	// ArrivalIcao Arrival location — an ICAO code (resolved to coordinates for maps/distance) or a free-text place name for off-airport sites
	//
	// Example: EDDH
	ArrivalIcao *string `json:"arrivalIcao,omitempty"`

	// ArrivalTime Landing time in UTC. Marks the end of airborne/flight time.
	//
	// Example: 16:45:00
	ArrivalTime *string `json:"arrivalTime,omitempty"`

	// CreatedAt Example: 2026-01-30T16:00:00Z
	CreatedAt time.Time `json:"createdAt"`

	// CrewMembers People on board this flight with their roles
	CrewMembers *[]FlightCrewMember `json:"crewMembers,omitempty"`

	// CrossCountryTime Cross-country time in minutes. Auto-calculated when departure ≠ arrival.
	//
	// Example: 150
	CrossCountryTime int `json:"crossCountryTime"`

	// Date Example: 2026-01-30
	Date openapi_types.Date `json:"date"`

	// DepartureAirportName Airport name resolved live from the airport database for display. Not stored with the flight. Null when departureIcao does not resolve against the airport database (e.g. a free-text off-airport site).
	//
	// Example: Frankfurt am Main Airport
	DepartureAirportName *string `json:"departureAirportName,omitempty"`

	// DepartureIcao Departure location — an ICAO code (resolved to coordinates for maps/distance) or a free-text place name for off-airport sites
	//
	// Example: EDDF
	DepartureIcao *string `json:"departureIcao,omitempty"`

	// DepartureTime Takeoff time in UTC. Marks the beginning of airborne/flight time.
	//
	// Example: 14:30:00
	DepartureTime *string `json:"departureTime,omitempty"`

	// Distance Distance in nautical miles. Auto-calculated from airport coordinates.
	//
	// Example: 185.3
	Distance float32 `json:"distance"`

	// DualGivenTime Dual instruction given time in minutes. Auto-calculated when user acts as instructor.
	//
	// Example: 0
	DualGivenTime *int `json:"dualGivenTime,omitempty"`

	// DualTime Dual instruction block time in minutes (computed from isDual and totalTime)
	//
	// Example: 0
	DualTime int `json:"dualTime"`

	// Endorsements Instructor endorsements, skill test references, examiner notes. EASA AMC1 FCL.050 Col 24 / FAA §61.51(h). Separate from pilot remarks.
	//
	// Example: Skill test passed
	Endorsements *string `json:"endorsements,omitempty"`

	// ExaminerTime Time conducting a check as examiner, in minutes. Overlays the pilot function time like dualGivenTime; bounded by totalTime only.
	//
	// Example: 0
	ExaminerTime *int `json:"examinerTime,omitempty"`

	// FstdType FSTD type designation (e.g., "FNPT II", "FFS A320", "FTD Level 5", "BATD", "AATD"). Required by EASA AMC1 FCL.050 Col 22 and FAA §61.51(b)(1)(iv).
	//
	// Example: FNPT II
	FstdType *string `json:"fstdType,omitempty"`

	// GroundTrainingTime Ground training time in minutes
	//
	// Example: 0
	GroundTrainingTime *int `json:"groundTrainingTime,omitempty"`

	// Holds Number of holding procedures performed
	//
	// Example: 1
	Holds *int `json:"holds,omitempty"`

	// Id Example: 770e8400-e29b-41d4-a716-446655440002
	Id openapi_types.UUID `json:"id"`

	// IfrTime Instrument block time in minutes
	//
	// Example: 60
	IfrTime int `json:"ifrTime"`

	// InstructorComments Instructor comments about the flight
	InstructorComments *string `json:"instructorComments,omitempty"`

	// InstructorName Name of the instructor for this flight
	InstructorName *string `json:"instructorName,omitempty"`

	// IsDual Whether this flight was logged as dual instruction received. Mutually exclusive with isPic.
	//
	// Example: false
	IsDual bool `json:"isDual"`

	// IsFlightReview Whether this flight was a Flight Review (FAA 61.56) or equivalent
	//
	// Example: false
	IsFlightReview *bool `json:"isFlightReview,omitempty"`

	// IsIpc Whether this flight included an Instrument Proficiency Check (IPC)
	//
	// Example: false
	IsIpc *bool `json:"isIpc,omitempty"`

	// IsPassenger True when the user was carried on this flight rather than crewing it.
	// Derived on save: another person is pilot-in-command and the operation
	// carries no co-pilot seat the user may occupy — the aircraft is not
	// certificated for a minimum crew of two, the user is not a required
	// safety pilot, and no co-pilot seat was declared. The row keeps its
	// route and block times as the record of the trip and carries zero in
	// every flight-time column, contributing to no total, statistic or
	// currency calculation.
	//
	//
	// Example: false
	IsPassenger bool `json:"isPassenger"`

	// IsPic Whether this flight was logged as pilot-in-command. Mutually exclusive with isDual.
	//
	// Example: true
	IsPic bool `json:"isPic"`

	// IsProficiencyCheck Whether this flight was a Proficiency Check (EASA FCL.740.A MEP/SET, FCL.625.A IR, or FAA §61.58)
	//
	// Example: false
	IsProficiencyCheck *bool `json:"isProficiencyCheck,omitempty"`

	// IsSimulator True when this entry is an FSTD (simulator) session rather than a flight.
	// A session carries its duration in simulatedFlightTime and zero in every
	// flight-time column — totalTime, picTime, dualTime, sicTime, dualGivenTime,
	// multiPilotTime, soloTime, crossCountryTime, nightTime and ifrTime — and
	// contributes to no flight total, statistic or currency calculation
	// (EASA AMC1 FCL.050: session time is recorded separately and is never
	// summed with flight time).
	//
	//
	// Example: false
	IsSimulator bool `json:"isSimulator"`

	// LandingsDay Number of day landings. Auto-calculated from sunset/sunrise at arrival airport.
	//
	// Example: 3
	LandingsDay int `json:"landingsDay"`

	// LandingsNight Number of night landings. Auto-calculated from sunset/sunrise at arrival airport.
	//
	// Example: 1
	LandingsNight int `json:"landingsNight"`

	// LaunchMethod Launch method for glider/SPL flights (winch, aerotow, or self-launch)
	//
	// Example: winch
	LaunchMethod *FlightLaunchMethod `json:"launchMethod,omitempty"`

	// MultiPilotTime Multi-pilot time in minutes (EASA AMC1 FCL.050 Col 10). Time operated on multi-pilot aircraft.
	//
	// Example: 0
	MultiPilotTime *int `json:"multiPilotTime,omitempty"`

	// NightTime Night block time in minutes. Auto-calculated from departure/arrival times and airport sunset/sunrise data.
	//
	// Example: 30
	NightTime int `json:"nightTime"`

	// OffBlockTime Off-block time (chocks off / engine start) in UTC. Marks the beginning of block time per EASA FCL.010 / FAA 14 CFR 1.1.
	//
	// Example: 14:15:00
	OffBlockTime *string `json:"offBlockTime,omitempty"`

	// OnBlockTime On-block time (chocks on / engine shutdown) in UTC. Marks the end of block time per EASA FCL.010 / FAA 14 CFR 1.1.
	//
	// Example: 16:55:00
	OnBlockTime *string `json:"onBlockTime,omitempty"`

	// PicName Name of the pilot-in-command for this flight (EASA AMC1 FCL.050 Col 12). Auto-set to "Self" when isPic=true, or to instructorName when isDual=true.
	//
	// Example: Self
	PicName *string `json:"picName,omitempty"`

	// PicTime Pilot-in-command block time in minutes (computed from isPic and totalTime)
	//
	// Example: 150
	PicTime int `json:"picTime"`

	// PicusTime PIC under supervision (PICUS) time in minutes (EASA FCL.030, Part-FCL). Declared by the pilot, never auto-calculated; carved out of the derived function time. Counts toward PIC experience requirements (e.g. unfreezing an ATPL) but is kept distinct from PIC and SIC time.
	//
	// Example: 0
	PicusTime *int `json:"picusTime,omitempty"`

	// ReliefTime Cruise relief co-pilot time in minutes (augmented crew). Declared by the pilot, never auto-calculated; carved out of the derived function time.
	//
	// Example: 0
	ReliefTime *int `json:"reliefTime,omitempty"`

	// Remarks Free text notes
	//
	// Example: Training flight - touch and go practice
	Remarks *string `json:"remarks,omitempty"`

	// Route Route waypoints as comma-separated ICAO codes for VFR/IFR flight plans
	//
	// Example: EDDF,EDDS,EDDM
	Route *string `json:"route,omitempty"`

	// SicTime Second-in-command time in minutes. Auto-calculated when SIC crew role assigned.
	//
	// Example: 0
	SicTime *int `json:"sicTime,omitempty"`

	// SignatureId Present iff the flight is locked by a completed, non-voided
	// instructor signature. Void the signature (see
	// /flights/{flightId}/signatures/{signatureId}/void) to unlock it
	// for editing.
	SignatureId *openapi_types.UUID `json:"signatureId,omitempty"`

	// SimulatedFlightTime Simulated flight time in minutes (FTD/FSTD)
	//
	// Example: 0
	SimulatedFlightTime *int `json:"simulatedFlightTime,omitempty"`

	// SimulatedInstrumentTime Simulated instrument time in minutes (FSTD/FTD/ATD)
	//
	// Example: 18
	SimulatedInstrumentTime *int `json:"simulatedInstrumentTime,omitempty"`

	// SoloTime Solo time in minutes. Auto-calculated when no crew and not dual instruction.
	//
	// Example: 90
	SoloTime int `json:"soloTime"`

	// SpicTime Student pilot-in-command (SPIC) time in minutes (EASA integrated course). Declared by the pilot, never auto-calculated; carved out of the derived function time.
	//
	// Example: 0
	SpicTime *int `json:"spicTime,omitempty"`

	// TakeoffsDay Number of day takeoffs. Auto-calculated from sunset/sunrise at departure airport unless overridden.
	//
	// Example: 3
	TakeoffsDay int `json:"takeoffsDay"`

	// TakeoffsNight Number of night takeoffs. Auto-calculated from sunset/sunrise at departure airport unless overridden.
	//
	// Example: 1
	TakeoffsNight int `json:"takeoffsNight"`

	// TotalTime Total block time in minutes (off-block to on-block)
	//
	// Example: 150
	TotalTime int `json:"totalTime"`

	// UpdatedAt Example: 2026-01-30T16:00:00Z
	UpdatedAt time.Time `json:"updatedAt"`

	// UserId Example: 550e8400-e29b-41d4-a716-446655440000
	UserId openapi_types.UUID `json:"userId"`
}

type FlightAnalytics struct {
	// ApproachTypes Instrument approaches flown, grouped by approach type.
	ApproachTypes []AnalyticsApproachTypeRow `json:"approachTypes"`

	// Baseline Present when the user's initial-hours snapshot was added to `totals`.
	// The snapshot is applied whenever the timeframe reaches back to the
	// baseline date (always for all time), so the Reports totals match the
	// dashboard statistics. It contributes to `totals` only — per-month,
	// per-aircraft and per-airport breakdowns cannot attribute it.
	Baseline       *StatisticsBaselineContribution `json:"baseline,omitempty"`
	ByAircraftType []AnalyticsAircraftRow          `json:"byAircraftType"`
	ByAirport      []AnalyticsAirportRow           `json:"byAirport"`

	// ByCategory Aircraft categories (tailwheel, complex, high performance). A flight can appear in more than one category.
	ByCategory []AnalyticsGroupRow   `json:"byCategory"`
	ByClass    []AnalyticsGroupRow   `json:"byClass"`
	ByCountry  []AnalyticsCountryRow `json:"byCountry"`

	// ByCrew Time flown alongside each logged crew member — one row per person,
	// not per role. Crew entries linked to the same contact are one
	// person; unlinked entries fold by trimmed, case-insensitive name.
	ByCrew []AnalyticsPersonRow `json:"byCrew"`

	// ByInstructor Dual received, grouped by the instructor named on the flight.
	ByInstructor   []AnalyticsPersonRow   `json:"byInstructor"`
	ByRegistration []AnalyticsAircraftRow `json:"byRegistration"`
	ByRoute        []AnalyticsRouteRow    `json:"byRoute"`

	// DayOfWeek Always seven entries, Monday (1) through Sunday (7), including days with no flights.
	DayOfWeek []AnalyticsBucketRow `json:"dayOfWeek"`

	// DurationBuckets Flight-length histogram. Buckets are fixed - under 30m, 30–60m, 1–2h, 2–3h, 3–5h, over 5h.
	DurationBuckets []AnalyticsBucketRow `json:"durationBuckets"`

	// HourOfDay Always 24 entries, 00–23 UTC, keyed by off-block time (falling back to take-off time). Flights with neither time recorded are omitted.
	HourOfDay []AnalyticsBucketRow `json:"hourOfDay"`

	// MonthOfYear Always twelve entries, January (1) through December (12), including months with no flights.
	MonthOfYear []AnalyticsBucketRow `json:"monthOfYear"`

	// Monthly One entry per calendar month in the timeframe that has at least one flight, oldest first.
	Monthly []AnalyticsMonthPoint `json:"monthly"`
	Range   AnalyticsRange        `json:"range"`
	Records AnalyticsRecords      `json:"records"`

	// Totals Aggregated totals for the timeframe. When the user has an initial-hours
	// snapshot that the timeframe reaches back to, its carried-forward totals
	// are included here and reported separately in `FlightAnalytics.baseline`.
	Totals AnalyticsTotals `json:"totals"`

	// Yearly One entry per calendar year in the timeframe that has at least one flight, oldest first.
	Yearly []AnalyticsYearPoint `json:"yearly"`
}

type FlightBaseline struct {
	// BaselineDate Cutoff date the snapshot covers (inclusive).
	BaselineDate        openapi_types.Date `json:"baselineDate"`
	CreatedAt           *time.Time         `json:"createdAt,omitempty"`
	CrossCountryMinutes *int               `json:"crossCountryMinutes,omitempty"`
	DualGivenMinutes    *int               `json:"dualGivenMinutes,omitempty"`

	// DualMinutes Dual instruction received in minutes
	DualMinutes *int `json:"dualMinutes,omitempty"`

	// ExaminerMinutes Carried-forward examiner time in minutes
	ExaminerMinutes *int `json:"examinerMinutes,omitempty"`

	// IfrMinutes Total IFR / instrument time in minutes
	IfrMinutes        *int `json:"ifrMinutes,omitempty"`
	LandingsDay       *int `json:"landingsDay,omitempty"`
	LandingsNight     *int `json:"landingsNight,omitempty"`
	MultiPilotMinutes *int `json:"multiPilotMinutes,omitempty"`
	NightMinutes      *int `json:"nightMinutes,omitempty"`

	// Notes Optional free-form context (e.g. "From paper logbook 1998-2010").
	Notes      *string `json:"notes,omitempty"`
	PicMinutes *int    `json:"picMinutes,omitempty"`

	// PicusMinutes Carried-forward PIC under supervision (PICUS) time in minutes
	PicusMinutes *int `json:"picusMinutes,omitempty"`

	// ReliefMinutes Carried-forward cruise relief co-pilot time in minutes
	ReliefMinutes *int `json:"reliefMinutes,omitempty"`
	SicMinutes    *int `json:"sicMinutes,omitempty"`
	SoloMinutes   *int `json:"soloMinutes,omitempty"`

	// SpicMinutes Carried-forward student pilot-in-command (SPIC) time in minutes
	SpicMinutes  *int `json:"spicMinutes,omitempty"`
	TotalFlights *int `json:"totalFlights,omitempty"`

	// TotalMinutes Total block time in minutes
	TotalMinutes *int       `json:"totalMinutes,omitempty"`
	UpdatedAt    *time.Time `json:"updatedAt,omitempty"`
}

type FlightBaselineInput struct {
	// BaselineDate Cutoff date the snapshot covers (inclusive).
	BaselineDate        openapi_types.Date `json:"baselineDate"`
	CrossCountryMinutes *int               `json:"crossCountryMinutes,omitempty"`
	DualGivenMinutes    *int               `json:"dualGivenMinutes,omitempty"`

	// DualMinutes Dual instruction received in minutes
	DualMinutes *int `json:"dualMinutes,omitempty"`

	// ExaminerMinutes Carried-forward examiner time in minutes
	ExaminerMinutes *int `json:"examinerMinutes,omitempty"`

	// IfrMinutes Total IFR / instrument time in minutes
	IfrMinutes        *int `json:"ifrMinutes,omitempty"`
	LandingsDay       *int `json:"landingsDay,omitempty"`
	LandingsNight     *int `json:"landingsNight,omitempty"`
	MultiPilotMinutes *int `json:"multiPilotMinutes,omitempty"`
	NightMinutes      *int `json:"nightMinutes,omitempty"`

	// Notes Optional free-form context (e.g. "From paper logbook 1998-2010").
	Notes      *string `json:"notes,omitempty"`
	PicMinutes *int    `json:"picMinutes,omitempty"`

	// PicusMinutes Carried-forward PIC under supervision (PICUS) time in minutes
	PicusMinutes *int `json:"picusMinutes,omitempty"`

	// ReliefMinutes Carried-forward cruise relief co-pilot time in minutes
	ReliefMinutes *int `json:"reliefMinutes,omitempty"`
	SicMinutes    *int `json:"sicMinutes,omitempty"`
	SoloMinutes   *int `json:"soloMinutes,omitempty"`

	// SpicMinutes Carried-forward student pilot-in-command (SPIC) time in minutes
	SpicMinutes  *int `json:"spicMinutes,omitempty"`
	TotalFlights *int `json:"totalFlights,omitempty"`

	// TotalMinutes Total block time in minutes
	TotalMinutes *int `json:"totalMinutes,omitempty"`
}

type FlightCreate struct {
	// ActualInstrumentTime Actual instrument (IMC) time in minutes. Always 0 for an FSTD session.
	ActualInstrumentTime *int `json:"actualInstrumentTime,omitempty"`

	// AircraftReg Aircraft registration. Required for a flight, rejected for an FSTD session.
	//
	// Example: D-EFGH
	AircraftReg *string `json:"aircraftReg,omitempty"`

	// AircraftType Aircraft type. For an FSTD session, the aircraft type the device represents.
	//
	// Example: C172
	AircraftType string `json:"aircraftType"`

	// AllLandings Total landings (day + night). Auto-calculated by the server.
	AllLandings *int `json:"allLandings,omitempty"`

	// Approaches Structured instrument approach details
	Approaches      *[]ApproachEntryInput `json:"approaches,omitempty"`
	ApproachesCount *int                  `json:"approachesCount,omitempty"`

	// ArrivalIcao Arrival location — an ICAO code (resolved to coordinates for maps/distance) or a free-text place name for off-airport sites. Required for a flight, rejected for an FSTD session.
	//
	// Example: EDDH
	ArrivalIcao *string `json:"arrivalIcao,omitempty"`

	// ArrivalTime Landing time in UTC
	//
	// Example: 16:45:00
	ArrivalTime *string `json:"arrivalTime,omitempty"`

	// CrewMembers People on board this flight
	CrewMembers *[]FlightCrewMemberInput `json:"crewMembers,omitempty"`

	// CrossCountryTime Cross-country time in minutes. Auto-calculated by the server.
	CrossCountryTime *int `json:"crossCountryTime,omitempty"`

	// Date Example: 2026-01-30
	Date openapi_types.Date `json:"date"`

	// DepartureIcao Departure location — an ICAO code (resolved to coordinates for maps/distance) or a free-text place name for off-airport sites. Required for a flight, rejected for an FSTD session.
	//
	// Example: EDDF
	DepartureIcao *string `json:"departureIcao,omitempty"`

	// DepartureTime Takeoff time in UTC
	//
	// Example: 14:30:00
	DepartureTime *string `json:"departureTime,omitempty"`

	// Distance Distance in nautical miles. Auto-calculated by the server.
	Distance      *float32 `json:"distance,omitempty"`
	DualGivenTime *int     `json:"dualGivenTime,omitempty"`

	// DualTime Dual instruction time in minutes. Computed by server — equals totalTime when isDual is true, 0 otherwise.
	//
	// Example: 0
	DualTime *int `json:"dualTime,omitempty"`

	// Endorsements Instructor endorsements, skill test references
	Endorsements *string `json:"endorsements,omitempty"`

	// ExaminerTime Time conducting a check as examiner, in minutes. Overlays function time; bounded by totalTime.
	ExaminerTime *int `json:"examinerTime,omitempty"`

	// FstdType FSTD type designation (e.g., "FNPT II", "FFS A320"). Required when isSimulator is true.
	FstdType           *string `json:"fstdType,omitempty"`
	GroundTrainingTime *int    `json:"groundTrainingTime,omitempty"`
	Holds              *int    `json:"holds,omitempty"`

	// IfrTime Example: 60
	IfrTime            *int    `json:"ifrTime,omitempty"`
	InstructorComments *string `json:"instructorComments,omitempty"`
	InstructorName     *string `json:"instructorName,omitempty"`
	IsFlightReview     *bool   `json:"isFlightReview,omitempty"`
	IsIpc              *bool   `json:"isIpc,omitempty"`
	IsProficiencyCheck *bool   `json:"isProficiencyCheck,omitempty"`

	// IsSimulator Marks this entry as an FSTD (simulator) session rather than a flight.
	IsSimulator *bool `json:"isSimulator,omitempty"`

	// Landings Total number of landings. Day/night split is auto-calculated from sunset/sunrise at arrival airport. Required for a flight, rejected for an FSTD session.
	//
	// Example: 3
	Landings     *int                      `json:"landings,omitempty"`
	LaunchMethod *FlightCreateLaunchMethod `json:"launchMethod,omitempty"`

	// MultiPilotTime Multi-pilot time in minutes (EASA AMC1 FCL.050 Col 10)
	MultiPilotTime *int `json:"multiPilotTime,omitempty"`

	// OffBlockTime Off-block time (chocks off / engine start) in UTC. Required for a flight, rejected for an FSTD session.
	//
	// Example: 14:15:00
	OffBlockTime *string `json:"offBlockTime,omitempty"`

	// OnBlockTime On-block time (chocks on / engine shutdown) in UTC. Required for a flight, rejected for an FSTD session.
	//
	// Example: 16:55:00
	OnBlockTime *string `json:"onBlockTime,omitempty"`

	// PicName Name of the PIC. Auto-set to "Self" when isPic=true, or to instructorName when isDual=true.
	PicName *string `json:"picName,omitempty"`

	// PicTime Pilot-in-command time in minutes. Computed by server — equals totalTime when isPic is true, 0 otherwise.
	//
	// Example: 150
	PicTime *int `json:"picTime,omitempty"`

	// PicusTime PIC under supervision time in minutes. Carved out of the derived function time; the declared function times together with the derived ones must not exceed totalTime.
	PicusTime *int `json:"picusTime,omitempty"`

	// ReliefTime Cruise relief co-pilot time in minutes. Carved out of the derived function time.
	ReliefTime *int `json:"reliefTime,omitempty"`

	// Remarks Example: Training flight - touch and go practice
	Remarks *string `json:"remarks,omitempty"`

	// Route Route waypoints as comma-separated ICAO codes
	//
	// Example: EDDF,EDDS,EDDM
	Route   *string `json:"route,omitempty"`
	SicTime *int    `json:"sicTime,omitempty"`

	// SimulatedFlightTime FSTD session duration in minutes (EASA AMC1 FCL.050 Col 22). Required and positive when isSimulator is true.
	SimulatedFlightTime     *int `json:"simulatedFlightTime,omitempty"`
	SimulatedInstrumentTime *int `json:"simulatedInstrumentTime,omitempty"`

	// SoloTime Solo time in minutes. Auto-calculated by the server.
	SoloTime *int `json:"soloTime,omitempty"`

	// SpicTime Student pilot-in-command time in minutes. Carved out of the derived function time.
	SpicTime *int `json:"spicTime,omitempty"`

	// TakeoffsDay Number of day takeoffs. Provide to override auto-calculation.
	//
	// Example: 3
	TakeoffsDay *int `json:"takeoffsDay,omitempty"`

	// TakeoffsNight Number of night takeoffs. Provide to override auto-calculation.
	//
	// Example: 0
	TakeoffsNight *int `json:"takeoffsNight,omitempty"`

	// TotalTime Total block time in minutes calculated from offBlockTime and onBlockTime. Always 0 for an FSTD session. This field is computed by the server and should not be provided by the client.
	//
	// Example: 150
	TotalTime *int `json:"totalTime,omitempty"`
}

type FlightCreateLaunchMethod string

type FlightCrewMember struct {
	// ContactId Reference to a saved contact for autocomplete reuse
	ContactId *openapi_types.UUID `json:"contactId,omitempty"`
	FlightId  openapi_types.UUID  `json:"flightId"`
	Id        openapi_types.UUID  `json:"id"`

	// Name Example: John Smith
	Name string `json:"name"`

	// Role Role of a person on board a flight
	Role CrewRole `json:"role"`
}

type FlightCrewMemberInput struct {
	ContactId *openapi_types.UUID `json:"contactId,omitempty"`

	// Name Example: John Smith
	Name string `json:"name"`

	// Role Role of a person on board a flight
	Role CrewRole `json:"role"`
}

type FlightId = openapi_types.UUID

type FlightLaunchMethod string

type FlightListColumn string

type FlightReviewStatus struct {
	// ExpiresOn Last date the flight review remains valid — the final day of the 24th calendar month after it was completed (inclusive)
	ExpiresOn *openapi_types.Date `json:"expiresOn,omitempty"`

	// LastCompleted Date of most recent flight review
	LastCompleted *openapi_types.Date `json:"lastCompleted,omitempty"`

	// MessageKey Stable key identifying which statement is true, for client-side localisation. Catalogued in docs/CURRENCY_MESSAGES.md.
	//
	// Example: flight_review.current
	MessageKey *string `json:"messageKey,omitempty"`

	// MessageParams Variable parts of a localised message that are not already fields on the enclosing object. Which fields are present is determined by messageKey; see docs/CURRENCY_MESSAGES.md for the per-key contract.
	MessageParams *MessageParams `json:"messageParams,omitempty"`

	// Status Flight review currency status
	Status FlightReviewStatusStatus `json:"status"`
}

type FlightReviewStatusStatus string

type FlightRoute struct {
	ArrivalCoords struct {
		Lat float64 `json:"lat"`
		Lng float64 `json:"lng"`
	} `json:"arrivalCoords"`

	// ArrivalIcao Example: EDDH
	ArrivalIcao     string `json:"arrivalIcao"`
	DepartureCoords struct {
		Lat float64 `json:"lat"`
		Lng float64 `json:"lng"`
	} `json:"departureCoords"`

	// DepartureIcao Example: EDDF
	DepartureIcao string `json:"departureIcao"`

	// FlightCount Number of flights on this route
	//
	// Example: 5
	FlightCount int `json:"flightCount"`
}

type FlightRoutesResponse struct {
	Airports []Airport     `json:"airports"`
	Routes   []FlightRoute `json:"routes"`
}

type FlightSession struct {
	// AircraftReg Aircraft registration; required by the time the session goes on blocks
	//
	// Example: D-EFGH
	AircraftReg *string `json:"aircraftReg,omitempty"`

	// ArrivalIcao Arrival airport, provided explicitly or resolved from GPS coordinates
	//
	// Example: EDDH
	ArrivalIcao *string   `json:"arrivalIcao,omitempty"`
	CreatedAt   time.Time `json:"createdAt"`

	// DepartureIcao Departure airport, provided explicitly or resolved from GPS coordinates
	//
	// Example: EDDF
	DepartureIcao *string `json:"departureIcao,omitempty"`

	// FlightId ID of the flight log entry created when the session was completed
	FlightId *openapi_types.UUID `json:"flightId,omitempty"`
	Id       openapi_types.UUID  `json:"id"`

	// LandingAt Landing instant in UTC
	LandingAt *time.Time `json:"landingAt,omitempty"`

	// OffBlockAt Off-block instant (chocks off / engine start) in UTC
	OffBlockAt *time.Time `json:"offBlockAt,omitempty"`

	// OnBlockAt On-block instant (chocks on / engine shutdown) in UTC
	OnBlockAt *time.Time `json:"onBlockAt,omitempty"`

	// Status Session lifecycle state. `onblock` events complete the session.
	Status FlightSessionStatus `json:"status"`

	// TakeoffAt Takeoff instant in UTC
	TakeoffAt *time.Time         `json:"takeoffAt,omitempty"`
	UpdatedAt time.Time          `json:"updatedAt"`
	UserId    openapi_types.UUID `json:"userId"`
}

type FlightSessionEvent struct {
	// AircraftReg Aircraft registration. Can be sent with any event; required by the time the session goes on blocks.
	//
	// Example: D-EFGH
	AircraftReg *string `json:"aircraftReg,omitempty"`

	// Icao Explicit airport for this event (departure for offblock/takeoff, arrival for landing/onblock). Takes precedence over lat/lon.
	//
	// Example: EDDF
	Icao *string `json:"icao,omitempty"`

	// Lat GPS latitude used to resolve the nearest airport
	Lat *float64 `json:"lat,omitempty"`

	// Lon GPS longitude used to resolve the nearest airport
	Lon *float64 `json:"lon,omitempty"`

	// OccurredAt When the event actually happened (UTC). Defaults to the server clock; send this when the tap was queued offline.
	OccurredAt *time.Time `json:"occurredAt,omitempty"`

	// Type Which block/flight time instant this event records
	Type FlightSessionEventType `json:"type"`
}

type FlightSessionEventType string

type FlightSessionStatus string

type FlightSignature struct {
	CreatedAt                  time.Time            `json:"createdAt"`
	EmailSendCount             int                  `json:"emailSendCount"`
	EmailSentAt                *time.Time           `json:"emailSentAt,omitempty"`
	FlightId                   openapi_types.UUID   `json:"flightId"`
	Id                         openapi_types.UUID   `json:"id"`
	InstructorCredentialNumber *string              `json:"instructorCredentialNumber,omitempty"`
	InstructorEmail            *openapi_types.Email `json:"instructorEmail,omitempty"`
	InstructorName             *string              `json:"instructorName,omitempty"`

	// Method live = captured in person with no token; deferred = token-based, delivered by email and/or a shareable link/QR
	Method         FlightSignatureMethod `json:"method"`
	SignedAt       *time.Time            `json:"signedAt,omitempty"`
	Status         FlightSignatureStatus `json:"status"`
	TokenExpiresAt *time.Time            `json:"tokenExpiresAt,omitempty"`
	UpdatedAt      time.Time             `json:"updatedAt"`
	VoidedAt       *time.Time            `json:"voidedAt,omitempty"`
	VoidedReason   *string               `json:"voidedReason,omitempty"`
}

type FlightSignatureMethod string

type FlightSignatureStatus string

type FlightUpdate struct {
	ActualInstrumentTime *int                      `json:"actualInstrumentTime,omitempty"`
	AircraftReg          *string                   `json:"aircraftReg,omitempty"`
	AircraftType         *string                   `json:"aircraftType,omitempty"`
	Approaches           *[]ApproachEntryInput     `json:"approaches,omitempty"`
	ApproachesCount      *int                      `json:"approachesCount,omitempty"`
	ArrivalIcao          nullable.Nullable[string] `json:"arrivalIcao,omitempty"`

	// ArrivalTime Landing time in UTC
	ArrivalTime nullable.Nullable[string] `json:"arrivalTime,omitempty"`

	// CrewMembers People on board this flight
	CrewMembers   *[]FlightCrewMemberInput  `json:"crewMembers,omitempty"`
	Date          *openapi_types.Date       `json:"date,omitempty"`
	DepartureIcao nullable.Nullable[string] `json:"departureIcao,omitempty"`

	// DepartureTime Takeoff time in UTC
	DepartureTime nullable.Nullable[string] `json:"departureTime,omitempty"`
	DualGivenTime *int                      `json:"dualGivenTime,omitempty"`

	// Endorsements Instructor endorsements, skill test references
	Endorsements nullable.Nullable[string] `json:"endorsements,omitempty"`

	// ExaminerTime Time conducting a check as examiner, in minutes. Overlays function time; bounded by totalTime.
	ExaminerTime *int `json:"examinerTime,omitempty"`

	// FstdType FSTD type designation
	FstdType           nullable.Nullable[string] `json:"fstdType,omitempty"`
	GroundTrainingTime *int                      `json:"groundTrainingTime,omitempty"`
	Holds              *int                      `json:"holds,omitempty"`
	IfrTime            *int                      `json:"ifrTime,omitempty"`
	InstructorComments nullable.Nullable[string] `json:"instructorComments,omitempty"`
	InstructorName     nullable.Nullable[string] `json:"instructorName,omitempty"`
	IsFlightReview     *bool                     `json:"isFlightReview,omitempty"`
	IsIpc              *bool                     `json:"isIpc,omitempty"`
	IsProficiencyCheck *bool                     `json:"isProficiencyCheck,omitempty"`

	// IsSimulator Switches the entry between flight and FSTD session. Changing it clears the columns that do not apply to the new kind.
	IsSimulator *bool `json:"isSimulator,omitempty"`

	// Landings Total number of landings
	Landings     *int                      `json:"landings,omitempty"`
	LaunchMethod nullable.Nullable[string] `json:"launchMethod,omitempty"`

	// MultiPilotTime Multi-pilot time in minutes
	MultiPilotTime *int `json:"multiPilotTime,omitempty"`

	// OffBlockTime Off-block time (chocks off / engine start) in UTC
	OffBlockTime nullable.Nullable[string] `json:"offBlockTime,omitempty"`

	// OnBlockTime On-block time (chocks on / engine shutdown) in UTC
	OnBlockTime nullable.Nullable[string] `json:"onBlockTime,omitempty"`

	// PicName Name of the PIC
	PicName nullable.Nullable[string] `json:"picName,omitempty"`

	// PicusTime PIC under supervision time in minutes. Carved out of the derived function time.
	PicusTime *int `json:"picusTime,omitempty"`

	// ReliefTime Cruise relief co-pilot time in minutes. Carved out of the derived function time.
	ReliefTime *int                      `json:"reliefTime,omitempty"`
	Remarks    nullable.Nullable[string] `json:"remarks,omitempty"`

	// Route Route waypoints as comma-separated ICAO codes
	Route                   nullable.Nullable[string] `json:"route,omitempty"`
	SicTime                 *int                      `json:"sicTime,omitempty"`
	SimulatedFlightTime     *int                      `json:"simulatedFlightTime,omitempty"`
	SimulatedInstrumentTime *int                      `json:"simulatedInstrumentTime,omitempty"`

	// SpicTime Student pilot-in-command time in minutes. Carved out of the derived function time.
	SpicTime *int `json:"spicTime,omitempty"`

	// TakeoffsDay Number of day takeoffs. Provide to override auto-calculation.
	TakeoffsDay *int `json:"takeoffsDay,omitempty"`

	// TakeoffsNight Number of night takeoffs. Provide to override auto-calculation.
	TakeoffsNight *int `json:"takeoffsNight,omitempty"`
	TotalTime     *int `json:"totalTime,omitempty"`
}

type Forbidden = Error

type GetFlightAnalyticsParams struct {
	// Months Number of months to include, counted from the start of the month `months` months ago. 0 means all time.
	Months *int `form:"months,omitempty" json:"months,omitempty"`

	// Limit Maximum number of rows returned per ranked breakdown (aircraft, airports, routes, instructors, crew).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}

type GetFlightTrendsParams struct {
	// Months Number of months to include (default 12, max 60)
	Months *int `form:"months,omitempty" json:"months,omitempty"`
}

type GetLicenseStatisticsParams struct {
	// StartDate Filter from this date (inclusive)
	StartDate *openapi_types.Date `form:"startDate,omitempty" json:"startDate,omitempty"`

	// EndDate Filter to this date (inclusive)
	EndDate *openapi_types.Date `form:"endDate,omitempty" json:"endDate,omitempty"`
}

type GetMyStatisticsParams struct {
	// StartDate Filter from this date (inclusive)
	StartDate *openapi_types.Date `form:"startDate,omitempty" json:"startDate,omitempty"`

	// EndDate Filter to this date (inclusive)
	EndDate *openapi_types.Date `form:"endDate,omitempty" json:"endDate,omitempty"`
}

type GetNotificationHistoryParams struct {
	// Limit Maximum number of results to return
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetStatsByClassParams struct {
	// Months Number of months to include (default 12, 0 = all time)
	Months *int `form:"months,omitempty" json:"months,omitempty"`
}

type GetUpdateStatusParams struct {
	// FrontendVersion Version the calling frontend build was stamped with.
	FrontendVersion *string `form:"frontendVersion,omitempty" json:"frontendVersion,omitempty"`

	// FrontendCommit Commit the calling frontend image was built from. Used when the frontend runs an untagged build (the `latest` image), where there is no version to compare.
	FrontendCommit *string `form:"frontendCommit,omitempty" json:"frontendCommit,omitempty"`
}

type GinServerOptions struct {
	BaseURL      string
	Middlewares  []MiddlewareFunc
	ErrorHandler func(*gin.Context, error, int)
}

type ImportColumnMapping struct {
	// DateFormat Date parsing format (Go / strftime-style). Only relevant when targetField is `date`.
	//
	// Example: 2006-01-02
	DateFormat *string `json:"dateFormat,omitempty"`

	// SourceColumn Column header name from the uploaded file
	//
	// Example: Date
	SourceColumn string `json:"sourceColumn"`

	// TargetField Target flight log field for column mapping.
	//
	// Landings can be mapped either as a day/night split (`landingsDay` +
	// `landingsNight`, which are summed) or as a single `landingsTotal`
	// column. When a file carries both — as ForeFlight and MyFlightbook do —
	// the larger of the two wins, so touch-and-go landings counted only in
	// the total column are not lost.
	//
	// Person fields (`person1`–`person6`) extract crew members from import rows.
	// During ForeFlight imports, role assignment is automatic:
	// - If an instructor is detected (via `instructorName` or dual-received time),
	//   `person1` is assigned the **Instructor** role and `person2` the **Student** role.
	// - Otherwise, `person1` is assigned **PIC**.
	// - `person3`–`person6` default to **Passenger**.
	// Contacts are auto-created for each unique person name.
	// Use `ignore` to skip a column during import.
	TargetField ImportField `json:"targetField"`

	// TimeFormat Time parsing format. Only relevant for time fields.
	//
	// Example: 15:04
	TimeFormat *string `json:"timeFormat,omitempty"`

	// TrueValue String value that maps to boolean `true` (e.g. "Yes", "X", "1"). Only relevant for isPic / isDual.
	//
	// Example: X
	TrueValue *string `json:"trueValue,omitempty"`
}

type ImportConfirmRequest struct {
	// IncludeDuplicates When true, import all duplicate rows as well (overrides selectedRows filtering)
	IncludeDuplicates *bool `json:"includeDuplicates,omitempty"`

	// SelectedRows Row indices to import (1-based). If omitted or empty, all `valid` rows are imported.
	// Include duplicate row indices here to force-import them.
	//
	//
	// Example: [1,2,3,5,7,8]
	SelectedRows *[]int `json:"selectedRows,omitempty"`

	// UploadToken Upload token from the preview response
	//
	// Example: imp_01HXYZ1234567890ABCDEF
	UploadToken string `json:"uploadToken"`
}

type ImportDataJSONJSONBody struct {
	Aircraft            *[]map[string]interface{} `json:"aircraft,omitempty"`
	Contacts            *[]map[string]interface{} `json:"contacts,omitempty"`
	Credentials         *[]map[string]interface{} `json:"credentials,omitempty"`
	CustomCurrencyRules *[]map[string]interface{} `json:"customCurrencyRules,omitempty"`
	ExportedAt          *time.Time                `json:"exportedAt,omitempty"`
	FlightBaseline      *map[string]interface{}   `json:"flightBaseline,omitempty"`
	Flights             *[]map[string]interface{} `json:"flights,omitempty"`

	// Format Example: NinerLog JSON Backup
	Format                  string                    `json:"format"`
	Licenses                *[]map[string]interface{} `json:"licenses,omitempty"`
	NotificationPreferences *map[string]interface{}   `json:"notificationPreferences,omitempty"`
	Version                 *string                   `json:"version,omitempty"`
}

type ImportDataJSONJSONRequestBody ImportDataJSONJSONBody

type ImportField string

type ImportFormat string

type ImportId = openapi_types.UUID

type ImportJSONResult struct {
	// AircraftImported Number of aircraft created from the backup
	//
	// Example: 3
	AircraftImported int `json:"aircraftImported"`

	// AircraftSkipped Aircraft skipped because the registration already exists for the user
	//
	// Example: 1
	AircraftSkipped int `json:"aircraftSkipped"`

	// ClassRatingsImported Example: 4
	ClassRatingsImported int `json:"classRatingsImported"`

	// ContactsCreated Contacts created because a crew name in the backup matched none of this account's contacts — counted after the backup's own contacts have been restored, so it covers only crew names with no contact record of their own.
	//
	// Example: 5
	ContactsCreated int `json:"contactsCreated"`

	// ContactsImported Contacts restored from the backup's own contacts section
	//
	// Example: 12
	ContactsImported int `json:"contactsImported"`

	// ContactsSkipped Contacts skipped because this account already holds that name
	//
	// Example: 2
	ContactsSkipped int `json:"contactsSkipped"`

	// CredentialsImported Example: 2
	CredentialsImported int `json:"credentialsImported"`

	// CrewMembersImported Example: 11
	CrewMembersImported int `json:"crewMembersImported"`

	// CustomCurrencyRulesImported User-authored currency rules restored. Sharing state is never carried over: a restored rule is private until shared again.
	//
	// Example: 3
	CustomCurrencyRulesImported int `json:"customCurrencyRulesImported"`

	// FlightBaselineImported Whether the backup carried a carried-forward hours baseline that was applied
	FlightBaselineImported bool `json:"flightBaselineImported"`

	// FlightsImported Example: 27
	FlightsImported int `json:"flightsImported"`

	// LicensesImported Example: 2
	LicensesImported int `json:"licensesImported"`

	// NotificationPreferencesImported Whether the backup carried notification preferences that were applied
	NotificationPreferencesImported bool `json:"notificationPreferencesImported"`
}

type ImportPreviewFlight struct {
	// Errors Validation errors when status is `error`
	Errors *[]struct {
		// Field Example: totalTime
		Field *string `json:"field,omitempty"`

		// Message Example: Must be greater than 0
		Message *string `json:"message,omitempty"`
	} `json:"errors,omitempty"`

	// ExistingFlightId ID of the matching existing flight when status is `duplicate`
	ExistingFlightId *openapi_types.UUID `json:"existingFlightId,omitempty"`

	// Flight Creates either a flight or an FSTD (simulator) session.
	//
	// For a flight (`isSimulator` absent or false) `aircraftReg`, `departureIcao`,
	// `arrivalIcao`, `offBlockTime`, `onBlockTime` and `landings` are all required;
	// omitting any of them returns 400.
	//
	// For an FSTD session (`isSimulator: true`) they must be omitted — a training
	// device is not flown between places and has no block times. The session
	// requires `fstdType` and `simulatedFlightTime` instead. Session time is never
	// summed into flight time (EASA AMC1 FCL.050 Cols 20-22).
	Flight FlightCreate `json:"flight"`

	// RowIndex 1-based row number in the original file
	//
	// Example: 2
	RowIndex int `json:"rowIndex"`

	// Status Row validation result:
	// - valid: Ready to import
	// - duplicate: Matches an existing flight (same date, aircraft, departure, arrival, total time ±0.1h)
	// - error: Validation failed — see `errors` field
	Status ImportPreviewFlightStatus `json:"status"`
}

type ImportPreviewFlightStatus string

type ImportPreviewRequest struct {
	// Mappings Column → field mappings (user-confirmed or adjusted)
	Mappings []ImportColumnMapping `json:"mappings"`

	// SkipDuplicates Whether to flag rows that match existing flights as duplicates
	SkipDuplicates *bool `json:"skipDuplicates,omitempty"`

	// UploadToken Upload token from the upload response
	//
	// Example: imp_01HXYZ1234567890ABCDEF
	UploadToken string `json:"uploadToken"`
}

type ImportPreviewResponse struct {
	// DuplicateCount Rows matching existing flights
	//
	// Example: 3
	DuplicateCount int `json:"duplicateCount"`

	// ErrorCount Rows with validation errors
	//
	// Example: 1
	ErrorCount int `json:"errorCount"`

	// Flights All rows with their validation status, sorted by rowIndex
	Flights []ImportPreviewFlight `json:"flights"`

	// TotalRows Total rows processed
	//
	// Example: 42
	TotalRows int `json:"totalRows"`

	// UploadToken Upload token to use in the confirm request
	//
	// Example: imp_01HXYZ1234567890ABCDEF
	UploadToken string `json:"uploadToken"`

	// ValidCount Rows ready to import
	//
	// Example: 38
	ValidCount int `json:"validCount"`
}

type ImportResult struct {
	// AircraftCreated Number of aircraft auto-created from the imported rows. Any registration that appears in the file but not yet in the user's fleet is added, so imported flights are backed by a fleet entry.
	//
	// Example: 4
	AircraftCreated *int `json:"aircraftCreated,omitempty"`

	// ContactsCreated Number of new contacts auto-created from person data during import
	//
	// Example: 2
	ContactsCreated *int `json:"contactsCreated,omitempty"`

	// CreatedAt Example: 2026-02-13T18:00:00Z
	CreatedAt time.Time `json:"createdAt"`

	// DuplicateCount Number of rows detected as duplicates
	//
	// Example: 3
	DuplicateCount int `json:"duplicateCount"`

	// ErrorCount Number of rows that failed validation
	//
	// Example: 1
	ErrorCount int `json:"errorCount"`

	// Errors Per-row errors for rows that were not imported
	Errors *[]struct {
		// Field Example: totalTime
		Field string `json:"field"`

		// Message Example: Must be greater than 0
		Message string `json:"message"`

		// RawValue The original value from the file that caused the error
		//
		// Example: -1.5
		RawValue *string `json:"rawValue,omitempty"`

		// RowIndex 1-based row number that caused the error
		//
		// Example: 15
		RowIndex int `json:"rowIndex"`
	} `json:"errors,omitempty"`

	// FileName Example: foreflight_logbook_2025.csv
	FileName string `json:"fileName"`

	// Format The import template that matched the uploaded file, detected from its
	// header row. Recording the source format is what makes the import
	// auditable — and it is the value the admin dashboard groups by to show
	// which logbooks pilots are migrating from.
	//
	// - CSV: no template matched; columns were mapped by name and by hand
	// - FOREFLIGHT_CSV: ForeFlight Logbook export (also carries an Aircraft Table)
	// - NINERLOG_CSV: NinerLog's own CSV export, re-imported
	// - LOGTEN_CSV: LogTen Pro (Coradine), human-readable or `flight_…` key dialect
	// - MYFLIGHTBOOK_CSV: MyFlightbook
	// - CAPZLOG_CSV: capzlog.aero
	// - FLYLOG_CSV: FLYLOG.io
	// - WADER_CSV: Wader Pilot Logbook
	// - VEREINSFLIEGER_CSV: Vereinsflieger club flight list, standard export (German headers, airborne times only)
	// - VEREINSFLIEGER_EXTENDED_CSV: Vereinsflieger club flight list, extended export (adds off-block/on-block and block minutes)
	// - SKYDEMON_CSV: SkyDemon logbook export
	// - EASA_CSV: generic EASA AMC1 FCL.050 column layout
	// - FAA_CSV: generic FAA/ASA column layout
	// - XLS: Microsoft Excel 97-2003 workbook
	// - XLSX: Microsoft Excel 2007+ workbook (Open XML)
	Format ImportFormat `json:"format"`

	// Id Example: 990e8400-e29b-41d4-a716-446655440004
	Id openapi_types.UUID `json:"id"`

	// ImportedCount Number of flights successfully created
	//
	// Example: 38
	ImportedCount int `json:"importedCount"`

	// ImportedFlightIds IDs of the created flight log entries
	ImportedFlightIds *[]openapi_types.UUID `json:"importedFlightIds,omitempty"`

	// SkippedCount Number of rows skipped (duplicates not imported)
	//
	// Example: 3
	SkippedCount int `json:"skippedCount"`

	// Status Overall import result:
	// - completed: All selected rows imported successfully
	// - partial: Some rows imported, some failed
	// - failed: No rows imported (all failed validation)
	Status ImportStatus `json:"status"`

	// TotalRows Total rows in the uploaded file
	//
	// Example: 42
	TotalRows int `json:"totalRows"`

	// UserId Example: 550e8400-e29b-41d4-a716-446655440000
	UserId openapi_types.UUID `json:"userId"`
}

type ImportStatus string

type ImportTemplate struct {
	// AutoDetected Whether a file in this format is recognised automatically from its
	// header row. `false` means the file still imports, but every column
	// is mapped on the mapping screen.
	AutoDetected bool `json:"autoDetected"`

	// Confidence How the template's column list was built.
	// - `exact`: the header row is known verbatim (NinerLog's own exports,
	//   or a published and stable column list)
	// - `best-effort`: the aliases cover the documented columns plus the
	//   usual spelling variants, but the export has not been verified byte
	//   for byte. Auto-detection may miss; the column-mapping step catches it.
	Confidence ImportTemplateConfidence `json:"confidence"`

	// Description What this template covers and what it cannot carry across
	Description string `json:"description"`

	// ExportSteps Ordered, human-readable instructions for exporting from the source
	// application. Shown on the import screen.
	ExportSteps []string `json:"exportSteps"`

	// Id The import template that matched the uploaded file, detected from its
	// header row. Recording the source format is what makes the import
	// auditable — and it is the value the admin dashboard groups by to show
	// which logbooks pilots are migrating from.
	//
	// - CSV: no template matched; columns were mapped by name and by hand
	// - FOREFLIGHT_CSV: ForeFlight Logbook export (also carries an Aircraft Table)
	// - NINERLOG_CSV: NinerLog's own CSV export, re-imported
	// - LOGTEN_CSV: LogTen Pro (Coradine), human-readable or `flight_…` key dialect
	// - MYFLIGHTBOOK_CSV: MyFlightbook
	// - CAPZLOG_CSV: capzlog.aero
	// - FLYLOG_CSV: FLYLOG.io
	// - WADER_CSV: Wader Pilot Logbook
	// - VEREINSFLIEGER_CSV: Vereinsflieger club flight list, standard export (German headers, airborne times only)
	// - VEREINSFLIEGER_EXTENDED_CSV: Vereinsflieger club flight list, extended export (adds off-block/on-block and block minutes)
	// - SKYDEMON_CSV: SkyDemon logbook export
	// - EASA_CSV: generic EASA AMC1 FCL.050 column layout
	// - FAA_CSV: generic FAA/ASA column layout
	// - XLS: Microsoft Excel 97-2003 workbook
	// - XLSX: Microsoft Excel 2007+ workbook (Open XML)
	Id ImportFormat `json:"id"`

	// Name Display name of the source logbook
	//
	// Example: MyFlightbook
	Name string `json:"name"`

	// Regions Regulatory layouts the source targets
	Regions []ImportTemplateRegions `json:"regions"`

	// Vendor Company or project behind the source logbook
	//
	// Example: MyFlightbook
	Vendor *string `json:"vendor,omitempty"`

	// Website Homepage of the source logbook, when it has one
	//
	// Example: https://myflightbook.com
	Website *string `json:"website,omitempty"`
}

type ImportTemplateConfidence string

type ImportTemplateList struct {
	Templates []ImportTemplate `json:"templates"`
}

type ImportTemplateRegions string

type ImportUploadResponse struct {
	// Columns Column headers found in the file
	//
	// Example: ["Date","AircraftID","From","To","Route","TimeOut","TimeIn","TotalTime","PIC","Landings"]
	Columns []string `json:"columns"`

	// DetectedTemplate One logbook export format NinerLog knows how to read, together with the
	// steps for getting that file out of the source application.
	DetectedTemplate *ImportTemplate `json:"detectedTemplate,omitempty"`

	// Format The import template that matched the uploaded file, detected from its
	// header row. Recording the source format is what makes the import
	// auditable — and it is the value the admin dashboard groups by to show
	// which logbooks pilots are migrating from.
	//
	// - CSV: no template matched; columns were mapped by name and by hand
	// - FOREFLIGHT_CSV: ForeFlight Logbook export (also carries an Aircraft Table)
	// - NINERLOG_CSV: NinerLog's own CSV export, re-imported
	// - LOGTEN_CSV: LogTen Pro (Coradine), human-readable or `flight_…` key dialect
	// - MYFLIGHTBOOK_CSV: MyFlightbook
	// - CAPZLOG_CSV: capzlog.aero
	// - FLYLOG_CSV: FLYLOG.io
	// - WADER_CSV: Wader Pilot Logbook
	// - VEREINSFLIEGER_CSV: Vereinsflieger club flight list, standard export (German headers, airborne times only)
	// - VEREINSFLIEGER_EXTENDED_CSV: Vereinsflieger club flight list, extended export (adds off-block/on-block and block minutes)
	// - SKYDEMON_CSV: SkyDemon logbook export
	// - EASA_CSV: generic EASA AMC1 FCL.050 column layout
	// - FAA_CSV: generic FAA/ASA column layout
	// - XLS: Microsoft Excel 97-2003 workbook
	// - XLSX: Microsoft Excel 2007+ workbook (Open XML)
	Format ImportFormat `json:"format"`

	// PreviewRows First 5 rows as key-value objects (column header → cell value)
	//
	// Example: [{"AircraftID":"D-EFGH","Date":"2025-12-01","From":"EDDF","Landings":"1","PIC":"1.5","To":"EDDH","TotalTime":"1.5"}]
	PreviewRows []map[string]string `json:"previewRows"`

	// SuggestedMappings Server-suggested column mappings based on header names.
	// When a template matched, these come from that template's column
	// layout; otherwise they fall back to a cross-vendor alias table.
	// The user can adjust mappings before submitting the preview request.
	SuggestedMappings []ImportColumnMapping `json:"suggestedMappings"`

	// TotalRows Total number of data rows in the file (excluding header)
	//
	// Example: 42
	TotalRows int `json:"totalRows"`

	// UploadToken Opaque token identifying this upload session. Valid for 1 hour.
	//
	// Example: imp_01HXYZ1234567890ABCDEF
	UploadToken string `json:"uploadToken"`
}