webtalk 1.0.0

package/setup-npm-publishing.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+set -e
+
+echo "======================================"
+echo "NPM Publishing Setup for webtalk"
+echo "======================================"
+echo ""
+echo "This script will:"
+echo "  1. Validate your npm token"
+echo "  2. Create NPM_TOKEN GitHub secret"
+echo "  3. Verify workflow setup"
+echo ""
+
+# Check prerequisites
+echo "Checking prerequisites..."
+MISSING=0
+
+if ! command -v gh &> /dev/null; then
+    echo "❌ GitHub CLI (gh) not found"
+    MISSING=1
+else
+    echo "✓ GitHub CLI found"
+fi
+
+if ! command -v npm &> /dev/null; then
+    echo "❌ npm not found"
+    MISSING=1
+else
+    echo "✓ npm found"
+fi
+
+if [ $MISSING -eq 1 ]; then
+    echo ""
+    echo "Install GitHub CLI: https://cli.github.com"
+    exit 1
+fi
+
+echo ""
+
+# Step 1: npm token input
+echo "========================================"
+echo "STEP 1: Provide npm Automation Token"
+echo "========================================"
+echo ""
+echo "How to generate your token:"
+echo "  1. Visit: https://www.npmjs.com/settings/tokens"
+echo "  2. Click 'Generate New Token'"
+echo "  3. Select 'Automation' type"
+echo "  4. Optionally add description: 'GitHub Actions - webtalk'"
+echo "  5. Click 'Create'"
+echo "  6. COPY the token immediately (shown only once)"
+echo ""
+read -sp "Paste your npm token and press Enter: " NPM_TOKEN
+echo ""
+echo ""
+
+if [ -z "$NPM_TOKEN" ]; then
+    echo "❌ No token provided. Exiting."
+    exit 1
+fi
+
+# Validate token format (should be ~40-50 chars, alphanumeric)
+if ! [[ "$NPM_TOKEN" =~ ^[a-zA-Z0-9_-]+$ ]] || [ ${#NPM_TOKEN} -lt 20 ]; then
+    echo "❌ Token format invalid. Should be alphanumeric string 20+ chars."
+    exit 1
+fi
+
+echo "✓ Token format valid"
+echo ""
+
+# Step 2: Verify GitHub authentication
+echo "========================================"
+echo "STEP 2: Verify GitHub Authentication"
+echo "========================================"
+echo ""
+
+if ! gh auth status 2>/dev/null | grep -q "Logged in"; then
+    echo "❌ Not authenticated to GitHub. Please run: gh auth login"
+    exit 1
+fi
+
+GITHUB_USER=$(gh auth status 2>&1 | grep "Logged in to" | head -1 | awk '{print $NF}' | tr -d '()')
+echo "✓ Authenticated as: $GITHUB_USER"
+echo ""
+
+# Step 3: Set GitHub secret
+echo "========================================"
+echo "STEP 3: Creating GitHub Secret"
+echo "========================================"
+echo ""
+
+REPO="AnEntrypoint/realtime-whisper-webgpu"
+SECRET_NAME="NPM_TOKEN"
+
+echo "Repository: https://github.com/$REPO"
+echo "Secret name: $SECRET_NAME"
+echo ""
+
+# Create or update the secret
+if echo "$NPM_TOKEN" | gh secret set "$SECRET_NAME" --repo "$REPO" 2>&1; then
+    echo "✓ Secret set successfully"
+else
+    echo "❌ Failed to set secret"
+    exit 1
+fi
+
+echo ""
+
+# Step 4: Verify secret exists
+echo "========================================"
+echo "STEP 4: Verifying Secret"
+echo "========================================"
+echo ""
+
+if gh secret list --repo "$REPO" 2>/dev/null | grep -q "$SECRET_NAME"; then
+    echo "✓ $SECRET_NAME is available in GitHub Actions"
+    echo ""
+    echo "View it at:"
+    echo "https://github.com/$REPO/settings/secrets/actions"
+else
+    echo "⚠ Warning: Could not verify secret in list"
+    echo "Check GitHub manually at:"
+    echo "https://github.com/$REPO/settings/secrets/actions"
+fi
+
+echo ""
+echo "========================================"
+echo "Setup Complete!"
+echo "========================================"
+echo ""
+echo "Your webtalk npm package is now ready to publish automatically."
+echo ""
+echo "To publish a new version:"
+echo "  1. Update version in package.json"
+echo "  2. git add . && git commit -m 'bump version X.X.X'"
+echo "  3. git push origin main"
+echo "  4. GitHub Actions will publish to npm automatically"
+echo ""
+echo "Monitor at: https://github.com/$REPO/actions"
+echo ""

package/stt.js

@@ -0,0 +1,141 @@
+const STATUS = {
+  LOADING: 'loading',
+  READY: 'ready',
+  RECORDING: 'recording',
+  TRANSCRIBING: 'transcribing',
+  ERROR: 'error'
+};
+
+class STT {
+  constructor(options = {}) {
+    this.language = options.language || 'en';
+    this.onTranscript = options.onTranscript || null;
+    this.onStatus = options.onStatus || null;
+    this.onPartial = options.onPartial || null;
+    this.basePath = options.basePath || '';
+    this.workerFile = options.workerFile || 'worker-BPxxCWVT.js';
+    this.worker = null;
+    this.ready = false;
+    this.recorder = null;
+    this.recordChunks = [];
+    this._resolveStop = null;
+    this._currentTranscript = '';
+  }
+
+  async init() {
+    return new Promise((resolve, reject) => {
+      try {
+        const workerPath = this.basePath + '/assets/' + this.workerFile;
+        this.worker = new Worker(workerPath);
+        this.worker.onmessage = (e) => this._handleMessage(e.data);
+        this.worker.onerror = (e) => reject(e);
+        this._initResolve = resolve;
+        this.worker.postMessage({ type: 'load' });
+      } catch (err) {
+        reject(err);
+      }
+    });
+  }
+
+  _handleMessage(msg) {
+    switch (msg.status) {
+      case 'loading':
+        this.onStatus?.(STATUS.LOADING, typeof msg.data === 'string' ? msg.data : 'Loading...');
+        break;
+      case 'ready':
+        this.ready = true;
+        this.onStatus?.(STATUS.READY, 'Ready');
+        this._initResolve?.();
+        this._initResolve = null;
+        break;
+      case 'start':
+        this.onStatus?.(STATUS.TRANSCRIBING, 'Transcribing...');
+        break;
+      case 'update': {
+        const text = this._extractText(msg.output);
+        this._currentTranscript = text;
+        this.onPartial?.(text);
+        break;
+      }
+      case 'complete': {
+        const text = this._extractText(msg.output);
+        this._currentTranscript = text;
+        this.onTranscript?.(text);
+        this.onStatus?.(STATUS.READY, 'Ready');
+        this._resolveStop?.(text);
+        this._resolveStop = null;
+        break;
+      }
+    }
+  }
+
+  _extractText(output) {
+    if (!output) return '';
+    if (Array.isArray(output)) return output.map(o => o.text || o).join('');
+    return output.text || String(output);
+  }
+
+  async startRecording() {
+    if (!this.ready) throw new Error('STT not initialized');
+    const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+    this.recordChunks = [];
+    this.recorder = new MediaRecorder(stream);
+    this.recorder.ondataavailable = (e) => this.recordChunks.push(e.data);
+    this._stream = stream;
+    this.recorder.start();
+    this.onStatus?.(STATUS.RECORDING, 'Recording...');
+  }
+
+  stopRecording() {
+    return new Promise((resolve) => {
+      if (!this.recorder || this.recorder.state === 'inactive') {
+        resolve(this._currentTranscript);
+        return;
+      }
+      this._resolveStop = resolve;
+      this.recorder.onstop = async () => {
+        this._stream?.getTracks().forEach(t => t.stop());
+        const blob = new Blob(this.recordChunks, { type: 'audio/webm' });
+        await this._processAudio(blob);
+      };
+      this.recorder.stop();
+    });
+  }
+
+  async transcribeBlob(blob) {
+    return new Promise((resolve) => {
+      this._resolveStop = resolve;
+      this._processAudio(blob);
+    });
+  }
+
+  async _processAudio(blob) {
+    if (!this.worker || !this.ready) return;
+    this.onStatus?.(STATUS.TRANSCRIBING, 'Transcribing...');
+    const arrayBuf = await blob.arrayBuffer();
+    const ctx = new AudioContext({ sampleRate: 16000 });
+    const decoded = await ctx.decodeAudioData(arrayBuf);
+    const audio = decoded.getChannelData(0);
+    ctx.close();
+    this.worker.postMessage({ type: 'generate', data: { audio, language: this.language } });
+  }
+
+  getStatus() {
+    return {
+      ready: this.ready,
+      recording: this.recorder?.state === 'recording',
+      language: this.language,
+      workerFile: this.workerFile,
+      hasWorker: !!this.worker
+    };
+  }
+
+  destroy() {
+    this.worker?.terminate();
+    this.worker = null;
+    this.ready = false;
+    this._stream?.getTracks().forEach(t => t.stop());
+  }
+}
+
+export { STT };

package/tts/EventEmitter.js

@@ -0,0 +1,59 @@
+export class EventEmitter {
+  constructor() {
+    this.events = {};
+  }
+
+  addEventListener(event, listener, options = {}) {
+    if (!this.events[event]) {
+      this.events[event] = [];
+    }
+    
+    const wrappedListener = {
+      callback: listener,
+      once: options.once || false
+    };
+    
+    this.events[event].push(wrappedListener);
+  }
+
+  removeEventListener(event, listener) {
+    if (!this.events[event]) return;
+    
+    this.events[event] = this.events[event].filter(
+      wrappedListener => wrappedListener.callback !== listener
+    );
+  }
+
+  dispatchEvent(event) {
+    const eventName = event.type;
+    if (!this.events[eventName]) return;
+    
+    this.events[eventName] = this.events[eventName].filter(wrappedListener => {
+      wrappedListener.callback.call(this, event);
+      return !wrappedListener.once;
+    });
+  }
+
+  emit(eventName, data) {
+    const event = new CustomEvent(eventName, { detail: data });
+    this.dispatchEvent(event);
+  }
+}
+
+export class CustomEvent {
+  constructor(type, options = {}) {
+    this.type = type;
+    this.detail = options.detail;
+    this.target = null;
+    this.currentTarget = null;
+    this.defaultPrevented = false;
+    this.bubbles = options.bubbles || false;
+    this.cancelable = options.cancelable || false;
+  }
+
+  preventDefault() {
+    if (this.cancelable) {
+      this.defaultPrevented = true;
+    }
+  }
+}