@erinjs/core 1.0.0

package/core/packages/util/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "noEmit": false
+  },
+  "include": ["src/**/*"]
+}

package/core/packages/util/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['cjs', 'esm'],
+  dts: true,
+  splitting: false,
+  clean: true,
+});

package/core/packages/util/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.test.ts'],
+  },
+});

package/core/packages/voice/README.md

@@ -0,0 +1,42 @@
+# @erinjs/voice
+
+Voice for Fluxer bots. Join channels and play WebM/Opus audio.
+
+## Install
+
+```bash
+pnpm add @erinjs/voice @erinjs/core
+```
+
+## Usage
+
+```javascript
+import { getVoiceManager, LiveKitRtcConnection } from '@erinjs/voice';
+
+const voiceManager = getVoiceManager(client);
+const connection = await voiceManager.join(channel);
+await connection.play(streamUrl);
+
+// Inbound transcription / speech-to-text pipeline
+if (connection instanceof LiveKitRtcConnection) {
+  const subs = voiceManager.subscribeChannelParticipants(channel.id);
+  connection.on('speakerStart', ({ participantId }) => {
+    console.log('speaker start', participantId);
+  });
+  connection.on('speakerStop', ({ participantId }) => {
+    console.log('speaker stop', participantId);
+  });
+  connection.on('audioFrame', (frame) => {
+    // frame.samples is Int16 PCM suitable for WAV/STT pipelines
+    console.log(frame.participantId, frame.sampleRate, frame.channels, frame.samples.length);
+  });
+
+  // cleanup subscriptions when done
+  for (const sub of subs) sub.stop();
+}
+
+connection.stop();
+voiceManager.leave(guildId);
+```
+
+Use yt-dlp to get stream URLs from YouTube. For LiveKit, listen for `serverLeave` to reconnect.

package/core/packages/voice/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@erinjs/voice",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "1.2.4",
+  "description": "Voice support for Fluxer bots",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blstmo-abandoned-us-for-the-milk/core.git",
+    "directory": "packages/voice"
+  },
+  "bugs": "https://github.com/blstmo-abandoned-us-for-the-milk/core/issues",
+  "homepage": "https://github.com/blstmo-abandoned-us-for-the-milk/core#readme",
+  "keywords": [
+    "fluxer",
+    "voice",
+    "audio",
+    "livekit"
+  ],
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --max-warnings 0 --config ../../eslint.config.js",
+    "lint:fix": "eslint src --fix --config ../../eslint.config.js",
+    "test": "vitest run --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests"
+  },
+  "dependencies": {
+    "@erinjs/collection": "workspace:*",
+    "@erinjs/core": "workspace:*",
+    "@erinjs/types": "workspace:*",
+    "@livekit/rtc-node": "^0.13.24",
+    "mp4box": "^0.5.2",
+    "opus-decoder": "^0.7.0",
+    "prism-media": "^1.3.5",
+    "tweetnacl": "^1.0.3",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "livekit-server-sdk": "^2.15.0",
+    "node-webcodecs": "^1.0.0"
+  }
+}

package/core/packages/voice/src/LiveKitRtcConnection.receive.test.ts

@@ -0,0 +1,24 @@
+import { describe, it, expect, vi } from 'vitest';
+import { LiveKitRtcConnection } from './LiveKitRtcConnection.js';
+
+function makeClient() {
+  return {
+    on: vi.fn(),
+    emit: vi.fn(),
+    sendToGateway: vi.fn(),
+    user: { id: 'bot' },
+    rest: { post: vi.fn() },
+  };
+}
+
+describe('LiveKitRtcConnection receive api', () => {
+  it('returns inert subscription when room is not connected', () => {
+    const channel = { id: 'c1', guildId: 'g1' } as never;
+    const conn = new LiveKitRtcConnection(makeClient() as never, channel, 'bot');
+
+    const sub = conn.subscribeParticipantAudio('u1');
+
+    expect(sub.participantId).toBe('u1');
+    expect(() => sub.stop()).not.toThrow();
+  });
+});