@absolutejs/voice-rime 0.0.1-beta.1

package/README.md

@@ -0,0 +1,68 @@
+# `@absolutejs/voice-rime`
+
+Rime text-to-speech adapter for `@absolutejs/voice`.
+
+Wraps Rime's `/v1/rime-tts` HTTP streaming endpoint behind voice's `TTSAdapter` seam. Supports the mist / mistv2 / arcana voice models for fast, conversational TTS.
+
+## Install
+
+```sh
+bun add @absolutejs/voice-rime
+```
+
+`@absolutejs/voice` is a runtime dependency.
+
+## Use
+
+```ts
+import { voice } from "@absolutejs/voice";
+import { rime } from "@absolutejs/voice-rime";
+
+const app = voice({
+  // ... stt + other voice options ...
+  tts: rime({
+    apiKey: process.env.RIME_API_KEY!,
+    speaker: "cove",
+    // optional:
+    modelId: "mistv2",           // default; or 'mist' / 'arcana'
+    audioFormat: "pcm",          // default; or 'mulaw' for telephony
+    sampleRate: 22_050,          // default
+    speedAlpha: 1.0,
+    lang: "eng",
+    reduceLatency: true,
+    pauseBetweenBrackets: true,
+    phonemizeBetweenBrackets: true,
+  }),
+});
+```
+
+For telephony at 8 kHz μ-law:
+
+```ts
+rime({
+  apiKey,
+  speaker: "cove",
+  audioFormat: "mulaw",
+});
+```
+
+## Options
+
+| Option | Required | Default | Notes |
+| --- | --- | --- | --- |
+| `apiKey` | yes | — | Rime API key, sent as `Authorization: Bearer <key>`. |
+| `speaker` | yes | — | Rime speaker id (`cove`, `marsh`, `river`, etc.). |
+| `modelId` | no | `mistv2` | `mist`, `mistv2`, `arcana`, or a future Rime model id. |
+| `audioFormat` | no | `pcm` | Must be `pcm` (PCM s16le) or `mulaw` (telephony @ 8 kHz). |
+| `sampleRate` | no | `22050` | Ignored for `mulaw`. |
+| `lang` | no | — | Language hint (`eng`, etc.). |
+| `speedAlpha`, `inlineSpeedAlpha` | no | — | Forwarded to Rime. |
+| `reduceLatency`, `pauseBetweenBrackets`, `phonemizeBetweenBrackets`, `noTextNormalization` | no | — | Forwarded as boolean controls. |
+| `baseUrl` | no | `https://users.rime.ai` | Override for staging hosts. |
+| `fetch` | no | `globalThis.fetch` | Inject for tests; opportunistic HTTP/2 multiplexing on outbound HTTPS. |
+
+## Notes
+
+- Whitespace-only `send()` is a no-op.
+- `session.close(reason)` aborts in-flight requests and refuses further sends.
+- This adapter targets Rime's HTTP streaming endpoint. If you need their WebSocket transport, open an issue.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { rime } from './rime';
+export type { RimeAudioFormat, RimeModel, RimeSampleRate, RimeTTSOptions } from './types';

package/dist/index.js

@@ -0,0 +1,170 @@
+// @bun
+// src/rime.ts
+var DEFAULT_BASE_URL = "https://users.rime.ai";
+var DEFAULT_ENDPOINT_PATH = "/v1/rime-tts";
+var DEFAULT_MODEL = "mistv2";
+var DEFAULT_AUDIO_FORMAT = "pcm";
+var DEFAULT_SAMPLE_RATE = 22050;
+var isHttpsUrl = (url) => typeof url === "string" ? url.startsWith("https://") : url.protocol === "https:";
+var h2IfHttps = (url) => isHttpsUrl(url) ? { protocol: "http2" } : {};
+var createListenerMap = () => ({
+  audio: new Set,
+  close: new Set,
+  error: new Set
+});
+var emit = async (listeners, event, payload) => {
+  for (const listener of listeners[event]) {
+    await listener(payload);
+  }
+};
+var omitUndefined = (value) => Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+var resolveBaseUrl = (config) => (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+var resolveStreamUrl = (config) => new URL(`${resolveBaseUrl(config)}${DEFAULT_ENDPOINT_PATH}`);
+var resolveAcceptHeader = (audioFormat) => {
+  switch (audioFormat) {
+    case "mulaw":
+      return "audio/basic";
+    case "pcm":
+    default:
+      return "audio/pcm";
+  }
+};
+var resolveAudioFormat = (config) => {
+  const audioFormat = config.audioFormat ?? DEFAULT_AUDIO_FORMAT;
+  const sampleRate = config.sampleRate ?? DEFAULT_SAMPLE_RATE;
+  if (audioFormat === "pcm") {
+    return {
+      channels: 1,
+      container: "raw",
+      encoding: "pcm_s16le",
+      sampleRateHz: sampleRate
+    };
+  }
+  if (audioFormat === "mulaw") {
+    return {
+      channels: 1,
+      container: "raw",
+      encoding: "mulaw",
+      sampleRateHz: 8000
+    };
+  }
+  throw new Error(`Unsupported Rime audio format "${String(audioFormat)}" for @absolutejs/voice TTS streaming. ` + `Use "pcm" for PCM playback or "mulaw" for telephony.`);
+};
+var buildHeaders = (config, audioFormat) => ({
+  Accept: resolveAcceptHeader(audioFormat),
+  Authorization: `Bearer ${config.apiKey}`,
+  "Content-Type": "application/json"
+});
+var resolveErrorMessage = (error) => {
+  if (typeof error === "string" && error.trim())
+    return error;
+  if (error instanceof Error && error.message.trim())
+    return error.message;
+  return "Rime TTS request failed";
+};
+var buildRequestPayload = (config, text) => omitUndefined({
+  audioFormat: config.audioFormat ?? DEFAULT_AUDIO_FORMAT,
+  inlineSpeedAlpha: config.inlineSpeedAlpha,
+  lang: config.lang,
+  modelId: config.modelId ?? DEFAULT_MODEL,
+  noTextNormalization: config.noTextNormalization,
+  pauseBetweenBrackets: config.pauseBetweenBrackets,
+  phonemizeBetweenBrackets: config.phonemizeBetweenBrackets,
+  reduceLatency: config.reduceLatency,
+  samplingRate: config.sampleRate ?? DEFAULT_SAMPLE_RATE,
+  speaker: config.speaker,
+  speedAlpha: config.speedAlpha,
+  text
+});
+var rime = (config) => {
+  if (!config.apiKey) {
+    throw new Error("@absolutejs/voice-rime requires an apiKey.");
+  }
+  if (!config.speaker) {
+    throw new Error('@absolutejs/voice-rime requires a speaker (e.g. "cove", "marsh", "river").');
+  }
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  const audioFormat = config.audioFormat ?? DEFAULT_AUDIO_FORMAT;
+  const audioFormatDescriptor = resolveAudioFormat(config);
+  return {
+    kind: "tts",
+    open: () => {
+      const listeners = createListenerMap();
+      const activeControllers = new Set;
+      let closed = false;
+      return {
+        close: async (reason) => {
+          if (closed)
+            return;
+          closed = true;
+          for (const controller of activeControllers) {
+            controller.abort(reason);
+          }
+          await emit(listeners, "close", {
+            reason,
+            recoverable: false,
+            type: "close"
+          });
+        },
+        on: (event, handler) => {
+          listeners[event].add(handler);
+          return () => {
+            listeners[event].delete(handler);
+          };
+        },
+        send: async (text) => {
+          if (closed)
+            return;
+          const trimmed = text.trim();
+          if (!trimmed)
+            return;
+          const controller = new AbortController;
+          activeControllers.add(controller);
+          try {
+            const target = resolveStreamUrl(config);
+            const response = await fetchImpl(target, {
+              ...h2IfHttps(target),
+              body: JSON.stringify(buildRequestPayload(config, trimmed)),
+              headers: buildHeaders(config, audioFormat),
+              method: "POST",
+              signal: controller.signal
+            });
+            if (!response.ok || !response.body) {
+              const bodyText = await response.text().catch(() => "");
+              throw new Error(`Rime returned ${String(response.status)} ${response.statusText}${bodyText ? `: ${bodyText.slice(0, 200)}` : ""}`);
+            }
+            const reader = response.body.getReader();
+            try {
+              while (true) {
+                const { done, value } = await reader.read();
+                if (done || !value)
+                  break;
+                await emit(listeners, "audio", {
+                  chunk: value,
+                  format: audioFormatDescriptor,
+                  receivedAt: Date.now(),
+                  type: "audio"
+                });
+              }
+            } finally {
+              reader.releaseLock();
+            }
+          } catch (error) {
+            if (error.name === "AbortError")
+              return;
+            await emit(listeners, "error", {
+              error: error instanceof Error ? error : new Error(resolveErrorMessage(error)),
+              recoverable: false,
+              type: "error"
+            });
+          } finally {
+            activeControllers.delete(controller);
+          }
+        }
+      };
+    }
+  };
+};
+export {
+  rime
+};

package/dist/rime.d.ts

@@ -0,0 +1,3 @@
+import type { TTSAdapter } from '@absolutejs/voice';
+import type { RimeTTSOptions } from './types';
+export declare const rime: (config: RimeTTSOptions) => TTSAdapter;

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+export type RimeModel = 'arcana' | 'mist' | 'mistv2' | (string & {});
+export type RimeAudioFormat = 'mulaw' | 'pcm' | (string & {});
+export type RimeSampleRate = 8_000 | 16_000 | 22_050 | 24_000 | (number & {});
+export type RimeTTSOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    audioFormat?: RimeAudioFormat;
+    fetch?: typeof fetch;
+    inlineSpeedAlpha?: number;
+    lang?: string;
+    modelId?: RimeModel;
+    noTextNormalization?: boolean;
+    pauseBetweenBrackets?: boolean;
+    phonemizeBetweenBrackets?: boolean;
+    reduceLatency?: boolean;
+    sampleRate?: RimeSampleRate;
+    speaker: string;
+    speedAlpha?: number;
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+	"name": "@absolutejs/voice-rime",
+	"version": "0.0.1-beta.1",
+	"description": "Rime text-to-speech adapter for @absolutejs/voice",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/voice-adapters.git",
+		"directory": "rime"
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"license": "CC BY-NC 4.0",
+	"author": "Alex Kahn",
+	"scripts": {
+		"build": "rm -rf dist && bun build ./src/index.ts --outdir dist --target bun --external @absolutejs/voice && tsc --emitDeclarationOnly --project tsconfig.json",
+		"format": "prettier --write \"./**/*.{js,ts,json,md}\"",
+		"release": "bun run format && bun run build && bun publish --access public",
+		"test": "bun test",
+		"typecheck": "bun run tsc --noEmit"
+	},
+	"dependencies": {
+		"@absolutejs/voice": "0.0.22-beta.471"
+	},
+	"devDependencies": {
+		"@types/bun": "1.3.9",
+		"typescript": "^5.9.3"
+	}
+}