@deadair/sdk 0.7.0

package/dist/schedule/types/schedule.types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * One stretch of the station's day: from this time, on these days, the station plays this
+ * generated from [ScheduleSlot](../../../../../apps/api/data/contracts/schedule/schedule.types.ck#L8)
+ */
+export interface ScheduleSlot {
+    id: string;
+    /** What the operator calls this stretch of the day. Becomes the broadcast's name */
+    label: string;
+    /** When it starts, as minutes past midnight on the station's clock */
+    startsAtMinutes: number;
+    /** When it stops, in the same terms. Before the start means the block runs past midnight, which is ordinary for a late show; equal to it means a full twenty-four hours */
+    endsAtMinutes: number;
+    /** The weekdays it runs on, Sunday 0. Absent or empty means every day */
+    days?: number[];
+    /** The plugin the records come from. Absent, with no playlist, is a slot the station fills itself */
+    sourcePluginId?: string;
+    sourcePlaylistId?: string;
+    /** A published chart to play instead, as `pluginId:chartId`. An ALTERNATIVE to the playlist pair rather than a companion, and it wins if both are sent: a playlist names copies the station can already fetch and a chart names records it has to look up */
+    sourceChartId?: string;
+    /** Which way round that chart is played. Absent is `countdown`, which ends on number one. Ignored without `sourceChartId` */
+    sourceChartOrder?: 'countdown' | 'ranked' | 'unordered';
+    /** Who hosts this stretch of the day. Absent means the station's own active persona */
+    personaId?: string;
+    /** What this stretch of the day is asked to play, in the operator's own words. The same ceiling `PutOnAirInput.brief` has, because a changeover builds one of those from this and the two boxes are one field set on the console */
+    brief?: string;
+    /** The earliest release year this stretch of the day plays. Absent means no lower bound, and a record whose year the catalog does not know is played whatever the period */
+    eraFrom?: number;
+    /** The latest release year, on the same terms. Set with `eraFrom` for a decade; either may stand alone */
+    eraTo?: number;
+    /** Whether somebody phones in during this stretch of the day. Absent leaves the station's own setting standing, exactly as it does when an operator briefs a broadcast by hand; a `setlist` or a `feature` takes no calls whatever this says */
+    callins?: boolean;
+    mode: 'rotation' | 'setlist' | 'feature';
+    onEnd: 'extend' | 'repeat' | 'stop';
+}
+export interface ScheduleSlotInput {
+    /** What the operator calls this stretch of the day. Becomes the broadcast's name */
+    label: string;
+    /** When it starts, as minutes past midnight on the station's clock */
+    startsAtMinutes: number;
+    /** When it stops, in the same terms. Before the start means the block runs past midnight, which is ordinary for a late show; equal to it means a full twenty-four hours */
+    endsAtMinutes: number;
+    /** The weekdays it runs on, Sunday 0. Absent or empty means every day */
+    days?: number[];
+    /** The plugin the records come from. Absent, with no playlist, is a slot the station fills itself */
+    sourcePluginId?: string;
+    sourcePlaylistId?: string;
+    /** A published chart to play instead, as `pluginId:chartId`. An ALTERNATIVE to the playlist pair rather than a companion, and it wins if both are sent: a playlist names copies the station can already fetch and a chart names records it has to look up */
+    sourceChartId?: string;
+    /** Which way round that chart is played. Absent is `countdown`, which ends on number one. Ignored without `sourceChartId` */
+    sourceChartOrder?: 'countdown' | 'ranked' | 'unordered';
+    /** Who hosts this stretch of the day. Absent means the station's own active persona */
+    personaId?: string;
+    /** What this stretch of the day is asked to play, in the operator's own words. The same ceiling `PutOnAirInput.brief` has, because a changeover builds one of those from this and the two boxes are one field set on the console */
+    brief?: string;
+    /** The earliest release year this stretch of the day plays. Absent means no lower bound, and a record whose year the catalog does not know is played whatever the period */
+    eraFrom?: number;
+    /** The latest release year, on the same terms. Set with `eraFrom` for a decade; either may stand alone */
+    eraTo?: number;
+    /** Whether somebody phones in during this stretch of the day. Absent leaves the station's own setting standing, exactly as it does when an operator briefs a broadcast by hand; a `setlist` or a `feature` takes no calls whatever this says */
+    callins?: boolean;
+    mode: 'rotation' | 'setlist' | 'feature';
+    onEnd: 'extend' | 'repeat' | 'stop';
+}
+/**
+ * A window of the station's day to draw
+ * generated from [ScheduleTimetableQuery](../../../../../apps/api/data/contracts/schedule/schedule.types.ck#L32)
+ */
+export interface ScheduleTimetableQuery {
+    /** The first day to draw, as `YYYY-MM-DD` on the station's own calendar. Absent means the station's today, which is the only way a caller that does not know the station's timezone can anchor */
+    from?: string;
+    /** How many days from `from`. Defaults to a week */
+    days?: number;
+}
+/**
+ * One block: this slot, on this day, between these two times
+ * generated from [ScheduleOccurrence](../../../../../apps/api/data/contracts/schedule/schedule.types.ck#L45)
+ */
+export interface ScheduleOccurrence {
+    slotId: string;
+    label: string;
+    /** `YYYY-MM-DD HH:mm:ss` on the station's own clock, deliberately carrying no timezone offset: it is a reading rather than a moment, so it draws as written wherever the console is running */
+    start: string;
+    /** The same, exclusive. Every block stays inside one day, so a slot running past midnight arrives as two */
+    end: string;
+}
+/**
+ * generated from [ScheduleSlotList](../../../../../apps/api/data/contracts/schedule/schedule.types.ck#L27)
+ */
+export interface ScheduleSlotList {
+    slots: ScheduleSlot[];
+}
+export interface ScheduleSlotListInput {
+    slots: ScheduleSlotInput[];
+}
+/**
+ * The station's day as blocks, ready to draw
+ * generated from [ScheduleTimetable](../../../../../apps/api/data/contracts/schedule/schedule.types.ck#L38)
+ */
+export interface ScheduleTimetable {
+    /** The range actually drawn, echoed so a caller steps forward and back by adding days to a string rather than by knowing the station's timezone */
+    from: string;
+    days: number;
+    occurrences: ScheduleOccurrence[];
+}
+/**
+ * Which slot the clock says should be on right now, and what follows it
+ * generated from [ScheduleNow](../../../../../apps/api/data/contracts/schedule/schedule.types.ck#L53)
+ */
+export interface ScheduleNow {
+    /** What time it is on the station's own clock, in the same zone-naive `YYYY-MM-DD HH:mm:ss` shape as a block's ends. It is here so a caller can say how much of the block is left without knowing the station's timezone: subtracting two readings taken in one frame is arithmetic, deriving one is not */
+    now: string;
+    /** The slot in force at this instant. Absent means the station has no schedule */
+    slotId?: string;
+    /** The slot the running order actually belongs to. Different from the one above while an operator's own choice holds, which it does until the next slot begins */
+    airingSlotId?: string;
+    /** The block on now, if there is one, and the few that follow it, earliest first. Empty for a station with nothing scheduled from here on. A gap is simply absent, exactly as it is on the timetable: what plays there is the sustaining source rather than a block */
+    upcoming: ScheduleOccurrence[];
+}
+//# sourceMappingURL=schedule.types.d.ts.map

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

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

package/dist/sdk-options.d.ts

@@ -0,0 +1,45 @@
+export declare class SdkError<TBody = unknown> extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly body: TBody;
+    readonly headers: Headers;
+    constructor(status: number, statusText: string, body: TBody, headers: Headers);
+}
+export interface SdkRequestInit extends RequestInit {
+    /**
+     * Statuses this operation declares as values rather than errors — a 304 from
+     * conditional-GET middleware, or an error status the service returns deliberately.
+     * Anything else at or above 400 still throws SdkError.
+     */
+    expectStatuses?: number[];
+}
+export type SdkFetch = (url: string, init: SdkRequestInit) => Promise<Response>;
+export interface SdkOptions {
+    baseUrl: string;
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    fetch?: SdkFetch;
+    /** Called once per request to produce a unique X-Request-ID header value */
+    requestIdFactory?: () => string;
+}
+export declare const bigIntReplacer: (_: string, value: any) => any;
+export declare const bigIntReviver: (_: string, value: any) => any;
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare function readContentType(res: Response): string;
+export declare function createSdkFetch(options: SdkOptions): SdkFetch;
+export declare function buildQueryString(query: object | undefined): string;
+export declare function buildHeaders(headers: object | undefined): Record<string, string>;
+export declare function parseBigIntHeader(name: string, value: string): bigint;
+/**
+ * Read a JSON response body.
+ *
+ * No reviver: `bigIntReviver` matches any string of the form `123n` anywhere in the
+ * document, so a contract with no bigint field would still have a legitimate string like
+ * "123n" silently turned into a BigInt. Clients whose contracts do use bigint import
+ * `parseJsonWithBigInt` under this name instead.
+ */
+export declare function parseJson<T>(res: Response): Promise<T>;
+/** `parseJson` for contracts that declare a bigint, applying the `123n` reviver. */
+export declare function parseJsonWithBigInt<T>(res: Response): Promise<T>;
+//# sourceMappingURL=sdk-options.d.ts.map

package/dist/sdk-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-options.d.ts","sourceRoot":"","sources":["../src/sdk-options.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,KAAK;aAE5B,MAAM,EAAE,MAAM;aACd,UAAU,EAAE,MAAM;aAClB,IAAI,EAAE,KAAK;aACX,OAAO,EAAE,OAAO;gBAHhB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,OAAO;CAKvC;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAC/C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpG,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,OAAO,GAAG,KAAG,GAKtD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,EAAE,OAAO,GAAG,KAAG,GAKrD,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtG,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAErD;AAYD,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAoB5D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYlE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAShF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5D;AAED,oFAAoF;AACpF,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAEtE"}

package/dist/settings/settings.client.d.ts

@@ -0,0 +1,17 @@
+import type { SdkFetch } from '../sdk-options.js';
+import type { StationSettings, StationSettingsInput } from './types/settings.types.js';
+export declare class SettingsClient {
+    private fetch;
+    constructor(fetch: SdkFetch);
+    /**
+     * @name Get settings
+     * @description Every station setting, its descriptor and its current value
+     */
+    getSettings(): Promise<StationSettings>;
+    /**
+     * @name Update settings
+     * @description Applies a submitted settings form and answers with the settings as they now stand
+     */
+    updateSettings(body: StationSettingsInput): Promise<StationSettings>;
+}
+//# sourceMappingURL=settings.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.client.d.ts","sourceRoot":"","sources":["../../src/settings/settings.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,qBAAa,cAAc;IACX,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAK7C;;;OAGG;IACG,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;CAQ7E"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/settings/types/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC"}

package/dist/settings/types/settings.types.d.ts

@@ -0,0 +1,35 @@
+import type { ConfigFieldDescriptor } from '../../plugins/types/plugins.types.js';
+/**
+ * Which part of the console owns a setting. Every one of these but `schedule` and `personas` is a section of the settings page; `schedule` is edited on the schedule page, beside the timetable it describes, and `personas` on the characters page, beside the names it stands behind.
+ * generated from [SettingGroup](../../../../../apps/api/data/contracts/settings/settings.types.ck#L7)
+ */
+export type SettingGroup = 'station' | 'stream' | 'housekeeping' | 'mail' | 'rotation' | 'playout' | 'render' | 'llm' | 'analysis' | 'schedule' | 'personas';
+/**
+ * A submitted settings form. Partial: a key that is present is written, a key that is absent is left
+ * alone, so a console may send one field. A secret submitted blank clears it
+ * generated from [StationSettingsInput](../../../../../apps/api/data/contracts/settings/settings.types.ck#L42)
+ */
+export interface StationSettingsInput {
+    values: Record<string, unknown>;
+}
+/**
+ * A station setting as the console needs to render it. `ConfigFieldDescriptor` is the plugins area's,
+ * and shared deliberately: a plugin's settings form and the station's are the same problem, and the
+ * console renders both with one component
+ * generated from [StationSettingDescriptor](../../../../../apps/api/data/contracts/settings/settings.types.ck#L29)
+ */
+export interface StationSettingDescriptor extends ConfigFieldDescriptor {
+    group: SettingGroup;
+}
+/**
+ * Every station setting, with what it is currently worth
+ * generated from [StationSettings](../../../../../apps/api/data/contracts/settings/settings.types.ck#L34)
+ */
+export interface StationSettings {
+    descriptors: StationSettingDescriptor[];
+    /** Every NON-secret setting, with defaults filled in for whatever is not stored */
+    values: Record<string, unknown>;
+    /** One entry per `secret` setting: whether a value is currently stored. Never the value itself */
+    configured: Record<string, boolean>;
+}
+//# sourceMappingURL=settings.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.types.d.ts","sourceRoot":"","sources":["../../../src/settings/types/settings.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtI;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACnE,KAAK,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACxC,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kGAAkG;IAClG,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC"}

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

@@ -0,0 +1,2 @@
+export * from './pagination.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/types/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC"}

package/dist/shared/types/pagination.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Represents a pagination object
+ * generated from [Pagination](../../../../../apps/api/data/contracts/shared/pagination.ck#L7)
+ */
+export interface Pagination {
+    /** The page number */
+    page?: number;
+    /** The page size */
+    pageSize?: number;
+    /** The sort order */
+    sort?: 'asc' | 'desc';
+    /** The total number of items */
+    total: number;
+}
+export interface PaginationInput {
+    /** The page number */
+    page?: number;
+    /** The page size */
+    pageSize?: number;
+    /** The sort order */
+    sort?: 'asc' | 'desc';
+}
+/**
+ * generated from [PaginationWithActive](../../../../../apps/api/data/contracts/shared/pagination.ck#L14)
+ */
+export interface PaginationWithActive extends Pagination {
+    /** Optionally filter by whether the items are active */
+    active?: boolean;
+}
+export interface PaginationWithActiveInput extends PaginationInput {
+    /** Optionally filter by whether the items are active */
+    active?: boolean;
+}
+//# sourceMappingURL=pagination.d.ts.map

package/dist/shared/types/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/shared/types/pagination.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACpD,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAC9D,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/station/station.client.d.ts

@@ -0,0 +1,49 @@
+import type { SdkFetch } from '../sdk-options.js';
+import type { LogPage, LogQuery, LogSourceList } from './types/logs.types.js';
+import type { StationAttention, StationCheckup } from './types/station.types.js';
+import type { TraceDetail, TracesPage, TracesQuery } from './types/traces.types.js';
+export declare class StationClient {
+    private fetch;
+    constructor(fetch: SdkFetch);
+    /**
+     * @name List logs
+     * @description Every log this install has, present or not, with its size and when it was last written
+     */
+    listLogs(): Promise<LogSourceList>;
+    /**
+     * @name Read log
+     * @description A tail of one log, newest first
+     */
+    readLog(id: string, query?: LogQuery): Promise<LogPage>;
+    /**
+     * @name Download log
+     * @description The retained log as a plain-text attachment, oldest first, as the file is written
+     */
+    downloadLog(id: string): Promise<{
+        data: string;
+        headers: {
+            contentDisposition?: string;
+        };
+    }>;
+    /**
+     * @name Read station attention
+     * @description Everything wrong or waiting, worst first, each with the console page that can act on it
+     */
+    readStationAttention(): Promise<StationAttention>;
+    /**
+     * @name Read station checkup
+     * @description The loops the station runs and how much of the library it has looked at
+     */
+    readStationCheckup(): Promise<StationCheckup>;
+    /**
+     * @name Read traces
+     * @description Recent decisions, newest first, folded to one row each
+     */
+    readTraces(query?: TracesQuery): Promise<TracesPage>;
+    /**
+     * @name Read trace
+     * @description One decision: every call it made, and the decisions on either side of it
+     */
+    readTrace(id: string): Promise<TraceDetail>;
+}
+//# sourceMappingURL=station.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"station.client.d.ts","sourceRoot":"","sources":["../../src/station/station.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGpF,qBAAa,aAAa;IACV,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAKxC;;;OAGG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7D;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAMlG;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAKvD;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC;IAKnD;;;OAGG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ1D;;;OAGG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAIpD"}

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

@@ -0,0 +1,4 @@
+export * from './logs.types.js';
+export * from './station.types.js';
+export * from './traces.types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/station/types/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,73 @@
+import { DateTime } from 'luxon';
+/**
+ * Five values, where `PluginLogLevel` next door has four. The plugin enum is the narrower one on
+ * purpose — that is the vocabulary a plugin's own `PluginLogger` offers — while `api.log` is written
+ * by `DeadairLogger`, which tees every level the app-wide `Logger` has, `trace` included. Narrowing
+ * here would make a `trace` line unrepresentable in the type of the surface that reads the file it
+ * is in.
+ * generated from [LogLevel](../../../../../apps/api/data/contracts/station/logs.types.ck#L12)
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
+/**
+ * One log file this install has, whether or not anything has been written to it
+ * generated from [LogSource](../../../../../apps/api/data/contracts/station/logs.types.ck#L14)
+ */
+export interface LogSource {
+    /** A closed set the API owns: `api`, `liquidsoap`, `shim`. Never a path */
+    id: string;
+    label: string;
+    /** What writes it, in a sentence, because "shim" means nothing to somebody who has not read the tree */
+    description: string;
+    /** Whether the file is there at all. A station that never ran the stream has no stream logs, which is a state rather than a fault */
+    present: boolean;
+    /** Whether its lines carry a level, so the console knows whether to offer the filter */
+    levels: boolean;
+    /** Retained size across every segment. Zero when absent */
+    bytes: number;
+    /** Absent when nothing has ever been written */
+    lastWriteAt?: DateTime;
+}
+/** Rehydrates every wire-encoded scalar in a LogSource into its runtime type. Mutates and returns `raw`. */
+export declare function reviveLogSource(raw: LogSource): LogSource;
+/**
+ * One line, as far as it could be read back
+ * generated from [LogLine](../../../../../apps/api/data/contracts/station/logs.types.ck#L28)
+ */
+export interface LogLine {
+    /** Absent on a line this API did not write, and on one of its own that did not parse */
+    ts?: string;
+    /** Absent for the same two reasons */
+    level?: LogLevel;
+    /** Must match MAX_LINE_BYTES_CEILING in apps/api/src/logging/rotating.log.store.ts. Change both together */
+    text: string;
+}
+/**
+ * generated from [LogQuery](../../../../../apps/api/data/contracts/station/logs.types.ck#L41)
+ */
+export interface LogQuery {
+    limit?: number;
+    /** Ignored by a source whose lines carry no level */
+    level?: LogLevel;
+}
+/**
+ * generated from [LogSourceList](../../../../../apps/api/data/contracts/station/logs.types.ck#L24)
+ */
+export interface LogSourceList {
+    /** Every source, in a fixed order, including the ones that are not present */
+    sources: LogSource[];
+}
+/** Rehydrates every wire-encoded scalar in a LogSourceList into its runtime type. Mutates and returns `raw`. */
+export declare function reviveLogSourceList(raw: LogSourceList): LogSourceList;
+/**
+ * generated from [LogPage](../../../../../apps/api/data/contracts/station/logs.types.ck#L34)
+ */
+export interface LogPage {
+    sourceId: string;
+    /** The minimum severity that was applied. Absent when the source carries no levels, so a filter that did nothing cannot look as though it worked */
+    level?: LogLevel;
+    /** Whether the read hit its byte budget, so the oldest line here is not the file's first */
+    truncated: boolean;
+    /** Newest first, as the plugin log page, the activity feed and the script history all send */
+    lines: LogLine[];
+}
+//# sourceMappingURL=logs.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.types.d.ts","sourceRoot":"","sources":["../../../src/station/types/logs.types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAYjC;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,wGAAwG;IACxG,WAAW,EAAE,MAAM,CAAC;IACpB,qIAAqI;IACrI,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,MAAM,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED,4GAA4G;AAC5G,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAMzD;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB,wFAAwF;IACxF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,8EAA8E;IAC9E,OAAO,EAAE,SAAS,EAAE,CAAC;CACxB;AAED,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CASrE;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oJAAoJ;IACpJ,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,4FAA4F;IAC5F,SAAS,EAAE,OAAO,CAAC;IACnB,8FAA8F;IAC9F,KAAK,EAAE,OAAO,EAAE,CAAC;CACpB"}

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

@@ -0,0 +1,120 @@
+import { DateTime } from 'luxon';
+/**
+ * One concrete thing an attention row is about, so the reason does not live a page away.
+ *
+ * The row above it counts and categorises; this names. "4 records have no copy left that will play"
+ * is a category an operator can do nothing with until they know WHICH four and WHY each one, and
+ * every one of those facts was already stored — the fetch error on `track_audio.last_error`, the
+ * provider's refusal on `track_sources.playable` — and reachable only by finding the record and
+ * hovering a cell on its page. This is that fact travelling with the row that counted it.
+ * generated from [AttentionEvidence](../../../../../apps/api/data/contracts/station/station.types.ck#L14)
+ */
+export interface AttentionEvidence {
+    /** The thing itself, as an operator would name it: a record's title and who made it */
+    label: string;
+    /** Why THIS one, in the station's own sentence. The row's `detail` says what the category means; this says what happened here */
+    reason: string;
+    /** The page holding the whole of it. Absent where there is no page for it, which the running order can hold: a record the catalog never ingested has none */
+    route?: string;
+}
+/**
+ * One loop the station runs, and when it last came round.
+ *
+ * Two timestamps and no verdict, because the loop cannot supply one: a five-second reconcile and a
+ * nightly sweep are both healthy and no single threshold describes both. `Heartbeat` itself takes
+ * this position — it answers how long it has been and lets the reader decide — and a `stalled`
+ * boolean here would be this module inventing the threshold that file deliberately refuses to.
+ *
+ * `lastBeat` is absent until a loop finishes its first pass, which is why `startedAt` is there: from
+ * the two of them a reader can tell a loop that has never completed anything from one that stopped.
+ * generated from [StationHeartbeat](../../../../../apps/api/data/contracts/station/station.types.ck#L45)
+ */
+export interface StationHeartbeat {
+    name: string;
+    /** When the loop registered, which is when it was last (re)started */
+    startedAt: DateTime;
+    /** When it last completed a pass. Absent until it completes its first */
+    lastBeat?: DateTime;
+}
+export interface StationHeartbeatInput {
+}
+/** Rehydrates every wire-encoded scalar in a StationHeartbeat into its runtime type. Mutates and returns `raw`. */
+export declare function reviveStationHeartbeat(raw: StationHeartbeat): StationHeartbeat;
+/**
+ * How much of the library the station has actually looked at.
+ *
+ * The counts `/catalog/tracks` already answers with, lifted out of a page of rows: a check-up wants
+ * the sentence "13 of 581 measured" without asking for thirteen tracks to get it.
+ * generated from [StationBacklog](../../../../../apps/api/data/contracts/station/station.types.ck#L55)
+ */
+export interface StationBacklog {
+    total: number;
+    cached: number;
+    measured: number;
+}
+export interface StationBacklogInput {
+}
+/**
+ * One thing that wants the operator's attention, or the fact that nothing does
+ * generated from [AttentionItem](../../../../../apps/api/data/contracts/station/station.types.ck#L21)
+ */
+export interface AttentionItem {
+    /** What this is, as a stable key: `silence`, `benchedCopies`, `noPersona`. The console groups and counts on it rather than on the sentence */
+    code: string;
+    /** `failure` is the station not doing its job, `warning` is something failing beside a station that is working, and `notice` is a thing nobody has set up yet. A notice is not a fault and must not be drawn as one */
+    severity: 'failure' | 'warning' | 'notice';
+    /** The line an operator reads first */
+    title: string;
+    /** The whole of it, in a sentence. Where the station already has words for a fact, these are those words rather than a second phrasing of them */
+    detail: string;
+    /** The console page that can do something about it */
+    route: string;
+    /** How many things this is about, where that is a number rather than a state */
+    count?: number;
+    /** A HANDFUL of the things this row is about, never all of them: this answer is polled and a row about four hundred records must not be four hundred sentences. `count` stays the true figure, and a console showing fewer than it says so */
+    evidence?: AttentionEvidence[];
+}
+/**
+ * One reading of the machinery, for a page that assembles the station's health.
+ *
+ * It carries ONLY the two signals nothing else exposes. Everything else a check-up shows — the
+ * silence verdict, the listener count, what needs somebody, the plugin statuses, the disk — is
+ * already on a contract the console reads, and composing them again here would be a second answer
+ * that can disagree with the first. `/playout/status` in particular is polled every two seconds for
+ * the transport strip, so asking for it a second way would be a second reading of the same fact.
+ *
+ * Each section is OPTIONAL and absent means that reader failed. A page saying what is wrong is the
+ * worst place for one broken reader to take the whole answer down, which is the rule
+ * `StationAttentionService` already works to. `revision` is the one exception and says so on its
+ * own line: it cannot fail, so absent there means something else.
+ *
+ * The revision is on THIS contract rather than composed from `/health`, which also reports it, and
+ * that is not the second-answer problem the paragraph above describes. Both read one string from one
+ * place at boot, so they cannot disagree. What they differ in is who can reach them: `/health` is
+ * `operation(internal)`, deliberately, so it generates no SDK method and the console cannot call it
+ * — which would leave "which build is this" answerable only from a shell, the one thing carrying it
+ * here exists to fix.
+ * generated from [StationCheckup](../../../../../apps/api/data/contracts/station/station.types.ck#L80)
+ */
+export interface StationCheckup {
+    /** When this reading was taken, so a stale page cannot pass itself off as now */
+    readAt: DateTime;
+    /** The commit this station was built from, as the image's `org.opencontainers.image.revision` label says it. Unlike the sections below, absent is not a failed reader: it means nothing stamped this build, which is what a development tree and a hand-built image both are */
+    revision?: string;
+    /** The release this station is, as the image's `org.opencontainers.image.version` label says it. Absent on the same terms as `revision` and for a second reason: only a tagged build carries one, so a station following `latest` reports a commit and no version */
+    version?: string;
+    heartbeats?: StationHeartbeat[];
+    backlog?: StationBacklog;
+}
+export interface StationCheckupInput {
+}
+/** Rehydrates every wire-encoded scalar in a StationCheckup into its runtime type. Mutates and returns `raw`. */
+export declare function reviveStationCheckup(raw: StationCheckup): StationCheckup;
+/**
+ * Everything wrong or waiting, worst first
+ * generated from [StationAttention](../../../../../apps/api/data/contracts/station/station.types.ck#L32)
+ */
+export interface StationAttention {
+    items: AttentionItem[];
+}
+//# sourceMappingURL=station.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"station.types.d.ts","sourceRoot":"","sources":["../../../src/station/types/station.types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAYjC;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAC9B,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,iIAAiI;IACjI,MAAM,EAAE,MAAM,CAAC;IACf,6JAA6J;IAC7J,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,SAAS,EAAE,QAAQ,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;CAAG;AAEzC,mHAAmH;AACnH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,CAO9E;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;CAAG;AAEvC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,8IAA8I;IAC9I,IAAI,EAAE,MAAM,CAAC;IACb,uNAAuN;IACvN,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,kJAAkJ;IAClJ,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8OAA8O;IAC9O,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,cAAc;IAC3B,iFAAiF;IACjF,MAAM,EAAE,QAAQ,CAAC;IACjB,gRAAgR;IAChR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qQAAqQ;IACrQ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;CAAG;AAEvC,iHAAiH;AACjH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc,CAYxE;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,aAAa,EAAE,CAAC;CAC1B"}