@deadair/sdk 0.31.3 → 0.32.0

package/dist/playlists/playlists.client.d.ts

@@ -1,5 +1,6 @@
 import type { SdkFetch } from '../sdk-options.js';
 import type { CatalogPlaylistPage, CatalogPlaylistTracks } from './types/playlists.types.js';
+import type { PlaylistFile, PlaylistImportInput, PlaylistImportPlan, PlaylistImportResult, StationPlaylist, StationPlaylistDetail, StationPlaylistList, StationPlaylistUpdate } from './types/station.playlists.types.js';
 export declare class PlaylistsClient {
     private fetch;
     constructor(fetch: SdkFetch);
@@ -33,5 +34,50 @@ export declare class PlaylistsClient {
      * @description Reads one playlist again, in the background. New records reach the library; a record taken out of it stays until the next full read judges it
      */
     refreshPlaylist(pluginId: string, playlistId: string): Promise<void>;
+    /**
+     * @name List station playlists
+     * @description Every playlist the station owns, newest first
+     */
+    listStationPlaylists(): Promise<StationPlaylistList>;
+    /**
+     * @name Get station playlist
+     * @description One station playlist with its records in order, placeholders included
+     */
+    getStationPlaylist(id: string): Promise<StationPlaylistDetail>;
+    /**
+     * @name Update station playlist
+     * @description Renames a station playlist, or rewrites what it is for
+     */
+    updateStationPlaylist(id: string, body: StationPlaylistUpdate): Promise<StationPlaylist>;
+    /**
+     * @name Delete station playlist
+     * @description Deletes a station playlist. The records it named stay in the library
+     */
+    deleteStationPlaylist(id: string): Promise<void>;
+    /**
+     * @name Fill station playlist
+     * @description Looks up the records this playlist names and the library does not hold, in the background, and adds the ones a provider has. The activity feed says how it went
+     */
+    fillStationPlaylist(id: string): Promise<void>;
+    /**
+     * @name Export station playlist
+     * @description One station playlist as a file another station can import
+     */
+    exportStationPlaylist(id: string): Promise<{
+        data: PlaylistFile;
+        headers: {
+            contentDisposition?: string;
+        };
+    }>;
+    /**
+     * @name Preview playlist import
+     * @description Reads a source and reports which of its records the library holds and which it would have to find. Writes nothing
+     */
+    previewPlaylistImport(body: PlaylistImportInput): Promise<PlaylistImportPlan>;
+    /**
+     * @name Import playlist
+     * @description Makes a new station playlist from a source and answers with what it did
+     */
+    importPlaylist(body: PlaylistImportInput): Promise<PlaylistImportResult>;
 }
 //# sourceMappingURL=playlists.client.d.ts.map

package/dist/playlists/playlists.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playlists.client.d.ts","sourceRoot":"","sources":["../../src/playlists/playlists.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAE7F,qBAAa,eAAe;IACZ,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAK7D;;;OAGG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAK7F;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7E"}
+{"version":3,"file":"playlists.client.d.ts","sourceRoot":"","sources":["../../src/playlists/playlists.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EACR,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACxB,MAAM,oCAAoC,CAAC;AAQ5C,qBAAa,eAAe;IACZ,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAK7D;;;OAGG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAK7F;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAK1D;;;OAGG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAKpE;;;OAGG;IACG,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAS9F;;;OAGG;IACG,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;OAGG;IACG,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;;OAGG;IACG,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE;YAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAMlH;;;OAGG;IACG,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IASnF;;;OAGG;IACG,cAAc,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAQjF"}

package/dist/playlists/types/index.d.ts

@@ -1,2 +1,3 @@
 export * from './playlists.types.js';
+export * from './station.playlists.types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/playlists/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/playlists/types/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/playlists/types/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC"}

package/dist/playlists/types/station.playlists.types.d.ts

@@ -0,0 +1,185 @@
+import { DateTime } from 'luxon';
+/**
+ * A playlist the station owns: records it holds in its own library, in an order somebody chose, cloned
+ * from somewhere else and free to differ from it afterwards
+ * generated from [StationPlaylist](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L9)
+ */
+export interface StationPlaylist {
+    id: string;
+    name: string;
+    /** What this playlist is for, in the operator's own words. Empty when nobody said */
+    prompt: string;
+    /** The plugin this was cloned from, for a badge and nothing else. Absent for one read from a file or made here */
+    originPluginId?: string;
+    /** Every row, placeholders included */
+    trackCount: number;
+    /** The rows that name a record in the library, which are the ones that can air */
+    resolvedCount: number;
+    createdAt: DateTime;
+    updatedAt: DateTime;
+}
+export interface StationPlaylistInput {
+    name: string;
+    /** What this playlist is for, in the operator's own words. Empty when nobody said */
+    prompt: string;
+}
+/** Rehydrates every wire-encoded scalar in a StationPlaylist into its runtime type. Mutates and returns `raw`. */
+export declare function reviveStationPlaylist(raw: StationPlaylist): StationPlaylist;
+/**
+ * One row of a station playlist: a record in the library, or a placeholder for one it does not hold yet
+ * generated from [StationPlaylistTrack](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L25)
+ */
+export interface StationPlaylistTrack {
+    /** The row's own id, not the record's */
+    id: string;
+    position: number;
+    title: string;
+    /** Ordered, primary artist first */
+    artists: string[];
+    album?: string;
+    durationMs?: number;
+    /** The library record this row plays. Absent on a placeholder */
+    trackId?: string;
+    artistId?: string;
+    albumId?: string;
+    /** On a placeholder, the plugin whose copy it was cloned from. Absent on one read from a file, which names a record and no copy of it */
+    originPluginId?: string;
+}
+/**
+ * What may change about a station playlist after it exists. Absent fields are left alone
+ * generated from [StationPlaylistUpdate](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L43)
+ */
+export interface StationPlaylistUpdate {
+    name?: string;
+    prompt?: string;
+}
+/**
+ * Where a record in a file came from, when it came from a provider's copy. Carried so a record the
+ * receiving library does not hold can still be matched by that copy later
+ * generated from [PlaylistFileOrigin](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L50)
+ */
+export interface PlaylistFileOrigin {
+    pluginId: string;
+    externalId: string;
+}
+/**
+ * A playlist one of the station's music sources holds, named the way the playlists listing names it
+ * generated from [PlaylistProviderRef](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L77)
+ */
+export interface PlaylistProviderRef {
+    pluginId: string;
+    playlistId: string;
+}
+/**
+ * What importing one record would do here
+ * generated from [PlaylistImportEntry](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L94)
+ */
+export interface PlaylistImportEntry {
+    position: number;
+    title: string;
+    artists: string[];
+    /** `matched`: the library holds it. `toAdd`: it names a provider's copy, which the station can add to its library. `toLookUp`: it names only a record, which the station has to search its providers for */
+    outcome: 'matched' | 'toAdd' | 'toLookUp';
+    /** The library record a `matched` row plays */
+    trackId?: string;
+}
+/**
+ * generated from [StationPlaylistList](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L20)
+ */
+export interface StationPlaylistList {
+    playlists: StationPlaylist[];
+}
+export interface StationPlaylistListInput {
+    playlists: StationPlaylistInput[];
+}
+/** Rehydrates every wire-encoded scalar in a StationPlaylistList into its runtime type. Mutates and returns `raw`. */
+export declare function reviveStationPlaylistList(raw: StationPlaylistList): StationPlaylistList;
+/**
+ * generated from [StationPlaylistDetail](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L38)
+ */
+export interface StationPlaylistDetail extends StationPlaylist {
+    tracks: StationPlaylistTrack[];
+}
+export interface StationPlaylistDetailInput extends StationPlaylistInput {
+    tracks: StationPlaylistTrack[];
+}
+/** Rehydrates every wire-encoded scalar in a StationPlaylistDetail into its runtime type. Mutates and returns `raw`. */
+export declare function reviveStationPlaylistDetail(raw: StationPlaylistDetail): StationPlaylistDetail;
+/**
+ * One record as a playlist file names it. By its words and its ISRC, never by an id of this station's:
+ * ids are minted afresh by every library, so a file keyed by them would restore onto nothing
+ * generated from [PlaylistFileTrack](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L57)
+ */
+export interface PlaylistFileTrack {
+    title: string;
+    /** Ordered, primary artist first */
+    artists: string[];
+    album?: string;
+    durationMs?: number;
+    isrc?: string;
+    origin?: PlaylistFileOrigin;
+}
+/**
+ * What an import WOULD do, written nowhere
+ * generated from [PlaylistImportPlan](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L107)
+ */
+export interface PlaylistImportPlan {
+    name: string;
+    matched: number;
+    toAdd: number;
+    toLookUp: number;
+    /** Lines of the source that named no record the station could read */
+    skipped: number;
+    entries: PlaylistImportEntry[];
+    /** Anything about the source as a whole an operator should know before importing it */
+    notices: string[];
+}
+/**
+ * A playlist as a file: everything somebody would need to rebuild it on another station
+ * generated from [PlaylistFile](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L67)
+ */
+export interface PlaylistFile {
+    /** What shape this is, so a file from a later build says so rather than being read wrongly */
+    format: string;
+    /** When it was exported, ISO-8601 */
+    takenAt: string;
+    /** The station it was taken from. Provenance only */
+    station?: string;
+    name: string;
+    prompt?: string;
+    tracks: PlaylistFileTrack[];
+}
+/**
+ * generated from [PlaylistImportResult](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L117)
+ */
+export interface PlaylistImportResult {
+    plan: PlaylistImportPlan;
+    playlist: StationPlaylist;
+}
+export interface PlaylistImportResultInput {
+    plan: PlaylistImportPlan;
+    playlist: StationPlaylistInput;
+}
+/** Rehydrates every wire-encoded scalar in a PlaylistImportResult into its runtime type. Mutates and returns `raw`. */
+export declare function revivePlaylistImportResult(raw: PlaylistImportResult): PlaylistImportResult;
+/**
+ * Something to import a playlist from. Exactly one source
+ * generated from [PlaylistImportInput](../../../../../apps/api/data/contracts/playlists/station.playlists.types.ck#L83)
+ */
+export interface PlaylistImportInput {
+    /** A playlist exported from a deadair station */
+    file?: PlaylistFile;
+    /** A playlist another program wrote, as its text: an M3U, a CSV with a header row, or one `Artist - Title` per line */
+    text?: string;
+    /** Which of those `text` is. Absent works it out from the text */
+    format?: 'm3u' | 'csv' | 'text';
+    /** The name of the file `text` came from, which names the playlist when the text does not */
+    fileName?: string;
+    /** A link to a playlist at one of the station's music sources, as a browser or an app shows it */
+    url?: string;
+    /** A playlist a music source lists here, by its plugin and its id */
+    providerPlaylist?: PlaylistProviderRef;
+    /** What to call the new playlist. Absent keeps the name the source gives it */
+    name?: string;
+}
+//# sourceMappingURL=station.playlists.types.d.ts.map

package/dist/playlists/types/station.playlists.types.d.ts.map

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

package/dist/playout/playout.client.d.ts

@@ -1,5 +1,5 @@
 import type { SdkFetch } from '../sdk-options.js';
-import type { PlayoutChartInput, PlayoutPlaylistInput, PlayoutStatus } from './types/playout.types.js';
+import type { PlayoutChartInput, PlayoutPlaylistInput, PlayoutStationPlaylistInput, PlayoutStatus } from './types/playout.types.js';
 export declare class PlayoutClient {
     private fetch;
     constructor(fetch: SdkFetch);
@@ -13,6 +13,11 @@ export declare class PlayoutClient {
      * @description Loads a plugin playlist into the running order and starts handing it to the player. Replaces whatever was queued; what is on air finishes rather than being cut off
      */
     playAPlaylist(body: PlayoutPlaylistInput): Promise<PlayoutStatus>;
+    /**
+     * @name Play a station playlist
+     * @description Loads a playlist the station owns into the running order and starts handing it to the player. The same replacement a plugin playlist makes, from records the library already holds
+     */
+    playAStationPlaylist(body: PlayoutStationPlaylistInput): Promise<PlayoutStatus>;
     /**
      * @name Play a chart
      * @description Builds the running order from a published chart and starts handing it to the player. The same replacement a playlist makes, from a document somebody else ranked

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

@@ -1 +1 @@
-{"version":3,"file":"playout.client.d.ts","sourceRoot":"","sources":["../../src/playout/playout.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEvG,qBAAa,aAAa;IACV,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAKhD;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IASvE;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IASjE;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC;IAKlD;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAK5C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;CAI9C"}
+{"version":3,"file":"playout.client.d.ts","sourceRoot":"","sources":["../../src/playout/playout.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEpI,qBAAa,aAAa;IACV,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAKhD;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IASvE;;;OAGG;IACG,oBAAoB,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,aAAa,CAAC;IASrF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IASjE;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC;IAKlD;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAK5C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;CAI9C"}

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

@@ -8,9 +8,18 @@ export interface PlayoutPlaylistInput {
     /** Whether records that sound like the ones on this playlist are mixed in among them, one every `rotation.mixInEvery` records. The playlist still plays in full and in its own order around them. Absent takes the station's own setting, which is off */
     mixInSimilar?: boolean;
 }
+/**
+ * A playlist the station owns, to load into the running order
+ * generated from [PlayoutStationPlaylistInput](../../../../../apps/api/data/contracts/playout/playout.types.ck#L13)
+ */
+export interface PlayoutStationPlaylistInput {
+    stationPlaylistId: string;
+    /** Whether records that sound like the ones on this playlist are mixed in among them, one every `rotation.mixInEvery` records. Absent takes the station's own setting, which is off */
+    mixInSimilar?: boolean;
+}
 /**
  * The published chart to build the running order from
- * generated from [PlayoutChartInput](../../../../../apps/api/data/contracts/playout/playout.types.ck#L13)
+ * generated from [PlayoutChartInput](../../../../../apps/api/data/contracts/playout/playout.types.ck#L18)
  */
 export interface PlayoutChartInput {
     /** As `pluginId:chartId`, which is how `GET /charts` lists them */
@@ -20,7 +29,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#L18)
+ * generated from [PlayoutItem](../../../../../apps/api/data/contracts/playout/playout.types.ck#L23)
  */
 export interface PlayoutItem {
     /** deadair's own id for this item, not the provider's: a playlist may hold the same track twice */
@@ -46,7 +55,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#L42)
+ * generated from [StreamConfigWarning](../../../../../apps/api/data/contracts/playout/playout.types.ck#L47)
  */
 export interface StreamConfigWarning {
     /** Which one is behind */
@@ -59,19 +68,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#L50)
+ * generated from [SilenceCause](../../../../../apps/api/data/contracts/playout/playout.types.ck#L55)
  */
 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#L68)
+ * generated from [SilenceState](../../../../../apps/api/data/contracts/playout/playout.types.ck#L73)
  */
 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#L85)
+ * generated from [PlayoutMount](../../../../../apps/api/data/contracts/playout/playout.types.ck#L90)
  */
 export interface PlayoutMount {
     format: 'mp3' | 'opus' | 'aac' | 'flac';
@@ -82,7 +91,7 @@ export interface PlayoutMount {
 }
 /**
  * Which rundown item Liquidsoap has just started playing
- * generated from [PlayoutAiredQuery](../../../../../apps/api/data/contracts/playout/playout.types.ck#L105)
+ * generated from [PlayoutAiredQuery](../../../../../apps/api/data/contracts/playout/playout.types.ck#L110)
  */
 export interface PlayoutAiredQuery {
     /** The id the app put on the pushed uri's `annotate:` metadata */
@@ -90,7 +99,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#L109)
+ * generated from [PlayoutStarveQuery](../../../../../apps/api/data/contracts/playout/playout.types.ck#L114)
  */
 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 */
@@ -100,7 +109,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#L31)
+ * generated from [PlayoutNowPlaying](../../../../../apps/api/data/contracts/playout/playout.types.ck#L36)
  */
 export interface PlayoutNowPlaying {
     item: PlayoutItem;
@@ -111,7 +120,7 @@ export interface PlayoutNowPlaying {
 }
 /**
  * One gate's answer about itself
- * generated from [SilenceCheck](../../../../../apps/api/data/contracts/playout/playout.types.ck#L70)
+ * generated from [SilenceCheck](../../../../../apps/api/data/contracts/playout/playout.types.ck#L75)
  */
 export interface SilenceCheck {
     /** Never `airing`, which is the absence of a blocking gate rather than a gate */
@@ -124,7 +133,7 @@ export interface SilenceCheck {
 }
 /**
  * Why the station cannot be heard, as one answer
- * generated from [StationSilence](../../../../../apps/api/data/contracts/playout/playout.types.ck#L77)
+ * generated from [StationSilence](../../../../../apps/api/data/contracts/playout/playout.types.ck#L82)
  */
 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 */
@@ -137,7 +146,7 @@ export interface StationSilence {
 }
 /**
  * The station's transport, as one reading
- * generated from [PlayoutStatus](../../../../../apps/api/data/contracts/playout/playout.types.ck#L91)
+ * generated from [PlayoutStatus](../../../../../apps/api/data/contracts/playout/playout.types.ck#L96)
  */
 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deadair/sdk",
-  "version": "0.31.3",
+  "version": "0.32.0",
   "description": "A typed client for the deadair station's HTTP API, generated from the same contracts the station serves.",
   "keywords": [
     "deadair",