fix(dev): rebuild audify for Electron on npm install

README.md

@@ -1207,6 +1207,8 @@ computes the FFT, and sends frames to the renderer.
 npm install
 ```
 
+After `npm install`, the `audify` native module is rebuilt for Electron automatically (`postinstall` → `rebuild:audio`). Without that step, source `npm start` can show `INVALID_HELPER_OUTPUT` from the audio helper. Manual: `npm run rebuild:audio`, then `npm run check:runtime`.
+
 ```bash
 npm start
 ```

README.tr.md

@@ -1204,6 +1204,8 @@ okur, FFT'yi hesaplar ve kareleri arayüze gönderir.
 npm install
 ```
 
+`npm install` bitince `audify` native modülü Electron için otomatik yeniden derlenir (`postinstall` → `rebuild:audio`). Bu adım olmazsa kaynaktan `npm start` ses yardımcı sürecinde `INVALID_HELPER_OUTPUT` verebilir. Elle: `npm run rebuild:audio`, sonra `npm run check:runtime`.
+
 ```bash
 npm start
 ```

package.json

@@ -1,7 +1,7 @@
 {
   "name": "soundvisualizer",
   "version": "3.1.4",
-  "description": "CAYADEV — çoklu ekran, OBS yayın çıkışı ve Studio shader editörü olan ses görselleştirici (Windows + macOS)",
+  "description": "CAYADEV \u2014 \u00e7oklu ekran, OBS yay\u0131n \u00e7\u0131k\u0131\u015f\u0131 ve Studio shader edit\u00f6r\u00fc olan ses g\u00f6rselle\u015ftirici (Windows + macOS)",
   "main": "src/main/main.js",
   "author": {
     "name": "CAYADEV",
@@ -17,6 +17,8 @@
   "scripts": {
     "start": "node scripts/start.js",
     "dev": "node scripts/start.js --dev",
+    "postinstall": "node scripts/rebuild-audify.js",
+    "rebuild:audio": "node scripts/rebuild-audify.js",
     "icons": "node scripts/gen-icons.js",
     "prepare:smtc": "node scripts/prepare-smtc.js",
     "prepare:appaudio": "node scripts/prepare-app-audio.js",
@@ -31,6 +33,7 @@
   },
   "devDependencies": {
     "@electron/packager": "^20.0.0",
+    "@electron/rebuild": "^4.2.0",
     "electron": "^43.6.0",
     "electron-builder": "^26.15.3",
     "node-gyp": "^12.3.0",

scripts/rebuild-audify.js

@@ -0,0 +1,58 @@
+'use strict';
+/* Kaynaktan `npm install` sonrası audify native ikilisini Electron ABI'sine
+   göre derler. Yapılmazsa loopback-helper stdout'ta geçerli JSON üretemez
+   ve Admin `INVALID_HELPER_OUTPUT` gösterir (ZIP + npm start senaryosu).
+
+   Sürüm (.exe) paketleri bunu paketleme sırasında zaten alır; bu betik
+   yalnız geliştirme kurulumuna yöneliktir. */
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const root = path.join(__dirname, '..');
+const cli = path.join(root, 'node_modules', '@electron', 'rebuild', 'lib', 'cli.js');
+
+let electronPath = null;
+try {
+  electronPath = require('electron');
+} catch {
+  electronPath = null;
+}
+
+if (typeof electronPath !== 'string' || !fs.existsSync(electronPath)) {
+  console.warn('[rebuild-audify] Electron henüz yok; atlanıyor.');
+  process.exit(0);
+}
+
+if (!fs.existsSync(cli)) {
+  console.warn('[rebuild-audify] @electron/rebuild bulunamadı; atlanıyor.');
+  process.exit(0);
+}
+
+console.log('[rebuild-audify] audify → Electron native rebuild…');
+const result = spawnSync(process.execPath, [cli, '-f', '-w', 'audify'], {
+  cwd: root,
+  stdio: 'inherit',
+  windowsHide: true,
+  env: process.env,
+});
+
+if (result.error) {
+  console.error('[rebuild-audify] başarısız:', result.error.message);
+  console.error('Elle deneyin: npm run rebuild:audio');
+  process.exit(0);
+}
+if (result.status !== 0) {
+  console.error('[rebuild-audify] çıkış kodu ' + (result.status || 1));
+  console.error('Elle deneyin: npm run rebuild:audio  (Windows: Visual Studio Build Tools gerekebilir)');
+  /* postinstall'ı tamamen düşürme: katkıcılar sadece UI bakabilsin.
+     Ses için check:runtime / rebuild:audio yeterli sinyal. */
+  process.exit(0);
+}
+
+const built = path.join(root, 'node_modules', 'audify', 'build', 'Release', 'audify.node');
+if (fs.existsSync(built)) {
+  console.log('[rebuild-audify] tamam: ' + built);
+} else {
+  console.warn('[rebuild-audify] bitti ama audify.node bulunamadı; npm run check:runtime ile doğrulayın.');
+}