@deadair/sdk 0.50.1 → 0.50.2

package/dist/playout/types/playout.types.d.ts

@@ -1,6 +1,6 @@
 /**
  * The plugin playlist to load into the running order
- * generated from [PlayoutPlaylistInput](../../../../../apps/api/data/contracts/playout/playout.types.ck#L7)
+ * generated from [PlayoutPlaylistInput](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutPlaylistInput {
     pluginId: string;
@@ -12,7 +12,7 @@ export interface PlayoutPlaylistInput {
 }
 /**
  * A playlist the station owns, to load into the running order
- * generated from [PlayoutStationPlaylistInput](../../../../../apps/api/data/contracts/playout/playout.types.ck#L14)
+ * generated from [PlayoutStationPlaylistInput](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutStationPlaylistInput {
     stationPlaylistId: string;
@@ -23,14 +23,14 @@ export interface PlayoutStationPlaylistInput {
 }
 /**
  * An album the library holds, to play whole
- * generated from [PlayoutAlbumInput](../../../../../apps/api/data/contracts/playout/playout.types.ck#L20)
+ * generated from [PlayoutAlbumInput](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutAlbumInput {
     albumId: string;
 }
 /**
  * The published chart to build the running order from
- * generated from [PlayoutChartInput](../../../../../apps/api/data/contracts/playout/playout.types.ck#L24)
+ * generated from [PlayoutChartInput](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutChartInput {
     /** As `pluginId:chartId`, which is how `GET /charts` lists them */
@@ -44,7 +44,7 @@ export interface PlayoutChartInput {
 }
 /**
  * One item in the running order, as the console sees it
- * generated from [PlayoutItem](../../../../../apps/api/data/contracts/playout/playout.types.ck#L31)
+ * generated from [PlayoutItem](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutItem {
     /** deadair's own id for this item, not the provider's: a playlist may hold the same track twice */
@@ -57,7 +57,7 @@ export interface PlayoutItem {
     /** Integer milliseconds. Deliberately not the `duration` scalar, which is a Luxon `Duration` over an ISO-8601 string */
     durationMs?: number;
     album?: string;
-    /** The locally cached cover where there is one, the provider's URL otherwise */
+    /** The station's own cover, as a path under the API root. Never a provider's URL */
     artworkUrl?: string;
     /** First release year, when the catalog knows one */
     year?: number;
@@ -70,7 +70,7 @@ export interface PlayoutItem {
  * re-rendered — so a reseeded secret leaves a process holding credentials that match nothing,
  * and the symptom names something else entirely (every listener refused, or no mount at all).
  * The app cannot restart a sibling container and should not be able to, so it reports.
- * generated from [StreamConfigWarning](../../../../../apps/api/data/contracts/playout/playout.types.ck#L55)
+ * generated from [StreamConfigWarning](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface StreamConfigWarning {
     /** Which one is behind */
@@ -83,19 +83,19 @@ export interface StreamConfigWarning {
 /**
  * Which gate is keeping the station quiet, or `airing` when none of them is. Ordered by cause: a
  * stalled transport loop makes every reading under it stale, so it is ruled out first
- * generated from [SilenceCause](../../../../../apps/api/data/contracts/playout/playout.types.ck#L63)
+ * generated from [SilenceCause](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export type SilenceCause = 'airing' | 'transportStalled' | 'controlDenied' | 'streamUnreachable' | 'configNotAdopted' | 'stoodDown' | 'noProgramme' | 'noAudience' | 'warmingUp' | 'waitingOnAudio' | 'notDriving' | 'starved';
 /**
  * How one gate is doing. `waiting` is its own state rather than a mild fault, because a station
  * idling for want of a listener and a station that cannot reach its stream are both silent and only
  * one of them is something to go and fix
- * generated from [SilenceState](../../../../../apps/api/data/contracts/playout/playout.types.ck#L81)
+ * generated from [SilenceState](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export type SilenceState = 'ok' | 'waiting' | 'fault';
 /**
  * One mount the station is publishing right now
- * generated from [PlayoutMount](../../../../../apps/api/data/contracts/playout/playout.types.ck#L98)
+ * generated from [PlayoutMount](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutMount {
     format: 'mp3' | 'opus' | 'aac' | 'flac';
@@ -106,7 +106,7 @@ export interface PlayoutMount {
 }
 /**
  * Which rundown item Liquidsoap has just started playing
- * generated from [PlayoutAiredQuery](../../../../../apps/api/data/contracts/playout/playout.types.ck#L118)
+ * generated from [PlayoutAiredQuery](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutAiredQuery {
     /** The id the app put on the pushed uri's `annotate:` metadata */
@@ -114,7 +114,7 @@ export interface PlayoutAiredQuery {
 }
 /**
  * Which way the running order went, and how long it had been that way
- * generated from [PlayoutStarveQuery](../../../../../apps/api/data/contracts/playout/playout.types.ck#L122)
+ * generated from [PlayoutStarveQuery](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutStarveQuery {
     /** `starved`: the queue stopped producing while deadair was driving, so the mount fell through to the local bed. `recovered`: it is producing again */
@@ -124,7 +124,7 @@ export interface PlayoutStarveQuery {
 }
 /**
  * What the PLAYER says is airing, which is not the same as what was last handed to it
- * generated from [PlayoutNowPlaying](../../../../../apps/api/data/contracts/playout/playout.types.ck#L44)
+ * generated from [PlayoutNowPlaying](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutNowPlaying {
     item: PlayoutItem;
@@ -135,7 +135,7 @@ export interface PlayoutNowPlaying {
 }
 /**
  * One gate's answer about itself
- * generated from [SilenceCheck](../../../../../apps/api/data/contracts/playout/playout.types.ck#L83)
+ * generated from [SilenceCheck](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface SilenceCheck {
     /** Never `airing`, which is the absence of a blocking gate rather than a gate */
@@ -148,7 +148,7 @@ export interface SilenceCheck {
 }
 /**
  * Why the station cannot be heard, as one answer
- * generated from [StationSilence](../../../../../apps/api/data/contracts/playout/playout.types.ck#L90)
+ * generated from [StationSilence](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface StationSilence {
     /** Whether the station believes its programme is reaching the mount. NOT whether anybody is hearing it: a station can be audible with no listeners in `always` mode, and can have listeners while airing the local bed */
@@ -161,7 +161,7 @@ export interface StationSilence {
 }
 /**
  * The station's transport, as one reading
- * generated from [PlayoutStatus](../../../../../apps/api/data/contracts/playout/playout.types.ck#L104)
+ * generated from [PlayoutStatus](../../../../../apps/api/data/contracts/playout/playout.types.ck)
  */
 export interface PlayoutStatus {
     /** Whether Liquidsoap's control API is answering at all. False means nothing can air, whatever the running order holds */

package/dist/playout/types/playout.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playout.types.d.ts","sourceRoot":"","sources":["../../../src/playout/types/playout.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playout.types.d.ts","sourceRoot":"","sources":["../../../src/playout/types/playout.types.ts"],"names":[],"mappings":"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"}

package/dist/plugins/plugins.client.d.ts

@@ -25,7 +25,7 @@ export declare class PluginsClient {
     rescanPlugins(): Promise<PluginSummary[]>;
     /**
      * @name Import plugin
-     * @description Takes a plugin in from the browser as the tarball npm pack writes and puts it in the plugins directory. It lands disabled, and a newer version of an installed plugin replaces the older one
+     * @description Takes a plugin in from the browser as the tarball npm pack writes and puts it in the plugins directory. Importing runs the plugin's code: the station loads it to read its manifest, inside the server and with the server's privileges. It lands disabled, which only means the station does not use it until it is enabled. A newer version of an installed plugin replaces the older one
      */
     importPlugin(body: FormData): Promise<PluginImportResult>;
     /**

package/dist/plugins/types/plugins.types.d.ts

@@ -1,24 +1,24 @@
 import { DateTime } from 'luxon';
 /**
  * Lifecycle state of a plugin the host knows about
- * generated from [PluginStatus](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L7)
+ * generated from [PluginStatus](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type PluginStatus = 'discovered' | 'disabled' | 'misconfigured' | 'active' | 'failed';
 /**
  * Where the station found a plugin: shipped inside the image, or installed by the operator into the plugins
  * directory on the data volume. Says nothing about trust; both kinds run inside the station with its privileges
- * generated from [PluginOrigin](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L11)
+ * generated from [PluginOrigin](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type PluginOrigin = 'bundled' | 'installed';
 /**
- * generated from [ConfigFieldType](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L13)
+ * generated from [ConfigFieldType](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type ConfigFieldType = 'string' | 'text' | 'url' | 'secret' | 'number' | 'boolean' | 'select' | 'multiselect' | 'list' | 'note';
 /**
  * What a `number` field's value is measured in. The stored value is always in this unit; only the
  * control the operator touches changes, so a byte count stays a byte count everywhere it is read and
  * a `fraction` stays the share between 0 and 1 that the code multiplying by it wants
- * generated from [ConfigFieldUnit](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L18)
+ * generated from [ConfigFieldUnit](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type ConfigFieldUnit = 'bytes' | 'fraction';
 /**
@@ -26,12 +26,12 @@ export type ConfigFieldUnit = 'bytes' | 'fraction';
  * per field rather than inferred, because a slider is right for a value you feel for and wrong for
  * one you have to hit exactly, and `tags` is right for a comma-separated line that is really a SET
  * and wrong for one that is prose. Nothing about the stored value changes either way
- * generated from [ConfigFieldControl](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L24)
+ * generated from [ConfigFieldControl](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type ConfigFieldControl = 'slider' | 'tags';
 /**
  * One choice of a `select` config field
- * generated from [ConfigFieldOption](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L27)
+ * generated from [ConfigFieldOption](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface ConfigFieldOption {
     value: string;
@@ -41,12 +41,12 @@ export interface ConfigFieldOption {
  * Where a field's or a column's choices come from when only the console can enumerate them: the
  * station's own tables, the platform's zone list, the enabled plugins that can do one of five jobs,
  * or the models the selected model plugin currently offers. Resolved by the console either way
- * generated from [ConfigFieldOptionSource](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L35)
+ * generated from [ConfigFieldOptionSource](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type ConfigFieldOptionSource = 'station.newsCategories' | 'station.newsFeeds' | 'station.podcastShows' | 'station.narrationSeries' | 'intl.timeZones' | 'plugins.speech' | 'plugins.llm' | 'plugins.mixer' | 'plugins.analysis' | 'plugins.similarity' | 'llm.models';
 /**
  * A row a `list` field offers to start from instead of an empty one. Adding a row from it fills the cells it names, by column key, and nothing records which preset a row came from
- * generated from [ConfigFieldPreset](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L52)
+ * generated from [ConfigFieldPreset](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface ConfigFieldPreset {
     /** What the operator picks it by */
@@ -58,25 +58,25 @@ export interface ConfigFieldPreset {
  * Whether a capability has ONE answer or is asked of everything in turn. `one` stores a plugin id
  * and `ordered` stores a list of them; see `plugins/plugin.providers.ts`, which both this and the
  * station read the pairing from
- * generated from [ProviderMode](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L101)
+ * generated from [ProviderMode](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type ProviderMode = 'one' | 'ordered';
 /**
  * A plugin handed over from the browser. The generated client types the body as `FormData`, so
  * nothing checks this shape. It says what to send
- * generated from [PluginImport](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L134)
+ * generated from [PluginImport](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginImport {
     /** The gzip tarball npm pack writes: every entry under package/, holding package.json and the built code, at most 64 MB */
     file: Blob;
 }
 /**
- * generated from [PluginLogLevel](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L145)
+ * generated from [PluginLogLevel](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type PluginLogLevel = 'debug' | 'info' | 'warn' | 'error';
 /**
  * A submitted settings form. Secret values arrive in here and are never echoed back
- * generated from [PluginConfigInput](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L177)
+ * generated from [PluginConfigInput](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginConfigInput {
     config: Record<string, unknown>;
@@ -84,12 +84,12 @@ export interface PluginConfigInput {
 /**
  * What a plugin may do with a capability it asked for. Denied is the default and needs no row: a
  * capability is refused until somebody allows it, so "never answered" and "refused" are one state
- * generated from [GrantDecision](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L183)
+ * generated from [GrantDecision](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export type GrantDecision = 'allowed' | 'denied';
 /**
  * Outcome of the plugin's own `testConnection()`
- * generated from [PluginTestResult](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L207)
+ * generated from [PluginTestResult](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginTestResult {
     ok: boolean;
@@ -98,14 +98,14 @@ export interface PluginTestResult {
 /**
  * Where the console should send the browser to obtain the operator's consent. Reported rather than
  * redirected to: the route is behind the Bearer floor, so a browser cannot follow a redirect from it
- * generated from [PluginOAuthStart](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L225)
+ * generated from [PluginOAuthStart](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginOAuthStart {
     url: string;
 }
 /**
  * Outcome of an OAuth callback
- * generated from [PluginOAuthResult](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L230)
+ * generated from [PluginOAuthResult](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginOAuthResult {
     pluginId: string;
@@ -113,7 +113,7 @@ export interface PluginOAuthResult {
     message?: string;
 }
 /**
- * generated from [PluginOAuthCallbackQuery](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L236)
+ * generated from [PluginOAuthCallbackQuery](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginOAuthCallbackQuery {
     code?: string;
@@ -130,7 +130,7 @@ export interface PluginOAuthCallbackQuery {
 }
 /**
  * One plugin's standing for one capability, as the Providers section draws it
- * generated from [ProviderCandidate](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L104)
+ * generated from [ProviderCandidate](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface ProviderCandidate {
     pluginId: string;
@@ -151,7 +151,7 @@ export interface ProviderCandidate {
  * Live choices for a plugin's config fields, keyed by field key, out of the plugin's own
  * `suggestConfigOptions()`. What `ConfigFieldDescriptor.options` cannot be: fixed when the manifest
  * was written, where these are whatever the operator's own server currently says
- * generated from [PluginFieldSuggestions](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L215)
+ * generated from [PluginFieldSuggestions](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginFieldSuggestions {
     /** Keys the plugin had nothing to say about are simply absent, rather than present and empty */
@@ -165,7 +165,7 @@ export interface PluginFieldSuggestions {
 /**
  * One column of a `list` field. Every ordinary cell is stored as a string in the row, so this describes the
  * control rather than the value; a `secret` cell is encrypted on its own and is never in the row at all
- * generated from [ConfigFieldColumn](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L39)
+ * generated from [ConfigFieldColumn](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface ConfigFieldColumn {
     key: string;
@@ -181,7 +181,7 @@ export interface ConfigFieldColumn {
     dependsOnValues?: string[];
 }
 /**
- * generated from [PluginLogEntry](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L147)
+ * generated from [PluginLogEntry](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginLogEntry {
     ts: string;
@@ -190,14 +190,14 @@ export interface PluginLogEntry {
     text: string;
 }
 /**
- * generated from [PluginLogQuery](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L159)
+ * generated from [PluginLogQuery](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginLogQuery {
     limit?: number;
     level?: PluginLogLevel;
 }
 /**
- * generated from [PluginLogLevelInput](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L164)
+ * generated from [PluginLogLevelInput](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginLogLevelInput {
     level: PluginLogLevel;
@@ -205,7 +205,7 @@ export interface PluginLogLevelInput {
 /**
  * One capability a plugin asked for, with the station's answer. The ask is the plugin's manifest and
  * the answer is a row, so a plugin that stops asking stops appearing here whatever was stored
- * generated from [PluginGrant](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L187)
+ * generated from [PluginGrant](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginGrant {
     pluginId: string;
@@ -221,7 +221,7 @@ export interface PluginGrant {
     decision: GrantDecision;
 }
 /**
- * generated from [PluginGrantInput](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L201)
+ * generated from [PluginGrantInput](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginGrantInput {
     capability: string;
@@ -229,7 +229,7 @@ export interface PluginGrantInput {
 }
 /**
  * One capability, who can answer it, and what the operator has said about the order
- * generated from [ProviderCapabilityState](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L116)
+ * generated from [ProviderCapabilityState](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface ProviderCapabilityState {
     /** The manifest capability, which is also the console's anchor for this block */
@@ -248,7 +248,7 @@ export interface ProviderCapabilityState {
 }
 /**
  * Mirrors the plugin SDK's `ConfigField`: enough for a console to render the settings form with no per-plugin code
- * generated from [ConfigFieldDescriptor](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L58)
+ * generated from [ConfigFieldDescriptor](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface ConfigFieldDescriptor {
     key: string;
@@ -281,7 +281,7 @@ export interface ConfigFieldDescriptor {
     rangeWith?: string;
 }
 /**
- * generated from [PluginLogPage](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L153)
+ * generated from [PluginLogPage](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginLogPage {
     pluginId: string;
@@ -290,7 +290,7 @@ export interface PluginLogPage {
     entries: PluginLogEntry[];
 }
 /**
- * generated from [PluginGrantList](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L197)
+ * generated from [PluginGrantList](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginGrantList {
     /** Every capability every installed plugin is asking for, refused ones included */
@@ -299,14 +299,14 @@ export interface PluginGrantList {
 /**
  * Every capability an operator chooses between. Capabilities that fan out and merge without
  * ranking are deliberately absent: order changes nothing about a union
- * generated from [ProviderCatalogue](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L128)
+ * generated from [ProviderCatalogue](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface ProviderCatalogue {
     capabilities: ProviderCapabilityState[];
 }
 /**
  * A plugin as the settings list sees it. Carries no configured VALUES, only which secrets are set
- * generated from [PluginSummary](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L80)
+ * generated from [PluginSummary](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginSummary {
     id: string;
@@ -352,7 +352,7 @@ export interface PluginSummaryInput {
 export declare function revivePluginSummary(raw: PluginSummary): PluginSummary;
 /**
  * What an import did
- * generated from [PluginImportResult](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L139)
+ * generated from [PluginImportResult](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginImportResult {
     /** The id the imported plugin claimed */
@@ -374,7 +374,7 @@ export interface PluginImportResultInput {
 export declare function revivePluginImportResult(raw: PluginImportResult): PluginImportResult;
 /**
  * A summary plus the stored NON-SECRET configuration
- * generated from [PluginDetail](../../../../../apps/api/data/contracts/plugins/plugins.types.ck#L169)
+ * generated from [PluginDetail](../../../../../apps/api/data/contracts/plugins/plugins.types.ck)
  */
 export interface PluginDetail extends PluginSummary {
     /** Absolute path of the plugin's directory on the station */

package/dist/podcasts/types/podcasts.types.d.ts

@@ -1,6 +1,6 @@
 /**
  * A programme the station carries, as one installed plugin describes it
- * generated from [StationShow](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L7)
+ * generated from [StationShow](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationShow {
     /** Unique across the station: the plugin's own id for the show, qualified with the plugin that offered it */
@@ -22,7 +22,7 @@ export interface StationShow {
 }
 /**
  * One episode of a programme the station carries, and what the station has done with it
- * generated from [StationEpisode](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L25)
+ * generated from [StationEpisode](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationEpisode {
     /** The station's own id for this episode */
@@ -58,7 +58,7 @@ export interface StationEpisode {
 }
 /**
  * A show a podcast plugin's directory knows about, which the station may or may not carry
- * generated from [StationDirectoryEntry](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L45)
+ * generated from [StationDirectoryEntry](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationDirectoryEntry {
     /** The directory's own id for the show. A key in a list, and nothing more */
@@ -76,7 +76,7 @@ export interface StationDirectoryEntry {
     explicit?: boolean;
 }
 /**
- * generated from [StationDirectoryQuery](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L58)
+ * generated from [StationDirectoryQuery](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationDirectoryQuery {
     /** Words to look a show up by: its name, its publisher, its subject */
@@ -84,7 +84,7 @@ export interface StationDirectoryQuery {
     limit?: number;
 }
 /**
- * generated from [StationEpisodeQuery](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L67)
+ * generated from [StationEpisodeQuery](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationEpisodeQuery {
     /** One show's episodes, or absent for every show's, newest first */
@@ -92,20 +92,20 @@ export interface StationEpisodeQuery {
     limit?: number;
 }
 /**
- * generated from [StationShowList](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L21)
+ * generated from [StationShowList](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationShowList {
     shows: StationShow[];
 }
 /**
- * generated from [StationEpisodePage](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L72)
+ * generated from [StationEpisodePage](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationEpisodePage {
     /** Newest first. Empty when the station knows of none, which is not an error */
     episodes: StationEpisode[];
 }
 /**
- * generated from [StationDirectoryPage](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck#L63)
+ * generated from [StationDirectoryPage](../../../../../apps/api/data/contracts/podcasts/podcasts.types.ck)
  */
 export interface StationDirectoryPage {
     /** Empty when nothing matched or no directory could be asked, which is not an error */

package/dist/productions/types/productions.types.d.ts

@@ -3,7 +3,7 @@ import { DateTime } from 'luxon';
  * One person in a production: the presenter, or somebody cast to phone in. A snapshot rather than a
  * reference, because the persona it names may be edited or deleted while the programme is still being
  * made and what the turns were written as has to be what an operator reads back
- * generated from [ProductionCastMember](../../../../../apps/api/data/contracts/productions/productions.types.ck#L10)
+ * generated from [ProductionCastMember](../../../../../apps/api/data/contracts/productions/productions.types.ck)
  */
 export interface ProductionCastMember {
     role: 'host' | 'caller' | 'guest' | 'cohost';
@@ -14,7 +14,7 @@ export interface ProductionCastMember {
 }
 /**
  * What an operator asks for. Everything else about a production is decided by the passes that make it
- * generated from [ProductionRequest](../../../../../apps/api/data/contracts/productions/productions.types.ck#L39)
+ * generated from [ProductionRequest](../../../../../apps/api/data/contracts/productions/productions.types.ck)
  */
 export interface ProductionRequest {
     kind?: string;
@@ -31,7 +31,7 @@ export interface ProductionRequest {
 export declare function reviveProductionRequest(raw: ProductionRequest): ProductionRequest;
 /**
  * Something the station makes rather than something it says: several beats of speech, written in several passes, that airs as one block
- * generated from [Production](../../../../../apps/api/data/contracts/productions/productions.types.ck#L17)
+ * generated from [Production](../../../../../apps/api/data/contracts/productions/productions.types.ck)
  */
 export interface Production {
     id: string;
@@ -77,7 +77,7 @@ export interface ProductionInput {
 /** Rehydrates every wire-encoded scalar in a Production into its runtime type. Mutates and returns `raw`. */
 export declare function reviveProduction(raw: Production): Production;
 /**
- * generated from [ProductionList](../../../../../apps/api/data/contracts/productions/productions.types.ck#L34)
+ * generated from [ProductionList](../../../../../apps/api/data/contracts/productions/productions.types.ck)
  */
 export interface ProductionList {
     productions: Production[];