@deadair/sdk 0.7.0

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

@@ -0,0 +1,91 @@
+import { DateTime } from 'luxon';
+/**
+ * Whether a call produced what it was asked for. Two values on purpose: every finer distinction —
+ * timed out, was preempted, came back empty — is a fact the caller knew and the recorder did not, so
+ * it lives in `detail` where it can be named
+ * generated from [TraceOutcome](../../../../../apps/api/data/contracts/station/traces.types.ck#L10)
+ */
+export type TraceOutcome = 'ok' | 'failed';
+/**
+ * One decision, folded: a job execution or a request
+ * generated from [TraceDecision](../../../../../apps/api/data/contracts/station/traces.types.ck#L22)
+ */
+export interface TraceDecision {
+    /** The job id or the request id. Already the station's correlation id, never generated for this */
+    id: string;
+    /** A queue name, or a method and path */
+    kind: string;
+    /** The decision that enqueued this one. Absent on a request, a cron job and anything at boot */
+    parent?: string;
+    /** When its first recorded call ended */
+    at: DateTime;
+    /** Wall clock, off the `job.run` span. Zero for a decision recorded before that span existed */
+    ms: number;
+    /** Everything it did, not counting the `job.run` that contains them */
+    calls: number;
+    /** How many of those did not produce what they were asked for */
+    failed: number;
+}
+/** Rehydrates every wire-encoded scalar in a TraceDecision into its runtime type. Mutates and returns `raw`. */
+export declare function reviveTraceDecision(raw: TraceDecision): TraceDecision;
+/**
+ * Which slice of the kept window to read
+ * generated from [TracesQuery](../../../../../apps/api/data/contracts/station/traces.types.ck#L32)
+ */
+export interface TracesQuery {
+    limit?: number;
+    /** An exact queue name or route, for reading one kind of decision on its own */
+    kind?: string;
+    /** Only decisions carrying at least one failed call */
+    failedOnly?: boolean;
+}
+/**
+ * One call inside a decision, and what it cost
+ * generated from [TraceSpan](../../../../../apps/api/data/contracts/station/traces.types.ck#L12)
+ */
+export interface TraceSpan {
+    /** When the call ended, which is when its cost was known */
+    at: DateTime;
+    /** Dotted and stable: `job.run`, `plugin.invoke`, `llm.generate` */
+    op: string;
+    /** Which one: a plugin and its method, or a model */
+    target?: string;
+    /** How long it held, measured around the call rather than reported by it */
+    ms: number;
+    outcome: TraceOutcome;
+    /** The failure, summarized to a shape rather than a stack */
+    error?: string;
+    /** Whatever this `op` is worth reading back: tokens, a finish reason, the bound it was given */
+    detail?: Record<string, unknown>;
+}
+/** Rehydrates every wire-encoded scalar in a TraceSpan into its runtime type. Mutates and returns `raw`. */
+export declare function reviveTraceSpan(raw: TraceSpan): TraceSpan;
+/**
+ * generated from [TracesPage](../../../../../apps/api/data/contracts/station/traces.types.ck#L38)
+ */
+export interface TracesPage {
+    /** Newest first */
+    decisions: TraceDecision[];
+    /** How many the window holds before `limit`, so a page can say it is showing a slice */
+    total: number;
+    /** How many calls were read to answer, which is the honest cost of this page */
+    spans: number;
+}
+/** Rehydrates every wire-encoded scalar in a TracesPage into its runtime type. Mutates and returns `raw`. */
+export declare function reviveTracesPage(raw: TracesPage): TracesPage;
+/**
+ * One decision, its calls, and the decisions on either side of it
+ * generated from [TraceDetail](../../../../../apps/api/data/contracts/station/traces.types.ck#L44)
+ */
+export interface TraceDetail {
+    decision: TraceDecision;
+    /** In the order they happened */
+    spans: TraceSpan[];
+    /** What enqueued this, when that decision is still inside the kept window */
+    parent?: TraceDecision;
+    /** What this one went on to enqueue */
+    caused: TraceDecision[];
+}
+/** Rehydrates every wire-encoded scalar in a TraceDetail into its runtime type. Mutates and returns `raw`. */
+export declare function reviveTraceDetail(raw: TraceDetail): TraceDetail;
+//# sourceMappingURL=traces.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traces.types.d.ts","sourceRoot":"","sources":["../../../src/station/types/traces.types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAYjC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,mGAAmG;IACnG,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,EAAE,EAAE,QAAQ,CAAC;IACb,gGAAgG;IAChG,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAIrE;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB,4DAA4D;IAC5D,EAAE,EAAE,QAAQ,CAAC;IACb,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,4GAA4G;AAC5G,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAIzD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,mBAAmB;IACnB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,6GAA6G;AAC7G,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAS5D;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,iCAAiC;IACjC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,uCAAuC;IACvC,MAAM,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAmB/D"}

package/dist/storage/storage.client.d.ts

@@ -0,0 +1,12 @@
+import type { SdkFetch } from '../sdk-options.js';
+import type { StorageReport } from './types/storage.types.js';
+export declare class StorageClient {
+    private fetch;
+    constructor(fetch: SdkFetch);
+    /**
+     * @name Read storage
+     * @description What is on disk, per store, against what the database says should be
+     */
+    readStorage(): Promise<StorageReport>;
+}
+//# sourceMappingURL=storage.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.client.d.ts","sourceRoot":"","sources":["../../src/storage/storage.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,qBAAa,aAAa;IACV,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;CAI9C"}

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

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

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

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

package/dist/storage/types/storage.types.d.ts

@@ -0,0 +1,59 @@
+import { DateTime } from 'luxon';
+/**
+ * Which store, as a stable id the console can key off rather than a name it renders.
+ * generated from [StorageStoreId](../../../../../apps/api/data/contracts/storage/storage.types.ck#L8)
+ */
+export type StorageStoreId = 'tracks' | 'art' | 'segments' | 'voices';
+/**
+ * One content store: what is on disk, and what the database says should be.
+ *
+ * The two halves are deliberately separate numbers rather than one reconciled figure. They disagree
+ * in two directions and each direction means something different — a file nothing claims is what a
+ * crash between writing bytes and writing a row leaves behind, and a row whose file is gone is what
+ * an operator emptying a directory leaves. Reporting one number would hide both.
+ * generated from [StorageStore](../../../../../apps/api/data/contracts/storage/storage.types.ck#L16)
+ */
+export interface StorageStore {
+    id: StorageStoreId;
+    /** What to call it on a page */
+    label: string;
+    /** Where it is, so `du` and this can be compared */
+    path: string;
+    /** Files actually there */
+    files: number;
+    /** What they weigh */
+    bytes: number;
+    /** Rows pointing at a file. Absent when no table backs this store */
+    rows?: number;
+    /** What those rows say those files weigh. Absent where the table does not record a size */
+    accountedBytes?: number;
+    /** The limit an operator set, where the store has one. Absent means no limit */
+    capBytes?: number;
+    /** Files no row claims. Reported and never cleaned up automatically */
+    orphanFiles: number;
+    orphanBytes: number;
+    /** Claims whose file is not there. The station re-fetches or re-renders these */
+    rowsWithNoFile: number;
+}
+export interface StorageStoreInput {
+}
+/**
+ * Every store, plus the number an operator actually wants first.
+ *
+ * `readAt` is not decoration: the figures come from walking directories, which is real I/O on a
+ * station holding tens of thousands of files, so the answer is cached for a short while and this is
+ * what stops a page mistaking it for live.
+ * generated from [StorageReport](../../../../../apps/api/data/contracts/storage/storage.types.ck#L35)
+ */
+export interface StorageReport {
+    readAt: DateTime;
+    totalFiles: number;
+    totalBytes: number;
+    stores: StorageStore[];
+}
+export interface StorageReportInput {
+    stores: StorageStoreInput[];
+}
+/** Rehydrates every wire-encoded scalar in a StorageReport into its runtime type. Mutates and returns `raw`. */
+export declare function reviveStorageReport(raw: StorageReport): StorageReport;
+//# sourceMappingURL=storage.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.types.d.ts","sourceRoot":"","sources":["../../../src/storage/types/storage.types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAYjC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,cAAc,CAAC;IACnB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;CAAG;AAErC;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAIrE"}

package/dist/stream/stream.client.d.ts

@@ -0,0 +1,32 @@
+import type { SdkFetch } from '../sdk-options.js';
+import type { FetcherAuthorization, FetcherAuthorizationFinished, FetcherAuthorizationInput, FetcherAuthorizationStart } from './types/stream.types.js';
+export declare class StreamClient {
+    private fetch;
+    constructor(fetch: SdkFetch);
+    /**
+     * @name Get HLS playlist
+     * @description One HLS playlist, and the tick that says somebody is still listening to it
+     */
+    getHLSPlaylist(name: string): Promise<{
+        data: Blob;
+        headers: {
+            cacheControl?: string;
+        };
+    }>;
+    /**
+     * @name Read fetcher authorization
+     * @description What the track fetcher holds by way of a Spotify login, and whether an authorization is already waiting to be finished
+     */
+    readFetcherAuthorization(): Promise<FetcherAuthorization>;
+    /**
+     * @name Start fetcher authorization
+     * @description Starts the fetcher's one-time authorization and answers with the URL to open. Starting another replaces whichever was pending
+     */
+    startFetcherAuthorization(): Promise<FetcherAuthorizationStart>;
+    /**
+     * @name Finish fetcher authorization
+     * @description Finishes an authorization from the address the operator's browser ended up at
+     */
+    finishFetcherAuthorization(body: FetcherAuthorizationInput): Promise<FetcherAuthorizationFinished>;
+}
+//# sourceMappingURL=stream.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.client.d.ts","sourceRoot":"","sources":["../../src/stream/stream.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EACR,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,YAAY;IACT,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE;YAAE,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAM/F;;;OAGG;IACG,wBAAwB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAK/D;;;OAGG;IACG,yBAAyB,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAKrE;;;OAGG;IACG,0BAA0B,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,4BAA4B,CAAC;CAQ3G"}

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

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

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

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

package/dist/stream/types/stream.types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * What the station's track fetcher holds by way of a Spotify login
+ * generated from [FetcherAuthorization](../../../../../apps/api/data/contracts/stream/stream.types.ck#L8)
+ */
+export interface FetcherAuthorization {
+    /** Whether the fetcher answered at all. False makes every field below a default rather than a reading, so a fetcher that is merely down is never reported as one that was never authorized */
+    reachable: boolean;
+    /** Whether this install has a stream half yet. False means there is nothing here to authorize */
+    configured: boolean;
+    /** Whether the fetcher holds its OWN stored authorization, which is the only kind Spotify's login accepts. False with a healthy plugin above it is a station that lists playlists perfectly and cannot fetch a single record */
+    authorized: boolean;
+    /** Whether a login is established right now */
+    session: boolean;
+    /** The last reason a login was refused. Present is not the same as fatal: a session may have recovered since */
+    loginError?: string;
+    /** An authorization already started and not yet finished, so an operator who lost the URL is given it back rather than having to start again */
+    pendingUrl?: string;
+    /** The address the browser will be sent to and will not be able to load. Reported so the console can say which page is expected to fail, rather than leaving that looking like a fault. Absent when the fetcher did not answer, since it is the only thing that knows it */
+    callbackUrl?: string;
+}
+/**
+ * An authorization to open in a browser
+ * generated from [FetcherAuthorizationStart](../../../../../apps/api/data/contracts/stream/stream.types.ck#L19)
+ */
+export interface FetcherAuthorizationStart {
+    /** The Spotify consent page, to be opened by the operator */
+    authorizeUrl: string;
+    /** How long this URL is good for. Starting another replaces it */
+    expiresInMs: number;
+}
+/**
+ * The callback the browser could not deliver, handed over by the operator instead
+ * generated from [FetcherAuthorizationInput](../../../../../apps/api/data/contracts/stream/stream.types.ck#L25)
+ */
+export interface FetcherAuthorizationInput {
+    /** The address the browser ended up at, pasted whole. Taken apart by the fetcher rather than here, because two readings of one address is one of them being wrong eventually */
+    redirectUrl: string;
+}
+/**
+ * Which account the station now fetches as
+ * generated from [FetcherAuthorizationFinished](../../../../../apps/api/data/contracts/stream/stream.types.ck#L30)
+ */
+export interface FetcherAuthorizationFinished {
+    /** The Spotify account that was authorized. Reported because an operator with two accounts in two browser profiles wants to know which one this station now is */
+    username: string;
+}
+//# sourceMappingURL=stream.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.types.d.ts","sourceRoot":"","sources":["../../../src/stream/types/stream.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,8LAA8L;IAC9L,SAAS,EAAE,OAAO,CAAC;IACnB,iGAAiG;IACjG,UAAU,EAAE,OAAO,CAAC;IACpB,gOAAgO;IAChO,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,gHAAgH;IAChH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gJAAgJ;IAChJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4QAA4Q;IAC5Q,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACtC,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACtC,gLAAgL;IAChL,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IACzC,kKAAkK;IAClK,QAAQ,EAAE,MAAM,CAAC;CACpB"}

package/dist/topics/topics.client.d.ts

@@ -0,0 +1,32 @@
+import type { SdkFetch } from '../sdk-options.js';
+import type { TopicInput, TopicKindList, TopicList, TopicQuery } from './types/topics.types.js';
+export declare class TopicsClient {
+    private fetch;
+    constructor(fetch: SdkFetch);
+    /**
+     * @name List topics
+     * @description Every subject this station has named, for one sort of break or for all of them
+     */
+    listTopics(query?: TopicQuery): Promise<TopicList>;
+    /**
+     * @name Create topic
+     * @description Names a new subject. Nothing uses it until something points at it
+     */
+    createTopic(body: TopicInput): Promise<TopicList>;
+    /**
+     * @name List topic kinds
+     * @description Which sorts of break have subjects, and the form each one's settings are edited with
+     */
+    listTopicKinds(): Promise<TopicKindList>;
+    /**
+     * @name Update topic
+     * @description Rewrites one subject. A break already written keeps the words it was given
+     */
+    updateTopic(id: string, body: TopicInput): Promise<TopicList>;
+    /**
+     * @name Delete topic
+     * @description Removes a subject, and any band on the format clock that asked for it
+     */
+    deleteTopic(id: string): Promise<TopicList>;
+}
+//# sourceMappingURL=topics.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.client.d.ts","sourceRoot":"","sources":["../../src/topics/topics.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEhG,qBAAa,YAAY;IACT,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAEnC;;;OAGG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAQxD;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IASvD;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAK9C;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IASnE;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAIpD"}

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

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

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

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

package/dist/topics/types/topics.types.d.ts

@@ -0,0 +1,65 @@
+import type { ConfigFieldDescriptor } from '../../plugins/types/plugins.types.js';
+/**
+ * What a break can be about: a news category, and later a weather location. The operator's own vocabulary, per sort of break
+ * generated from [Topic](../../../../../apps/api/data/contracts/topics/topics.types.ck#L8)
+ */
+export interface Topic {
+    id: string;
+    /** Which sort of break this is a subject for, as `segments.kind` spells it */
+    kind: string;
+    /** A stable slug, unique within its kind. What the format clock points a band at and what a seeded topic is recognised by */
+    key: string;
+    /** What a break calls it out loud, so it is the phrasing you would want to hear */
+    label: string;
+    /** This sort of break's own settings for this subject, in the fields its kind declares. Nothing generic reads them */
+    config: Record<string, unknown>;
+    /** Your own order, for the list. Two subjects never contest anything, so it means nothing else */
+    position: number;
+}
+export interface TopicInput {
+    /** Which sort of break this is a subject for, as `segments.kind` spells it */
+    kind: string;
+    /** A stable slug, unique within its kind. What the format clock points a band at and what a seeded topic is recognised by */
+    key: string;
+    /** What a break calls it out loud, so it is the phrasing you would want to hear */
+    label: string;
+    /** This sort of break's own settings for this subject, in the fields its kind declares. Nothing generic reads them */
+    config: Record<string, unknown>;
+    /** Your own order, for the list. Two subjects never contest anything, so it means nothing else */
+    position: number;
+}
+/**
+ * A sort of break that has subjects at all, and how one of its subjects is edited. `ConfigFieldDescriptor` is the plugins area's, shared for the reason a station setting shares it: one form component renders them all
+ * generated from [TopicKindDescriptor](../../../../../apps/api/data/contracts/topics/topics.types.ck#L22)
+ */
+export interface TopicKindDescriptor {
+    kind: string;
+    /** What to call one of these: a news subject is a category and a weather subject is a location */
+    nounOne: string;
+    nounMany: string;
+    description: string;
+    fields: ConfigFieldDescriptor[];
+}
+/**
+ * generated from [TopicQuery](../../../../../apps/api/data/contracts/topics/topics.types.ck#L34)
+ */
+export interface TopicQuery {
+    /** One sort of break, or absent for every subject this station has named */
+    kind?: string;
+}
+/**
+ * generated from [TopicList](../../../../../apps/api/data/contracts/topics/topics.types.ck#L17)
+ */
+export interface TopicList {
+    topics: Topic[];
+}
+export interface TopicListInput {
+    topics: TopicInput[];
+}
+/**
+ * generated from [TopicKindList](../../../../../apps/api/data/contracts/topics/topics.types.ck#L30)
+ */
+export interface TopicKindList {
+    kinds: TopicKindDescriptor[];
+}
+//# sourceMappingURL=topics.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.types.d.ts","sourceRoot":"","sources":["../../../src/topics/types/topics.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF;;;GAGG;AACH,MAAM,WAAW,KAAK;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,6HAA6H;IAC7H,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,sHAAsH;IACtH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kGAAkG;IAClG,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,6HAA6H;IAC7H,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,sHAAsH;IACtH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kGAAkG;IAClG,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAChC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@deadair/sdk",
+  "version": "0.7.0",
+  "description": "A typed client for the deadair station's HTTP API, generated from the same contracts the station serves.",
+  "keywords": [
+    "deadair",
+    "radio",
+    "sdk",
+    "client"
+  ],
+  "homepage": "https://deadair.radio/docs/api-reference",
+  "bugs": {
+    "url": "https://github.com/robert-dean/deadair/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robert-dean/deadair.git",
+    "directory": "packages/sdk"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "dist/**",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@types/luxon": "^3.7.3",
+    "decimal.js": "^10.6.0",
+    "luxon": "^3.7.2"
+  },
+  "devDependencies": {
+    "@repo/config-eslint": "0.0.0",
+    "@repo/config-typescript": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --sourcemap && tsc --emitDeclarationOnly --declaration",
+    "build:ci": "eslint --max-warnings=0 && pnpm run build",
+    "lint": "eslint --fix",
+    "format": "prettier --write . --ignore-path ../../.prettierignore"
+  }
+}