@dtelecom/stt 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 dTelecom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# @dtelecom/stt
+
+TypeScript SDK for dTelecom real-time speech-to-text with [x402](https://www.x402.org/) micropayments.
+
+Pay-per-minute STT powered by Whisper and Parakeet, with automatic blockchain payments on Base.
+
+## Install
+
+```bash
+npm install @dtelecom/stt
+```
+
+## Quick Start
+
+```typescript
+import { STTClient } from "@dtelecom/stt";
+
+const client = new STTClient({ privateKey: "0x..." });
+
+const stream = await client.session({ minutes: 5, language: "en" }).open();
+try {
+  for await (const t of stream.transcribeFile("meeting.wav")) {
+    console.log(`[${t.start?.toFixed(1)}s] ${t.text}`);
+  }
+} finally {
+  await stream.close();
+}
+```
+
+## Real-Time Streaming
+
+```typescript
+import { STTClient } from "@dtelecom/stt";
+
+const client = new STTClient({ privateKey: "0x..." });
+
+const stream = await client.session({ minutes: 5, language: "en" }).open();
+
+// Callback-based
+stream.onTranscription((t) => console.log(t.text));
+
+// Send audio chunks (PCM16, 16kHz, mono)
+await stream.sendAudio(pcmBuffer);
+
+// Or iterate asynchronously
+for await (const t of stream.transcriptions()) {
+  console.log(t.text);
+}
+
+await stream.close();
+```
+
+## Auto-Extend Sessions
+
+Sessions automatically buy more time when running low (enabled by default):
+
+```typescript
+// 30-minute session that auto-extends
+const stream = await client.session({ minutes: 30, language: "en" }).open();
+// When <60s remaining, SDK buys 5 more minutes automatically
+
+// Disable auto-extend
+const stream = await client.session({ minutes: 5, autoExtend: false }).open();
+```
+
+## Audio Format
+
+The server expects **PCM16, 16kHz, mono** audio. Convert with ffmpeg:
+
+```bash
+ffmpeg -i input.mp3 -ar 16000 -ac 1 -acodec pcm_s16le output.wav
+```
+
+## Pricing
+
+```typescript
+const info = await client.pricing();
+console.log(`$${info.pricePerMinuteUsd}/min (${info.currency} on ${info.network})`);
+```
+
+Current pricing: **$0.005/min** (USDC on Base).
+
+## API Reference
+
+### `new STTClient({ privateKey, url? })`
+
+Main client. Default URL: `https://x402stt.dtelecom.org`.
+
+- `session({ minutes?, language?, autoExtend? })` — Create a session context
+- `pricing()` — Get pricing info
+- `health()` — Check server health
+
+### `SessionContext`
+
+Returned by `client.session()`.
+
+- `open()` — Create the paid session and connect, returns a `Stream`
+
+### `Stream`
+
+Returned by `sessionContext.open()`.
+
+- `sendAudio(data: Buffer)` — Send raw PCM16 audio
+- `transcriptions()` — Async generator of `Transcription` objects
+- `transcribeFile(path)` — Stream a WAV file and yield transcriptions
+- `onTranscription(callback)` — Register callback for transcriptions
+- `close()` — Close the stream
+
+### `Transcription`
+
+- `text: string` — Transcribed text
+- `start?: number` — Start time in seconds
+- `end?: number` — End time in seconds
+- `confidence?: number` — Confidence score
+- `isFinal: boolean` — Whether this is a final transcription
+
+## Supported Languages
+
+25 languages via Parakeet-TDT (fast) with Whisper fallback:
+
+English, Russian, German, French, Spanish, Italian, Portuguese, Dutch, Polish, Czech, Romanian, Hungarian, Greek, Turkish, Ukrainian, Swedish, Norwegian, Danish, Finnish, Catalan, Croatian, Lithuanian, Slovenian, Latvian, Estonian.
+
+## Error Handling
+
+```typescript
+import { PaymentError, SessionExpiredError, ConnectionError } from "@dtelecom/stt";
+
+try {
+  const stream = await client.session({ minutes: 5 }).open();
+  for await (const t of stream.transcriptions()) {
+    console.log(t.text);
+  }
+} catch (e) {
+  if (e instanceof PaymentError) {
+    console.log("Payment failed — check wallet balance");
+  } else if (e instanceof SessionExpiredError) {
+    console.log("Session time ran out");
+  } else if (e instanceof ConnectionError) {
+    console.log("Cannot connect to server");
+  }
+}
+```
+
+## License
+
+MIT

package/dist/audio.d.ts

@@ -0,0 +1,20 @@
+/** PCM16 mono 16kHz constants. */
+export declare const SAMPLE_RATE = 16000;
+export declare const SAMPLE_WIDTH = 2;
+export declare const CHANNELS = 1;
+export declare const BYTES_PER_SECOND: number;
+export interface WavData {
+    pcmData: Buffer;
+    sampleRate: number;
+    channels: number;
+    sampleWidth: number;
+}
+/**
+ * Load a WAV file and validate that it is PCM16, 16kHz, mono.
+ * Returns the raw PCM data and format info.
+ */
+export declare function loadWav(path: string): WavData;
+/** Generate PCM16 silence bytes (16kHz mono). */
+export declare function silence(durationSeconds: number): Buffer;
+/** Helper: sleep for ms. */
+export declare function sleep(ms: number): Promise<void>;

package/dist/audio.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BYTES_PER_SECOND = exports.CHANNELS = exports.SAMPLE_WIDTH = exports.SAMPLE_RATE = void 0;
+exports.loadWav = loadWav;
+exports.silence = silence;
+exports.sleep = sleep;
+const node_fs_1 = require("node:fs");
+const errors_js_1 = require("./errors.js");
+/** PCM16 mono 16kHz constants. */
+exports.SAMPLE_RATE = 16000;
+exports.SAMPLE_WIDTH = 2; // 16-bit = 2 bytes
+exports.CHANNELS = 1;
+exports.BYTES_PER_SECOND = exports.SAMPLE_RATE * exports.SAMPLE_WIDTH * exports.CHANNELS; // 32000
+/**
+ * Load a WAV file and validate that it is PCM16, 16kHz, mono.
+ * Returns the raw PCM data and format info.
+ */
+function loadWav(path) {
+    let buf;
+    try {
+        buf = (0, node_fs_1.readFileSync)(path);
+    }
+    catch (e) {
+        if (e.code === "ENOENT") {
+            throw new errors_js_1.AudioFormatError(`File not found: ${path}`);
+        }
+        throw new errors_js_1.AudioFormatError(`Cannot read file: ${path}`);
+    }
+    // Parse WAV header
+    if (buf.length < 44) {
+        throw new errors_js_1.AudioFormatError("Cannot read WAV file: file too small");
+    }
+    const riff = buf.toString("ascii", 0, 4);
+    const wave = buf.toString("ascii", 8, 12);
+    if (riff !== "RIFF" || wave !== "WAVE") {
+        throw new errors_js_1.AudioFormatError("Cannot read WAV file: not a valid WAV");
+    }
+    // Find "fmt " chunk
+    let offset = 12;
+    let fmtOffset = -1;
+    let dataOffset = -1;
+    let dataSize = 0;
+    while (offset < buf.length - 8) {
+        const chunkId = buf.toString("ascii", offset, offset + 4);
+        const chunkSize = buf.readUInt32LE(offset + 4);
+        if (chunkId === "fmt ") {
+            fmtOffset = offset + 8;
+        }
+        else if (chunkId === "data") {
+            dataOffset = offset + 8;
+            dataSize = chunkSize;
+            break; // data is always the last chunk we care about
+        }
+        offset += 8 + chunkSize;
+    }
+    if (fmtOffset === -1) {
+        throw new errors_js_1.AudioFormatError("Cannot read WAV file: no fmt chunk");
+    }
+    if (dataOffset === -1) {
+        throw new errors_js_1.AudioFormatError("Cannot read WAV file: no data chunk");
+    }
+    const audioFormat = buf.readUInt16LE(fmtOffset); // 1 = PCM
+    const channels = buf.readUInt16LE(fmtOffset + 2);
+    const sampleRate = buf.readUInt32LE(fmtOffset + 4);
+    const bitsPerSample = buf.readUInt16LE(fmtOffset + 14);
+    const sampleWidth = bitsPerSample / 8;
+    if (audioFormat !== 1) {
+        throw new errors_js_1.AudioFormatError(`Expected PCM format (1), got ${audioFormat}. Convert with: ffmpeg -i input.wav -acodec pcm_s16le output.wav`);
+    }
+    if (sampleRate !== exports.SAMPLE_RATE) {
+        throw new errors_js_1.AudioFormatError(`Expected ${exports.SAMPLE_RATE}Hz, got ${sampleRate}Hz. Resample with: ffmpeg -i input.wav -ar 16000 -ac 1 output.wav`);
+    }
+    if (channels !== exports.CHANNELS) {
+        throw new errors_js_1.AudioFormatError(`Expected mono, got ${channels} channels. Convert with: ffmpeg -i input.wav -ac 1 output.wav`);
+    }
+    if (sampleWidth !== exports.SAMPLE_WIDTH) {
+        throw new errors_js_1.AudioFormatError(`Expected 16-bit, got ${bitsPerSample}-bit. Convert with: ffmpeg -i input.wav -acodec pcm_s16le output.wav`);
+    }
+    const pcmData = buf.subarray(dataOffset, dataOffset + dataSize);
+    return { pcmData, sampleRate, channels, sampleWidth };
+}
+/** Generate PCM16 silence bytes (16kHz mono). */
+function silence(durationSeconds) {
+    const numBytes = Math.floor(exports.BYTES_PER_SECOND * durationSeconds);
+    return Buffer.alloc(numBytes);
+}
+/** Helper: sleep for ms. */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,45 @@
+import { Stream } from "./stream.js";
+import type { PricingInfo, SessionInfo } from "./types.js";
+export interface STTClientOptions {
+    privateKey: string;
+    url?: string;
+}
+export interface SessionOptions {
+    minutes?: number;
+    language?: string;
+    autoExtend?: boolean;
+}
+/**
+ * Client for dTelecom real-time speech-to-text with x402 micropayments.
+ */
+export declare class STTClient {
+    /** @internal */ readonly _url: string;
+    /** @internal */ readonly _wsUrl: string;
+    /** @internal */ readonly _fetchWithPayment: typeof fetch;
+    constructor(options: STTClientOptions);
+    /**
+     * Create a session context. Call `.open()` to connect.
+     */
+    session(options?: SessionOptions): SessionContext;
+    /** @internal Buy a session via x402 payment. */
+    _createSession(minutes: number, language: string): Promise<SessionInfo>;
+    /** @internal Extend session with additional paid minutes. */
+    _extendSession(sessionId: string, minutes?: number): Promise<Record<string, unknown>>;
+    /** Get pricing information (no payment required). */
+    pricing(): Promise<PricingInfo>;
+    /** Check server health (no payment required). */
+    health(): Promise<Record<string, unknown>>;
+}
+/**
+ * Context returned by `client.session()`.
+ * Call `.open()` to create the session and connect.
+ */
+export declare class SessionContext {
+    private _client;
+    private _minutes;
+    private _language;
+    private _autoExtend;
+    constructor(client: STTClient, options?: SessionOptions);
+    /** Create the paid session and open a WebSocket stream. */
+    open(): Promise<Stream>;
+}

package/dist/client.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionContext = exports.STTClient = void 0;
+const fetch_1 = require("@x402/fetch");
+const client_1 = require("@x402/evm/exact/client");
+const accounts_1 = require("viem/accounts");
+const errors_js_1 = require("./errors.js");
+const stream_js_1 = require("./stream.js");
+const DEFAULT_URL = "https://x402stt.dtelecom.org";
+/**
+ * Client for dTelecom real-time speech-to-text with x402 micropayments.
+ */
+class STTClient {
+    /** @internal */ _url;
+    /** @internal */ _wsUrl;
+    /** @internal */ _fetchWithPayment;
+    constructor(options) {
+        this._url = (options.url ?? DEFAULT_URL).replace(/\/+$/, "");
+        this._wsUrl = this._url
+            .replace("https://", "wss://")
+            .replace("http://", "ws://");
+        const signer = (0, accounts_1.privateKeyToAccount)((options.privateKey.startsWith("0x")
+            ? options.privateKey
+            : `0x${options.privateKey}`));
+        const client = new fetch_1.x402Client();
+        (0, client_1.registerExactEvmScheme)(client, { signer });
+        this._fetchWithPayment = (0, fetch_1.wrapFetchWithPayment)(fetch, client);
+    }
+    /**
+     * Create a session context. Call `.open()` to connect.
+     */
+    session(options) {
+        return new SessionContext(this, options);
+    }
+    /** @internal Buy a session via x402 payment. */
+    async _createSession(minutes, language) {
+        let resp;
+        try {
+            resp = await this._fetchWithPayment(`${this._url}/v1/session`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ minutes, language }),
+            });
+        }
+        catch (e) {
+            throw new errors_js_1.ConnectionError(`Cannot reach server: ${e}`);
+        }
+        if (resp.status === 402) {
+            const body = await resp.json().catch(() => ({}));
+            throw new errors_js_1.PaymentError(`Payment failed: ${body.message ?? resp.statusText}`);
+        }
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => "");
+            throw new errors_js_1.STTError(`Session creation failed (${resp.status}): ${text}`);
+        }
+        const data = (await resp.json());
+        return {
+            sessionId: data.session_id,
+            sessionKey: data.session_key,
+            wsUrl: data.ws_url ?? `${this._wsUrl}/v1/stream`,
+            remainingSeconds: data.remaining_seconds,
+            minutes: data.minutes,
+            priceUsd: data.price_usd,
+        };
+    }
+    /** @internal Extend session with additional paid minutes. */
+    async _extendSession(sessionId, minutes = 5) {
+        let resp;
+        try {
+            resp = await this._fetchWithPayment(`${this._url}/v1/session/extend`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ session_id: sessionId, minutes }),
+            });
+        }
+        catch (e) {
+            throw new errors_js_1.ConnectionError(`Cannot reach server: ${e}`);
+        }
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => "");
+            throw new errors_js_1.PaymentError(`Extend failed (${resp.status}): ${text}`);
+        }
+        return (await resp.json());
+    }
+    /** Get pricing information (no payment required). */
+    async pricing() {
+        let resp;
+        try {
+            resp = await fetch(`${this._url}/pricing`, {
+                signal: AbortSignal.timeout(10_000),
+            });
+        }
+        catch (e) {
+            throw new errors_js_1.ConnectionError(`Cannot reach server: ${e}`);
+        }
+        if (!resp.ok) {
+            throw new errors_js_1.STTError(`Pricing request failed (${resp.status})`);
+        }
+        const data = (await resp.json());
+        return {
+            pricePerMinuteUsd: data.price_per_minute_usd,
+            minMinutes: data.min_minutes,
+            maxMinutes: data.max_minutes,
+            minPriceUsd: data.min_price_usd ??
+                data.price_per_minute_usd * data.min_minutes,
+            currency: data.currency,
+            network: data.network,
+        };
+    }
+    /** Check server health (no payment required). */
+    async health() {
+        let resp;
+        try {
+            resp = await fetch(`${this._url}/health`, {
+                signal: AbortSignal.timeout(10_000),
+            });
+        }
+        catch (e) {
+            throw new errors_js_1.ConnectionError(`Cannot reach server: ${e}`);
+        }
+        return (await resp.json());
+    }
+}
+exports.STTClient = STTClient;
+/**
+ * Context returned by `client.session()`.
+ * Call `.open()` to create the session and connect.
+ */
+class SessionContext {
+    _client;
+    _minutes;
+    _language;
+    _autoExtend;
+    constructor(client, options) {
+        this._client = client;
+        this._minutes = options?.minutes ?? 5;
+        this._language = options?.language ?? "en";
+        this._autoExtend = options?.autoExtend ?? true;
+    }
+    /** Create the paid session and open a WebSocket stream. */
+    async open() {
+        const info = await this._client._createSession(this._minutes, this._language);
+        console.log(`Session created: id=${info.sessionId.slice(0, 8)}, ${info.remainingSeconds}s remaining, $${info.priceUsd}`);
+        const wsUrl = `${this._client._wsUrl}/v1/stream`;
+        const stream = new stream_js_1.Stream({
+            wsUrl,
+            sessionInfo: info,
+            client: this._client,
+            language: this._language,
+            autoExtend: this._autoExtend,
+        });
+        await stream._connect();
+        return stream;
+    }
+}
+exports.SessionContext = SessionContext;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+/** Base exception for all STT errors. */
+export declare class STTError extends Error {
+    constructor(message: string);
+}
+/** Payment failed or insufficient funds. */
+export declare class PaymentError extends STTError {
+    constructor(message: string);
+}
+/** Session time exhausted. */
+export declare class SessionExpiredError extends STTError {
+    constructor(message: string);
+}
+/** WebSocket or HTTP connection error. */
+export declare class ConnectionError extends STTError {
+    constructor(message: string);
+}
+/** Invalid audio format (not PCM16, wrong sample rate, etc.). */
+export declare class AudioFormatError extends STTError {
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudioFormatError = exports.ConnectionError = exports.SessionExpiredError = exports.PaymentError = exports.STTError = void 0;
+/** Base exception for all STT errors. */
+class STTError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "STTError";
+    }
+}
+exports.STTError = STTError;
+/** Payment failed or insufficient funds. */
+class PaymentError extends STTError {
+    constructor(message) {
+        super(message);
+        this.name = "PaymentError";
+    }
+}
+exports.PaymentError = PaymentError;
+/** Session time exhausted. */
+class SessionExpiredError extends STTError {
+    constructor(message) {
+        super(message);
+        this.name = "SessionExpiredError";
+    }
+}
+exports.SessionExpiredError = SessionExpiredError;
+/** WebSocket or HTTP connection error. */
+class ConnectionError extends STTError {
+    constructor(message) {
+        super(message);
+        this.name = "ConnectionError";
+    }
+}
+exports.ConnectionError = ConnectionError;
+/** Invalid audio format (not PCM16, wrong sample rate, etc.). */
+class AudioFormatError extends STTError {
+    constructor(message) {
+        super(message);
+        this.name = "AudioFormatError";
+    }
+}
+exports.AudioFormatError = AudioFormatError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,yCAAyC;AACzC,MAAa,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AALD,4BAKC;AAED,4CAA4C;AAC5C,MAAa,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,8BAA8B;AAC9B,MAAa,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,0CAA0C;AAC1C,MAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,iEAAiE;AACjE,MAAa,gBAAiB,SAAQ,QAAQ;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { STTClient, SessionContext } from "./client.js";
+export type { STTClientOptions, SessionOptions } from "./client.js";
+export { Stream } from "./stream.js";
+export type { Transcription, SessionInfo, PricingInfo } from "./types.js";
+export { STTError, PaymentError, SessionExpiredError, ConnectionError, AudioFormatError, } from "./errors.js";

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudioFormatError = exports.ConnectionError = exports.SessionExpiredError = exports.PaymentError = exports.STTError = exports.Stream = exports.SessionContext = exports.STTClient = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "STTClient", { enumerable: true, get: function () { return client_js_1.STTClient; } });
+Object.defineProperty(exports, "SessionContext", { enumerable: true, get: function () { return client_js_1.SessionContext; } });
+var stream_js_1 = require("./stream.js");
+Object.defineProperty(exports, "Stream", { enumerable: true, get: function () { return stream_js_1.Stream; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "STTError", { enumerable: true, get: function () { return errors_js_1.STTError; } });
+Object.defineProperty(exports, "PaymentError", { enumerable: true, get: function () { return errors_js_1.PaymentError; } });
+Object.defineProperty(exports, "SessionExpiredError", { enumerable: true, get: function () { return errors_js_1.SessionExpiredError; } });
+Object.defineProperty(exports, "ConnectionError", { enumerable: true, get: function () { return errors_js_1.ConnectionError; } });
+Object.defineProperty(exports, "AudioFormatError", { enumerable: true, get: function () { return errors_js_1.AudioFormatError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAwD;AAA/C,sGAAA,SAAS,OAAA;AAAE,2GAAA,cAAc,OAAA;AAElC,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AAEf,yCAMqB;AALnB,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,gHAAA,mBAAmB,OAAA;AACnB,4GAAA,eAAe,OAAA;AACf,6GAAA,gBAAgB,OAAA"}

package/dist/stream.d.ts

@@ -0,0 +1,51 @@
+import type { SessionInfo, Transcription } from "./types.js";
+export interface StreamOptions {
+    wsUrl: string;
+    sessionInfo: SessionInfo;
+    client: {
+        _extendSession(sessionId: string, minutes?: number): Promise<Record<string, unknown>>;
+    };
+    language: string;
+    autoExtend: boolean;
+}
+/**
+ * WebSocket stream for sending audio and receiving transcriptions.
+ * Do not instantiate directly — use `STTClient.session().open()`.
+ */
+export declare class Stream {
+    private _wsUrl;
+    private _info;
+    private _client;
+    private _language;
+    private _autoExtend;
+    private _ws;
+    private _closed;
+    private _extending;
+    /** Queued transcriptions for the async iterator. null = end sentinel. */
+    private _queue;
+    private _waiters;
+    private _callbacks;
+    constructor(options: StreamOptions);
+    /** @internal Connect WebSocket, send config, wait for ready. */
+    _connect(): Promise<void>;
+    /** Close the WebSocket connection gracefully. */
+    close(): Promise<void>;
+    /** Send raw PCM16 audio bytes (16kHz mono). */
+    sendAudio(data: Buffer): Promise<void>;
+    /** Register a callback for incoming transcriptions. */
+    onTranscription(callback: (t: Transcription) => void): void;
+    /** Async iterator yielding transcriptions as they arrive. */
+    transcriptions(): AsyncGenerator<Transcription>;
+    /**
+     * Stream a WAV file and yield transcriptions.
+     * Loads the file, streams at real-time speed, sends trailing silence,
+     * and yields results.
+     */
+    transcribeFile(path: string): AsyncGenerator<Transcription>;
+    private _push;
+    private _pull;
+    private _pullWithTimeout;
+    private _onMessage;
+    private _onClose;
+    private _autoExtendSession;
+}

package/dist/stream.js

@@ -0,0 +1,258 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Stream = void 0;
+const ws_1 = __importDefault(require("ws"));
+const audio_js_1 = require("./audio.js");
+const errors_js_1 = require("./errors.js");
+const types_js_1 = require("./types.js");
+/** How long to wait for new transcriptions after audio ends. */
+const FILE_DRAIN_TIMEOUT_MS = 5_000;
+/** Trailing silence to flush VAD pipeline. */
+const TRAILING_SILENCE_SECONDS = 2.0;
+/** Chunk size for real-time audio streaming. */
+const CHUNK_MS = 20;
+/**
+ * WebSocket stream for sending audio and receiving transcriptions.
+ * Do not instantiate directly — use `STTClient.session().open()`.
+ */
+class Stream {
+    _wsUrl;
+    _info;
+    _client;
+    _language;
+    _autoExtend;
+    _ws = null;
+    _closed = false;
+    _extending = false;
+    /** Queued transcriptions for the async iterator. null = end sentinel. */
+    _queue = [];
+    _waiters = [];
+    _callbacks = [];
+    constructor(options) {
+        this._wsUrl = options.wsUrl;
+        this._info = options.sessionInfo;
+        this._client = options.client;
+        this._language = options.language;
+        this._autoExtend = options.autoExtend;
+    }
+    // ── Connection lifecycle ──────────────────────────────────────────
+    /** @internal Connect WebSocket, send config, wait for ready. */
+    async _connect() {
+        return new Promise((resolve, reject) => {
+            try {
+                this._ws = new ws_1.default(this._wsUrl);
+            }
+            catch (e) {
+                reject(new errors_js_1.ConnectionError(`WebSocket connection failed: ${e}`));
+                return;
+            }
+            const timeout = setTimeout(() => {
+                this._ws?.close();
+                reject(new errors_js_1.ConnectionError("Timeout waiting for ready message"));
+            }, 30_000);
+            this._ws.on("error", (err) => {
+                clearTimeout(timeout);
+                reject(new errors_js_1.ConnectionError(`WebSocket connection failed: ${err.message}`));
+            });
+            this._ws.on("open", () => {
+                const config = {
+                    type: "config",
+                    language: this._language,
+                    session_key: this._info.sessionKey,
+                };
+                this._ws.send(JSON.stringify(config));
+            });
+            // Wait for the "ready" message before resolving
+            this._ws.once("message", (raw) => {
+                clearTimeout(timeout);
+                const msg = JSON.parse(raw.toString());
+                if (msg.type === "error") {
+                    this._ws.close();
+                    reject(new errors_js_1.STTError(`Server error: ${msg.message ?? JSON.stringify(msg)}`));
+                    return;
+                }
+                if (msg.type !== "ready") {
+                    this._ws.close();
+                    reject(new errors_js_1.STTError(`Expected ready message, got: ${JSON.stringify(msg)}`));
+                    return;
+                }
+                const remaining = msg.remaining_seconds ?? this._info.remainingSeconds;
+                console.log(`Stream ready, remaining=${Math.round(remaining)}s`);
+                // Switch to the persistent recv loop
+                this._ws.on("message", (data, isBinary) => this._onMessage(data, isBinary));
+                this._ws.on("close", () => this._onClose());
+                resolve();
+            });
+        });
+    }
+    /** Close the WebSocket connection gracefully. */
+    async close() {
+        if (this._closed)
+            return;
+        this._closed = true;
+        // Signal end to async iterators
+        this._push(null);
+        if (this._ws) {
+            try {
+                this._ws.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    // ── Sending audio ─────────────────────────────────────────────────
+    /** Send raw PCM16 audio bytes (16kHz mono). */
+    async sendAudio(data) {
+        if (this._closed)
+            throw new errors_js_1.STTError("Stream is closed");
+        this._ws.send(data);
+    }
+    // ── Receiving transcriptions ──────────────────────────────────────
+    /** Register a callback for incoming transcriptions. */
+    onTranscription(callback) {
+        this._callbacks.push(callback);
+    }
+    /** Async iterator yielding transcriptions as they arrive. */
+    async *transcriptions() {
+        while (true) {
+            const item = await this._pull();
+            if (item === null)
+                return;
+            yield item;
+        }
+    }
+    /**
+     * Stream a WAV file and yield transcriptions.
+     * Loads the file, streams at real-time speed, sends trailing silence,
+     * and yields results.
+     */
+    async *transcribeFile(path) {
+        const { pcmData } = (0, audio_js_1.loadWav)(path);
+        const audioDuration = pcmData.length / audio_js_1.BYTES_PER_SECOND;
+        console.log(`Streaming file ${path} (${audioDuration.toFixed(1)}s)`);
+        // Stream audio at real-time speed
+        const chunkBytes = Math.floor(audio_js_1.BYTES_PER_SECOND * CHUNK_MS / 1000);
+        let offset = 0;
+        while (offset < pcmData.length) {
+            const chunk = pcmData.subarray(offset, offset + chunkBytes);
+            this._ws.send(chunk);
+            offset += chunkBytes;
+            await (0, audio_js_1.sleep)(CHUNK_MS);
+        }
+        // Send trailing silence to flush VAD
+        this._ws.send((0, audio_js_1.silence)(TRAILING_SILENCE_SECONDS));
+        await (0, audio_js_1.sleep)(TRAILING_SILENCE_SECONDS * 1000);
+        // Drain transcriptions with timeout
+        while (true) {
+            const item = await this._pullWithTimeout(FILE_DRAIN_TIMEOUT_MS);
+            if (item === null)
+                return;
+            yield item;
+        }
+    }
+    // ── Internal queue helpers ────────────────────────────────────────
+    _push(item) {
+        this._queue.push(item);
+        // Wake up any waiters
+        const waiter = this._waiters.shift();
+        if (waiter)
+            waiter();
+    }
+    async _pull() {
+        if (this._queue.length > 0) {
+            return this._queue.shift();
+        }
+        await new Promise((resolve) => this._waiters.push(resolve));
+        return this._queue.shift() ?? null;
+    }
+    async _pullWithTimeout(timeoutMs) {
+        if (this._queue.length > 0) {
+            return this._queue.shift();
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                // Remove the waiter if it hasn't been called
+                const idx = this._waiters.indexOf(wakerFn);
+                if (idx >= 0)
+                    this._waiters.splice(idx, 1);
+                resolve(null);
+            }, timeoutMs);
+            const wakerFn = () => {
+                clearTimeout(timer);
+                resolve(this._queue.shift() ?? null);
+            };
+            this._waiters.push(wakerFn);
+        });
+    }
+    // ── WebSocket message handling ────────────────────────────────────
+    _onMessage(raw, isBinary) {
+        // Ignore binary messages from server
+        if (isBinary)
+            return;
+        const text = raw.toString();
+        let msg;
+        try {
+            msg = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        const msgType = msg.type;
+        if (msgType === "transcription") {
+            const t = (0, types_js_1.transcriptionFromMessage)(msg);
+            this._push(t);
+            for (const cb of this._callbacks) {
+                try {
+                    cb(t);
+                }
+                catch (e) {
+                    console.error("Transcription callback error:", e);
+                }
+            }
+        }
+        else if (msgType === "session_expiring") {
+            const remaining = msg.remaining_seconds;
+            console.warn(`Session expiring, ${Math.round(remaining)}s remaining`);
+            if (this._autoExtend && !this._extending) {
+                this._autoExtendSession();
+            }
+        }
+        else if (msgType === "session_extended") {
+            const remaining = msg.remaining_seconds;
+            console.log(`Session extended, ${Math.round(remaining)}s remaining`);
+        }
+        else if (msgType === "session_expired") {
+            console.error("Session expired");
+            this._push(null);
+        }
+        else if (msgType === "error") {
+            console.error(`Server error: ${msg.message ?? JSON.stringify(msg)}`);
+        }
+    }
+    _onClose() {
+        if (!this._closed) {
+            this._push(null);
+        }
+    }
+    async _autoExtendSession() {
+        this._extending = true;
+        try {
+            const result = await this._client._extendSession(this._info.sessionId, 5);
+            console.log(`Auto-extended session: +${result.minutes_added ?? 5}min, ` +
+                `remaining=${Math.round(result.remaining_seconds)}s, ` +
+                `$${result.price_usd ?? "?"}`);
+        }
+        catch (e) {
+            console.error("Auto-extend failed:", e);
+        }
+        finally {
+            this._extending = false;
+        }
+    }
+}
+exports.Stream = Stream;
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+/** A transcription result from the STT server. */
+export interface Transcription {
+    text: string;
+    start?: number;
+    end?: number;
+    confidence?: number;
+    isFinal: boolean;
+}
+/** Info returned when a session is created. */
+export interface SessionInfo {
+    sessionId: string;
+    sessionKey: string;
+    wsUrl: string;
+    remainingSeconds: number;
+    minutes: number;
+    priceUsd: string;
+}
+/** Pricing information from the server. */
+export interface PricingInfo {
+    pricePerMinuteUsd: number;
+    minMinutes: number;
+    maxMinutes: number;
+    minPriceUsd: number;
+    currency: string;
+    network: string;
+}
+/** Parse a server JSON message into a Transcription. */
+export declare function transcriptionFromMessage(msg: Record<string, unknown>): Transcription;

package/dist/types.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transcriptionFromMessage = transcriptionFromMessage;
+/** Parse a server JSON message into a Transcription. */
+function transcriptionFromMessage(msg) {
+    return {
+        text: msg.text ?? "",
+        start: msg.start,
+        end: msg.end,
+        confidence: msg.confidence,
+        isFinal: msg.is_final ?? true,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;AA8BA,4DAQC;AATD,wDAAwD;AACxD,SAAgB,wBAAwB,CAAC,GAA4B;IACnE,OAAO;QACL,IAAI,EAAG,GAAG,CAAC,IAAe,IAAI,EAAE;QAChC,KAAK,EAAE,GAAG,CAAC,KAA2B;QACtC,GAAG,EAAE,GAAG,CAAC,GAAyB;QAClC,UAAU,EAAE,GAAG,CAAC,UAAgC;QAChD,OAAO,EAAG,GAAG,CAAC,QAAoB,IAAI,IAAI;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@dtelecom/stt",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for dTelecom real-time speech-to-text with x402 micropayments",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "stt",
+    "speech-to-text",
+    "x402",
+    "micropayments",
+    "realtime"
+  ],
+  "author": "dTelecom <dev@dtelecom.org>",
+  "license": "MIT",
+  "dependencies": {
+    "@x402/evm": "^2.0.0",
+    "@x402/fetch": "^2.0.0",
+    "viem": "^2.0.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}