nixamp 0.34.0 → 0.36.0

package/src/station-metering.ts

@@ -0,0 +1,218 @@
+/**
+ * What stations cost to run, and the limits that keep one from costing
+ * everything.
+ *
+ * Counted where it is spent: every byte a station's link delivers and every
+ * second somebody is connected, per station, per calendar month, kept in
+ * `usage-<port>.json`. Restarts and files that would not play are counted
+ * too, because those are what an operator is asked about.
+ *
+ * Limits are the operator's (environment, below), and each is a refusal a
+ * person can act on, never a silent cut:
+ *
+ *   NIXAMP_STATION_MAX_LISTENERS   per station (default 200)
+ *   NIXAMP_MAX_LISTENERS           across every station (default 500)
+ *   NIXAMP_MAX_RUNNING_STATIONS    stations on the air at once (default 10)
+ *   NIXAMP_STATION_MONTHLY_GB      delivered per station per month (default 0: no allowance)
+ *
+ * When an allowance runs out the policy is "pause": nobody new is admitted
+ * until the month turns or the allowance is raised; nobody already
+ * listening is cut off mid-song. Control requests are limited separately
+ * (STATION_CONTROL_LIMIT) so that a flood of listeners never locks the owner
+ * out, and a flood of control requests never starves listeners.
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+export interface Limits {
+  stationListeners: number;
+  totalListeners: number;
+  runningStations: number;
+  /** Bytes per station per month; 0 is no allowance. */
+  monthlyBytes: number;
+}
+
+export function limitsFromEnv(env: Record<string, string | undefined> = process.env): Limits {
+  const whole = (name: string, fallback: number): number => {
+    const value = Number(env[name]);
+    return Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
+  };
+  return {
+    stationListeners: whole("NIXAMP_STATION_MAX_LISTENERS", 200),
+    totalListeners: whole("NIXAMP_MAX_LISTENERS", 500),
+    runningStations: whole("NIXAMP_MAX_RUNNING_STATIONS", 10),
+    monthlyBytes: Math.round(Number(env["NIXAMP_STATION_MONTHLY_GB"] ?? 0) * 1024 ** 3) || 0,
+  };
+}
+
+/** Station control: start, stop, edit, publish. Thirty a minute is a person. */
+export const STATION_CONTROL_LIMIT = { allowed: 30, windowMs: 60_000 };
+
+export interface MonthUsage {
+  bytes: number;
+  listenerSeconds: number;
+  peakListeners: number;
+  restarts: number;
+  failures: number;
+}
+
+const BLANK: MonthUsage = { bytes: 0, listenerSeconds: 0, peakListeners: 0, restarts: 0, failures: 0 };
+
+export function monthOf(at: number): string {
+  return new Date(at).toISOString().slice(0, 7);
+}
+
+export class StationUsage {
+  /** station -> month -> usage */
+  private usage: Record<string, Record<string, MonthUsage>> = {};
+  private live = new Map<string, Map<object, number>>();
+  private timer: ReturnType<typeof setTimeout> | null = null;
+
+  constructor(private readonly file: string, private readonly now: () => number = Date.now) {
+    try {
+      this.usage = JSON.parse(readFileSync(file, "utf8")) as typeof this.usage;
+    } catch {
+      this.usage = {};
+    }
+  }
+
+  static fileFor(stateDir: string, port: number): string {
+    return join(stateDir, `usage-${port}.json`);
+  }
+
+  private month(station: string, at = this.now()): MonthUsage {
+    const byMonth = (this.usage[station] ??= {});
+    return (byMonth[monthOf(at)] ??= { ...BLANK });
+  }
+
+  private touch(): void {
+    if (this.timer) return;
+    this.timer = setTimeout(() => this.flush(), 5_000);
+    this.timer.unref?.();
+  }
+
+  flush(): void {
+    if (this.timer) clearTimeout(this.timer);
+    this.timer = null;
+    // Listening still going on is counted up to now, then counted on from now.
+    const at = this.now();
+    for (const [station, listeners] of this.live) {
+      for (const [who, since] of listeners) {
+        this.month(station, at).listenerSeconds += Math.max(0, (at - since) / 1000);
+        listeners.set(who, at);
+      }
+    }
+    try {
+      mkdirSync(dirname(this.file), { recursive: true });
+      const temporary = `${this.file}.${process.pid}.tmp`;
+      writeFileSync(temporary, JSON.stringify(this.usage), { mode: 0o600 });
+      renameSync(temporary, this.file);
+    } catch {
+      // Counting is not a reason to stop serving.
+    }
+  }
+
+  /** Somebody started listening; returns what to call when they stop. */
+  joined(station: string): () => void {
+    const who = {};
+    let listeners = this.live.get(station);
+    if (!listeners) {
+      listeners = new Map();
+      this.live.set(station, listeners);
+    }
+    listeners.set(who, this.now());
+    const month = this.month(station);
+    month.peakListeners = Math.max(month.peakListeners, listeners.size);
+    this.touch();
+    return () => {
+      const since = listeners!.get(who);
+      if (since === undefined) return;
+      listeners!.delete(who);
+      this.month(station).listenerSeconds += Math.max(0, (this.now() - since) / 1000);
+      this.touch();
+    };
+  }
+
+  delivered(station: string, bytes: number): void {
+    this.month(station).bytes += bytes;
+    this.touch();
+  }
+
+  restarted(station: string): void {
+    this.month(station).restarts += 1;
+    this.touch();
+  }
+
+  failed(station: string): void {
+    this.month(station).failures += 1;
+    this.touch();
+  }
+
+  listeners(station: string): number {
+    return this.live.get(station)?.size ?? 0;
+  }
+
+  totalListeners(): number {
+    let total = 0;
+    for (const listeners of this.live.values()) total += listeners.size;
+    return total;
+  }
+
+  thisMonth(station: string): MonthUsage {
+    return { ...this.month(station) };
+  }
+
+  history(station: string): Record<string, MonthUsage> {
+    return { ...(this.usage[station] ?? {}) };
+  }
+
+  forget(station: string): void {
+    delete this.usage[station];
+    this.live.delete(station);
+    this.touch();
+  }
+
+  /**
+   * Whether one more listener may join this station now: null to go
+   * ahead, or why not, with a code and how long to wait.
+   */
+  admit(station: string, limits: Limits): { code: string; error: string; status: number; retryAfter: number } | null {
+    if (limits.monthlyBytes > 0 && this.month(station).bytes >= limits.monthlyBytes) {
+      const now = new Date(this.now());
+      const next = Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1);
+      return { code: "allowance_exhausted", error: "this station has used its delivery allowance for the month", status: 429, retryAfter: Math.ceil((next - this.now()) / 1000) };
+    }
+    if (limits.stationListeners > 0 && this.listeners(station) >= limits.stationListeners) {
+      return { code: "station_full", error: "this station is full; try again in a little while", status: 503, retryAfter: 60 };
+    }
+    if (limits.totalListeners > 0 && this.totalListeners() >= limits.totalListeners) {
+      return { code: "server_full", error: "this server is carrying as many listeners as it can; try again in a little while", status: 503, retryAfter: 60 };
+    }
+    return null;
+  }
+}
+
+/** Things an owner should know about a station, in words. */
+export function alertsFor(
+  station: { desired: string; failures: Record<string, number> },
+  state: string,
+  offlineSince: number,
+  usage: MonthUsage,
+  limits: Limits,
+  now = Date.now(),
+): string[] {
+  const alerts: string[] = [];
+  if (station.desired === "running" && (state === "offline" || state === "recovering") && offlineSince > 0) {
+    const minutes = Math.floor((now - offlineSince) / 60_000);
+    if (minutes >= 2) alerts.push(`Off the air for ${minutes} minutes while it should be running.`);
+  }
+  const left = Object.values(station.failures).filter((count) => count >= 3).length;
+  if (left > 0) alerts.push(`${left} file${left === 1 ? " is" : "s are"} left out because ${left === 1 ? "it" : "they"} would not play.`);
+  if (usage.restarts >= 5) alerts.push(`Restarted ${usage.restarts} times this month: something keeps stopping it.`);
+  if (limits.monthlyBytes > 0) {
+    const share = usage.bytes / limits.monthlyBytes;
+    if (share >= 1) alerts.push("The delivery allowance for this month is used up: nobody new can join until it resets.");
+    else if (share >= 0.9) alerts.push(`${Math.round(share * 100)}% of this month's delivery allowance is used.`);
+  }
+  return alerts;
+}

package/src/station-page.ts

@@ -30,6 +30,7 @@ button:focus-visible,input:focus-visible,a:focus-visible{outline:3px solid var(-
 label{display:flex;align-items:center;gap:8px;color:var(--muted);font-size:.9rem}
 input[type=range]{width:120px;accent-color:var(--accent)}
 .small{margin-top:20px;font-size:.85rem;color:var(--muted)}.small a{color:inherit}
+.screen{display:block;width:100%;aspect-ratio:16/9;background:#000;border-radius:10px;margin:12px 0}
 .sr{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
 @media (prefers-reduced-motion:no-preference){.live::before{animation:pulse 2s ease-in-out infinite}}
 @keyframes pulse{50%{opacity:.35}}
@@ -42,13 +43,29 @@ const SCRIPT = `
   const q = "?t=" + encodeURIComponent(token);
   const api = "/api/v1/stations/" + encodeURIComponent(id);
   const $ = (s) => document.querySelector(s);
-  const audio = new Audio();
+  // Sound, or a TV station's picture: the element is chosen by the first state.
+  let audio = new Audio();
   audio.preload = "none";
+  let wired = false;
+  const wire = () => {
+    if (wired) return;
+    wired = true;
+    audio.addEventListener("playing", () => { if (retry) say("Back on"); retry = 0; if (last) draw(last); });
+    audio.addEventListener("error", again);
+    audio.addEventListener("ended", again);
+    audio.addEventListener("stalled", () => { if (wanted && audio.readyState < 3) again(); });
+  };
   let wanted = false, retry = 0, timer = 0, last = null, live = false;
   const chip = (state, text) => { const c = $("#state"); c.className = "chip " + state; c.textContent = text; };
   const say = (text) => { $("#announce").textContent = text; };
   const draw = (s) => {
     last = s;
+    if (s.kind === "video" && audio.tagName !== "VIDEO") {
+      audio = $("#screen");
+      audio.hidden = false;
+      wired = false;
+      wire();
+    }
     document.title = s.name + " · nixamp";
     $("#name").textContent = s.name;
     $("#about").textContent = s.description || "";
@@ -102,10 +119,7 @@ const SCRIPT = `
     clearTimeout(timer);
     timer = setTimeout(join, Math.min(15000, 1000 * 2 ** Math.min(retry, 4)));
   };
-  audio.addEventListener("playing", () => { if (retry) say("Back on"); retry = 0; if (last) draw(last); });
-  audio.addEventListener("error", again);
-  audio.addEventListener("ended", again);
-  audio.addEventListener("stalled", () => { if (wanted && audio.readyState < 3) again(); });
+  wire();
   $("#play").addEventListener("click", () => { if (wanted) { stop(); say("Stopped"); } else { wanted = true; retry = 0; button(); join(); say("Playing"); } });
   $("#volume").addEventListener("input", (e) => { audio.volume = Number(e.target.value); });
   poll();
@@ -130,6 +144,7 @@ const PAGE = `<!doctype html>
 <main>
   <div class="card">
     <span id="state" class="chip unavailable" role="status">Loading</span>
+    <video id="screen" class="screen" playsinline preload="none" hidden></video>
     <h1 id="name">&nbsp;</h1>
     <p id="about" class="about" hidden></p>
     <div class="now" aria-live="polite"><div id="title" class="title"></div><div id="by" class="by"></div></div>

package/src/station-routes.ts

@@ -15,6 +15,7 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { Channels } from "./channels.ts";
 import type { StationRunner } from "./station-runner.ts";
+import { alertsFor, type Limits, type StationUsage } from "./station-metering.ts";
 import {
   StationError, channelOf, tokensMatch, type OwnerStation, type PublicStation, type Station, type StationStore,
 } from "./stations.ts";
@@ -24,7 +25,7 @@ const LISTEN = /^\/api\/v1\/stations\/([a-z0-9]{10})\/(stream|state|listen\.m3u|
 
 /** Whether this path is one a station's own link may open, without the server's key. */
 export function isStationListenPath(path: string): boolean {
-  return LISTEN.test(path);
+  return LISTEN.test(path) || path === "/api/v1/stations/guide";
 }
 
 export interface StationContext {
@@ -45,6 +46,13 @@ export interface StationContext {
   readBody: (request: IncomingMessage) => Promise<string>;
   /** Headers every answer carries (CORS). */
   headers: Record<string, string>;
+  /** Metering and limits; absent in tests that do not care. */
+  usage?: StationUsage;
+  limits?: Limits;
+  /** Null to go ahead with a change, or how long to wait (control rate limit). */
+  throttle?: () => { retryAfter: number } | null;
+  /** Auto stations: run a sync with these settings (and keep them), or read them. */
+  auto?: { sync: (input: Record<string, unknown>) => Promise<unknown>; setting: () => unknown };
 }
 
 function fail(ctx: StationContext, response: ServerResponse, error: unknown): void {
@@ -86,7 +94,10 @@ export function publicView(ctx: StationContext, station: Station): PublicStation
     state,
     // Tags, or nothing: a bare file name is the owner's, not the public's.
     nowPlaying: track && (track.title || track.artist) ? track : null,
-    format: state === "stopped" || state === "offline" ? null : { codec: "mp3", bitrateKbps: station.bitrate, sampleRate: 48_000, channels: 2 },
+    kind: station.video ? "video" : "audio",
+    format: state === "stopped" || state === "offline" ? null : station.video
+      ? { codec: "h264+aac", bitrateKbps: station.bitrate, sampleRate: 48_000, channels: 2 }
+      : { codec: "mp3", bitrateKbps: station.bitrate, sampleRate: 48_000, channels: 2 },
     listeners: ctx.runner.listeners(station.id),
   };
 }
@@ -101,6 +112,10 @@ export function ownerView(ctx: StationContext, station: Station): OwnerStation &
     error: ctx.runner.error(station.id),
     links: links(ctx, station),
     nowPlaying: nowPlayingFile(ctx, station),
+    ...(ctx.usage && ctx.limits ? {
+      metrics: { listeners: ctx.usage.listeners(station.id), month: ctx.usage.thisMonth(station.id), limits: ctx.limits },
+      alerts: alertsFor(station, ctx.runner.observed(station.id), ctx.runner.downSince(station.id), ctx.usage.thisMonth(station.id), ctx.limits),
+    } : {}),
   };
 }
 
@@ -115,6 +130,16 @@ export async function handleStations(
   if (path !== "/api/v1/stations" && !path.startsWith("/api/v1/stations/")) return false;
   const method = request.method ?? "GET";
 
+  // The public guide: only stations their owner made public and listed, with
+  // their links, because public is what that means. Nothing else, ever.
+  if (path === "/api/v1/stations/guide" && (method === "GET" || method === "HEAD")) {
+    const listed = ctx.store.list().filter((one) => one.visibility === "public" && one.listed);
+    ctx.json(response, 200, {
+      stations: listed.map((one) => ({ ...publicView(ctx, one), page: links(ctx, one).page, m3u: links(ctx, one).m3u })),
+    });
+    return true;
+  }
+
   const listen = LISTEN.exec(path);
   if (listen) {
     const station = ctx.store.get(listen[1]!);
@@ -204,20 +229,45 @@ export async function handleStations(
       ctx.json(response, 503, { error: "the station is not on the air", code: "not_live", state: ctx.runner.observed(station.id) });
       return true;
     }
+    // Admitted only within the station's and the server's limits, and the
+    // month's allowance; refused with what to do about it.
+    const refused = method === "GET" && ctx.usage && ctx.limits ? ctx.usage.admit(station.id, ctx.limits) : null;
+    if (refused) {
+      response.writeHead(refused.status, { ...ctx.headers, "content-type": "application/json; charset=utf-8", "retry-after": String(refused.retryAfter) });
+      response.end(JSON.stringify({ error: refused.error, code: refused.code, retryAfter: refused.retryAfter }));
+      return true;
+    }
     response.writeHead(200, { ...ctx.headers, "content-type": ctx.channels.contentType(channelId), "cache-control": "no-store" });
     if (method === "HEAD") {
       response.end();
       return true;
     }
-    const detach = ctx.channels.listen(channelId, response);
+    // Every byte that goes out through the link is counted against the station.
+    const usage = ctx.usage;
+    const counted = usage
+      ? {
+          write: (chunk: Buffer): boolean => {
+            usage.delivered(station.id, chunk.length);
+            return response.write(chunk);
+          },
+          end: (): void => { response.end(); },
+          pending: (): number => response.writableLength,
+        }
+      : response;
+    const detach = ctx.channels.listen(channelId, counted);
     if (detach === null) {
       response.end();
       return true;
     }
+    const left = usage?.joined(station.id);
     const untrack = ctx.runner.track(station.id, { end: () => response.destroy() });
+    let gone = false;
     const leave = (): void => {
+      if (gone) return;
+      gone = true;
       detach();
       untrack();
+      left?.();
     };
     request.on("close", leave);
     response.on("close", leave);
@@ -229,6 +279,15 @@ export async function handleStations(
     ctx.json(response, 403, { error: "only this server's owner manages its stations", code: "forbidden" });
     return true;
   }
+  // Changes are limited apart from listening, so neither starves the other.
+  if (method !== "GET" && ctx.throttle) {
+    const wait = ctx.throttle();
+    if (wait) {
+      response.setHeader("retry-after", String(wait.retryAfter));
+      ctx.json(response, 429, { error: "too many changes at once; wait a moment", code: "rate_limited", retryAfter: wait.retryAfter });
+      return true;
+    }
+  }
 
   const body = async (): Promise<Record<string, unknown>> => {
     if (method === "GET" || method === "DELETE") return {};
@@ -271,6 +330,23 @@ export async function handleStations(
       return true;
     }
 
+    if (path === "/api/v1/stations/auto") {
+      if (!ctx.auto) {
+        ctx.json(response, 404, { error: "auto stations are not available here", code: "not_found" });
+        return true;
+      }
+      if (method === "GET") {
+        ctx.json(response, 200, { setting: ctx.auto.setting() });
+        return true;
+      }
+      if (method === "POST") {
+        ctx.json(response, 200, { report: await ctx.auto.sync(await body()) });
+        return true;
+      }
+      ctx.json(response, 405, { error: "GET or POST", code: "method_not_allowed" });
+      return true;
+    }
+
     const match = /^\/api\/v1\/stations\/([a-z0-9]{10})(?:\/([a-z-]+))?$/.exec(path);
     if (!match) {
       ctx.json(response, 404, { error: "no such station", code: "not_found" });
@@ -305,11 +381,30 @@ export async function handleStations(
       return true;
     }
 
+    if (action === "metrics" && method === "GET") {
+      if (!ctx.usage || !ctx.limits) {
+        ctx.json(response, 404, { error: "metering is off on this server", code: "not_found" });
+        return true;
+      }
+      ctx.json(response, 200, {
+        listeners: ctx.usage.listeners(station.id),
+        month: ctx.usage.thisMonth(station.id),
+        history: ctx.usage.history(station.id),
+        limits: ctx.limits,
+        alerts: alertsFor(station, ctx.runner.observed(station.id), ctx.runner.downSince(station.id), ctx.usage.thisMonth(station.id), ctx.limits),
+      });
+      return true;
+    }
     if (method !== "POST") {
       ctx.json(response, 405, { error: "POST", code: "method_not_allowed" });
       return true;
     }
     if (action === "start") {
+      const running = ctx.store.list().filter((one) => one.desired === "running" && one.id !== id).length;
+      if (ctx.limits && ctx.limits.runningStations > 0 && running >= ctx.limits.runningStations) {
+        ctx.json(response, 409, { error: `this server runs at most ${ctx.limits.runningStations} stations at once; stop one first`, code: "too_many_running" });
+        return true;
+      }
       const started = await ctx.runner.start(id);
       ctx.json(response, 200, { station: ownerView(ctx, started) });
       return true;

package/src/station-runner.ts

@@ -24,6 +24,11 @@ export interface RunnerDeps {
   roots: () => string[];
   log?: (line: string) => void;
   now?: () => number;
+  /** Told when a station is restarted after an unexpected end, and when a file will not play. */
+  onRestart?: (id: string) => void;
+  onFailure?: (id: string) => void;
+  /** A file for a break on a radio (false) or TV (true) station, or null for none. */
+  breaks?: (video: boolean) => Promise<string | null>;
 }
 
 /** Something a listener is connected through, that can be ended. */
@@ -42,6 +47,8 @@ export class StationRunner {
   private starting = new Set<string>();
   private errors = new Map<string, string>();
   private listening = new Map<string, Set<Ending>>();
+  /** When a station that should be on went off, for "off the air for N minutes". */
+  private down = new Map<string, number>();
 
   constructor(private readonly deps: RunnerDeps) {}
 
@@ -76,6 +83,7 @@ export class StationRunner {
   /** Wanted off, and taken off. Stays off across restarts. */
   stop(id: string): Station {
     const station = this.deps.store.setDesired(id, "stopped", this.now());
+    this.down.delete(id);
     this.cancelRecovery(id);
     this.attempts.delete(id);
     this.errors.delete(id);
@@ -137,8 +145,12 @@ export class StationRunner {
             return now ? this.playable(now) : [];
           },
           excluded: (file) => store.isExcluded(id, file),
+          ...(station.breaksEvery > 0 && this.deps.breaks
+            ? { breaks: { everySeconds: station.breaksEvery, next: () => this.deps.breaks!(station.video) } }
+            : {}),
           onFailure: ({ file, reason }) => {
             this.errors.set(id, reason);
+            this.deps.onFailure?.(id);
             if (store.recordFailure(id, file)) {
               this.log(`  Station "${station.name}": left out a file that failed ${EXCLUDE_AFTER} times.`);
             }
@@ -151,6 +163,7 @@ export class StationRunner {
         return false;
       }
       this.startedAt.set(id, this.now());
+      this.down.delete(id);
       this.deps.channels.keep(channelId);
       return true;
     } catch (error) {
@@ -176,6 +189,8 @@ export class StationRunner {
       this.errors.delete(id);
       return;
     }
+    if (!this.down.has(id)) this.down.set(id, this.now());
+    this.deps.onRestart?.(id);
     const ran = this.now() - (this.startedAt.get(id) ?? 0);
     if (ran >= HEALTHY_RUN_MS) this.attempts.delete(id);
     this.errors.set(id, info.error || "the station stopped");
@@ -211,6 +226,11 @@ export class StationRunner {
     return (this.attempts.get(id) ?? 0) <= RECOVERY_DELAYS_MS.length && this.timers.has(id) ? "recovering" : "offline";
   }
 
+  /** When it went off while wanted, or 0 when it is not off. */
+  downSince(id: string): number {
+    return this.down.get(id) ?? 0;
+  }
+
   error(id: string): string {
     return this.errors.get(id) ?? "";
   }

package/src/station-usage.ts

@@ -13,6 +13,8 @@ export const USAGE = `nixamp station — make a collection into a station
   nixamp station unpublish ID [--private]
   nixamp station link ID [--rotate]
   nixamp station delete ID
+  nixamp station auto [--no-video] [--min 10] [--films 3] [--tv 2] [--breaks 600] [--no-start]
+                     a station per genre, kept in step with the library (--off stops it)
 
   --json        machine-readable output
   --url, --key  another server, as with \`nixamp admin\`

package/src/stations.ts

@@ -54,6 +54,12 @@ export interface Station {
   listenToken: string;
   /** Audio bitrate of the station's rendition, in kbps. */
   bitrate: number;
+  /** A TV station: pictures as well as sound. */
+  video: boolean;
+  /** A break (advert or ident) at most this often, in seconds; 0 for none. */
+  breaksEvery: number;
+  /** Made and kept up to date by auto stations (e.g. "genre:audio:rock"); "" for one a person made. */
+  auto: string;
   rights: Rights | null;
   /** nixamp.com account that made it, "" when made with the control key. */
   owner: string;
@@ -131,6 +137,8 @@ export interface StationInput {
   shuffle?: unknown;
   repeat?: unknown;
   bitrate?: unknown;
+  video?: unknown;
+  breaksEvery?: unknown;
 }
 
 function text(value: unknown, max: number, field: string): string {
@@ -168,6 +176,9 @@ export class StationStore {
             owner: one.owner ?? "",
             description: one.description ?? "",
             idempotencyKey: one.idempotencyKey ?? "",
+            video: one.video ?? false,
+            breaksEvery: one.breaksEvery ?? 0,
+            auto: one.auto ?? "",
           });
         }
       }
@@ -217,6 +228,9 @@ export class StationStore {
       desired: "stopped",
       listenToken: newToken(),
       bitrate: this.bitrateFrom(input.bitrate),
+      video: input.video === true,
+      breaksEvery: this.breaksFrom(input.breaksEvery),
+      auto: "",
       rights: null,
       owner,
       failures: {},
@@ -229,6 +243,26 @@ export class StationStore {
     return station;
   }
 
+  private breaksFrom(value: unknown): number {
+    if (value === undefined || value === null || value === 0) return 0;
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 120 || value > 86_400) {
+      throw new StationError("invalid_breaks", "breaksEvery is seconds between breaks, from 120 to 86400, or 0 for none");
+    }
+    return value;
+  }
+
+  /** Mark a station as made by auto stations, so a later sync updates it rather than making another. */
+  markAuto(id: string, key: string): Station {
+    const station = this.require(id);
+    station.auto = key;
+    this.save();
+    return station;
+  }
+
+  byAuto(key: string): Station | undefined {
+    return [...this.stations.values()].find((one) => one.auto === key);
+  }
+
   private bitrateFrom(value: unknown): number {
     if (value === undefined) return DEFAULT_BITRATE;
     if (typeof value !== "number" || !BITRATES.includes(value)) {
@@ -249,6 +283,7 @@ export class StationStore {
     if (input.shuffle !== undefined) station.shuffle = input.shuffle === true;
     if (input.repeat !== undefined) station.repeat = input.repeat !== false;
     if (input.bitrate !== undefined) station.bitrate = this.bitrateFrom(input.bitrate);
+    if (input.breaksEvery !== undefined) station.breaksEvery = this.breaksFrom(input.breaksEvery);
     if (items !== null) {
       if (items.length === 0) throw new StationError("empty_station", "a station needs at least one file that plays");
       if (items.length > MAX_ITEMS) throw new StationError("too_many_items", `a station holds at most ${MAX_ITEMS} files`);
@@ -393,6 +428,8 @@ export interface PublicStation {
   description: string;
   visibility: Visibility;
   state: Observed;
+  /** Radio or TV. */
+  kind: "audio" | "video";
   nowPlaying: { title: string; artist: string; album: string } | null;
   format: { codec: string; bitrateKbps: number; sampleRate: number; channels: number } | null;
   listeners: number;

package/web/dist/assets/{ar-DoW0wbjC.js → ar-Ck-FmDpQ.js}

@@ -1 +1 @@
-import{n as e}from"./main-Y1Rvn1GX.js";var t={...e,"No parties live right now.":`لا توجد جلسات مباشرة الآن.`,"Could not refresh parties.":`تعذر تحديث الجلسات.`,"Pick a server in the directory, or paste its link here.":`اختر خادمًا من الدليل أو الصق رابطه هنا.`,"Interface language":`لغة الواجهة`,Language:`اللغة`,"Translation language":`لغة الترجمة`,"Original (auto-detect)":`الأصل (اكتشاف تلقائي)`,Play:`تشغيل`,Pause:`إيقاف مؤقت`,Stop:`إيقاف`,Next:`التالي`,Previous:`السابق`,Select:`اختيار`,"Next/Prev":`التالي/السابق`,Quit:`خروج`,"Now Playing":`قيد التشغيل`,"Spectrum Analyser":`محلل الطيف`,Playlist:`قائمة التشغيل`,Files:`الملفات`,"Open files":`فتح ملفات`,"Open folder":`فتح مجلد`,"Add to library":`إضافة إلى المكتبة`,"Replace playlist":`استبدال قائمة التشغيل`,Filter:`تصفية`,Search:`بحث`,"Nothing loaded.":`لم يُحمّل أي محتوى.`,"Empty.":`فارغ.`,"Loading…":`جارٍ التحميل…`,"Connecting…":`جارٍ الاتصال…`,Connected:`متصل`,"Not connected":`غير متصل`,"No source":`لا يوجد مصدر`,Playing:`يعمل`,Stopped:`متوقف`,Volume:`مستوى الصوت`,Seek:`موضع التشغيل`,"Full screen":`ملء الشاشة`,Download:`تنزيل`,Share:`مشاركة`,Copy:`نسخ`,"Copy link":`نسخ الرابط`,Copied:`تم النسخ`,Save:`حفظ`,Cancel:`إلغاء`,Close:`إغلاق`,Remove:`إزالة`,Delete:`حذف`,Edit:`تعديل`,Add:`إضافة`,Send:`إرسال`,Retry:`إعادة المحاولة`,Back:`رجوع`,"Next page":`الصفحة التالية`,"Previous page":`الصفحة السابقة`,"Show more":`عرض المزيد`,Panels:`اللوحات`,"Reset layout":`إعادة ضبط التخطيط`,Show:`إظهار`,Hide:`إخفاء`,Collapse:`طي`,Expand:`توسيع`,"Move up":`نقل لأعلى`,"Move down":`نقل لأسفل`,Install:`تثبيت`,"TV mode":`وضع التلفاز`,On:`مفعّل`,Off:`معطّل`,Account:`الحساب`,"Sign in":`تسجيل الدخول`,"Sign out":`تسجيل الخروج`,"Create account":`إنشاء حساب`,Email:`البريد الإلكتروني`,Password:`كلمة المرور`,"Forgot password?":`نسيت كلمة المرور؟`,"Welcome back":`مرحبًا بعودتك`,Profile:`الملف الشخصي`,Handle:`اسم المستخدم`,"Your servers":`خوادمك`,Server:`الخادم`,Connect:`اتصال`,Disconnect:`قطع الاتصال`,Directory:`الدليل`,Favourites:`المفضلة`,Follow:`متابعة`,Unfollow:`إلغاء المتابعة`,Notifications:`الإشعارات`,"Phone number":`رقم الهاتف`,"Save number":`حفظ الرقم`,Transcript:`النص المفرغ`,Captions:`الترجمة النصية`,"Translate audio":`ترجمة الصوت`,"Audio language":`لغة الصوت`,"Audio options":`خيارات الصوت`,"Keep background sound":`الاحتفاظ بأصوات الخلفية`,"Background level":`مستوى صوت الخلفية`,"Speaker voices":`أصوات المتحدثين`,"Any voice":`أي صوت`,"Male voice":`صوت رجالي`,"Female voice":`صوت نسائي`,"Original audio.":`الصوت الأصلي.`,"Buy translated audio":`شراء الصوت المترجم`,"Audio credit":`رصيد الصوت`,"Buy pass":`شراء تصريح`,Pass:`تصريح`,"Pay with":`الدفع باستخدام`,"Check payment":`التحقق من الدفع`,"Open checkout":`الانتقال للدفع`,"Free sessions":`جلسات مجانية`,"Usage rates and expiry":`الأسعار ومدة الصلاحية`,Catalogs:`الكتالوجات`,"Add catalog":`إضافة كتالوج`,"Catalog name":`اسم الكتالوج`,Link:`الرابط`,"Play link":`تشغيل الرابط`,"Go live":`بدء بث مباشر`,Publish:`نشر`,Listen:`استماع`,"Live now":`مباشر الآن`,Upcoming:`قريبًا`,Parties:`حفلات المشاهدة`,"Join party":`الانضمام للحفلة`,"Invite code":`رمز الدعوة`,Invite:`دعوة`,Chat:`الدردشة`,"Chat message":`رسالة دردشة`,People:`الأشخاص`,Speaker:`متحدث`,Speakers:`المتحدثون`,Listener:`مستمع`,Moderator:`مشرف`,"Raise hand":`رفع اليد`,"Hand raises":`الأيدي المرفوعة`,Questions:`الأسئلة`,Resources:`الموارد`,Replay:`إعادة العرض`,Schedule:`الجدول`,Event:`الفعالية`,Host:`المضيف`,About:`حول`,Stage:`المنصة`,Title:`العنوان`,Description:`الوصف`,Topic:`الموضوع`,Public:`عام`,"Anyone with the link":`أي شخص لديه الرابط`,"Invited people":`الأشخاص المدعوون`,"Who can join":`من يمكنه الانضمام`,"Date and time":`التاريخ والوقت`,"Expected length":`المدة المتوقعة`,Repeat:`تكرار`,"Does not repeat":`لا يتكرر`,"Every day":`كل يوم`,"Every week":`كل أسبوع`,Homepage:`الموقع الإلكتروني`,"Host name":`اسم المضيف`,"Profile photo URL":`رابط صورة الملف الشخصي`,"Broadcast link":`رابط البث`,"Edit event":`تعديل الفعالية`,"Save changes":`حفظ التغييرات`,"Create live":`إنشاء بث مباشر`,"Schedule class":`جدولة درس`,"Start class":`بدء الدرس`,"End event":`إنهاء الفعالية`,"End session":`إنهاء الجلسة`,"Session ended":`انتهت الجلسة`,"Event ended":`انتهت الفعالية`,Cancelled:`ملغاة`,"Replay available":`إعادة العرض متاحة`,Join:`انضمام`,"Create invite":`إنشاء دعوة`,"Invite as":`الدعوة بصفة`,"Watch now":`شاهد الآن`,"Start a room":`إنشاء غرفة`,"Recent replays":`إعادات العرض الأخيرة`,"Your account":`حسابك`,"Write with AI":`الكتابة بالذكاء الاصطناعي`,"Suggested title":`العنوان المقترح`,"Suggested description":`الوصف المقترح`,"Suggested topic":`الموضوع المقترح`,"Use these details":`استخدام هذه التفاصيل`,"Learn something live.":`تعلّم شيئًا مباشرة.`,"Screen share":`مشاركة الشاشة`,"Upload and broadcast":`رفع وبث`,Help:`مساعدة`,"Reload Player":`إعادة تحميل المشغل`,"Copy Bundled CLI Path":`نسخ مسار أداة سطر الأوامر المضمنة`,"Developer tools":`أدوات المطور`,Undo:`تراجع`,Redo:`إعادة`,Cut:`قص`,Paste:`لصق`,"Select all":`تحديد الكل`,Status:`الحالة`,"Activity log":`سجل النشاط`,Admin:`الإدارة`,"Playback controls":`عناصر التحكم بالتشغيل`,"Tracks and folders":`المقاطع والمجلدات`,"Original-language captions.":`ترجمة نصية باللغة الأصلية.`,"Skip to playback controls":`الانتقال إلى عناصر التحكم بالتشغيل`,"Skip to playlist":`الانتقال إلى قائمة التشغيل`,"Skip to transcript and translated audio":`الانتقال إلى النص المفرغ والصوت المترجم`};export{t as default};
+import{n as e}from"./main-C1ggd2H7.js";var t={...e,"No parties live right now.":`لا توجد جلسات مباشرة الآن.`,"Could not refresh parties.":`تعذر تحديث الجلسات.`,"Pick a server in the directory, or paste its link here.":`اختر خادمًا من الدليل أو الصق رابطه هنا.`,"Interface language":`لغة الواجهة`,Language:`اللغة`,"Translation language":`لغة الترجمة`,"Original (auto-detect)":`الأصل (اكتشاف تلقائي)`,Play:`تشغيل`,Pause:`إيقاف مؤقت`,Stop:`إيقاف`,Next:`التالي`,Previous:`السابق`,Select:`اختيار`,"Next/Prev":`التالي/السابق`,Quit:`خروج`,"Now Playing":`قيد التشغيل`,"Spectrum Analyser":`محلل الطيف`,Playlist:`قائمة التشغيل`,Files:`الملفات`,"Open files":`فتح ملفات`,"Open folder":`فتح مجلد`,"Add to library":`إضافة إلى المكتبة`,"Replace playlist":`استبدال قائمة التشغيل`,Filter:`تصفية`,Search:`بحث`,"Nothing loaded.":`لم يُحمّل أي محتوى.`,"Empty.":`فارغ.`,"Loading…":`جارٍ التحميل…`,"Connecting…":`جارٍ الاتصال…`,Connected:`متصل`,"Not connected":`غير متصل`,"No source":`لا يوجد مصدر`,Playing:`يعمل`,Stopped:`متوقف`,Volume:`مستوى الصوت`,Seek:`موضع التشغيل`,"Full screen":`ملء الشاشة`,Download:`تنزيل`,Share:`مشاركة`,Copy:`نسخ`,"Copy link":`نسخ الرابط`,Copied:`تم النسخ`,Save:`حفظ`,Cancel:`إلغاء`,Close:`إغلاق`,Remove:`إزالة`,Delete:`حذف`,Edit:`تعديل`,Add:`إضافة`,Send:`إرسال`,Retry:`إعادة المحاولة`,Back:`رجوع`,"Next page":`الصفحة التالية`,"Previous page":`الصفحة السابقة`,"Show more":`عرض المزيد`,Panels:`اللوحات`,"Reset layout":`إعادة ضبط التخطيط`,Show:`إظهار`,Hide:`إخفاء`,Collapse:`طي`,Expand:`توسيع`,"Move up":`نقل لأعلى`,"Move down":`نقل لأسفل`,Install:`تثبيت`,"TV mode":`وضع التلفاز`,On:`مفعّل`,Off:`معطّل`,Account:`الحساب`,"Sign in":`تسجيل الدخول`,"Sign out":`تسجيل الخروج`,"Create account":`إنشاء حساب`,Email:`البريد الإلكتروني`,Password:`كلمة المرور`,"Forgot password?":`نسيت كلمة المرور؟`,"Welcome back":`مرحبًا بعودتك`,Profile:`الملف الشخصي`,Handle:`اسم المستخدم`,"Your servers":`خوادمك`,Server:`الخادم`,Connect:`اتصال`,Disconnect:`قطع الاتصال`,Directory:`الدليل`,Favourites:`المفضلة`,Follow:`متابعة`,Unfollow:`إلغاء المتابعة`,Notifications:`الإشعارات`,"Phone number":`رقم الهاتف`,"Save number":`حفظ الرقم`,Transcript:`النص المفرغ`,Captions:`الترجمة النصية`,"Translate audio":`ترجمة الصوت`,"Audio language":`لغة الصوت`,"Audio options":`خيارات الصوت`,"Keep background sound":`الاحتفاظ بأصوات الخلفية`,"Background level":`مستوى صوت الخلفية`,"Speaker voices":`أصوات المتحدثين`,"Any voice":`أي صوت`,"Male voice":`صوت رجالي`,"Female voice":`صوت نسائي`,"Original audio.":`الصوت الأصلي.`,"Buy translated audio":`شراء الصوت المترجم`,"Audio credit":`رصيد الصوت`,"Buy pass":`شراء تصريح`,Pass:`تصريح`,"Pay with":`الدفع باستخدام`,"Check payment":`التحقق من الدفع`,"Open checkout":`الانتقال للدفع`,"Free sessions":`جلسات مجانية`,"Usage rates and expiry":`الأسعار ومدة الصلاحية`,Catalogs:`الكتالوجات`,"Add catalog":`إضافة كتالوج`,"Catalog name":`اسم الكتالوج`,Link:`الرابط`,"Play link":`تشغيل الرابط`,"Go live":`بدء بث مباشر`,Publish:`نشر`,Listen:`استماع`,"Live now":`مباشر الآن`,Upcoming:`قريبًا`,Parties:`حفلات المشاهدة`,"Join party":`الانضمام للحفلة`,"Invite code":`رمز الدعوة`,Invite:`دعوة`,Chat:`الدردشة`,"Chat message":`رسالة دردشة`,People:`الأشخاص`,Speaker:`متحدث`,Speakers:`المتحدثون`,Listener:`مستمع`,Moderator:`مشرف`,"Raise hand":`رفع اليد`,"Hand raises":`الأيدي المرفوعة`,Questions:`الأسئلة`,Resources:`الموارد`,Replay:`إعادة العرض`,Schedule:`الجدول`,Event:`الفعالية`,Host:`المضيف`,About:`حول`,Stage:`المنصة`,Title:`العنوان`,Description:`الوصف`,Topic:`الموضوع`,Public:`عام`,"Anyone with the link":`أي شخص لديه الرابط`,"Invited people":`الأشخاص المدعوون`,"Who can join":`من يمكنه الانضمام`,"Date and time":`التاريخ والوقت`,"Expected length":`المدة المتوقعة`,Repeat:`تكرار`,"Does not repeat":`لا يتكرر`,"Every day":`كل يوم`,"Every week":`كل أسبوع`,Homepage:`الموقع الإلكتروني`,"Host name":`اسم المضيف`,"Profile photo URL":`رابط صورة الملف الشخصي`,"Broadcast link":`رابط البث`,"Edit event":`تعديل الفعالية`,"Save changes":`حفظ التغييرات`,"Create live":`إنشاء بث مباشر`,"Schedule class":`جدولة درس`,"Start class":`بدء الدرس`,"End event":`إنهاء الفعالية`,"End session":`إنهاء الجلسة`,"Session ended":`انتهت الجلسة`,"Event ended":`انتهت الفعالية`,Cancelled:`ملغاة`,"Replay available":`إعادة العرض متاحة`,Join:`انضمام`,"Create invite":`إنشاء دعوة`,"Invite as":`الدعوة بصفة`,"Watch now":`شاهد الآن`,"Start a room":`إنشاء غرفة`,"Recent replays":`إعادات العرض الأخيرة`,"Your account":`حسابك`,"Write with AI":`الكتابة بالذكاء الاصطناعي`,"Suggested title":`العنوان المقترح`,"Suggested description":`الوصف المقترح`,"Suggested topic":`الموضوع المقترح`,"Use these details":`استخدام هذه التفاصيل`,"Learn something live.":`تعلّم شيئًا مباشرة.`,"Screen share":`مشاركة الشاشة`,"Upload and broadcast":`رفع وبث`,Help:`مساعدة`,"Reload Player":`إعادة تحميل المشغل`,"Copy Bundled CLI Path":`نسخ مسار أداة سطر الأوامر المضمنة`,"Developer tools":`أدوات المطور`,Undo:`تراجع`,Redo:`إعادة`,Cut:`قص`,Paste:`لصق`,"Select all":`تحديد الكل`,Status:`الحالة`,"Activity log":`سجل النشاط`,Admin:`الإدارة`,"Playback controls":`عناصر التحكم بالتشغيل`,"Tracks and folders":`المقاطع والمجلدات`,"Original-language captions.":`ترجمة نصية باللغة الأصلية.`,"Skip to playback controls":`الانتقال إلى عناصر التحكم بالتشغيل`,"Skip to playlist":`الانتقال إلى قائمة التشغيل`,"Skip to transcript and translated audio":`الانتقال إلى النص المفرغ والصوت المترجم`};export{t as default};