@deadair/sdk 0.50.0 → 0.50.2

package/dist/authentication/types/registration.types.d.ts

@@ -2,7 +2,7 @@ import { DateTime } from 'luxon';
 import type { OidcProvider } from './authentication.types.js';
 import type { PublicKeyCredentialWithAttestation } from './authentication.types.js';
 /**
- * generated from [PhoneFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L7)
+ * generated from [PhoneFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface PhoneFactorRegistration {
     /** The method of the factor */
@@ -13,7 +13,7 @@ export interface PhoneFactorRegistration {
     codeChallenge: string;
 }
 /**
- * generated from [PasswordFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L13)
+ * generated from [PasswordFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface PasswordFactorRegistration {
     /** The method of the factor */
@@ -22,7 +22,7 @@ export interface PasswordFactorRegistration {
     value: string;
 }
 /**
- * generated from [EmailFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L18)
+ * generated from [EmailFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface EmailFactorRegistration {
     /** The method of the factor */
@@ -33,7 +33,7 @@ export interface EmailFactorRegistration {
     codeChallenge: string;
 }
 /**
- * generated from [AuthenticatorFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L24)
+ * generated from [AuthenticatorFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface AuthenticatorFactorRegistration {
     /** The method of the factor */
@@ -44,7 +44,7 @@ export interface AuthenticatorFactorRegistration {
     label?: string;
 }
 /**
- * generated from [FidoFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L30)
+ * generated from [FidoFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface FidoFactorRegistration {
     /** The method of the factor */
@@ -54,7 +54,7 @@ export interface FidoFactorRegistration {
 }
 /**
  * Link an identity provider to the signed-in account. Answered with the provider's address; the browser goes there and comes back to Security
- * generated from [OidcFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L35)
+ * generated from [OidcFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface OidcFactorRegistration {
     /** The method of the factor */
@@ -63,7 +63,7 @@ export interface OidcFactorRegistration {
     provider: OidcProvider;
 }
 /**
- * generated from [PhoneFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L42)
+ * generated from [PhoneFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface PhoneFactorRegistrationResponse {
     /** The method of the factor */
@@ -78,7 +78,7 @@ export interface PhoneFactorRegistrationResponse {
 /** Rehydrates every wire-encoded scalar in a PhoneFactorRegistrationResponse into its runtime type. Mutates and returns `raw`. */
 export declare function revivePhoneFactorRegistrationResponse(raw: PhoneFactorRegistrationResponse): PhoneFactorRegistrationResponse;
 /**
- * generated from [PasswordFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L49)
+ * generated from [PasswordFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface PasswordFactorRegistrationResponse {
     /** The method of the factor */
@@ -87,7 +87,7 @@ export interface PasswordFactorRegistrationResponse {
     needsReset: boolean;
 }
 /**
- * generated from [EmailFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L54)
+ * generated from [EmailFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface EmailFactorRegistrationResponse {
     /** The method of the factor */
@@ -102,7 +102,7 @@ export interface EmailFactorRegistrationResponse {
 /** Rehydrates every wire-encoded scalar in a EmailFactorRegistrationResponse into its runtime type. Mutates and returns `raw`. */
 export declare function reviveEmailFactorRegistrationResponse(raw: EmailFactorRegistrationResponse): EmailFactorRegistrationResponse;
 /**
- * generated from [AuthenticatorFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L61)
+ * generated from [AuthenticatorFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface AuthenticatorFactorRegistrationResponse {
     /** The method of the factor */
@@ -124,7 +124,7 @@ export interface AuthenticatorFactorRegistrationResponse {
 export declare function reviveAuthenticatorFactorRegistrationResponse(raw: AuthenticatorFactorRegistrationResponse): AuthenticatorFactorRegistrationResponse;
 /**
  * The FIDO factor attestation information
- * generated from [FidoFactorAttestation](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L71)
+ * generated from [FidoFactorAttestation](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface FidoFactorAttestation {
     /** The relying party */
@@ -151,7 +151,7 @@ export interface FidoFactorAttestation {
     attestation: 'direct' | 'indirect' | 'none';
 }
 /**
- * generated from [OidcFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L96)
+ * generated from [OidcFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface OidcFactorRegistrationResponse {
     /** The method of the factor */
@@ -164,7 +164,7 @@ export interface OidcFactorRegistrationResponse {
 /** Rehydrates every wire-encoded scalar in a OidcFactorRegistrationResponse into its runtime type. Mutates and returns `raw`. */
 export declare function reviveOidcFactorRegistrationResponse(raw: OidcFactorRegistrationResponse): OidcFactorRegistrationResponse;
 /**
- * generated from [PhoneFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L104)
+ * generated from [PhoneFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface PhoneFactorRegistrationVerification {
     /** The method of the factor */
@@ -177,7 +177,7 @@ export interface PhoneFactorRegistrationVerification {
     codeVerifier: string;
 }
 /**
- * generated from [EmailFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L111)
+ * generated from [EmailFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface EmailFactorRegistrationVerification {
     /** The method of the factor */
@@ -190,7 +190,7 @@ export interface EmailFactorRegistrationVerification {
     codeVerifier: string;
 }
 /**
- * generated from [AuthenticatorFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L118)
+ * generated from [AuthenticatorFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface AuthenticatorFactorRegistrationVerification {
     /** The method of the factor */
@@ -203,7 +203,7 @@ export interface AuthenticatorFactorRegistrationVerification {
     codeVerifier: string;
 }
 /**
- * generated from [FidoFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L125)
+ * generated from [FidoFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface FidoFactorRegistrationVerification {
     /** The method of the factor */
@@ -215,7 +215,7 @@ export interface FidoFactorRegistrationVerification {
 }
 /**
  * Begin enrolling a TOTP authenticator during a pending login MFA challenge (no session — authorized by the challenge)
- * generated from [MfaEnrollAuthenticatorStart](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L133)
+ * generated from [MfaEnrollAuthenticatorStart](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollAuthenticatorStart {
     /** The pending MFA challenge from the `mfa_required` login response */
@@ -225,7 +225,7 @@ export interface MfaEnrollAuthenticatorStart {
 }
 /**
  * Verify the first TOTP code, persist the authenticator, and complete login
- * generated from [MfaEnrollAuthenticatorVerify](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L138)
+ * generated from [MfaEnrollAuthenticatorVerify](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollAuthenticatorVerify {
     /** The same pending MFA challenge */
@@ -237,12 +237,12 @@ export interface MfaEnrollAuthenticatorVerify {
 }
 /**
  * A second-factor method a user may enroll
- * generated from [EnrollmentMethod](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L144)
+ * generated from [EnrollmentMethod](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export type EnrollmentMethod = 'authenticator' | 'phone' | 'fido';
 /**
  * Begin enrolling an SMS phone factor during a pending login MFA challenge (no session — authorized by the challenge)
- * generated from [MfaEnrollPhoneStart](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L150)
+ * generated from [MfaEnrollPhoneStart](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollPhoneStart {
     /** The pending MFA challenge from the `mfa_required` login response */
@@ -252,7 +252,7 @@ export interface MfaEnrollPhoneStart {
 }
 /**
  * Acknowledges the phone registration and that an OTP was texted
- * generated from [MfaEnrollPhoneStartResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L155)
+ * generated from [MfaEnrollPhoneStartResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollPhoneStartResponse {
     /** The method of the factor */
@@ -268,7 +268,7 @@ export interface MfaEnrollPhoneStartResponse {
 export declare function reviveMfaEnrollPhoneStartResponse(raw: MfaEnrollPhoneStartResponse): MfaEnrollPhoneStartResponse;
 /**
  * Verify the texted OTP, persist the phone factor, and complete login
- * generated from [MfaEnrollPhoneVerify](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L162)
+ * generated from [MfaEnrollPhoneVerify](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollPhoneVerify {
     /** The same pending MFA challenge */
@@ -280,7 +280,7 @@ export interface MfaEnrollPhoneVerify {
 }
 /**
  * Begin enrolling a passkey during a pending login MFA challenge (no session — authorized by the challenge)
- * generated from [MfaEnrollFidoStart](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L168)
+ * generated from [MfaEnrollFidoStart](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollFidoStart {
     /** The pending MFA challenge from the `mfa_required` login response */
@@ -290,7 +290,7 @@ export interface MfaEnrollFidoStart {
 }
 /**
  * Post the new credential back, persist the passkey factor, and complete login
- * generated from [MfaEnrollFidoVerify](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L181)
+ * generated from [MfaEnrollFidoVerify](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollFidoVerify {
     /** The same pending MFA challenge */
@@ -301,11 +301,11 @@ export interface MfaEnrollFidoVerify {
     credential: PublicKeyCredentialWithAttestation;
 }
 /**
- * generated from [AuthenticationFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L40)
+ * generated from [AuthenticationFactorRegistration](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export type AuthenticationFactorRegistration = PhoneFactorRegistration | PasswordFactorRegistration | EmailFactorRegistration | AuthenticatorFactorRegistration | FidoFactorRegistration | OidcFactorRegistration;
 /**
- * generated from [FidoFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L88)
+ * generated from [FidoFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface FidoFactorRegistrationResponse {
     /** The method of the factor */
@@ -323,7 +323,7 @@ export interface FidoFactorRegistrationResponse {
 export declare function reviveFidoFactorRegistrationResponse(raw: FidoFactorRegistrationResponse): FidoFactorRegistrationResponse;
 /**
  * WebAuthn attestation options for `navigator.credentials.create`
- * generated from [MfaEnrollFidoStartResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L173)
+ * generated from [MfaEnrollFidoStartResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface MfaEnrollFidoStartResponse {
     /** The method of the factor */
@@ -340,19 +340,19 @@ export interface MfaEnrollFidoStartResponse {
 /** Rehydrates every wire-encoded scalar in a MfaEnrollFidoStartResponse into its runtime type. Mutates and returns `raw`. */
 export declare function reviveMfaEnrollFidoStartResponse(raw: MfaEnrollFidoStartResponse): MfaEnrollFidoStartResponse;
 /**
- * generated from [AuthenticationFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L131)
+ * generated from [AuthenticationFactorRegistrationVerification](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export type AuthenticationFactorRegistrationVerification = PhoneFactorRegistrationVerification | EmailFactorRegistrationVerification | AuthenticatorFactorRegistrationVerification | FidoFactorRegistrationVerification;
 /**
  * Which second factors this instance permits enrolling. `phone` is present only when an SMS provider is configured (SMS_DELIVERY != noop); `authenticator` and `fido` are always available.
- * generated from [EnrollmentMethods](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L146)
+ * generated from [EnrollmentMethods](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export interface EnrollmentMethods {
     /** The enrollable factor methods, in suggested display order */
     methods: EnrollmentMethod[];
 }
 /**
- * generated from [AuthenticationFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck#L102)
+ * generated from [AuthenticationFactorRegistrationResponse](../../../../../apps/api/data/contracts/authentication/registration.types.ck)
  */
 export type AuthenticationFactorRegistrationResponse = PhoneFactorRegistrationResponse | PasswordFactorRegistrationResponse | EmailFactorRegistrationResponse | AuthenticatorFactorRegistrationResponse | FidoFactorRegistrationResponse | OidcFactorRegistrationResponse;
 /** Rehydrates every wire-encoded scalar in a AuthenticationFactorRegistrationResponse into its runtime type. Mutates and returns `raw`. */

package/dist/catalog/types/catalog.types.d.ts

@@ -4,7 +4,7 @@ import type { PaginationInput } from '../../shared/types/pagination.js';
 /**
  * What the station has been told about a record. `neutral` is the absence of an opinion rather than
  * a middling one, and it is what rating something back to nothing means.
- * generated from [Rating](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L9)
+ * generated from [Rating](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export type Rating = 'liked' | 'neutral' | 'disliked';
 /**
@@ -18,7 +18,7 @@ export type Rating = 'liked' | 'neutral' | 'disliked';
  * The failure columns are here rather than hidden because that is the question this page exists to
  * answer. A row with `attempts` and no `fetchedAt` is a remembered failure, and `lastError` with
  * `nextAttemptAt` is the whole of why a perfectly good-looking record will not play.
- * generated from [TrackBinding](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L73)
+ * generated from [TrackBinding](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackBinding {
     /** `track_sources.id`, which is also what the audio URL carries */
@@ -54,7 +54,7 @@ export declare function reviveTrackBinding(raw: TrackBinding): TrackBinding;
  * argues at length: a measurement of a truncated download is confident and wrong, so every reader in
  * the app filters on `complete` and a page that showed only a date would be reporting a record as
  * measured that nothing will use the measurement of.
- * generated from [TrackAnalysis](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L98)
+ * generated from [TrackAnalysis](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackAnalysis {
     schemaVersion: number;
@@ -72,7 +72,7 @@ export interface TrackAnalysisInput {
 export declare function reviveTrackAnalysis(raw: TrackAnalysis): TrackAnalysis;
 /**
  * One airing of a record, as this page needs it: when, and under which broadcast.
- * generated from [TrackPlay](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L109)
+ * generated from [TrackPlay](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackPlay {
     airedAt: DateTime;
@@ -90,7 +90,7 @@ export declare function reviveTrackPlay(raw: TrackPlay): TrackPlay;
  * A count rather than a bare 204, because the interesting answers are the small ones: clearing the
  * audio of a record with three copies and being told `1` is the station saying two of them were
  * never here — which is a fact about the record and not about the button.
- * generated from [TrackClearResult](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L132)
+ * generated from [TrackClearResult](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackClearResult {
     trackId: string;
@@ -104,7 +104,7 @@ export interface TrackClearResultInput {
 /**
  * Where the singing starts and stops on one record, and which answer that is. Times are milliseconds
  * from the start of the file, the timeline a lyric's timings use. Never the words themselves.
- * generated from [VocalMarkersDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L140)
+ * generated from [VocalMarkersDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface VocalMarkersDetail {
     trackId: string;
@@ -121,7 +121,7 @@ export interface VocalMarkersDetailInput {
 }
 /**
  * An operator's correction: either the record is instrumental, or the singing starts at `onsetMs`.
- * generated from [VocalMarkersInput](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L149)
+ * generated from [VocalMarkersInput](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface VocalMarkersInput {
     /** Nobody sings on this record, whatever its lyrics say */
@@ -134,7 +134,7 @@ export interface VocalMarkersInput {
 /**
  * Narrow a clear to one provider's answer, for the case where one source is wrong and the rest are
  * not. Absent clears every provider's.
- * generated from [ClearEnrichmentQuery](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L157)
+ * generated from [ClearEnrichmentQuery](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface ClearEnrichmentQuery {
     provider?: string;
@@ -151,7 +151,7 @@ export interface ClearEnrichmentQuery {
  * One enum for both lists rather than two, because the alternative is a second near-identical
  * contract whose only content is which two keys it drops. A key the row cannot answer falls back to
  * name order rather than failing: an ordering nobody can serve is a page an operator cannot open.
- * generated from [CatalogSort](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L172)
+ * generated from [CatalogSort](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export type CatalogSort = 'name' | 'albums' | 'tracks' | 'year' | 'rating';
 /**
@@ -162,7 +162,7 @@ export type CatalogSort = 'name' | 'albums' | 'tracks' | 'year' | 'rating';
  *   unmeasured  no trustworthy measurement, so no cue points and no level decided before air
  *   benched     every copy written off, which is the one state that means it CANNOT air
  *   failing     a fetch has failed and is backing off. Not benched yet, and often the state before it
- * generated from [TrackState](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L188)
+ * generated from [TrackState](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export type TrackState = 'cached' | 'uncached' | 'unmeasured' | 'benched' | 'failing';
 /**
@@ -172,7 +172,7 @@ export type TrackState = 'cached' | 'uncached' | 'unmeasured' | 'benched' | 'fai
  * `state` is deliberately absent. It is three independent booleans rather than one column, so there
  * is no ordering of it an operator would agree with: a benched record and an unmeasured one are not
  * more or less than each other.
- * generated from [TrackSort](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L196)
+ * generated from [TrackSort](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export type TrackSort = 'title' | 'artist' | 'album' | 'year' | 'duration' | 'rating';
 /**
@@ -182,7 +182,7 @@ export type TrackSort = 'title' | 'artist' | 'album' | 'year' | 'duration' | 'ra
  * [analysis-queue-ordering](https://github.com/robert-dean/deadair/discussions/5) necessary, and it was a psql query then. `total` is the
  * same number as `meta.total` when nothing is filtered, and is repeated here so the counts can be
  * read as N of M without reaching into the pager.
- * generated from [TrackStateCounts](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L213)
+ * generated from [TrackStateCounts](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackStateCounts {
     total: number;
@@ -203,7 +203,7 @@ export interface TrackStateCounts {
 export interface TrackStateCountsInput {
 }
 /**
- * generated from [EnrichmentExternalId](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L265)
+ * generated from [EnrichmentExternalId](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface EnrichmentExternalId {
     /** e.g. `musicbrainz`, `wikidata` */
@@ -213,7 +213,7 @@ export interface EnrichmentExternalId {
 /**
  * Narrowed to http(s) by the host before it is stored, since the console renders these as
  * something a human clicks.
- * generated from [EnrichmentLink](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L272)
+ * generated from [EnrichmentLink](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface EnrichmentLink {
     label: string;
@@ -223,7 +223,7 @@ export interface EnrichmentLink {
  * One thing the station believes, and the words it read that say so. Extracted by the host out of
  * an article a plugin handed over, rather than said by any plugin: `sourceUrl` is where a person
  * checks it and `sourceQuote` is the span that supports it, and neither is ever absent.
- * generated from [FactClaim](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L365)
+ * generated from [FactClaim](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface FactClaim {
     id: string;
@@ -247,7 +247,7 @@ export declare function reviveFactClaim(raw: FactClaim): FactClaim;
 /**
  * Rate an artist, a record or a song. Ratings are absolute: a dislike anywhere above a track
  * excludes it, and nothing the station programmes may turn that off.
- * generated from [RateInput](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L13)
+ * generated from [RateInput](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface RateInput {
     rating: Rating;
@@ -257,19 +257,19 @@ export interface RateInput {
  * only ingest cares about: `artist_key` is a match key, and a row with `merged_into_id` set is
  * never read out at all.
  *
- * `imageUrl` on both contracts below is one field with two spellings. An absolute URL is the
- * provider's own, still hotlinked because nothing has cached it yet; a relative `art/<uuid>` is
- * the station's copy, to be resolved against the API base the client already configures (the API
- * mounts at the root and does not know the `/api` prefix the edge adds). Prefer the local one by
- * doing nothing: the switch happens server-side as soon as the art cache pass has the bytes.
- * generated from [Artist](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L26)
+ * `imageUrl` on both contracts below is always a path under the API root, never a provider's URL:
+ * `art/<uuid>` for the station's cached copy, or `art/source/<token>` for one it has not cached
+ * yet, which the station fetches on first ask and serves as its own. Resolve either against the
+ * API base the client already configures (the API mounts at the root and does not know the `/api`
+ * prefix the edge adds). The switch from the second to the first happens server-side.
+ * generated from [Artist](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface Artist {
     id: string;
     name: string;
     /** MusicBrainz artist id, absent until enrichment resolves one */
     mbid?: string;
-    /** Absolute upstream URL, or an API-relative path to the local copy */
+    /** An API-relative path: the cached copy, or the station's proxy for an uncached one */
     imageUrl?: string;
     rating?: Rating;
     /** Unmerged albums credited to this artist */
@@ -281,12 +281,12 @@ export interface ArtistInput {
     name: string;
     /** MusicBrainz artist id, absent until enrichment resolves one */
     mbid?: string;
-    /** Absolute upstream URL, or an API-relative path to the local copy */
+    /** An API-relative path: the cached copy, or the station's proxy for an uncached one */
     imageUrl?: string;
     rating?: Rating;
 }
 /**
- * generated from [Album](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L36)
+ * generated from [Album](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface Album {
     id: string;
@@ -297,7 +297,7 @@ export interface Album {
     /** MusicBrainz release-group id, absent until enrichment resolves one */
     mbid?: string;
     year?: number;
-    /** Absolute upstream URL, or an API-relative path to the local copy */
+    /** An API-relative path: the cached copy, or the station's proxy for an uncached one */
     imageUrl?: string;
     rating?: Rating;
     trackCount: number;
@@ -307,12 +307,12 @@ export interface AlbumInput {
     /** MusicBrainz release-group id, absent until enrichment resolves one */
     mbid?: string;
     year?: number;
-    /** Absolute upstream URL, or an API-relative path to the local copy */
+    /** An API-relative path: the cached copy, or the station's proxy for an uncached one */
     imageUrl?: string;
     rating?: Rating;
 }
 /**
- * generated from [Track](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L48)
+ * generated from [Track](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface Track {
     id: string;
@@ -322,7 +322,7 @@ export interface Track {
     /** Absent on a single ingested outside any release: `tracks.album_id` is nullable */
     albumId?: string;
     albumName?: string;
-    /** The record's cover, in the two spellings `Album.imageUrl` has. Nothing hangs art off a recording */
+    /** The record's cover, as `Album.imageUrl` spells it. Nothing hangs art off a recording */
     albumImageUrl?: string;
     /** Display credit as written on the release ("X feat. Y"), not a join key */
     artists: string;
@@ -343,7 +343,7 @@ export interface TrackInput {
 /**
  * Pagination plus a name filter. Every list operation here takes it, so the console's search box
  * narrows server-side rather than filtering one page client-side and lying about the total.
- * generated from [CatalogQuery](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L176)
+ * generated from [CatalogQuery](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface CatalogQuery extends Pagination {
     search?: string;
@@ -358,7 +358,7 @@ export interface CatalogQueryInput extends PaginationInput {
  * `1997`, `1997-06` or `1997-06-24` depending on what is actually known about the release, and the
  * SDK types it the same way. A `datetime` would reject the first two or invent a day and a time
  * for them, which is a precision the source never claimed.
- * generated from [TrackEnrichmentData](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L281)
+ * generated from [TrackEnrichmentData](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackEnrichmentData {
     artist?: string;
@@ -376,18 +376,20 @@ export interface TrackEnrichmentData {
     musicalKey?: string;
     label?: string;
     isrc?: string;
+    /** The provider's picture as the station serves it: `art/<id>` once cached, else the station's proxy `art/source/<token>`. Never the URL the plugin supplied */
     artworkUrl?: string;
     externalIds?: EnrichmentExternalId[];
     links?: EnrichmentLink[];
-    /** What the plugin said that the SDK has no field for. Per provider only: the merged view drops it */
+    /** What the plugin said that the SDK has no field for. Per provider only: the merged view drops it. Never holds a URL: any string with one is dropped when read, along with the key or array element that held it */
     extra?: Record<string, unknown>;
 }
 /**
- * generated from [ArtistEnrichmentData](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L301)
+ * generated from [ArtistEnrichmentData](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface ArtistEnrichmentData {
     name?: string;
     biography?: string;
+    /** The provider's picture as the station serves it: `art/<id>` once cached, else the station's proxy `art/source/<token>`. Never the URL the plugin supplied */
     imageUrl?: string;
     genres?: string[];
     facts?: string[];
@@ -396,7 +398,7 @@ export interface ArtistEnrichmentData {
     extra?: Record<string, unknown>;
 }
 /**
- * generated from [AlbumEnrichmentData](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L312)
+ * generated from [AlbumEnrichmentData](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface AlbumEnrichmentData {
     name?: string;
@@ -408,6 +410,7 @@ export interface AlbumEnrichmentData {
     label?: string;
     genres?: string[];
     facts?: string[];
+    /** The provider's picture as the station serves it: `art/<id>` once cached, else the station's proxy `art/source/<token>`. Never the URL the plugin supplied */
     artworkUrl?: string;
     externalIds?: EnrichmentExternalId[];
     links?: EnrichmentLink[];
@@ -415,7 +418,7 @@ export interface AlbumEnrichmentData {
 }
 /**
  * One page of artists, with the totals the request was counted against
- * generated from [ArtistPage](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L245)
+ * generated from [ArtistPage](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface ArtistPage {
     meta: Pagination;
@@ -427,7 +430,7 @@ export interface ArtistPageInput {
 }
 /**
  * One page of albums
- * generated from [AlbumPage](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L250)
+ * generated from [AlbumPage](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface AlbumPage {
     meta: Pagination;
@@ -443,7 +446,7 @@ export interface AlbumPageInput {
  * The enrichment is deliberately NOT here. It has its own operation already, answering
  * `TrackEnrichmentDetail` with every provider's payload and the station's own sourced claims, and
  * the console draws it through the same panel the list uses. One enrichment shape rather than two.
- * generated from [TrackDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L120)
+ * generated from [TrackDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackDetail extends Track {
     bindings: TrackBinding[];
@@ -470,7 +473,7 @@ export declare function reviveTrackDetail(raw: TrackDetail): TrackDetail;
  * the query that was already running — and everything wider (which providers, how many bytes, why the
  * last fetch failed) is `TrackDetail`'s, one click away. A fourth would be the beginning of putting
  * the detail page in a table cell.
- * generated from [TrackRow](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L232)
+ * generated from [TrackRow](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackRow extends Track {
     /** The bytes are on this machine */
@@ -487,7 +490,7 @@ export interface TrackRowInput extends TrackInput {
  *
  * Its own contract rather than a field on `CatalogQuery`, because that one is shared with the artist
  * and album lists where none of these states means anything.
- * generated from [TrackQuery](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L202)
+ * generated from [TrackQuery](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackQuery extends Omit<CatalogQuery, 'sortBy'> {
     state?: TrackState;
@@ -501,7 +504,7 @@ export interface TrackQueryInput extends Omit<CatalogQueryInput, 'sortBy'> {
  * One provider's stored answer. `found: false` is a recorded miss, which is a fact rather than a
  * failure: the provider was asked, had nothing, and is not asked again until `expiresAt`. A provider
  * that could not be asked at all is `failed` instead, and the two never both hold.
- * generated from [TrackEnrichmentSource](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L329)
+ * generated from [TrackEnrichmentSource](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackEnrichmentSource {
     provider: string;
@@ -522,7 +525,7 @@ export interface TrackEnrichmentSourceInput {
 /** Rehydrates every wire-encoded scalar in a TrackEnrichmentSource into its runtime type. Mutates and returns `raw`. */
 export declare function reviveTrackEnrichmentSource(raw: TrackEnrichmentSource): TrackEnrichmentSource;
 /**
- * generated from [ArtistEnrichmentSource](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L340)
+ * generated from [ArtistEnrichmentSource](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface ArtistEnrichmentSource {
     provider: string;
@@ -541,7 +544,7 @@ export interface ArtistEnrichmentSourceInput {
 /** Rehydrates every wire-encoded scalar in a ArtistEnrichmentSource into its runtime type. Mutates and returns `raw`. */
 export declare function reviveArtistEnrichmentSource(raw: ArtistEnrichmentSource): ArtistEnrichmentSource;
 /**
- * generated from [AlbumEnrichmentSource](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L351)
+ * generated from [AlbumEnrichmentSource](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface AlbumEnrichmentSource {
     provider: string;
@@ -561,7 +564,7 @@ export interface AlbumEnrichmentSourceInput {
 export declare function reviveAlbumEnrichmentSource(raw: AlbumEnrichmentSource): AlbumEnrichmentSource;
 /**
  * One page of tracks, with what the station has of each and of the whole set
- * generated from [TrackPage](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L255)
+ * generated from [TrackPage](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackPage {
     meta: Pagination;
@@ -581,7 +584,7 @@ export interface TrackPageInput {
  * `claims` sits beside them rather than inside `merged`, because a claim is the host's own and not
  * any provider's. The articles they were read out of are deliberately NOT here: raw source prose is
  * stored and never sent.
- * generated from [TrackEnrichmentDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L385)
+ * generated from [TrackEnrichmentDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface TrackEnrichmentDetail {
     trackId: string;
@@ -597,7 +600,7 @@ export interface TrackEnrichmentDetailInput {
 /** Rehydrates every wire-encoded scalar in a TrackEnrichmentDetail into its runtime type. Mutates and returns `raw`. */
 export declare function reviveTrackEnrichmentDetail(raw: TrackEnrichmentDetail): TrackEnrichmentDetail;
 /**
- * generated from [ArtistEnrichmentDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L392)
+ * generated from [ArtistEnrichmentDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface ArtistEnrichmentDetail {
     artistId: string;
@@ -613,7 +616,7 @@ export interface ArtistEnrichmentDetailInput {
 /** Rehydrates every wire-encoded scalar in a ArtistEnrichmentDetail into its runtime type. Mutates and returns `raw`. */
 export declare function reviveArtistEnrichmentDetail(raw: ArtistEnrichmentDetail): ArtistEnrichmentDetail;
 /**
- * generated from [AlbumEnrichmentDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck#L399)
+ * generated from [AlbumEnrichmentDetail](../../../../../apps/api/data/contracts/catalog/catalog.types.ck)
  */
 export interface AlbumEnrichmentDetail {
     albumId: string;