yandex-music-desktop-library 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WebAFilippov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,287 @@
+# Yandex Music Desktop Library
+
+[![npm version](https://badge.fury.io/js/yandex-music-desktop-library.svg)](https://www.npmjs.com/package/yandex-music-desktop-library)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+TypeScript library for controlling **Yandex Music desktop application** on Windows. Provides event-based and promise-based APIs for media control, volume management, and real-time track information.
+
+## ⚠️ Requirements
+
+- **Windows 10/11** (version 1809 or later)
+- **Node.js** 14.0.0 or later
+- **Yandex Music** desktop application installed and running
+
+## 🚀 Installation
+
+```bash
+npm install yandex-music-desktop-library
+```
+
+## 📖 Quick Start
+
+```typescript
+import { YandexMusicController } from 'yandex-music-desktop-library';
+
+// Create controller with custom options
+const controller = new YandexMusicController({
+  thumbnailSize: 200,      // Thumbnail size in pixels (default: 150)
+  thumbnailQuality: 90,    // JPEG quality 1-100 (default: 85)
+  autoRestart: true,       // Auto-restart on crash (default: true)
+  restartDelay: 1000       // Restart delay in ms (default: 1000)
+});
+
+// Event-based API - listen for track changes
+controller.on('track', (track) => {
+  if (track) {
+    console.log(`🎵 Now playing: ${track.title} by ${track.artist}`);
+    console.log(`📀 Album: ${track.album}`);
+    console.log(`🔊 Volume: ${track.volume}% (Muted: ${track.isMuted})`);
+    console.log(`▶️ Status: ${track.playbackStatus}`);
+  } else {
+    console.log('⏹️ Yandex Music is not running');
+  }
+});
+
+// Listen for volume changes
+controller.on('volume', ({ volume, isMuted }) => {
+  console.log(`🔊 Volume changed: ${volume}% (Muted: ${isMuted})`);
+});
+
+// Handle errors
+controller.on('error', (error) => {
+  console.error('Controller error:', error.message);
+});
+
+// Start the controller
+await controller.start();
+
+// Promise-based API - control playback
+await controller.playPause();
+await controller.next();
+await controller.previous();
+
+// Control volume
+await controller.setVolume(75);
+await controller.volumeUp(5);   // Increase by 5%
+await controller.volumeDown(3); // Decrease by 3%
+await controller.toggleMute();
+
+// Stop the controller
+await controller.stop();
+```
+
+## 🔌 Electron Integration
+
+### Basic Usage
+
+```typescript
+import { YandexMusicController } from 'yandex-music-desktop-library';
+import { ipcMain } from 'electron';
+
+const controller = new YandexMusicController({
+  thumbnailSize: 150,
+  thumbnailQuality: 85,
+  autoRestart: true
+});
+
+// Start controller when app is ready
+app.whenReady().then(async () => {
+  await controller.start();
+});
+
+// IPC handlers for renderer process
+ipcMain.handle('play-pause', () => controller.playPause());
+ipcMain.handle('next-track', () => controller.next());
+ipcMain.handle('previous-track', () => controller.previous());
+ipcMain.handle('set-volume', (_, value) => controller.setVolume(value));
+ipcMain.handle('volume-up', (_, step) => controller.volumeUp(step));
+ipcMain.handle('volume-down', (_, step) => controller.volumeDown(step));
+ipcMain.handle('toggle-mute', () => controller.toggleMute());
+
+// Send track updates to renderer
+controller.on('track', (track) => {
+  mainWindow.webContents.send('track-update', track);
+});
+
+controller.on('volume', (volume) => {
+  mainWindow.webContents.send('volume-update', volume);
+});
+
+// Cleanup on quit
+app.on('before-quit', async () => {
+  await controller.stop();
+});
+```
+
+### Production Build with electron-builder
+
+Add to your `package.json`:
+
+```json
+{
+  "build": {
+    "asarUnpack": [
+      "node_modules/yandex-music-desktop-library/bin/**/*"
+    ]
+  }
+}
+```
+
+This ensures the C# executable is unpacked from the ASAR archive so it can be spawned.
+
+## 📡 MQTT / ESP32 Integration
+
+Perfect for DIY hardware controllers:
+
+```typescript
+import { YandexMusicController } from 'yandex-music-desktop-library';
+import mqtt from 'mqtt';
+
+const controller = new YandexMusicController();
+const client = mqtt.connect('mqtt://your-esp32-ip');
+
+// Start controller
+await controller.start();
+
+// Send track data to ESP32
+controller.on('track', (track) => {
+  if (track) {
+    client.publish('media/current', JSON.stringify({
+      title: track.title,
+      artist: track.artist,
+      album: track.album,
+      volume: track.volume,
+      isMuted: track.isMuted,
+      status: track.playbackStatus,
+      hasThumbnail: !!track.thumbnailBase64
+    }));
+
+    // Send thumbnail separately (it's large)
+    if (track.thumbnailBase64) {
+      client.publish('media/thumbnail', track.thumbnailBase64);
+    }
+  }
+});
+
+// Receive commands from ESP32
+client.subscribe('esp32/commands');
+client.on('message', (topic, message) => {
+  const cmd = message.toString();
+  
+  switch (cmd) {
+    case 'playpause':
+      controller.playPause();
+      break;
+    case 'next':
+      controller.next();
+      break;
+    case 'prev':
+      controller.previous();
+      break;
+    case 'vol_up':
+      controller.volumeUp(5);
+      break;
+    case 'vol_down':
+      controller.volumeDown(5);
+      break;
+    case 'mute':
+      controller.toggleMute();
+      break;
+  }
+});
+```
+
+## 📋 API Reference
+
+### ControllerOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `thumbnailSize` | `number` | `150` | Thumbnail size in pixels (1-1000) |
+| `thumbnailQuality` | `number` | `85` | JPEG quality (1-100) |
+| `autoRestart` | `boolean` | `true` | Auto-restart on crash |
+| `restartDelay` | `number` | `1000` | Restart delay in milliseconds |
+
+### TrackData
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `id` | `string` | Session unique identifier |
+| `appId` | `string` | Application identifier |
+| `appName` | `string` | Human-readable app name |
+| `title` | `string` | Track title |
+| `artist` | `string` | Track artist |
+| `album` | `string` | Album name |
+| `playbackStatus` | `'Playing' \| 'Paused' \| 'Stopped' \| 'Unknown'` | Current playback status |
+| `thumbnailBase64` | `string \| null` | Base64-encoded JPEG thumbnail |
+| `isFocused` | `boolean` | Whether this is the focused session |
+| `volume` | `number` | System volume level (0-100) |
+| `isMuted` | `boolean` | Whether volume is muted |
+
+### YandexMusicController
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `start()` | `Promise<void>` | Start the controller |
+| `stop()` | `Promise<void>` | Stop the controller |
+| `isRunning()` | `boolean` | Check if controller is active |
+| `play()` | `Promise<void>` | Start playback |
+| `pause()` | `Promise<void>` | Pause playback |
+| `playPause()` | `Promise<void>` | Toggle play/pause |
+| `next()` | `Promise<void>` | Skip to next track |
+| `previous()` | `Promise<void>` | Skip to previous track |
+| `volumeUp(stepPercent?)` | `Promise<void>` | Increase volume (default step: 3) |
+| `volumeDown(stepPercent?)` | `Promise<void>` | Decrease volume (default step: 3) |
+| `setVolume(value)` | `Promise<void>` | Set volume to specific value (0-100) |
+| `toggleMute()` | `Promise<void>` | Toggle mute state |
+
+#### Events
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `track` | `TrackData \| null` | Emitted when track changes or Yandex Music state changes |
+| `volume` | `{ volume: number, isMuted: boolean }` | Emitted when system volume changes |
+| `error` | `Error` | Emitted when an error occurs |
+| `exit` | `number \| null` | Emitted when the controller process exits |
+
+## 🛠️ Development
+
+```bash
+# Clone repository
+git clone https://github.com/WebAFilippov/yandexMusic-desktop-library.git
+cd yandexMusic-desktop-library
+
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# The C# executable will be automatically built and included in bin/win-x64/
+```
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 🐛 Issues
+
+If you find a bug, please [create an issue](https://github.com/WebAFilippov/yandexMusic-desktop-library/issues) with:
+- Windows version
+- Node.js version
+- Steps to reproduce
+- Error messages (if any)
+
+## 💡 Related Projects
+
+- [YandexMusicController](https://github.com/WebAFilippov/af-csharp-yandexMusic) - The C# backend service
+
+---
+
+**Note**: This package is for Windows only and requires the Yandex Music desktop application to be installed.

package/dist/controller.d.ts

@@ -0,0 +1,96 @@
+import { EventEmitter } from 'events';
+import { ControllerOptions } from './types.js';
+/**
+ * Controller for Yandex Music desktop application on Windows.
+ * Provides both event-based and promise-based APIs for controlling playback and volume.
+ *
+ * @example
+ * ```typescript
+ * import { YandexMusicController } from 'yandex-music-desktop-library';
+ *
+ * const controller = new YandexMusicController({
+ *   thumbnailSize: 200,
+ *   thumbnailQuality: 90,
+ *   autoRestart: true
+ * });
+ *
+ * // Event-based API
+ * controller.on('track', (track) => {
+ *   console.log(`Now playing: ${track?.title} by ${track?.artist}`);
+ * });
+ *
+ * await controller.start();
+ * await controller.playPause();
+ * await controller.setVolume(75);
+ * ```
+ */
+export declare class YandexMusicController extends EventEmitter {
+    private process?;
+    private options;
+    private restartTimer?;
+    private isStarted;
+    private executablePath;
+    /**
+     * Creates a new YandexMusicController instance
+     * @param options - Configuration options
+     */
+    constructor(options?: ControllerOptions);
+    private clamp;
+    /**
+     * Starts the controller and spawns the C# process
+     * @returns Promise that resolves when controller is ready
+     * @throws Error if controller is already running or fails to start
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the controller and kills the C# process
+     * @returns Promise that resolves when process is terminated
+     */
+    stop(): Promise<void>;
+    /**
+     * Checks if the controller is currently running
+     * @returns true if process is active
+     */
+    isRunning(): boolean;
+    private sendCommand;
+    /**
+     * Start playback
+     */
+    play(): Promise<void>;
+    /**
+     * Pause playback
+     */
+    pause(): Promise<void>;
+    /**
+     * Toggle between play and pause
+     */
+    playPause(): Promise<void>;
+    /**
+     * Skip to next track
+     */
+    next(): Promise<void>;
+    /**
+     * Skip to previous track
+     */
+    previous(): Promise<void>;
+    /**
+     * Increase volume by specified step
+     * @param stepPercent - Percentage to increase (default: 3)
+     */
+    volumeUp(stepPercent?: number): Promise<void>;
+    /**
+     * Decrease volume by specified step
+     * @param stepPercent - Percentage to decrease (default: 3)
+     */
+    volumeDown(stepPercent?: number): Promise<void>;
+    /**
+     * Set volume to specific value
+     * @param value - Volume level 0-100
+     */
+    setVolume(value: number): Promise<void>;
+    /**
+     * Toggle mute state
+     */
+    toggleMute(): Promise<void>;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,EAAE,iBAAiB,EAAyB,MAAM,YAAY,CAAC;AAgBtE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAE/B;;;OAGG;gBACS,OAAO,GAAE,iBAAsB;IAY3C,OAAO,CAAC,KAAK;IAIb;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+F5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC3B;;;OAGG;IACH,SAAS,IAAI,OAAO;YAIN,WAAW;IAmBzB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;;OAGG;IACG,QAAQ,CAAC,WAAW,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;;OAGG;IACG,UAAU,CAAC,WAAW,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/controller.js

@@ -0,0 +1,270 @@
+import { spawn } from 'child_process';
+import { createInterface } from 'readline';
+import { EventEmitter } from 'events';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { promises as fs } from 'fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Controller for Yandex Music desktop application on Windows.
+ * Provides both event-based and promise-based APIs for controlling playback and volume.
+ *
+ * @example
+ * ```typescript
+ * import { YandexMusicController } from 'yandex-music-desktop-library';
+ *
+ * const controller = new YandexMusicController({
+ *   thumbnailSize: 200,
+ *   thumbnailQuality: 90,
+ *   autoRestart: true
+ * });
+ *
+ * // Event-based API
+ * controller.on('track', (track) => {
+ *   console.log(`Now playing: ${track?.title} by ${track?.artist}`);
+ * });
+ *
+ * await controller.start();
+ * await controller.playPause();
+ * await controller.setVolume(75);
+ * ```
+ */
+export class YandexMusicController extends EventEmitter {
+    process;
+    options;
+    restartTimer;
+    isStarted = false;
+    executablePath;
+    /**
+     * Creates a new YandexMusicController instance
+     * @param options - Configuration options
+     */
+    constructor(options = {}) {
+        super();
+        this.options = {
+            thumbnailSize: this.clamp(options.thumbnailSize ?? 150, 1, 1000),
+            thumbnailQuality: this.clamp(options.thumbnailQuality ?? 85, 1, 100),
+            autoRestart: options.autoRestart ?? true,
+            restartDelay: Math.max(options.restartDelay ?? 1000, 0)
+        };
+        this.executablePath = join(__dirname, '..', 'bin', 'win-x64', 'YandexMusicController.exe');
+    }
+    clamp(value, min, max) {
+        return Math.min(Math.max(value, min), max);
+    }
+    /**
+     * Starts the controller and spawns the C# process
+     * @returns Promise that resolves when controller is ready
+     * @throws Error if controller is already running or fails to start
+     */
+    async start() {
+        if (this.isRunning()) {
+            throw new Error('Controller is already running');
+        }
+        // Verify executable exists
+        try {
+            await fs.access(this.executablePath);
+        }
+        catch {
+            throw new Error(`Executable not found at: ${this.executablePath}`);
+        }
+        const args = [
+            `--thumbnail-size=${this.options.thumbnailSize}`,
+            `--thumbnail-quality=${this.options.thumbnailQuality}`
+        ];
+        return new Promise((resolve, reject) => {
+            try {
+                this.process = spawn(this.executablePath, args, {
+                    windowsHide: true,
+                    stdio: ['pipe', 'pipe', 'pipe']
+                });
+                this.process.on('error', (err) => {
+                    this.emit('error', err);
+                    reject(err);
+                });
+                this.process.on('exit', (code) => {
+                    this.isStarted = false;
+                    this.emit('exit', code);
+                    if (this.options.autoRestart && code !== 0 && !this.restartTimer) {
+                        this.restartTimer = setTimeout(() => {
+                            this.restartTimer = undefined;
+                            this.start().catch(() => {
+                                // Auto-restart failed, emit error
+                                this.emit('error', new Error('Auto-restart failed'));
+                            });
+                        }, this.options.restartDelay);
+                    }
+                });
+                // Handle stdout for JSON messages
+                if (this.process.stdout) {
+                    const rl = createInterface({
+                        input: this.process.stdout,
+                        crlfDelay: Infinity
+                    });
+                    rl.on('line', (line) => {
+                        try {
+                            const msg = JSON.parse(line);
+                            if (msg.type === 'session') {
+                                this.emit('track', msg.data);
+                                // Also emit volume event when track data changes
+                                if (msg.data) {
+                                    this.emit('volume', {
+                                        volume: msg.data.volume,
+                                        isMuted: msg.data.isMuted
+                                    });
+                                }
+                            }
+                        }
+                        catch {
+                            // Ignore non-JSON lines (debug output)
+                        }
+                    });
+                }
+                // Handle stderr for errors
+                if (this.process.stderr) {
+                    const rl = createInterface({
+                        input: this.process.stderr,
+                        crlfDelay: Infinity
+                    });
+                    rl.on('line', (line) => {
+                        this.emit('error', new Error(line));
+                    });
+                }
+                // Wait a moment for process to initialize
+                setTimeout(() => {
+                    this.isStarted = true;
+                    resolve();
+                }, 500);
+            }
+            catch (err) {
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    /**
+     * Stops the controller and kills the C# process
+     * @returns Promise that resolves when process is terminated
+     */
+    async stop() {
+        if (!this.isRunning()) {
+            return;
+        }
+        // Clear restart timer
+        if (this.restartTimer) {
+            clearTimeout(this.restartTimer);
+            this.restartTimer = undefined;
+        }
+        return new Promise((resolve) => {
+            if (!this.process) {
+                resolve();
+                return;
+            }
+            // Send close command
+            this.sendCommand({ command: 'close' });
+            // Wait for graceful exit
+            const timeout = setTimeout(() => {
+                this.process?.kill();
+                this.isStarted = false;
+                resolve();
+            }, 1000);
+            this.process.on('exit', () => {
+                clearTimeout(timeout);
+                this.isStarted = false;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Checks if the controller is currently running
+     * @returns true if process is active
+     */
+    isRunning() {
+        return this.isStarted && this.process !== undefined && !this.process.killed;
+    }
+    async sendCommand(cmd) {
+        if (!this.isRunning()) {
+            throw new Error('Controller is not running. Call start() first.');
+        }
+        return new Promise((resolve, reject) => {
+            const message = JSON.stringify(cmd) + '\n';
+            this.process.stdin.write(message, (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    // Playback Controls
+    /**
+     * Start playback
+     */
+    async play() {
+        return this.sendCommand({ command: 'play' });
+    }
+    /**
+     * Pause playback
+     */
+    async pause() {
+        return this.sendCommand({ command: 'pause' });
+    }
+    /**
+     * Toggle between play and pause
+     */
+    async playPause() {
+        return this.sendCommand({ command: 'playpause' });
+    }
+    /**
+     * Skip to next track
+     */
+    async next() {
+        return this.sendCommand({ command: 'next' });
+    }
+    /**
+     * Skip to previous track
+     */
+    async previous() {
+        return this.sendCommand({ command: 'previous' });
+    }
+    // Volume Controls
+    /**
+     * Increase volume by specified step
+     * @param stepPercent - Percentage to increase (default: 3)
+     */
+    async volumeUp(stepPercent = 3) {
+        return this.sendCommand({
+            command: 'volume_up',
+            stepPercent: this.clamp(stepPercent, 1, 100)
+        });
+    }
+    /**
+     * Decrease volume by specified step
+     * @param stepPercent - Percentage to decrease (default: 3)
+     */
+    async volumeDown(stepPercent = 3) {
+        return this.sendCommand({
+            command: 'volume_down',
+            stepPercent: this.clamp(stepPercent, 1, 100)
+        });
+    }
+    /**
+     * Set volume to specific value
+     * @param value - Volume level 0-100
+     */
+    async setVolume(value) {
+        return this.sendCommand({
+            command: 'set_volume',
+            value: this.clamp(value, 0, 100)
+        });
+    }
+    /**
+     * Toggle mute state
+     */
+    async toggleMute() {
+        return this.sendCommand({ command: 'toggle_mute' });
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Yandex Music Desktop Library
+ *
+ * TypeScript library for controlling Yandex Music desktop application on Windows.
+ * Provides event-based and promise-based APIs for media control and volume management.
+ *
+ * @packageDocumentation
+ */
+export { YandexMusicController } from './controller.js';
+export type { ControllerOptions, TrackData, VolumeData, ControllerEvents } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Yandex Music Desktop Library
+ *
+ * TypeScript library for controlling Yandex Music desktop application on Windows.
+ * Provides event-based and promise-based APIs for media control and volume management.
+ *
+ * @packageDocumentation
+ */
+export { YandexMusicController } from './controller.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Options for configuring the YandexMusicController
+ */
+export interface ControllerOptions {
+    /**
+     * Thumbnail size in pixels. Must be between 1 and 1000.
+     * @default 150
+     */
+    thumbnailSize?: number;
+    /**
+     * JPEG quality for thumbnails. Must be between 1 and 100.
+     * @default 85
+     */
+    thumbnailQuality?: number;
+    /**
+     * Whether to automatically restart the controller if it crashes.
+     * @default true
+     */
+    autoRestart?: boolean;
+    /**
+     * Delay in milliseconds before auto-restart.
+     * @default 1000
+     */
+    restartDelay?: number;
+}
+/**
+ * Data about the currently playing track
+ */
+export interface TrackData {
+    /**
+     * Unique identifier for the session
+     */
+    id: string;
+    /**
+     * Application identifier
+     */
+    appId: string;
+    /**
+     * Human-readable application name
+     */
+    appName: string;
+    /**
+     * Track title
+     */
+    title: string;
+    /**
+     * Track artist
+     */
+    artist: string;
+    /**
+     * Album name
+     */
+    album: string;
+    /**
+     * Current playback status
+     */
+    playbackStatus: 'Playing' | 'Paused' | 'Stopped' | 'Unknown';
+    /**
+     * Base64-encoded thumbnail image (JPEG), or null if not available
+     */
+    thumbnailBase64: string | null;
+    /**
+     * Whether this is the currently focused media session
+     */
+    isFocused: boolean;
+    /**
+     * Current system volume level (0-100)
+     */
+    volume: number;
+    /**
+     * Whether the system volume is muted
+     */
+    isMuted: boolean;
+}
+/**
+ * Volume change event data
+ */
+export interface VolumeData {
+    /**
+     * Current volume level (0-100)
+     */
+    volume: number;
+    /**
+     * Whether volume is muted
+     */
+    isMuted: boolean;
+}
+/**
+ * Events emitted by YandexMusicController
+ */
+export interface ControllerEvents {
+    /**
+     * Emitted when track information changes or when Yandex Music state changes
+     */
+    track: [data: TrackData | null];
+    /**
+     * Emitted when system volume changes
+     */
+    volume: [data: VolumeData];
+    /**
+     * Emitted when an error occurs
+     */
+    error: [error: Error];
+    /**
+     * Emitted when the controller process exits
+     */
+    exit: [code: number | null];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAE7D;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE3B;;OAEG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEtB;;OAEG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "yandex-music-desktop-library",
+  "version": "1.0.0",
+  "description": "TypeScript library for controlling Yandex Music desktop application on Windows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "win32"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "yandex",
+    "music",
+    "desktop",
+    "windows",
+    "media",
+    "controller",
+    "typescript"
+  ],
+  "author": "WebAFilippov",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/WebAFilippov/yandexMusic-desktop-library.git"
+  },
+  "bugs": {
+    "url": "https://github.com/WebAFilippov/yandexMusic-desktop-library/issues"
+  },
+  "homepage": "https://github.com/WebAFilippov/yandexMusic-desktop-library#readme",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "bin/**/*",
+    "README.md",
+    "LICENSE"
+  ]
+}