@groovenet/player 0.1.2 → 0.1.4

package/build/ownToneBackend.js

@@ -0,0 +1,349 @@
+import { EventEmitter } from "node:events";
+import { fileURLToPath } from "node:url";
+import { posix } from "node:path";
+import { PlayerError } from "./types.js";
+/**
+ * Single-output adapter for a dedicated OwnTone engine with terminal-v1.patch.
+ * Unpatched engines are refused; a stopped state alone never means EOF.
+ */
+export class OwnToneBackend extends EventEmitter {
+    apiUrl;
+    transport;
+    timeoutMs;
+    pollIntervalMs;
+    authorization;
+    outputId;
+    session = null;
+    finishedSession = null;
+    failedSession = null;
+    selected = false;
+    uncertain = false;
+    closed = false;
+    timer;
+    closing;
+    tail = Promise.resolve();
+    constructor(options) {
+        super();
+        try {
+            this.apiUrl = new URL(options.apiUrl.endsWith("/") ? options.apiUrl : `${options.apiUrl}/`);
+        }
+        catch {
+            throw new PlayerError("INVALID_ARGUMENT", "OwnTone API URL must be an absolute HTTP(S) URL");
+        }
+        if (!["http:", "https:"].includes(this.apiUrl.protocol) || this.apiUrl.username || this.apiUrl.password || this.apiUrl.search || this.apiUrl.hash) {
+            throw new PlayerError("INVALID_ARGUMENT", "OwnTone API URL must use HTTP(S), without credentials, query or fragment");
+        }
+        this.transport = options.fetch ?? globalThis.fetch;
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.pollIntervalMs = options.pollIntervalMs ?? 500;
+        if (![this.timeoutMs, this.pollIntervalMs].every((value) => Number.isFinite(value) && value > 0)) {
+            throw new PlayerError("INVALID_ARGUMENT", "OwnTone timeouts and polling interval must be positive");
+        }
+        this.authorization = options.password === undefined ? undefined : `Basic ${Buffer.from(`admin:${options.password}`).toString("base64")}`;
+        this.outputId = options.outputId;
+    }
+    // All commands and polls share a serial lane: no delayed response from an old
+    // load can emit an event for the next track, or race cleanup.
+    serial(operation) {
+        const result = this.tail.then(() => {
+            if (this.closed)
+                throw new PlayerError("ENGINE_UNAVAILABLE", "OwnTone backend is closed");
+            return operation();
+        });
+        this.tail = result.catch(() => { });
+        return result;
+    }
+    load(source) {
+        return this.serial(async () => {
+            // Only indexed files have verified finite-track semantics. In particular,
+            // never strip Authorization from an app HTTP URL and enqueue it as a stream.
+            let path;
+            try {
+                path = fileURLToPath(source.url);
+            }
+            catch {
+                throw new PlayerError("STREAM_FAILED", "OwnTone requires a file URL in its indexed shared library; authenticated HTTP sources are not supported");
+            }
+            if (source.headers && Object.keys(source.headers).length) {
+                throw new PlayerError("STREAM_FAILED", "OwnTone indexed sources cannot include HTTP headers");
+            }
+            const params = new URLSearchParams({ directory: posix.dirname(path) });
+            const search = await this.request(`library/files?${params}`);
+            const tracks = search?.tracks?.items;
+            if (!Array.isArray(tracks) || tracks.some((track) => !track || typeof track.path !== "string"))
+                throw this.invalidResponse();
+            const matches = tracks.filter((track) => track.path === path && track.data_kind === "file" && Number.isSafeInteger(track.id) && track.id > 0 && track.length_ms > 0);
+            if (matches.length !== 1)
+                throw new PlayerError("NO_AUDIO", "Audio file is missing, ambiguous, or not yet indexed in OwnTone");
+            const status = await this.status();
+            if (status.state !== "stop" && (!this.session || !this.owns(status, await this.queue()))) {
+                throw new PlayerError("DEVICE_BUSY", "OwnTone has an unowned active or paused session; explicitly stop that engine before loading Groovenet audio");
+            }
+            if (!this.outputId)
+                throw new PlayerError("DEVICE_UNAVAILABLE", "Select one OwnTone output before playback");
+            // Device selection is an explicit load-time action, never a reconnect action.
+            await this.select(this.outputId);
+            this.session = null;
+            this.finishedSession = null;
+            this.failedSession = null;
+            this.cancelPoll();
+            await this.request("player/stop", "PUT");
+            await this.request("player/repeat?state=off", "PUT");
+            await this.request("player/consume?state=false", "PUT");
+            await this.request("player/shuffle?state=false", "PUT");
+            const queue = await this.request(`queue/items/add?${new URLSearchParams({ uris: `library:track:${matches[0].id}`, clear: "true" })}`, "POST");
+            this.validateQueue(queue);
+            if (queue.items.length !== 1)
+                throw new PlayerError("STREAM_FAILED", "OwnTone did not queue exactly one audio file");
+            this.session = { itemId: queue.items[0].id, queueVersion: queue.version, instance: status.groovenet_terminal.instance, sequence: status.groovenet_terminal.sequence };
+            try {
+                await this.request("player/play", "PUT");
+            }
+            catch (error) {
+                // A lost reply can mean playback started. Keep the item identity for
+                // explicit close/reconciliation, without retrying the play command.
+                this.uncertain = true;
+                this.schedulePoll();
+                throw error;
+            }
+            this.uncertain = false;
+            this.schedulePoll();
+        });
+    }
+    pause(paused) {
+        return this.serial(async () => {
+            await this.assertOwned();
+            await this.request(`player/${paused ? "pause" : "play"}`, "PUT");
+        });
+    }
+    seek(seconds) {
+        return this.serial(async () => {
+            if (!Number.isFinite(seconds) || seconds < 0)
+                throw new PlayerError("INVALID_ARGUMENT", "Seek position must be non-negative seconds");
+            await this.assertOwned();
+            await this.request(`player/seek?position_ms=${Math.round(seconds * 1000)}`, "PUT");
+        });
+    }
+    setVolume(volume) {
+        return this.serial(async () => {
+            if (!Number.isFinite(volume) || volume < 0 || volume > 100)
+                throw new PlayerError("INVALID_ARGUMENT", "Volume must be between 0 and 100");
+            if (!this.outputId || !this.selected)
+                throw new PlayerError("DEVICE_UNAVAILABLE", "Select an OwnTone output before setting volume");
+            if (this.session)
+                await this.assertOwned();
+            if (!(await this.output(this.outputId)).selected)
+                throw new PlayerError("DEVICE_UNAVAILABLE", "OwnTone output was deselected");
+            await this.request(`outputs/${encodeURIComponent(this.outputId)}`, "PUT", { volume });
+        });
+    }
+    listDevices() {
+        return this.serial(async () => (await this.outputs()).map(({ id, name, type }) => ({ id, name, description: type })));
+    }
+    outputConnection() {
+        return this.serial(async () => {
+            if (!this.outputId)
+                return "unknown";
+            const output = (await this.outputs()).find((candidate) => candidate.id === this.outputId);
+            if (!output?.selected)
+                return "disconnected";
+            if (output.connected === undefined)
+                return "unknown";
+            return output.connected ? "connected" : "disconnected";
+        });
+    }
+    setOutputDevice(id) {
+        return this.serial(async () => {
+            const status = await this.status();
+            if (status.state !== "stop")
+                await this.assertOwned();
+            await this.select(id);
+            this.outputId = id;
+        });
+    }
+    close() {
+        if (this.closing)
+            return this.closing;
+        this.closing = this.serial(async () => {
+            this.cancelPoll();
+            try {
+                if (this.session || this.finishedSession || this.failedSession || this.selected) {
+                    const status = await this.status();
+                    const queue = await this.queue();
+                    const finished = this.finishedSession;
+                    const completed = finished && status.state === "stop" && status.groovenet_terminal.instance === finished.instance && status.groovenet_terminal.item_id === finished.itemId && status.groovenet_terminal.reason === "eof" && (queue.items.length === 0 || (queue.version === finished.queueVersion && queue.items.length === 1 && queue.items[0].id === finished.itemId));
+                    const stoppedOwned = this.session && status.state === "stop" && status.groovenet_terminal.instance === this.session.instance && queue.version === this.session.queueVersion && queue.items.length === 1 && queue.items[0].id === this.session.itemId;
+                    const outputs = await this.outputs();
+                    const foreignOutput = outputs.some((output) => output.selected && output.id !== this.outputId);
+                    const failed = status.state !== "play" && this.matchesFailedSession(status, queue);
+                    if (!foreignOutput && (this.owns(status, queue) || completed || stoppedOwned || failed || (!this.session && !finished && this.selected && status.state === "stop" && queue.items.length === 0))) {
+                        await this.request("player/stop", "PUT");
+                        await this.request("queue/clear", "PUT");
+                        await this.request("outputs/set", "PUT", { outputs: [] });
+                    }
+                }
+            }
+            finally {
+                this.session = null;
+                this.failedSession = null;
+                this.selected = false;
+                this.closed = true;
+            }
+        });
+        return this.closing;
+    }
+    async request(path, method = "GET", body) {
+        const signal = AbortSignal.timeout(this.timeoutMs);
+        try {
+            const response = await this.transport(new URL(path, this.apiUrl), {
+                method, signal, redirect: "error",
+                headers: { ...(this.authorization ? { Authorization: this.authorization } : {}), ...(body === undefined ? {} : { "Content-Type": "application/json" }) },
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            });
+            if (!response.ok) {
+                const code = response.status === 401 || response.status === 403 ? "ENGINE_AUTH" : response.status === 409 ? "DEVICE_BUSY" : "ENGINE_API";
+                // Do not include engine body, URL, password or source path in errors.
+                throw new PlayerError(code, `OwnTone API returned HTTP ${response.status}`);
+            }
+            if (response.status === 204)
+                return undefined;
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof PlayerError)
+                throw error;
+            throw new PlayerError(signal.aborted ? "ENGINE_TIMEOUT" : "ENGINE_UNAVAILABLE", signal.aborted ? "OwnTone API request timed out" : "OwnTone API is unreachable or returned invalid JSON");
+        }
+    }
+    invalidResponse() { return new PlayerError("ENGINE_API", "OwnTone returned an invalid API response"); }
+    async status() {
+        const status = await this.request("player");
+        if (!status || !["play", "pause", "stop"].includes(status.state) || !Number.isSafeInteger(status.item_id) || !Number.isFinite(status.item_progress_ms) || !Number.isFinite(status.item_length_ms))
+            throw this.invalidResponse();
+        const terminal = status.groovenet_terminal;
+        if (!terminal || terminal.version !== 1 || !/^[a-f0-9]{32}$/.test(terminal.instance) || !Number.isSafeInteger(terminal.sequence) || terminal.sequence < 0 || !Number.isSafeInteger(terminal.item_id) || !["none", "eof", "input_error", "failed", "output_lost", "interrupted"].includes(terminal.reason)) {
+            throw new PlayerError("ENGINE_INCOMPATIBLE", "OwnTone requires the Groovenet terminal-v1 extension for reliable completion events");
+        }
+        return status;
+    }
+    validateQueue(queue) {
+        if (!queue || !Number.isSafeInteger(queue.version) || !Array.isArray(queue.items) || queue.items.some((item) => !item || !Number.isSafeInteger(item.id)))
+            throw this.invalidResponse();
+    }
+    async queue() {
+        const queue = await this.request("queue");
+        this.validateQueue(queue);
+        return queue;
+    }
+    async outputs() {
+        const result = await this.request("outputs");
+        if (!Array.isArray(result?.outputs) || result.outputs.some((output) => !output || typeof output.id !== "string" || typeof output.name !== "string" || typeof output.selected !== "boolean" || typeof output.type !== "string"))
+            throw this.invalidResponse();
+        return result.outputs;
+    }
+    async output(id) {
+        const output = (await this.outputs()).find((output) => output.id === id);
+        if (!output)
+            throw new PlayerError("DEVICE_UNAVAILABLE", "OwnTone output is unavailable");
+        if (output.busy || output.prevent_playback)
+            throw new PlayerError("DEVICE_BUSY", "OwnTone output is busy");
+        if (output.requires_auth || output.needs_auth_key)
+            throw new PlayerError("DEVICE_AUTH", "Authorize this output in OwnTone before using it");
+        return output;
+    }
+    async select(id) {
+        if (!id)
+            throw new PlayerError("INVALID_ARGUMENT", "OwnTone output ID must not be empty");
+        await this.output(id);
+        this.selected = false;
+        await this.request("outputs/set", "PUT", { outputs: [id] });
+        const outputs = await this.outputs();
+        if (outputs.filter((output) => output.selected).length !== 1 || !outputs.some((output) => output.id === id && output.selected)) {
+            throw new PlayerError("DEVICE_UNAVAILABLE", "OwnTone could not select the requested single output");
+        }
+        this.selected = true;
+    }
+    owns(status, queue) {
+        return this.session !== null && status.groovenet_terminal.instance === this.session.instance && !this.terminalForSession(status) && status.state !== "stop" && status.item_id === this.session.itemId && queue.version === this.session.queueVersion && queue.items.length === 1 && queue.items[0].id === this.session.itemId;
+    }
+    terminalForSession(status) {
+        return this.session !== null && status.groovenet_terminal.instance === this.session.instance && status.groovenet_terminal.sequence > this.session.sequence && status.groovenet_terminal.item_id === this.session.itemId;
+    }
+    /** Retain cleanup identity only for a terminal failure of our unchanged item.
+     * Polls never reconnect or replay. close() rechecks this identity before writes.
+     */
+    rememberFailure(status, queue) {
+        if (this.session && this.terminalForSession(status) && ["output_lost", "input_error", "failed"].includes(status.groovenet_terminal.reason)) {
+            this.failedSession = { ...this.session, terminalSequence: status.groovenet_terminal.sequence, terminalReason: status.groovenet_terminal.reason };
+            if (!this.matchesFailedSession(status, queue))
+                this.failedSession = null;
+        }
+    }
+    matchesFailedSession(status, queue) {
+        const failed = this.failedSession;
+        return failed !== null && status.groovenet_terminal.instance === failed.instance
+            && status.item_id === failed.itemId && status.groovenet_terminal.item_id === failed.itemId
+            && status.groovenet_terminal.sequence === failed.terminalSequence && status.groovenet_terminal.reason === failed.terminalReason
+            && queue.version === failed.queueVersion && queue.items.length === 1 && queue.items[0].id === failed.itemId;
+    }
+    async assertOwned() {
+        const status = await this.status();
+        const queue = await this.queue();
+        if (!this.owns(status, queue)) {
+            this.rememberFailure(status, queue);
+            this.session = null;
+            throw new PlayerError("PLAYBACK_INTERRUPTED", "OwnTone playback stopped or was replaced; explicitly play again to start a session");
+        }
+        return status;
+    }
+    schedulePoll() {
+        this.timer = setTimeout(() => {
+            void this.serial(async () => {
+                if (!this.session)
+                    return;
+                try {
+                    const status = await this.status();
+                    const queue = await this.queue();
+                    if (!this.uncertain && this.terminalForSession(status) && status.groovenet_terminal.reason === "eof" && status.state === "stop" && (queue.items.length === 0 || (queue.version === this.session.queueVersion && queue.items.length === 1 && queue.items[0].id === this.session.itemId))) {
+                        this.finishedSession = this.session;
+                        this.session = null;
+                        this.emit("ended");
+                        return;
+                    }
+                    if (!this.owns(status, queue)) {
+                        this.rememberFailure(status, queue);
+                        const reason = status.groovenet_terminal.instance !== this.session.instance ? "engine restarted" : this.terminalForSession(status) ? status.groovenet_terminal.reason : status.state === "stop" ? "stopped" : queue.version !== this.session.queueVersion ? "queue changed" : "item replaced";
+                        throw new PlayerError("PLAYBACK_INTERRUPTED", `OwnTone playback interrupted (${reason}); the queue has not advanced. Check the engine/receiver, then explicitly play again when ready.`);
+                    }
+                    const outputs = await this.outputs();
+                    const output = outputs.find((output) => output.id === this.outputId);
+                    if (outputs.filter((output) => output.selected).length !== 1 || !output?.selected)
+                        throw new PlayerError("DEVICE_UNAVAILABLE", "OwnTone output was disconnected or deselected");
+                    this.uncertain = false;
+                    this.emit("position", Math.max(0, status.item_progress_ms) / 1000, status.item_length_ms > 0 ? status.item_length_ms / 1000 : null);
+                    this.schedulePoll();
+                }
+                catch (error) {
+                    if (error instanceof PlayerError && (error.code === "ENGINE_UNAVAILABLE" || error.code === "ENGINE_TIMEOUT")) {
+                        // Reconcile using reads only. Never infer EOF across a connection gap.
+                        if (!this.uncertain)
+                            this.emit("error", error);
+                        this.uncertain = true;
+                        this.schedulePoll();
+                    }
+                    else {
+                        this.session = null;
+                        this.selected = false;
+                        this.emit("error", error);
+                    }
+                }
+            }).catch(() => { });
+        }, this.pollIntervalMs);
+        this.timer.unref();
+    }
+    cancelPoll() {
+        clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+}
+//# sourceMappingURL=ownToneBackend.js.map

package/build/ownToneBackend.js.map

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

package/build/paths.d.ts

@@ -0,0 +1,4 @@
+import type { PlayerDaemonPaths } from "./daemon.js";
+/** Where the daemon's control socket and pidfile live: `~/.groovenet/player/`. */
+export declare function defaultPlayerPaths(home?: string): PlayerDaemonPaths;
+//# sourceMappingURL=paths.d.ts.map

package/build/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAkB,GAAG,iBAAiB,CAG9E"}

package/build/paths.js

@@ -0,0 +1,8 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Where the daemon's control socket and pidfile live: `~/.groovenet/player/`. */
+export function defaultPlayerPaths(home = homedir()) {
+    const dir = join(home, ".groovenet", "player");
+    return { socketPath: join(dir, "player.sock"), pidPath: join(dir, "player.pid") };
+}
+//# sourceMappingURL=paths.js.map

package/build/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAW,OAAO,EAAE;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC;AACpF,CAAC"}

package/build/playLogger.d.ts

@@ -0,0 +1,39 @@
+import type { Track } from "@groovenet/client";
+import type { PlaybackSnapshot, QueueEntry } from "./types.js";
+/** The slice of PlayerCore the logger listens to, so tests need no player. */
+export interface PlayEventSource {
+    on(event: "change", listener: (snapshot: PlaybackSnapshot) => void): unknown;
+    on(event: "track-started" | "track-ended", listener: (entry: QueueEntry) => void): unknown;
+    off(event: "change", listener: (snapshot: PlaybackSnapshot) => void): unknown;
+    off(event: "track-started" | "track-ended", listener: (entry: QueueEntry) => void): unknown;
+}
+export interface LoggedPlay {
+    track: Track;
+    startedAt: Date;
+    listened: number;
+}
+export interface PlayLoggerOptions {
+    source: PlayEventSource;
+    /** Records one play. Resolve for "logged" or "already logged"; reject to retry later. */
+    logPlay: (play: LoggedPlay) => Promise<void>;
+    /** Only this library's tracks are logged; the API rejects another owner's. */
+    friendId: number;
+    now?: () => Date;
+    onError?: (error: unknown, play: LoggedPlay) => void;
+    retryDelayMs?: number;
+}
+/** Logs a play when a track has been listened to long enough (see playThreshold). */
+export declare class PlayLogger {
+    private readonly options;
+    private tracked;
+    private readonly now;
+    private readonly retryDelayMs;
+    private readonly onStart;
+    private readonly onChange;
+    private readonly onEnd;
+    constructor(options: PlayLoggerOptions);
+    start(): void;
+    stop(): void;
+    private maybeLog;
+}
+//# sourceMappingURL=playLogger.d.ts.map

package/build/playLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playLogger.d.ts","sourceRoot":"","sources":["../src/playLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC;IAC7E,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC;IAC3F,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC;IAC9E,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC;CAC7F;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,yFAAyF;IACzF,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAYD,qFAAqF;AACrF,qBAAa,UAAU;IAwBT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAvBpC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMvB;IAEF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAKpB;IAEF,YAA6B,OAAO,EAAE,iBAAiB,EAGtD;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,IAAI,IAAI,IAAI,CAKX;IAED,OAAO,CAAC,QAAQ;CAiBjB"}

package/build/playLogger.js

@@ -0,0 +1,59 @@
+import { advanceProgress, initialProgress, isPlay } from "./playThreshold.js";
+/** Logs a play when a track has been listened to long enough (see playThreshold). */
+export class PlayLogger {
+    options;
+    tracked = null;
+    now;
+    retryDelayMs;
+    onStart = (entry) => {
+        this.tracked = { entry, startedAt: this.now(), progress: initialProgress, duration: null, claimed: false, retryAt: 0 };
+    };
+    onChange = (snapshot) => {
+        const tracked = this.tracked;
+        if (!tracked || snapshot.current?.id !== tracked.entry.id)
+            return;
+        tracked.duration = snapshot.duration;
+        tracked.progress = advanceProgress(tracked.progress, snapshot.position, snapshot.status === "playing");
+        this.maybeLog(tracked);
+    };
+    onEnd = (entry) => {
+        if (this.tracked?.entry.id === entry.id) {
+            this.maybeLog(this.tracked);
+            this.tracked = null;
+        }
+    };
+    constructor(options) {
+        this.options = options;
+        this.now = options.now ?? (() => new Date());
+        this.retryDelayMs = options.retryDelayMs ?? 30_000;
+    }
+    start() {
+        this.options.source.on("track-started", this.onStart);
+        this.options.source.on("change", this.onChange);
+        this.options.source.on("track-ended", this.onEnd);
+    }
+    stop() {
+        this.options.source.off("track-started", this.onStart);
+        this.options.source.off("change", this.onChange);
+        this.options.source.off("track-ended", this.onEnd);
+        this.tracked = null;
+    }
+    maybeLog(tracked) {
+        const { track } = tracked.entry;
+        if (tracked.claimed || !isPlay(tracked.progress.listened, tracked.duration))
+            return;
+        if (!track.release_id || track.friend_id !== this.options.friendId)
+            return;
+        if (this.now().getTime() < tracked.retryAt)
+            return;
+        // `claimed` makes repeated events harmless; the API's unique index covers a restart.
+        tracked.claimed = true;
+        const play = { track, startedAt: tracked.startedAt, listened: tracked.progress.listened };
+        void this.options.logPlay(play).then(() => undefined, (error) => {
+            tracked.claimed = false;
+            tracked.retryAt = this.now().getTime() + this.retryDelayMs;
+            this.options.onError?.(error, play);
+        });
+    }
+}
+//# sourceMappingURL=playLogger.js.map

package/build/playLogger.js.map

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

package/build/playThreshold.d.ts

@@ -0,0 +1,31 @@
+/** A track shorter than this is never a play. */
+export declare const MIN_TRACK_SECONDS = 30;
+/** Half of the track, or this many seconds, whichever comes first. */
+export declare const MAX_THRESHOLD_SECONDS = 240;
+export declare const THRESHOLD_FRACTION = 0.5;
+/**
+ * The largest forward jump between two position updates that still counts as
+ * listening. mpv reports about once a second, so anything bigger is a seek.
+ */
+export declare const MAX_STEP_SECONDS = 5;
+export interface ListenProgress {
+    /** Seconds actually played, excluding pauses and seeks. */
+    listened: number;
+    /** The last position seen, or null before the first update. */
+    lastPosition: number | null;
+}
+export declare const initialProgress: ListenProgress;
+/**
+ * Seconds of play time that make a play, or null when the track can never be
+ * one. An unknown duration is judged by the absolute limit alone.
+ */
+export declare function playThreshold(duration: number | null): number | null;
+/**
+ * Fold one position update into the running total. Only forward progress while
+ * playing counts: a pause adds nothing, and a backward or oversized jump is a
+ * seek, which moves the reference point without adding listening time.
+ */
+export declare function advanceProgress(progress: ListenProgress, position: number, playing: boolean, maxStep?: number): ListenProgress;
+/** Whether `listened` seconds of a track of this duration is a play. */
+export declare function isPlay(listened: number, duration: number | null): boolean;
+//# sourceMappingURL=playThreshold.d.ts.map

package/build/playThreshold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playThreshold.d.ts","sourceRoot":"","sources":["../src/playThreshold.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,EAAE,cAAiD,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIpE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,MAAyB,GACjC,cAAc,CAKhB;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGzE"}

package/build/playThreshold.js

@@ -0,0 +1,40 @@
+/** A track shorter than this is never a play. */
+export const MIN_TRACK_SECONDS = 30;
+/** Half of the track, or this many seconds, whichever comes first. */
+export const MAX_THRESHOLD_SECONDS = 240;
+export const THRESHOLD_FRACTION = 0.5;
+/**
+ * The largest forward jump between two position updates that still counts as
+ * listening. mpv reports about once a second, so anything bigger is a seek.
+ */
+export const MAX_STEP_SECONDS = 5;
+export const initialProgress = { listened: 0, lastPosition: 0 };
+/**
+ * Seconds of play time that make a play, or null when the track can never be
+ * one. An unknown duration is judged by the absolute limit alone.
+ */
+export function playThreshold(duration) {
+    if (duration === null)
+        return MAX_THRESHOLD_SECONDS;
+    if (!Number.isFinite(duration) || duration < MIN_TRACK_SECONDS)
+        return null;
+    return Math.min(duration * THRESHOLD_FRACTION, MAX_THRESHOLD_SECONDS);
+}
+/**
+ * Fold one position update into the running total. Only forward progress while
+ * playing counts: a pause adds nothing, and a backward or oversized jump is a
+ * seek, which moves the reference point without adding listening time.
+ */
+export function advanceProgress(progress, position, playing, maxStep = MAX_STEP_SECONDS) {
+    if (!Number.isFinite(position))
+        return progress;
+    const delta = progress.lastPosition === null ? 0 : position - progress.lastPosition;
+    const counted = playing && delta > 0 && delta <= maxStep ? delta : 0;
+    return { listened: progress.listened + counted, lastPosition: position };
+}
+/** Whether `listened` seconds of a track of this duration is a play. */
+export function isPlay(listened, duration) {
+    const threshold = playThreshold(duration);
+    return threshold !== null && listened >= threshold;
+}
+//# sourceMappingURL=playThreshold.js.map

package/build/playThreshold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playThreshold.js","sourceRoot":"","sources":["../src/playThreshold.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,sEAAsE;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AASlC,MAAM,CAAC,MAAM,eAAe,GAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AAEhF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,qBAAqB,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAwB,EACxB,QAAgB,EAChB,OAAgB,EAChB,OAAO,GAAW,gBAAgB;IAElC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC;IACpF,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAC3E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,QAAuB;IAC9D,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,SAAS,KAAK,IAAI,IAAI,QAAQ,IAAI,SAAS,CAAC;AACrD,CAAC"}

package/build/player.d.ts

@@ -33,6 +33,7 @@ export declare class PlayerCore extends EventEmitter {
     move(from: number, to: number): void;
     play(index?: number): Promise<void>;
     pause(): Promise<void>;
+    stop(): Promise<void>;
     resume(): Promise<void>;
     next(): Promise<void>;
     previous(): Promise<void>;

package/build/player.d.ts.map

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