@ing.jorgeu/wargaming-overlay 2.5.0 → 3.1.0

package/tts/playback.js

@@ -0,0 +1,28 @@
+// No external player: the npm package contains native CoreAudio/WASAPI/ALSA bindings.
+async function play(samples,sampleRate,{cpal=require('node-cpal')}={}){
+ let host,device,stream;
+ try{
+  host=cpal.defaultHost();device=host.defaultOutputDevice();
+  if(!device)throw Error('No hay salida de audio predeterminada.');
+  let supported=device.defaultOutputConfig();
+  if(supported.sampleFormat()!==cpal.SampleFormat.F32){
+   const candidate=[...device.supportedOutputConfigs()].find(c=>c.sampleFormat()===cpal.SampleFormat.F32);
+   if(!candidate)throw Error('La salida de audio no admite float32.');
+   supported=candidate.tryWithSampleRate(supported.sampleRate())||candidate.tryWithStandardSampleRate()||candidate.withMaxSampleRate();
+  }
+  const config=supported.config();let position=0,finished=false,drainTimer;
+  await new Promise((resolve,reject)=>{
+   stream=device.buildOutputStream(config,cpal.SampleFormat.F32,data=>{
+    for(let frame=0;frame<data.length/config.channels;frame++){
+     const left=Math.floor(position),fraction=position-left;
+     const sample=left<samples.length?(samples[left]*(1-fraction)+(samples[Math.min(left+1,samples.length-1)]||0)*fraction):0;
+     for(let channel=0;channel<config.channels;channel++)data[frame*config.channels+channel]=sample;
+     position+=sampleRate/config.sampleRate;
+    }
+    if(position>=samples.length&&!finished){finished=true;drainTimer=setTimeout(resolve,Math.ceil(data.length/config.channels/config.sampleRate*1000)+250);}
+   },error=>{clearTimeout(drainTimer);reject(error);});
+   stream.play();
+  });
+ }finally{stream?.close();device?.close();host?.close();}
+}
+module.exports={play};

package/tts/speech.js

@@ -1,12 +1,15 @@
 const {spawn}=require('node:child_process');
-function speak(text,{spawnImpl=spawn,platform=process.platform,signal,timeoutMs=120000}={}){
+function say(text,{spawnImpl=spawn,platform=process.platform,signal,timeoutMs=120000}={}){
  if(platform!=='darwin')return Promise.reject(Error('El TTS local requiere macOS.'));
  if(signal?.aborted)return Promise.resolve();
  return new Promise((resolve,reject)=>{
   // Feed text through stdin, not a shell/option. Remove Apple's embedded speech commands.
   const child=spawnImpl('/usr/bin/say',[],{stdio:['pipe','ignore','pipe'],shell:false});
   let timedOut=false,done=false;
-  const stop=()=>child.kill('SIGKILL');
+  const stop=()=>{
+   if(platform==='win32'&&child.pid){const killer=spawnImpl('taskkill.exe',['/PID',String(child.pid),'/T','/F'],{shell:false,windowsHide:true,stdio:'ignore'});killer.once('error',()=>child.kill('SIGKILL'));killer.unref?.();}
+   else child.kill('SIGKILL');
+  };
   const timer=setTimeout(()=>{timedOut=true;stop();},timeoutMs);
   const finish=(error)=>{if(done)return;done=true;clearTimeout(timer);signal?.removeEventListener('abort',stop);error?reject(error):resolve();};
   signal?.addEventListener('abort',stop,{once:true});
@@ -17,4 +20,53 @@ function speak(text,{spawnImpl=spawn,platform=process.platform,signal,timeoutMs=
   if(signal?.aborted)stop();
  });
 }
-module.exports={speak};
+
+
+const path=require('node:path'),fs=require('node:fs'),os=require('node:os');
+const {cacheDirectory}=require('./kokoro-assets');
+function settings(config={},env=process.env,platform=process.platform){
+ const opts={provider:env.TTS_PROVIDER||config.ttsProvider||'kokoro',fallback:env.TTS_FALLBACK||config.ttsFallback||(platform==='darwin'?'say':'none'),voice:env.KOKORO_VOICE||config.kokoroVoice||'ef_dora',speed:Number(env.KOKORO_SPEED??config.kokoroSpeed??1),cacheDir:env.KOKORO_CACHE_DIR||config.kokoroCacheDir||cacheDirectory()};
+ if(!['kokoro','say'].includes(opts.provider))throw Error('ttsProvider debe ser kokoro o say.');
+ if(!['say','none'].includes(opts.fallback))throw Error('ttsFallback debe ser say o none.');
+ if((opts.provider==='say'||opts.fallback==='say')&&platform!=='darwin')throw Error('say solo está disponible en macOS. Usa kokoro y ttsFallback=none.');
+ if(!['ef_dora','em_alex','em_santa'].includes(opts.voice))throw Error('kokoroVoice debe ser ef_dora, em_alex o em_santa.');
+ if(!Number.isFinite(opts.speed)||opts.speed<0.5||opts.speed>2)throw Error('kokoroSpeed debe estar entre 0.5 y 2.');
+ if(typeof opts.cacheDir!=='string'||!opts.cacheDir)throw Error('kokoroCacheDir debe ser una ruta.');
+ return opts;
+}
+function kokoro(text,{spawnImpl=spawn,platform=process.platform,signal,timeoutMs=120000,log=console.log,...opts}={}){
+ if(signal?.aborted)return Promise.resolve();
+ return new Promise((resolve,reject)=>{
+  const temporary=fs.mkdtempSync(path.join(os.tmpdir(),'overlay-tts-'));
+  const child=spawnImpl(process.execPath,[path.join(__dirname,'kokoro-worker.js')],{stdio:['pipe','ignore','pipe'],shell:false,windowsHide:true,cwd:temporary,...(temporary?{env:{...process.env,OVERLAY_TTS_TEMP_DIR:temporary}}:{})});
+  let done=false,timedOut=false;
+  const stop=()=>{
+   if(platform==='win32'&&child.pid){const killer=spawnImpl('taskkill.exe',['/PID',String(child.pid),'/T','/F'],{shell:false,windowsHide:true,stdio:'ignore'});killer.once('error',()=>child.kill('SIGKILL'));killer.unref?.();}
+   else child.kill('SIGKILL');
+  };
+  const timer=setTimeout(()=>{timedOut=true;stop();},timeoutMs);
+  const finish=error=>{if(done)return;done=true;clearTimeout(timer);signal?.removeEventListener('abort',stop);
+   const cleanup=temporary?require('node:fs/promises').rm(temporary,{recursive:true,force:true,maxRetries:5,retryDelay:100}).catch(()=>log('[TTS] No se pudo limpiar un archivo de audio temporal.')):Promise.resolve();
+   cleanup.then(()=>error?reject(error):resolve());
+  };
+  signal?.addEventListener('abort',stop,{once:true});
+  let stderr='';child.stderr?.setEncoding('utf8');child.stderr?.on('data',chunk=>{stderr=(stderr+chunk).slice(-4000);});
+  child.stdin.on('error',()=>{});
+  child.once('error',()=>finish(Error('No se pudo iniciar Kokoro.')));
+  child.once('close',code=>{if(stderr.trim())log(stderr.trim());finish(signal?.aborted?null:timedOut?Error('Se agotó el tiempo de Kokoro.'):code===0?null:Error('Falló Kokoro o la salida de audio.'));});
+  child.stdin.end(JSON.stringify({text:String(text),voice:opts.voice,speed:opts.speed,cacheDir:opts.cacheDir}));
+  if(signal?.aborted)stop();
+ });
+}
+function createSpeech(config={}, {env=process.env,platform=process.platform,log=console.log,spawnImpl=spawn}={}){
+ const opts=settings(config,env,platform);
+ return async(text,options={})=>{
+  if(options.signal?.aborted)return;
+  const common={...options,platform,spawnImpl,log};
+  if(opts.provider==='say')return say(text,common);
+  try{await kokoro(text,{...common,...opts});}
+  catch(e){if(options.signal?.aborted)return;if(opts.fallback!=='say')throw e;log('[TTS] Kokoro falló; leyendo este mensaje con say.');await say(text,common);}
+ };
+}
+function speak(text,options={}){return createSpeech(options.config,{env:options.env,platform:options.platform,log:options.log,spawnImpl:options.spawnImpl})(text,options);}
+module.exports={speak,say,kokoro,createSpeech,settings};

package/tts/voice-command.js

@@ -0,0 +1,14 @@
+const fs=require('node:fs'),path=require('node:path');
+const {createSpeech}=require('./speech');
+async function testVoice(text,{dataDir,provider,voice,speed,fallback}={}, {speechFactory=createSpeech,signals=process,env=process.env}={}){
+ if(typeof text!=='string'||!text.trim())throw Error('Indica un texto: wargaming-overlay --test-tts "Hola, esta es una prueba."');
+ let config={};
+ if(dataDir){try{config=JSON.parse(fs.readFileSync(path.join(dataDir,'youtube-tts.json'),'utf8'));}catch(e){if(e.code!=='ENOENT')throw Error('Configuración youtube-tts.json inválida.');}}
+ // CLI overrides environment and file settings, without changing the saved configuration.
+ const overrides={...env};
+ for(const [key,value] of Object.entries({TTS_PROVIDER:provider,KOKORO_VOICE:voice,KOKORO_SPEED:speed,TTS_FALLBACK:fallback}))if(value!==undefined)overrides[key]=String(value);
+ const speech=speechFactory(config,{env:overrides});const controller=new AbortController();
+ const stop=()=>controller.abort();signals.once('SIGINT',stop);signals.once('SIGTERM',stop);
+ try{await speech(text,{signal:controller.signal});}finally{signals.removeListener('SIGINT',stop);signals.removeListener('SIGTERM',stop);}
+}
+module.exports={testVoice};

package/tts/wav.js

@@ -0,0 +1,6 @@
+function wav(samples,sampleRate){
+ const data=Buffer.alloc(44+samples.length*2);data.write('RIFF');data.writeUInt32LE(data.length-8,4);data.write('WAVEfmt ',8);data.writeUInt32LE(16,16);data.writeUInt16LE(1,20);data.writeUInt16LE(1,22);data.writeUInt32LE(sampleRate,24);data.writeUInt32LE(sampleRate*2,28);data.writeUInt16LE(2,32);data.writeUInt16LE(16,34);data.write('data',36);data.writeUInt32LE(samples.length*2,40);
+ for(let i=0;i<samples.length;i++)data.writeInt16LE(Math.round(Math.max(-1,Math.min(1,samples[i]))*32767),44+i*2);
+ return data;
+}
+module.exports={wav};

package/tts/windows-playback.js

@@ -0,0 +1,14 @@
+const fs=require('node:fs/promises'),os=require('node:os'),path=require('node:path');
+const {spawn}=require('node:child_process');const {wav}=require('./wav');
+async function playWindows(samples,sampleRate,{spawnImpl=spawn}={}){
+ const dir=process.env.OVERLAY_TTS_TEMP_DIR||await fs.mkdtemp(path.join(os.tmpdir(),'overlay-tts-'));const file=path.join(dir,'speech.wav');
+ try{
+  await fs.writeFile(file,wav(samples,sampleRate));
+  await new Promise((resolve,reject)=>{
+   const child=spawnImpl('powershell.exe',['-NoProfile','-NonInteractive','-Command',"$ErrorActionPreference='Stop'; $player=New-Object System.Media.SoundPlayer; try { $player.SoundLocation=$env:OVERLAY_TTS_WAV; $player.Load(); $player.PlaySync() } finally { $player.Dispose() }"],{shell:false,windowsHide:true,stdio:'ignore',env:{...process.env,OVERLAY_TTS_WAV:file}});
+   child.once('error',()=>reject(Error('No se pudo abrir el audio integrado de Windows.')));
+   child.once('close',code=>code===0?resolve():reject(Error('Falló el audio integrado de Windows.')));
+  });
+ }finally{await fs.rm(dir,{recursive:true,force:true});}
+}
+module.exports={playWindows};

package/youtube/index.js

@@ -5,16 +5,19 @@ function configFor(dataDir,env=process.env){
  for(const [key,min,max] of [['maxMessageLength',50,300],['maxQueueLength',1,100]])if(!Number.isInteger(config[key])||config[key]<min||config[key]>max)throw Error(`Configuración ${key} fuera de rango.`);
  for(const key of ['enabled','readUsername','filterUrls'])if(typeof config[key]!=='boolean')throw Error(`Configuración ${key} debe ser true/false.`);
  if(!Array.isArray(config.extraBlockedTerms)||config.extraBlockedTerms.some(t=>typeof t!=='string'||t.length>100))throw Error('extraBlockedTerms debe ser una lista de textos cortos.');
+ if(config.httpFallback!==undefined&&typeof config.httpFallback!=='boolean')throw Error('httpFallback debe ser true/false.');
+ if(config.apiKeyFile){if(typeof config.apiKeyFile!=='string')throw Error('apiKeyFile debe ser una ruta.');try{config.apiKey=fs.readFileSync(path.resolve(config.apiKeyFile),'utf8').trim();}catch{throw Error('No se pudo leer apiKeyFile.');}if(!config.apiKey||/\s/.test(config.apiKey))throw Error('El archivo API key debe contener únicamente la clave.');}
  return config;
 }
 function startYouTube(dataDir,{env=process.env,platform=process.platform,log=console.log}={}){
  if(env.YOUTUBE_CHAT_TTS_ENABLED!=='true'){log('[YouTube] Chat TTS desactivado. Actívalo con YOUTUBE_CHAT_TTS_ENABLED=true.');return null;}
  try{
-  if(platform!=='darwin')throw Error('El TTS local requiere macOS.');
+  if(!['darwin','win32','linux'].includes(platform))throw Error('Sistema no compatible con TTS.');
   const config=configFor(dataDir,env);if(!config.enabled){log('[YouTube] TTS desactivado en configuración.');return null;}
+  require('../tts/speech').settings(config,env,platform);
   const {YouTubeService}=require('./service');
   log('[YouTube] Iniciando chat TTS. Si falta autorización, ejecuta wargaming-overlay youtube-auth --client-secret /ruta/client.json.');
-  return new YouTubeService({config,log}).start();
+  return new YouTubeService({config,log,speech:require('../tts/speech').createSpeech(config,{env,platform,log})}).start();
  }catch(e){log('[YouTube] '+e.message+' El overlay continúa funcionando.');return null;}
 }
 module.exports={startYouTube,configFor};

package/youtube/live-chat.js

@@ -3,7 +3,7 @@ function normalize(item){
  if(item.snippet?.type!==1 || !item.id || typeof item.snippet.textMessageDetails?.messageText!=='string')return null;
  return {id:item.id,type:'youtube_chat_message',author:item.authorDetails?.displayName||'Usuario',text:item.snippet.textMessageDetails.messageText,timestamp:item.snippet.publishedAt,messageType:'textMessageEvent'};
 }
-async function* streamChat({auth,liveChatId,pageToken,signal,createClient}){
+async function* streamChat({auth,liveChatId,pageToken,signal,createClient,apiKey}){
  const grpc=require('@grpc/grpc-js'),loader=require('@grpc/proto-loader');
  const def=loader.loadSync(path.join(__dirname,'chat.proto'));
  const Service=grpc.loadPackageDefinition(def).youtube.api.v3.V3DataLiveChatMessageService;
@@ -11,8 +11,10 @@ async function* streamChat({auth,liveChatId,pageToken,signal,createClient}){
  let call;
  const cancel=()=>call?.cancel();
  try{
-  const token=await auth.token(signal);if(signal?.aborted)return;
-  const meta=new grpc.Metadata();meta.set('authorization',`Bearer ${token}`);
+  const meta=new grpc.Metadata();
+  if(apiKey)meta.set('x-goog-api-key',apiKey);
+  else meta.set('authorization',`Bearer ${await auth.token(signal)}`);
+  if(signal?.aborted)return;
   // Reopen periodically with fresh credentials, retaining the continuation token.
   call=client.streamList({liveChatId,pageToken,part:['id','snippet','authorDetails']},meta,{deadline:Date.now()+45*60*1000});
   signal?.addEventListener('abort',cancel,{once:true});

package/youtube/poll-chat.js

@@ -0,0 +1,15 @@
+const {setTimeout:delay}=require('node:timers/promises');
+async function* pollChat({auth,liveChatId,pageToken,signal,fetchImpl=fetch,sleep=ms=>delay(ms,null,{signal})}){
+ while(!signal?.aborted){
+  const url=new URL('https://www.googleapis.com/youtube/v3/liveChat/messages');
+  url.search=new URLSearchParams({liveChatId,part:'id,snippet,authorDetails',...(pageToken?{pageToken}:{})});
+  const response=await fetchImpl(url,{headers:{Authorization:`Bearer ${await auth.token(signal)}`},signal:signal?AbortSignal.any([signal,AbortSignal.timeout(20000)]):AbortSignal.timeout(20000)});
+  const data=await response.json();
+  if(!response.ok){const reason=data.error?.errors?.[0]?.reason;const code=response.status===401?16:response.status===404?5:['liveChatEnded','liveChatDisabled'].includes(reason)?9:response.status===400?3:response.status===403?7:14;throw Object.assign(Error('No se pudo consultar el chat por HTTP.'),{code});}
+  yield {...data,items:(data.items||[]).map(item=>({...item,snippet:{...item.snippet,type:({textMessageEvent:1,chatEndedEvent:4})[item.snippet?.type]||0}}))};
+  if(data.offlineAt)return;
+  pageToken=data.nextPageToken||pageToken;
+  await sleep(Math.max(15000,Number(data.pollingIntervalMillis)||0));
+ }
+}
+module.exports={pollChat};

package/youtube/service.js

@@ -3,13 +3,14 @@ const {setTimeout:delay}=require('node:timers/promises');
 const {Auth}=require('./auth');
 const {findBroadcast}=require('./live-broadcast');
 const {streamChat,normalize}=require('./live-chat');
+const {pollChat}=require('./poll-chat');
 const {SpeechQueue}=require('../tts/queue');
 const {sanitize}=require('../tts/sanitizer');
 const backoff=[1000,2000,5000,10000,30000];
 class YouTubeService extends EventEmitter {
- constructor({config={},auth=new Auth(),discover=findBroadcast,stream=streamChat,queue,log=console.log,sleep=(ms,signal)=>delay(ms,null,{signal}),now=Date.now}={}){
-  super();this.config=config;this.auth=auth;this.discover=discover;this.stream=stream;this.log=log;this.sleep=sleep;this.now=now;
-  this.queue=queue||new SpeechQueue({maxQueueLength:config.maxQueueLength||10,log});this.state='DISCONNECTED';this.seen=new Set();this.controller=new AbortController();this.chat=null;this.pageToken=undefined;this.task=null;
+ constructor({config={},auth=new Auth(),discover=findBroadcast,stream=streamChat,poll=pollChat,queue,speech,log=console.log,sleep=(ms,signal)=>delay(ms,null,{signal}),now=Date.now}={}){
+  super();this.config=config;this.auth=auth;this.discover=discover;this.stream=stream;this.poll=poll;this.polling=false;this.log=log;this.sleep=sleep;this.now=now;
+  this.queue=queue||new SpeechQueue({maxQueueLength:config.maxQueueLength||10,speech:speech||require('../tts/speech').createSpeech(config,{log}),log});this.state='DISCONNECTED';this.seen=new Set();this.controller=new AbortController();this.chat=null;this.pageToken=undefined;this.task=null;
  }
  status(state,message){if(this.state!==state||this.lastMessage!==message){this.state=state;this.lastMessage=message;this.log('[YouTube] '+message);}}
  start(){if(!this.task)this.task=this.run().catch(()=>{if(!this.controller.signal.aborted)this.status('DISCONNECTED','Servicio detenido por un error inesperado; el overlay continúa.');});return this;}
@@ -26,10 +27,11 @@ class YouTubeService extends EventEmitter {
      this.chat=broadcast.liveChatId;this.pageToken=undefined;this.startedAt=this.now();
      this.log(`[YouTube] Directo detectado${broadcast.multiple?' (hay varios; se usa el primero por ID)':''}.`);
     }
-    let ended=false;
-    this.status('CONNECTED_TO_CHAT','Conectando al chat en vivo mediante streamList…');
-    for await(const batch of this.stream({auth:this.auth,liveChatId:this.chat,pageToken:this.pageToken,signal})){
+    let ended=false,received=false,continuation=false;
+    if(this.state!=='CONNECTED_TO_CHAT')this.status('CONNECTING_TO_CHAT',this.polling?'Conectando al chat mediante HTTP (respaldo, cada 15 s)…':'Conectando al chat en vivo mediante streamList…');
+    for await(const batch of (this.polling?this.poll:this.stream)({auth:this.auth,liveChatId:this.chat,pageToken:this.pageToken,signal,apiKey:this.config.apiKey})){
      if(signal.aborted)break;
+     received=true;continuation=!!batch.nextPageToken;
      failures=0;this.status('CONNECTED_TO_CHAT','Chat conectado; esperando mensajes nuevos.');
      if(batch.offlineAt || (batch.items||[]).some(i=>i.snippet?.type===4)){ended=true;break;}
      for(const item of batch.items||[]){
@@ -47,15 +49,22 @@ class YouTubeService extends EventEmitter {
      this.pageToken=batch.nextPageToken||this.pageToken;
     }
     if(ended){this.endChat();await this.sleep(60000,signal);continue;}
-    if(!signal.aborted)throw Error('Chat connection closed');
+    if(!signal.aborted){
+     // Successful EOF with a cursor is a continuation, not an authentication failure.
+     if(received&&continuation){await this.sleep(1000,signal);continue;}
+     throw Object.assign(Error('Chat stream ended without continuation'),{code:14});
+    }
    }catch(e){
     if(signal.aborted)break;
-    if(e.code===16)this.auth.invalidate();
+    if(e.code===16){
+     if(!this.config.apiKey||this.polling)this.auth.invalidate();
+     if(!this.polling&&this.config.httpFallback===true){this.polling=true;this.pageToken=undefined;this.status('DISCONNECTED','streamList rechazó las credenciales. Cambiando a HTTP de respaldo (cada 15 s).');continue;}
+    }
     if([5,9].includes(e.code)){this.endChat();await this.sleep(60000,signal);continue;}
     if(e.code===3)this.pageToken=undefined;
     const ms=backoff[Math.min(failures++,backoff.length-1)];
     // Do not print upstream payloads or request objects: they may contain credentials.
-    this.status('DISCONNECTED',`Conexión/autorización no disponible${Number.isInteger(e.code)?' (código '+e.code+')':''}. Reintento en ${ms/1000}s. Si persiste, revisa OAuth, API y cuota.`);
+    this.status('DISCONNECTED',e.code===16?`streamList/YouTube rechazó las credenciales (código 16). Reintento en ${ms/1000}s. Si OAuth funciona por HTTP, configura apiKeyFile para streamList. El respaldo HTTP requiere httpFallback: true.`:`Conexión/autorización no disponible${Number.isInteger(e.code)?' (código '+e.code+')':''}. Reintento en ${ms/1000}s. Si persiste, revisa OAuth, API y cuota.`);
     await this.sleep(ms,signal);
    }
   }