@groovenet/player 0.1.3 → 0.1.5

package/build/server/observer.js

@@ -0,0 +1,47 @@
+import { unknownSpeaker } from "./manager.js";
+/** Exact attribute matches must identify one dedicated engine, never a shared host. */
+export function homeAssistantObserver(options) {
+    const transport = options.fetch ?? globalThis.fetch;
+    const cache = new Map();
+    return async (outputId, context) => {
+        const mappedEntity = (key) => options.entities && Object.hasOwn(options.entities, key) ? options.entities[key] : undefined;
+        let entity = mappedEntity(outputId);
+        if (!entity && Object.keys(options.entities ?? {}).length > 0) {
+            try {
+                const name = context?.outputName ?? await context?.resolveOutputName?.();
+                entity = name ? mappedEntity(name) : undefined;
+            }
+            catch { /* Discovery failure leaves the output unmapped. */ }
+        }
+        if (!options.url || !options.token || !entity)
+            return { ...unknownSpeaker(), entity_id: entity ?? null };
+        const cached = cache.get(entity);
+        if (!context?.fresh && cached && cached.until > Date.now())
+            return structuredClone(cached.value);
+        let value = { availability: "unknown", observed_at: null, source: "home_assistant", entity_id: entity, sender_identity: "unknown", sender_engine_id: null };
+        try {
+            const response = await transport(new URL(`api/states/${encodeURIComponent(entity)}`, options.url.endsWith("/") ? options.url : `${options.url}/`), { headers: { Authorization: `Bearer ${options.token}` }, signal: AbortSignal.timeout(2000), redirect: "error" });
+            if (response.ok) {
+                const body = await response.json();
+                if (body && typeof body === "object" && "state" in body && typeof body.state === "string") {
+                    const state = body.state.toLowerCase();
+                    const attributes = "attributes" in body && body.attributes && typeof body.attributes === "object" ? body.attributes : {};
+                    const senders = Object.entries(options.senders ?? {});
+                    const matches = senders.filter(([, expected]) => Object.keys(expected).length > 0 && Object.entries(expected).every(([key, expectedValue]) => Object.hasOwn(attributes, key) && attributes[key] === expectedValue));
+                    // Idle/unavailable metadata can outlive a session. Never identify it.
+                    if (["playing", "paused", "buffering"].includes(state)) {
+                        if (matches.length === 1)
+                            value = { ...value, sender_identity: "groovenet", sender_engine_id: matches[0][0] };
+                        else if (matches.length === 0 && senders.some(([, expected]) => Object.keys(expected).some(key => typeof attributes[key] === "string" && attributes[key] !== "")))
+                            value.sender_identity = "foreign";
+                    }
+                    value = { ...value, availability: ["unknown", "unavailable"].includes(state) ? "unknown" : ["idle", "off", "standby"].includes(state) ? "idle" : "occupied", observed_at: new Date().toISOString() };
+                }
+            }
+        }
+        catch { /* Missing/stale observation is unknown, never free. */ }
+        cache.set(entity, { until: Date.now() + 5000, value });
+        return structuredClone(value);
+    };
+}
+//# sourceMappingURL=observer.js.map

package/build/server/observer.js.map

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

package/build/server/runtime.d.ts

@@ -0,0 +1,18 @@
+import { ServerPlayerManager } from "./manager.js";
+import type { ServerPlay } from "./store.js";
+import { PostgresPlayerStore } from "./store.js";
+import type { Server } from "node:http";
+import type { EventEmitter } from "node:events";
+export declare function postServerPlay(appUrl: string, play: ServerPlay): Promise<void>;
+export declare function runPlayerWorker(env?: NodeJS.ProcessEnv, dependencies?: {
+    store?: PostgresPlayerStore;
+    manager?: ServerPlayerManager;
+    server?: Server;
+    signals?: EventEmitter;
+}): Promise<{
+    manager: ServerPlayerManager;
+    server: Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+    store: PostgresPlayerStore;
+    shutdown: () => Promise<void>;
+}>;
+//# sourceMappingURL=runtime.d.ts.map

package/build/server/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/server/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAsB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,YAAY,GAAE;IAAE,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAO;;;;oBAwB/K,OAAO,CAAC,IAAI,CAAC;GAwCnC"}

package/build/server/runtime.js

@@ -0,0 +1,101 @@
+import { Pool } from "pg";
+import { z } from "zod";
+import { OwnToneBackend } from "../ownToneBackend.js";
+import { playerIdSchema } from "@groovenet/contracts";
+import { ServerPlayerManager } from "./manager.js";
+import { PostgresPlayerStore } from "./store.js";
+import { homeAssistantObserver } from "./observer.js";
+import { playerHttpServer } from "./http.js";
+export async function postServerPlay(appUrl, play) {
+    const response = await fetch(new URL("/api/spins", appUrl), {
+        method: "POST", headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ friend_id: play.friendId, release_id: play.releaseId, medium: "digital", played_at: play.startedAt.toISOString(), context_type: "player", track_refs: [{ track_id: play.trackId, friend_id: play.friendId }] }),
+        signal: AbortSignal.timeout(5000),
+    });
+    if (response.ok)
+        return;
+    if (response.status === 409 && (await response.json()).error === "Digital play already logged")
+        return;
+    throw new Error(`Server play API returned ${response.status}`);
+}
+export async function runPlayerWorker(env = process.env, dependencies = {}) {
+    const connectionSchema = z.object({ apiUrl: z.url().refine((value) => { const url = new URL(value); return ["http:", "https:"].includes(url.protocol) && !url.username && !url.password && !url.search && !url.hash; }), libraryRoot: z.string().startsWith("/"), password: z.string().optional() }).strict();
+    const configured = z.record(playerIdSchema, connectionSchema).parse(JSON.parse(env.PLAYER_ENGINES_JSON ?? "{}"));
+    if (Object.keys(configured).length === 0)
+        throw new Error("PLAYER_ENGINES_JSON requires at least one dedicated engine");
+    const urls = Object.values(configured).map((engine) => new URL(engine.apiUrl).href.replace(/\/$/, ""));
+    if (new Set(urls).size !== urls.length)
+        throw new Error("Each player engine must have a different API URL");
+    const key = env.PLAYER_API_KEY ?? "";
+    if (key.length < 32)
+        throw new Error("PLAYER_API_KEY must contain at least 32 characters");
+    if (!env.DATABASE_URL)
+        throw new Error("DATABASE_URL is required");
+    const ownerFriendId = z.coerce.number().int().positive().parse(env.PLAYER_LIBRARY_FRIEND_ID);
+    const appUrl = z.url().parse(env.PLAYER_APP_URL ?? "http://app:3000");
+    const engines = Object.fromEntries(Object.entries(configured).map(([id, options]) => [id, { libraryRoot: options.libraryRoot, create: (outputId) => new OwnToneBackend({ apiUrl: options.apiUrl, password: options.password, outputId }) }]));
+    const entities = z.record(z.string(), z.string().regex(/^[a-z_]+\.[a-z0-9_]+$/)).parse(JSON.parse(env.PLAYER_HA_ENTITIES_JSON ?? "{}"));
+    const senders = z.record(playerIdSchema, z.record(z.string().min(1), z.string().min(1)).refine(value => Object.keys(value).length > 0)).parse(JSON.parse(env.PLAYER_HA_SENDERS_JSON ?? "{}"));
+    for (const engineId of Object.keys(senders))
+        if (!configured[engineId])
+            throw new Error("HA sender must reference a configured engine");
+    const store = dependencies.store ?? new PostgresPlayerStore(new Pool({ connectionString: env.DATABASE_URL, connectionTimeoutMillis: 5000, query_timeout: 5000, statement_timeout: 5000 }));
+    const logPlay = (play) => postServerPlay(appUrl, play);
+    const manager = dependencies.manager ?? new ServerPlayerManager(store, engines, homeAssistantObserver({ url: env.PLAYER_HA_URL, token: env.PLAYER_HA_TOKEN, entities, senders }), { ownerFriendId, logPlay });
+    const server = dependencies.server ?? playerHttpServer(manager, key);
+    const signals = dependencies.signals ?? process;
+    let stopping = false;
+    let shutdownPromise;
+    let heartbeat;
+    let playRetry;
+    function shutdown() {
+        if (shutdownPromise)
+            return shutdownPromise;
+        stopping = true;
+        clearInterval(heartbeat);
+        clearInterval(playRetry);
+        signals.off("SIGINT", stop);
+        signals.off("SIGTERM", stop);
+        server.close();
+        server.closeAllConnections();
+        shutdownPromise = (async () => {
+            try {
+                await manager.shutdown();
+            }
+            finally {
+                manager.off("fault", failStop);
+                await store.release();
+            }
+        })();
+        return shutdownPromise;
+    }
+    const stop = () => { void shutdown().catch(() => { process.exitCode = 1; }); };
+    const failStop = () => { process.exitCode = 1; stop(); };
+    try {
+        await store.acquire(failStop);
+        manager.on("fault", failStop);
+        await manager.initialize();
+        if (stopping)
+            throw new Error("Player worker lost its lease during initialization");
+        let checking = false;
+        heartbeat = setInterval(() => {
+            if (checking)
+                return;
+            checking = true;
+            void store.heartbeat().catch(failStop).finally(() => { checking = false; });
+        }, 1000);
+        void manager.retryPlays();
+        playRetry = setInterval(() => { void manager.retryPlays(); }, 30_000);
+        signals.once("SIGINT", stop);
+        signals.once("SIGTERM", stop);
+        const port = z.coerce.number().int().min(1).max(65535).parse(env.PLAYER_WORKER_PORT ?? "13700");
+        server.once("error", failStop);
+        server.listen(port, "0.0.0.0", () => console.log(`Player worker listening on ${port}`));
+        return { manager, server, store, shutdown };
+    }
+    catch (error) {
+        await shutdown().catch(() => { });
+        throw error;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/build/server/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/server/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAK7C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,IAAgB;IACnE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE;QAC1D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;QACtO,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;KAClC,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,EAAE;QAAE,OAAO;IACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAyB,EAAC,KAAK,KAAK,6BAA6B;QAAE,OAAO;IAC7H,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAE,YAAY,GAA4G,EAAE;IACpM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9S,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC,CAAC;IACjH,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACxH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACvG,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAC5G,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;IACrC,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3F,IAAI,CAAC,GAAG,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,IAAI,iBAAiB,CAAC,CAAC;IACtE,MAAM,OAAO,GAAiC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,QAAiB,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrR,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAC,CAAC;IACxI,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,CAAC,CAAC,CAAC;IAC9L,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACxI,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,IAAI,mBAAmB,CAAC,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,YAAY,EAAE,uBAAuB,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3L,MAAM,OAAO,GAAG,CAAC,IAAgB,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI,IAAI,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,qBAAqB,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9M,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI,OAAO,CAAC;IAChD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,eAA0C,CAAC;IAC/C,IAAI,SAAqC,CAAC;IAC1C,IAAI,SAAqC,CAAC;IAC1C,SAAS,QAAQ;QACf,IAAI,eAAe;YAAE,OAAO,eAAe,CAAC;QAC5C,QAAQ,GAAG,IAAI,CAAC;QAChB,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC7B,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;YAAC,CAAC;oBACzB,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAAC,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;QACpE,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,KAAK,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9B,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3B,IAAI,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpF,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAC3B,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC,EAAE,IAAI,CAAC,CAAC;QACT,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;QAC1B,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,CAAC;QAChG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC,CAAC;QACxF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACjC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/build/server/store.d.ts

@@ -0,0 +1,47 @@
+import { Pool } from "pg";
+import { type CreateServerPlayer, type PlayerTrackRef, type ServerPlayer, type ServerPlayerState } from "@groovenet/contracts";
+import type { Track } from "@groovenet/client";
+export declare class ServerPlayerError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, message: string, status?: number);
+}
+export interface ServerPlay {
+    entryId: string;
+    playerId: string;
+    trackId: string;
+    friendId: number;
+    releaseId: string;
+    startedAt: Date;
+}
+export interface PlayerStore {
+    list(): Promise<ServerPlayer[]>;
+    create(input: CreateServerPlayer, state: ServerPlayerState): Promise<ServerPlayer>;
+    save(player: ServerPlayer, expectedRevision: number): Promise<ServerPlayer>;
+    checkpoint(player: ServerPlayer): Promise<void>;
+    resolve(ref: PlayerTrackRef): Promise<Track | null>;
+    queuePlay(play: ServerPlay): Promise<void>;
+    pendingPlays(): Promise<ServerPlay[]>;
+    markPlayLogged(entryId: string): Promise<void>;
+}
+/** Only the elected worker writes this table; every command also uses CAS. */
+export declare class PostgresPlayerStore implements PlayerStore {
+    readonly pool: Pool;
+    private lease?;
+    private onLost?;
+    constructor(pool: Pool);
+    acquire(onLost: () => void): Promise<void>;
+    heartbeat(): Promise<void>;
+    release(): Promise<void>;
+    private row;
+    list(): Promise<ServerPlayer[]>;
+    create(input: CreateServerPlayer, state: ServerPlayerState): Promise<ServerPlayer>;
+    save(player: ServerPlayer, expectedRevision: number): Promise<ServerPlayer>;
+    checkpoint(player: ServerPlayer): Promise<void>;
+    resolve(ref: PlayerTrackRef): Promise<Track | null>;
+    queuePlay(play: ServerPlay): Promise<void>;
+    pendingPlays(): Promise<ServerPlay[]>;
+    markPlayLogged(entryId: string): Promise<void>;
+    private mapError;
+}
+//# sourceMappingURL=store.d.ts.map

package/build/server/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/server/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAsB,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACnJ,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,qBAAa,iBAAkB,SAAQ,KAAK;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAmB,QAAQ,CAAC,MAAM;IAAnE,YAAqB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAW,MAAM,SAAM,EAAqB;CAC/F;AACD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnF,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACpD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,YAAY,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACtC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,8EAA8E;AAC9E,qBAAa,mBAAoB,YAAW,WAAW;IAGzC,QAAQ,CAAC,IAAI,EAAE,IAAI;IAF/B,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,YAAqB,IAAI,EAAE,IAAI,EAAI;IAE7B,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/C;IAEK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAG/B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB7B;IAED,OAAO,CAAC,GAAG;IAIL,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAGpC;IAEK,MAAM,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKvF;IAEK,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAMhF;IAEK,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpD;IAEK,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAIxD;IAEK,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;IAEK,YAAY,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAI1C;IAEK,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnD;IAED,OAAO,CAAC,QAAQ;CAIjB"}

package/build/server/store.js

@@ -0,0 +1,120 @@
+import { serverPlayerSchema } from "@groovenet/contracts";
+export class ServerPlayerError extends Error {
+    code;
+    status;
+    constructor(code, message, status = 409) {
+        super(message);
+        this.code = code;
+        this.status = status;
+    }
+}
+/** Only the elected worker writes this table; every command also uses CAS. */
+export class PostgresPlayerStore {
+    pool;
+    lease;
+    onLost;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    async acquire(onLost) {
+        const client = await this.pool.connect();
+        try {
+            const result = await client.query("SELECT pg_try_advisory_lock(693, 1) AS acquired");
+            if (!result.rows[0]?.acquired)
+                throw new ServerPlayerError("WORKER_ALREADY_RUNNING", "Another player worker owns the engine lifecycles", 503);
+            this.lease = client;
+            this.onLost = onLost;
+            this.pool.on("error", onLost);
+            client.once("error", onLost);
+            client.once("end", onLost);
+        }
+        catch (error) {
+            client.release();
+            throw error;
+        }
+    }
+    async heartbeat() {
+        if (!this.lease)
+            throw new ServerPlayerError("WORKER_UNAVAILABLE", "Player worker has no database lease", 503);
+        await this.lease.query("SELECT 1");
+    }
+    async release() {
+        const lease = this.lease;
+        this.lease = undefined;
+        try {
+            if (lease) {
+                try {
+                    await lease.query("SELECT pg_advisory_unlock(693, 1)");
+                }
+                finally {
+                    lease.release();
+                }
+            }
+        }
+        finally {
+            if (this.onLost) {
+                this.pool.off("error", this.onLost);
+                lease?.off("error", this.onLost);
+                lease?.off("end", this.onLost);
+                this.onLost = undefined;
+            }
+            await this.pool.end();
+        }
+    }
+    row(row) {
+        return serverPlayerSchema.parse({ id: row.id, name: row.name, engine_id: row.engine_id, availability_policy: row.availability_policy, revision: Number(row.revision), assigned_output: row.assigned_output, state: row.state });
+    }
+    async list() {
+        const result = await this.pool.query("SELECT * FROM server_players ORDER BY id");
+        return result.rows.map((row) => this.row(row));
+    }
+    async create(input, state) {
+        try {
+            const result = await this.pool.query("INSERT INTO server_players(id, name, engine_id, state) VALUES ($1, $2, $3, $4::jsonb) RETURNING *", [input.id, input.name, input.engine_id, JSON.stringify(state)]);
+            return this.row(result.rows[0]);
+        }
+        catch (error) {
+            throw this.mapError(error);
+        }
+    }
+    async save(player, expectedRevision) {
+        try {
+            const result = await this.pool.query(`UPDATE server_players SET name=$2, assigned_output=$3, state=$4::jsonb, availability_policy=$5, revision=revision+1, updated_at=now() WHERE id=$1 AND revision=$6 RETURNING *`, [player.id, player.name, player.assigned_output, JSON.stringify(player.state), player.availability_policy, expectedRevision]);
+            if (!result.rows[0])
+                throw new ServerPlayerError("REVISION_CONFLICT", "Player changed; refresh its state before retrying");
+            return this.row(result.rows[0]);
+        }
+        catch (error) {
+            throw this.mapError(error);
+        }
+    }
+    async checkpoint(player) {
+        // Do not bump the edit revision for elapsed-time updates. CAS prevents a
+        // delayed checkpoint from overwriting a newer command or queue transition.
+        await this.pool.query("UPDATE server_players SET state=$2::jsonb, updated_at=now() WHERE id=$1 AND revision=$3", [player.id, JSON.stringify(player.state), player.revision]);
+    }
+    async resolve(ref) {
+        const result = await this.pool.query("SELECT t.* FROM tracks t WHERE track_id=$1 AND friend_id=$2 LIMIT 2", [ref.track_id, ref.friend_id]);
+        if (result.rows.length !== 1)
+            return null;
+        return result.rows[0];
+    }
+    async queuePlay(play) {
+        await this.pool.query(`INSERT INTO server_player_plays (entry_id, player_id, track_id, friend_id, release_id, started_at)
+      VALUES ($1, $2, $3, $4, $5, $6) ON CONFLICT (entry_id) DO NOTHING`, [play.entryId, play.playerId, play.trackId, play.friendId, play.releaseId, play.startedAt]);
+    }
+    async pendingPlays() {
+        const result = await this.pool.query(`SELECT entry_id, player_id, track_id, friend_id, release_id, started_at
+      FROM server_player_plays WHERE logged_at IS NULL ORDER BY started_at`);
+        return result.rows.map(row => ({ entryId: row.entry_id, playerId: row.player_id, trackId: row.track_id, friendId: row.friend_id, releaseId: row.release_id, startedAt: new Date(row.started_at) }));
+    }
+    async markPlayLogged(entryId) {
+        await this.pool.query("UPDATE server_player_plays SET logged_at=now() WHERE entry_id=$1 AND logged_at IS NULL", [entryId]);
+    }
+    mapError(error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "23505")
+            return new ServerPlayerError("ASSIGNMENT_CONFLICT", "Player ID, engine, or speaker is already assigned");
+        return error;
+    }
+}
+//# sourceMappingURL=store.js.map

package/build/server/store.js.map

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

package/build/types.d.ts

@@ -36,9 +36,11 @@ export interface PlaybackBackend {
     setVolume(volume: number): Promise<void>;
     listDevices(): Promise<AudioDevice[]>;
     setOutputDevice(deviceId: string): Promise<void>;
+    /** Transport evidence for server resume policy; selected alone is not connected. */
+    outputConnection?(): Promise<"connected" | "disconnected" | "unknown">;
     close(): Promise<void>;
 }
-export type PlayerErrorCode = "NO_AUDIO" | "MPV_NOT_FOUND" | "MPV_EXITED" | "MPV_IPC" | "STREAM_FAILED" | "DEVICE_UNAVAILABLE" | "INVALID_ARGUMENT";
+export type PlayerErrorCode = "NO_AUDIO" | "MPV_NOT_FOUND" | "MPV_EXITED" | "MPV_IPC" | "STREAM_FAILED" | "DEVICE_UNAVAILABLE" | "INVALID_ARGUMENT" | "ENGINE_UNAVAILABLE" | "ENGINE_INCOMPATIBLE" | "ENGINE_AUTH" | "ENGINE_TIMEOUT" | "ENGINE_API" | "DEVICE_BUSY" | "DEVICE_AUTH" | "PLAYBACK_INTERRUPTED";
 export declare class PlayerError extends Error {
     readonly code: PlayerErrorCode;
     constructor(code: PlayerErrorCode, message: string, options?: ErrorOptions);

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9F,GAAG,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/F,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,eAAe,GACf,YAAY,GACZ,SAAS,GACT,eAAe,GACf,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,eAAe;IADhC,YACW,IAAI,EAAE,eAAe,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9F,GAAG,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/F,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,oFAAoF;IACpF,gBAAgB,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC,CAAC;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,eAAe,GACf,YAAY,GACZ,SAAS,GACT,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,GACb,gBAAgB,GAChB,YAAY,GACZ,aAAa,GACb,aAAa,GACb,sBAAsB,CAAC;AAE3B,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,eAAe;IADhC,YACW,IAAI,EAAE,eAAe,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF"}

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyDA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAEzB,IAAI;IADf,YACW,IAAqB,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAJf,IAAI;QAKb,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmEA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAEzB,IAAI;IADf,YACW,IAAqB,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAJf,IAAI;QAKb,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/owntone/Dockerfile

@@ -0,0 +1,27 @@
+# OwnTone is GPL-2.0; this image is built from the pinned upstream source plus
+# terminal-v1.patch. Keep both available when distributing a derived image.
+FROM alpine:3.22 AS build
+RUN apk add --no-cache alsa-lib-dev autoconf automake avahi-dev bison confuse-dev \
+    curl curl-dev flex g++ gawk gcc gettext-dev gnutls-dev gperf json-c-dev \
+    libevent-dev libgcrypt-dev libplist-dev libsodium-dev libtool libunistring-dev \
+    libwebsockets-dev libxml2-dev make protobuf-c-dev sqlite-dev ffmpeg-dev patch
+WORKDIR /source
+RUN curl -fsSL https://codeload.github.com/owntone/owntone-server/tar.gz/d6fb3edf5831de38134ebd92fcf09a730ddd37aa -o source.tar.gz \
+    && echo 'b2c391e25295ea9d598dba70e23dcbe31635ae38f36ac570aa61f7c803d98f98  source.tar.gz' | sha256sum -c - \
+    && tar -xzf source.tar.gz --strip-components=1 && rm source.tar.gz
+COPY terminal-v1.patch /source/terminal-v1.patch
+RUN patch -p1 < terminal-v1.patch \
+    && autoreconf -fi -I /usr/share/gettext/m4 \
+    && ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var \
+       --disable-install_systemd --disable-install_user --disable-webinterface \
+    && make -j2 && make DESTDIR=/output install \
+    && (cd src/libairptp && ./configure --prefix=/usr --enable-daemon && make -j2 && make DESTDIR=/output install) \
+    && rm -rf /output/var && make clean
+
+FROM alpine:3.22
+RUN apk add --no-cache alsa-lib avahi confuse curl dbus ffmpeg gnutls json-c \
+    libevent libgcrypt libplist libsodium libunistring libuuid libwebsockets libxml2 protobuf-c sqlite-libs
+COPY --from=build /output/ /
+# Corresponding source and patch are included for reproducibility/distribution.
+COPY --from=build /source/ /usr/src/owntone/
+ENTRYPOINT ["/usr/sbin/owntone", "-f", "-c", "/etc/owntone.conf"]

package/owntone/smoke.mjs

@@ -0,0 +1,135 @@
+// Network-isolated engine + real adapter test. Docker is required; no speakers,
+// production volumes, port publication or host packages are used.
+// Build the player and engine image first, then: node owntone/smoke.mjs
+import assert from "node:assert/strict";
+import { execFile, execFileSync } from "node:child_process";
+import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { OwnToneBackend } from "../build/ownToneBackend.js";
+
+const exec = promisify(execFile);
+const name = `groovenet-692-smoke-${process.pid}`;
+const dir = mkdtempSync(join(tmpdir(), "groovenet-692-"));
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const docker = (...args) => execFileSync("docker", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+const config = `general {
+ uid = "nobody"
+ db_path = "/tmp/engine/library.db"
+ cache_dir = "/tmp/engine"
+ logfile = "/dev/stderr"
+ loglevel = log
+ trusted_networks = { "localhost" }
+ bind_address = "127.0.0.1"
+ speaker_autoselect = no
+}
+library {
+ name = "Groovenet 692 isolated"
+ port = 13689
+ directories = { "/tmp/media" }
+ clear_queue_on_stop_disable = true
+}
+audio { type = "dummy" }
+mpd { port = 0 }
+`;
+writeFileSync(join(dir, "engine.conf"), config);
+const transport = async (input, init = {}) => {
+  const args = ["exec", name, "curl", "-sS", "--max-time", "5", "-X", init.method ?? "GET", "-w", "\n%{http_code}"];
+  for (const [key, value] of Object.entries(init.headers ?? {})) args.push("-H", `${key}: ${value}`);
+  if (init.body) args.push("-d", String(init.body));
+  args.push(String(input));
+  const { stdout } = await exec("docker", args, { signal: init.signal });
+  const split = stdout.lastIndexOf("\n");
+  const status = Number(stdout.slice(split + 1));
+  return new Response(status === 204 ? null : stdout.slice(0, split), { status });
+};
+const read = async (path) => (await transport(`http://127.0.0.1:13689/api/${path}`)).json();
+const put = (path) => transport(`http://127.0.0.1:13689/api/${path}`, { method: "PUT" });
+const wait = async (predicate, message) => {
+  const deadline = Date.now() + 12000;
+  while (Date.now() < deadline) {
+    if (await predicate()) return;
+    await delay(100);
+  }
+  throw new Error(`Timed out: ${message}`);
+};
+let backend;
+try {
+  docker("run", "-d", "--name", name, "--network", "none", "--mount", `type=bind,src=${join(dir, "engine.conf")},dst=/tmp/engine.conf,readonly`, "--entrypoint", "/bin/sh", "groovenet-owntone:692-test", "-ec", `
+    mkdir -p /tmp/engine /tmp/media /run/dbus
+    chown nobody /tmp/engine /tmp/media
+    ffmpeg -y -v error -f lavfi -i 'sine=frequency=440:duration=3' -af volume=0.01 /tmp/media/short.wav
+    ffmpeg -y -v error -f lavfi -i 'sine=frequency=440:duration=15' -af volume=0.01 /tmp/media/long.wav
+    rm -f /run/dbus/pid /run/dbus/dbus.pid /run/avahi-daemon/pid
+    dbus-uuidgen --ensure
+    dbus-daemon --system --fork
+    avahi-daemon --daemonize --no-drop-root
+    exec /usr/sbin/owntone -f -c /tmp/engine.conf
+  `);
+  await wait(async () => {
+    try { return (await read("search?type=tracks&expression=media_kind%20is%20music")).tracks.items.length === 2; }
+    catch { return false; }
+  }, "fixture index");
+  const devices = await read("outputs");
+  assert.equal(devices.outputs.length, 1);
+  const outputId = devices.outputs[0].id;
+  backend = new OwnToneBackend({ apiUrl: "http://127.0.0.1:13689/api", outputId, fetch: transport, pollIntervalMs: 100 });
+  let ended = 0;
+  const errors = [];
+  const positions = [];
+  backend.on("ended", () => ended++).on("error", (error) => errors.push(error)).on("position", (position) => positions.push(position));
+  await backend.load({ url: "file:///tmp/media/short.wav" });
+  await wait(() => ended === 1 || errors.length > 0, "natural completion");
+  assert.deepEqual(errors, []);
+  assert.equal(ended, 1);
+  assert.equal((await read("player")).groovenet_terminal.reason, "eof");
+  console.log("PASS: natural EOF emitted exactly once through the real adapter");
+  await backend.load({ url: "file:///tmp/media/long.wav" });
+  await wait(() => positions.some((p) => p > 0.1), "position progress");
+  await backend.pause(true);
+  await backend.seek(5);
+  await backend.pause(false);
+  await backend.setVolume(5);
+  await put("player/stop");
+  await wait(() => errors.length > 0, "explicit external stop");
+  assert.equal(ended, 1);
+  assert.equal(errors.at(-1).code, "PLAYBACK_INTERRUPTED");
+  assert.equal((await read("player")).groovenet_terminal.reason, "interrupted");
+  console.log("PASS: external stop does not advance; pause/resume/absolute seek/volume accepted");
+  errors.length = 0;
+  await backend.load({ url: "file:///tmp/media/long.wav" });
+  await put("queue/clear");
+  await wait(() => errors.length > 0, "external queue replacement");
+  assert.equal(ended, 1);
+  assert.equal(errors.at(-1).code, "PLAYBACK_INTERRUPTED");
+  console.log("PASS: external queue replacement does not advance");
+  await backend.close();
+  backend = undefined;
+  // Restart the same container: its DB survives, but its signal epoch must not.
+  const beforeRestart = (await read("player")).groovenet_terminal.instance;
+  backend = new OwnToneBackend({ apiUrl: "http://127.0.0.1:13689/api", outputId, fetch: transport, pollIntervalMs: 100 });
+  let restartEnded = 0;
+  const restartErrors = [];
+  backend.on("ended", () => restartEnded++).on("error", (error) => restartErrors.push(error));
+  await backend.load({ url: "file:///tmp/media/long.wav" });
+  docker("restart", name);
+  await wait(async () => {
+    try { return (await read("player")).groovenet_terminal.instance !== beforeRestart; }
+    catch { return false; }
+  }, "new engine epoch");
+  await wait(() => restartErrors.some((error) => error.code === "PLAYBACK_INTERRUPTED"), "restart reconciliation");
+  assert.equal(restartEnded, 0);
+  assert.equal((await read("player")).state, "stop");
+  console.log("PASS: engine restart changes epoch and never replays or advances");
+  await backend.close();
+  backend = undefined;
+  console.log("PASS: isolated smoke complete (dummy output only; no audible hardware validation)");
+} catch (error) {
+  try { execFileSync("docker", ["logs", "--tail", "50", name], { stdio: "inherit" }); } catch { /* not started */ }
+  throw error;
+} finally {
+  await backend?.close().catch(() => {});
+  try { docker("rm", "-f", name); } catch { /* already gone */ }
+  rmSync(dir, { recursive: true, force: true });
+}