termux-stt 2.0.4 → 2.1.0

package/bin/termux-stt.js

@@ -1,51 +1,55 @@
-#!/usr/bin/env node
-/**
- * AMEVA Standard Node.js CLI Runner for termux_stt.
- * Automatically resolves Python 3 environment and dispatches to python -m termux_stt.
- */
-const fs = require('fs');
-const { spawn, execSync } = require('child_process');
-
-function findPython() {
-  if (process.env.PYTHON && fs.existsSync(process.env.PYTHON)) {
-    return process.env.PYTHON;
-  }
-  const termuxBin = '/data/data/com.termux/files/usr/bin/python3';
-  if (fs.existsSync(termuxBin)) {
-    return termuxBin;
-  }
-  const termuxBinAlt = '/data/data/com.termux/files/usr/bin/python';
-  if (fs.existsSync(termuxBinAlt)) {
-    return termuxBinAlt;
-  }
-  const candidates = ['python3', 'python'];
-  for (const cmd of candidates) {
-    try {
-      const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
-      const res = execSync(checkCmd, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
-      if (res) return cmd;
-    } catch (_) {}
-  }
-  return 'python3';
-}
-
-const pythonBin = findPython();
-const args = ['-m', 'termux_stt.platform.installer', ...process.argv.slice(2)];
-
-const child = spawn(pythonBin, args, {
-  stdio: 'inherit',
-  env: process.env
-});
-
-child.on('error', (err) => {
-  console.error(`[${'termux_stt'}] Failed to spawn python process (${pythonBin}):`, err.message);
-  process.exit(1);
-});
-
-child.on('exit', (code, signal) => {
-  if (signal) {
-    process.kill(process.pid, signal);
-  } else {
-    process.exit(code || 0);
-  }
-});
+#!/usr/bin/env node
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+/**
+ * AMEVA Standard Node.js CLI Runner for termux_stt.
+ * Automatically resolves Python 3 environment and dispatches to python -m termux_stt.
+ */
+const fs = require('fs');
+const { spawn, execSync } = require('child_process');
+
+function findPython() {
+  if (process.env.PYTHON && fs.existsSync(process.env.PYTHON)) {
+    return process.env.PYTHON;
+  }
+  const termuxBin = '/data/data/com.termux/files/usr/bin/python3';
+  if (fs.existsSync(termuxBin)) {
+    return termuxBin;
+  }
+  const termuxBinAlt = '/data/data/com.termux/files/usr/bin/python';
+  if (fs.existsSync(termuxBinAlt)) {
+    return termuxBinAlt;
+  }
+  const candidates = ['python3', 'python'];
+  for (const cmd of candidates) {
+    try {
+      const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
+      const res = execSync(checkCmd, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+      if (res) return cmd;
+    } catch (_) {}
+  }
+  return 'python3';
+}
+
+const pythonBin = findPython();
+const args = ['-m', 'termux_stt.platform.installer', ...process.argv.slice(2)];
+
+const child = spawn(pythonBin, args, {
+  stdio: 'inherit',
+  env: process.env
+});
+
+child.on('error', (err) => {
+  console.error(`[${'termux_stt'}] Failed to spawn python process (${pythonBin}):`, err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code || 0);
+  }
+});

package/index.d.ts

@@ -1,68 +1,72 @@
-export interface EngineOptions {
-  model?: string;
-  lang?: string;
-  device?: 'auto' | 'vulkan' | 'gpu' | 'cpu';
-  threads?: number;
-  vad?: boolean;
-  vadThreshold?: number;
-  quantization?: string;
-  numSpeakers?: number;
-  customModelPath?: string;
-  [key: string]: any;
-}
-
-export interface Segment {
-  start: number;
-  end: number;
-  text: string;
-  speaker?: string;
-  confidence?: number;
-}
-
-export class TranscriptResult {
-  text: string;
-  segments: Segment[];
-  language?: string;
-  duration?: number;
-  speakers?: string[];
-
-  toJson(): string;
-  toSrt(): string;
-  toVtt(): string;
-  toRttm(fileId?: string): string;
-}
-
-export abstract class Engine {
-  options: EngineOptions;
-  constructor(options?: EngineOptions);
-  abstract transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
-  abstract diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
-  getInfo(): Record<string, any>;
-}
-
-export class WhisperEngine extends Engine {
-  transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
-  diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
-}
-
-export class SherpaEngine extends Engine {
-  transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
-  diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
-}
-
-export class HybridEngine extends Engine {
-  transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
-  diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
-}
-
-export function createEngine(
-  engineName?: 'whisper' | 'sherpa' | 'hybrid' | string,
-  options?: EngineOptions
-): Engine;
-
-export class TermuxSTT {
-  engine: Engine;
-  constructor(options?: EngineOptions & { engine?: string });
-  transcribe(filePath: string, options?: any): Promise<TranscriptResult>;
-  diarize(filePath: string, options?: any): Promise<TranscriptResult>;
-}
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+export interface EngineOptions {
+  model?: string;
+  lang?: string;
+  device?: 'auto' | 'vulkan' | 'gpu' | 'cpu';
+  threads?: number;
+  vad?: boolean;
+  vadThreshold?: number;
+  quantization?: string;
+  numSpeakers?: number;
+  customModelPath?: string;
+  [key: string]: any;
+}
+
+export interface Segment {
+  start: number;
+  end: number;
+  text: string;
+  speaker?: string;
+  confidence?: number;
+}
+
+export class TranscriptResult {
+  text: string;
+  segments: Segment[];
+  language?: string;
+  duration?: number;
+  speakers?: string[];
+
+  toJson(): string;
+  toSrt(): string;
+  toVtt(): string;
+  toRttm(fileId?: string): string;
+}
+
+export abstract class Engine {
+  options: EngineOptions;
+  constructor(options?: EngineOptions);
+  abstract transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
+  abstract diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
+  getInfo(): Record<string, any>;
+}
+
+export class WhisperEngine extends Engine {
+  transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
+  diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
+}
+
+export class SherpaEngine extends Engine {
+  transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
+  diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
+}
+
+export class HybridEngine extends Engine {
+  transcribe(audioPath: string, options?: any): Promise<TranscriptResult>;
+  diarize(audioPath: string, numSpeakers?: number): Promise<TranscriptResult>;
+}
+
+export function createEngine(
+  engineName?: 'whisper' | 'sherpa' | 'hybrid' | string,
+  options?: EngineOptions
+): Engine;
+
+export class TermuxSTT {
+  engine: Engine;
+  constructor(options?: EngineOptions & { engine?: string });
+  transcribe(filePath: string, options?: any): Promise<TranscriptResult>;
+  diarize(filePath: string, options?: any): Promise<TranscriptResult>;
+}

package/index.js

@@ -1,49 +1,53 @@
-/**
- * termux-stt Node.js entry point (v2.0.0)
- */
-
-const { Engine, TranscriptResult, Segment, formatTime } = require('./lib/engine');
-const { WhisperEngine } = require('./lib/whisper');
-const { SherpaEngine } = require('./lib/sherpa');
-const { HybridEngine } = require('./lib/hybrid');
-
-function createEngine(engineName = 'whisper', options = {}) {
-  const name = String(engineName).toLowerCase();
-  switch (name) {
-    case 'whisper':
-      return new WhisperEngine(options);
-    case 'sherpa':
-      return new SherpaEngine(options);
-    case 'hybrid':
-      return new HybridEngine(options);
-    case 'vosk':
-      throw new Error("Vosk has been deprecated and completely removed in v2.0.0. Please use 'sherpa' (SenseVoice) or 'whisper'.");
-    default:
-      throw new Error(`Unknown engine: ${engineName}. Available: whisper, sherpa, hybrid`);
-  }
-}
-
-class TermuxSTT {
-  constructor(options = {}) {
-    const engineName = options.engine || 'whisper';
-    this.engine = createEngine(engineName, options);
-  }
-  transcribe(filePath, options = {}) {
-    return this.engine.transcribe(filePath, options);
-  }
-  diarize(filePath, options = {}) {
-    return this.engine.diarize(filePath, options);
-  }
-}
-
-module.exports = {
-  TermuxSTT,
-  createEngine,
-  Engine,
-  TranscriptResult,
-  Segment,
-  WhisperEngine,
-  SherpaEngine,
-  HybridEngine,
-  formatTime
-};
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+/**
+ * termux-stt Node.js entry point (v2.0.0)
+ */
+
+const { Engine, TranscriptResult, Segment, formatTime } = require('./lib/engine');
+const { WhisperEngine } = require('./lib/whisper');
+const { SherpaEngine } = require('./lib/sherpa');
+const { HybridEngine } = require('./lib/hybrid');
+
+function createEngine(engineName = 'whisper', options = {}) {
+  const name = String(engineName).toLowerCase();
+  switch (name) {
+    case 'whisper':
+      return new WhisperEngine(options);
+    case 'sherpa':
+      return new SherpaEngine(options);
+    case 'hybrid':
+      return new HybridEngine(options);
+    case 'vosk':
+      throw new Error("Vosk has been deprecated and completely removed in v2.0.0. Please use 'sherpa' (SenseVoice) or 'whisper'.");
+    default:
+      throw new Error(`Unknown engine: ${engineName}. Available: whisper, sherpa, hybrid`);
+  }
+}
+
+class TermuxSTT {
+  constructor(options = {}) {
+    const engineName = options.engine || 'whisper';
+    this.engine = createEngine(engineName, options);
+  }
+  transcribe(filePath, options = {}) {
+    return this.engine.transcribe(filePath, options);
+  }
+  diarize(filePath, options = {}) {
+    return this.engine.diarize(filePath, options);
+  }
+}
+
+module.exports = {
+  TermuxSTT,
+  createEngine,
+  Engine,
+  TranscriptResult,
+  Segment,
+  WhisperEngine,
+  SherpaEngine,
+  HybridEngine,
+  formatTime
+};

package/lib/engine.js

@@ -1,92 +1,96 @@
-/**
- * termux-stt - Engine Abstraction for Node.js
- */
-
-class TranscriptResult {
-  constructor(text, segments = [], language = 'ko', duration = 0) {
-    this.text = text;
-    this.segments = segments;
-    this.language = language;
-    this.duration = duration;
-  }
-
-  toJson() {
-    return JSON.stringify(this, null, 2);
-  }
-
-  toSrt() {
-    return this.segments.map((seg, i) => {
-      const start = formatTime(seg.start);
-      const end = formatTime(seg.end);
-      return `${i + 1}\n${start} --> ${end}\n${seg.text}\n`;
-    }).join('\n');
-  }
-
-  toVtt() {
-    const body = this.segments.map((seg) => {
-      const start = formatTime(seg.start, true);
-      const end = formatTime(seg.end, true);
-      return `${start} --> ${end}\n${seg.text}\n`;
-    }).join('\n');
-    return `WEBVTT\n\n${body}`;
-  }
-
-  toRttm(fileId = 'audio') {
-    return this.segments.map((seg) => {
-      const spk = seg.speaker || 'Speaker_0';
-      const dur = (seg.end - seg.start).toFixed(2);
-      return `SPEAKER ${fileId} 1 ${seg.start.toFixed(2)} ${dur} <NA> <NA> ${spk} <NA> <NA>`;
-    }).join('\n');
-  }
-}
-
-class Segment {
-  constructor(start, end, text, speaker = null, confidence = null) {
-    this.start = start;
-    this.end = end;
-    this.text = text;
-    this.speaker = speaker;
-    this.confidence = confidence;
-  }
-}
-
-function formatTime(seconds, isVtt = false) {
-  const s = Math.max(0, seconds || 0);
-  const hrs = Math.floor(s / 3600);
-  const mins = Math.floor((s % 3600) / 60);
-  const secs = Math.floor(s % 60);
-  const ms = Math.floor((s % 1) * 1000);
-
-  const pad = (n, z = 2) => String(n).padStart(z, '0');
-  const sep = isVtt ? '.' : ',';
-  return `${pad(hrs)}:${pad(mins)}:${pad(secs)}${sep}${pad(ms, 3)}`;
-}
-
-class Engine {
-  constructor(config = {}) {
-    this.config = config;
-  }
-
-  async transcribe(audioPath, options = {}) {
-    throw new Error('transcribe() must be implemented by subclass');
-  }
-
-  async diarize(audioPath, numSpeakers = 2) {
-    throw new Error('diarize() must be implemented by subclass');
-  }
-
-  streamMic(duration = null) {
-    throw new Error('streamMic() must be implemented by subclass');
-  }
-
-  getInfo() {
-    return { name: this.constructor.name, config: this.config };
-  }
-}
-
-module.exports = {
-  Engine,
-  TranscriptResult,
-  Segment,
-  formatTime
-};
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+/**
+ * termux-stt - Engine Abstraction for Node.js
+ */
+
+class TranscriptResult {
+  constructor(text, segments = [], language = 'ko', duration = 0) {
+    this.text = text;
+    this.segments = segments;
+    this.language = language;
+    this.duration = duration;
+  }
+
+  toJson() {
+    return JSON.stringify(this, null, 2);
+  }
+
+  toSrt() {
+    return this.segments.map((seg, i) => {
+      const start = formatTime(seg.start);
+      const end = formatTime(seg.end);
+      return `${i + 1}\n${start} --> ${end}\n${seg.text}\n`;
+    }).join('\n');
+  }
+
+  toVtt() {
+    const body = this.segments.map((seg) => {
+      const start = formatTime(seg.start, true);
+      const end = formatTime(seg.end, true);
+      return `${start} --> ${end}\n${seg.text}\n`;
+    }).join('\n');
+    return `WEBVTT\n\n${body}`;
+  }
+
+  toRttm(fileId = 'audio') {
+    return this.segments.map((seg) => {
+      const spk = seg.speaker || 'Speaker_0';
+      const dur = (seg.end - seg.start).toFixed(2);
+      return `SPEAKER ${fileId} 1 ${seg.start.toFixed(2)} ${dur} <NA> <NA> ${spk} <NA> <NA>`;
+    }).join('\n');
+  }
+}
+
+class Segment {
+  constructor(start, end, text, speaker = null, confidence = null) {
+    this.start = start;
+    this.end = end;
+    this.text = text;
+    this.speaker = speaker;
+    this.confidence = confidence;
+  }
+}
+
+function formatTime(seconds, isVtt = false) {
+  const s = Math.max(0, seconds || 0);
+  const hrs = Math.floor(s / 3600);
+  const mins = Math.floor((s % 3600) / 60);
+  const secs = Math.floor(s % 60);
+  const ms = Math.floor((s % 1) * 1000);
+
+  const pad = (n, z = 2) => String(n).padStart(z, '0');
+  const sep = isVtt ? '.' : ',';
+  return `${pad(hrs)}:${pad(mins)}:${pad(secs)}${sep}${pad(ms, 3)}`;
+}
+
+class Engine {
+  constructor(config = {}) {
+    this.config = config;
+  }
+
+  async transcribe(audioPath, options = {}) {
+    throw new Error('transcribe() must be implemented by subclass');
+  }
+
+  async diarize(audioPath, numSpeakers = 2) {
+    throw new Error('diarize() must be implemented by subclass');
+  }
+
+  streamMic(duration = null) {
+    throw new Error('streamMic() must be implemented by subclass');
+  }
+
+  getInfo() {
+    return { name: this.constructor.name, config: this.config };
+  }
+}
+
+module.exports = {
+  Engine,
+  TranscriptResult,
+  Segment,
+  formatTime
+};