dvgateway-sdk 1.0.0

package/dist/audio/codec.js

@@ -0,0 +1,136 @@
+/**
+ * Audio Codec Utilities
+ *
+ * Converts between DVGateway's native slin16 format and Float32 PCM
+ * used by most AI STT/TTS APIs.
+ *
+ * DVGateway audio format:
+ *   - Sample rate: 16000 Hz
+ *   - Bit depth: 16-bit signed integer
+ *   - Endianness: little-endian
+ *   - Frame size: 640 bytes = 320 samples = 20ms
+ *   - Channels: 1 (mono)
+ */
+/** Convert slin16 Buffer → normalized Float32Array [-1.0, 1.0] */
+export function slin16ToFloat32(buf) {
+    const samples = buf.byteLength >> 1; // divide by 2 (each sample = 2 bytes)
+    const out = new Float32Array(samples);
+    for (let i = 0; i < samples; i++) {
+        // Read signed 16-bit little-endian integer
+        const s16 = buf.readInt16LE(i * 2);
+        // Normalize to [-1.0, 1.0]
+        out[i] = s16 / 32768.0;
+    }
+    return out;
+}
+/** Convert normalized Float32Array [-1.0, 1.0] → slin16 Buffer */
+export function float32ToSlin16(samples) {
+    const buf = Buffer.allocUnsafe(samples.length * 2);
+    for (let i = 0; i < samples.length; i++) {
+        // Clamp to [-1.0, 1.0] and scale to int16 range
+        const clamped = Math.max(-1.0, Math.min(1.0, samples[i] ?? 0));
+        const s16 = Math.round(clamped * 32767);
+        buf.writeInt16LE(s16, i * 2);
+    }
+    return buf;
+}
+/** Convert μ-law (ulaw) Buffer → slin16 Buffer */
+export function ulawToSlin16(ulaw) {
+    const out = Buffer.allocUnsafe(ulaw.byteLength * 2);
+    for (let i = 0; i < ulaw.byteLength; i++) {
+        const s16 = ULAW_TO_LINEAR[ulaw[i]];
+        out.writeInt16LE(s16, i * 2);
+    }
+    return out;
+}
+/** Convert slin16 Buffer → μ-law (ulaw) Buffer */
+export function slin16ToUlaw(slin16) {
+    const samples = slin16.byteLength >> 1;
+    const out = Buffer.allocUnsafe(samples);
+    for (let i = 0; i < samples; i++) {
+        const s16 = slin16.readInt16LE(i * 2);
+        out[i] = linearToUlaw(s16);
+    }
+    return out;
+}
+/**
+ * Resample Float32Array from one sample rate to another.
+ * Uses linear interpolation — suitable for real-time processing.
+ *
+ * @param samples - Input samples
+ * @param fromRate - Source sample rate (e.g. 16000)
+ * @param toRate   - Target sample rate (e.g. 24000 for ElevenLabs)
+ */
+export function resample(samples, fromRate, toRate) {
+    if (fromRate === toRate)
+        return samples;
+    const ratio = fromRate / toRate;
+    const outLength = Math.round(samples.length / ratio);
+    const out = new Float32Array(outLength);
+    for (let i = 0; i < outLength; i++) {
+        const srcPos = i * ratio;
+        const srcIdx = Math.floor(srcPos);
+        const frac = srcPos - srcIdx;
+        const s0 = samples[srcIdx] ?? 0;
+        const s1 = samples[Math.min(srcIdx + 1, samples.length - 1)] ?? 0;
+        out[i] = s0 + frac * (s1 - s0); // linear interpolation
+    }
+    return out;
+}
+/**
+ * Calculate RMS (Root Mean Square) amplitude of audio samples.
+ * Returns a value in [0.0, 1.0].
+ */
+export function calculateRms(samples) {
+    if (samples.length === 0)
+        return 0;
+    let sum = 0;
+    for (let i = 0; i < samples.length; i++) {
+        const s = samples[i] ?? 0;
+        sum += s * s;
+    }
+    return Math.sqrt(sum / samples.length);
+}
+/**
+ * Simple Voice Activity Detection based on RMS threshold.
+ * Returns true if the frame likely contains speech.
+ *
+ * @param samples - Float32 samples
+ * @param threshold - RMS threshold (default: 0.01, i.e. -40 dBFS)
+ */
+export function detectVoiceActivity(samples, threshold = 0.01) {
+    return calculateRms(samples) > threshold;
+}
+// ─── μ-law lookup tables ──────────────────────────────────────────────────
+/** μ-law to linear 16-bit PCM lookup table (256 entries) */
+const ULAW_TO_LINEAR = (() => {
+    const table = new Int16Array(256);
+    for (let i = 0; i < 256; i++) {
+        const u = ~i;
+        const sign = u & 0x80;
+        const exponent = (u >> 4) & 0x07;
+        const mantissa = u & 0x0f;
+        let sample = ((mantissa << 3) + 0x84) << exponent;
+        sample -= 0x84;
+        table[i] = sign !== 0 ? -sample : sample;
+    }
+    return table;
+})();
+function linearToUlaw(sample) {
+    const BIAS = 0x84;
+    const CLIP = 32635;
+    const sign = sample < 0 ? 0x80 : 0;
+    if (sample < 0)
+        sample = -sample;
+    if (sample > CLIP)
+        sample = CLIP;
+    sample += BIAS;
+    let exponent = 7;
+    for (let expMask = 0x4000; (sample & expMask) === 0 && exponent > 0; exponent--) {
+        expMask >>= 1;
+    }
+    const mantissa = (sample >> (exponent + 3)) & 0x0f;
+    const result = ~(sign | (exponent << 4) | mantissa);
+    return result & 0xff;
+}
+//# sourceMappingURL=codec.js.map

package/dist/audio/codec.js.map

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

package/dist/audio/codec.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=codec.test.d.ts.map

package/dist/audio/codec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.test.d.ts","sourceRoot":"","sources":["../../src/audio/codec.test.ts"],"names":[],"mappings":""}

package/dist/audio/codec.test.js

@@ -0,0 +1,155 @@
+import { slin16ToFloat32, float32ToSlin16, ulawToSlin16, slin16ToUlaw, resample, calculateRms, detectVoiceActivity, } from './codec.js';
+describe('slin16ToFloat32', () => {
+    it('should convert silence (zeros) correctly', () => {
+        const buf = Buffer.alloc(640); // 320 samples of silence
+        const result = slin16ToFloat32(buf);
+        expect(result.length).toBe(320);
+        expect(result.every((s) => s === 0)).toBe(true);
+    });
+    it('should convert max positive value to ~1.0', () => {
+        const buf = Buffer.alloc(2);
+        buf.writeInt16LE(32767, 0); // max int16
+        const result = slin16ToFloat32(buf);
+        expect(result[0]).toBeCloseTo(1.0, 3);
+    });
+    it('should convert max negative value to ~-1.0', () => {
+        const buf = Buffer.alloc(2);
+        buf.writeInt16LE(-32768, 0); // min int16
+        const result = slin16ToFloat32(buf);
+        expect(result[0]).toBeCloseTo(-1.0, 3);
+    });
+    it('should handle a standard 20ms frame (640 bytes)', () => {
+        const buf = Buffer.alloc(640);
+        // Write a known pattern
+        for (let i = 0; i < 320; i++) {
+            buf.writeInt16LE(i * 100, i * 2);
+        }
+        const result = slin16ToFloat32(buf);
+        expect(result.length).toBe(320);
+        expect(result[0]).toBe(0); // first sample = 0
+        expect(result[1]).toBeCloseTo(100 / 32768, 4);
+    });
+});
+describe('float32ToSlin16', () => {
+    it('should convert silence correctly', () => {
+        const samples = new Float32Array(320);
+        const buf = float32ToSlin16(samples);
+        expect(buf.byteLength).toBe(640);
+        for (let i = 0; i < 320; i++) {
+            expect(buf.readInt16LE(i * 2)).toBe(0);
+        }
+    });
+    it('should clamp values beyond [-1.0, 1.0]', () => {
+        const samples = new Float32Array([1.5, -1.5, 0.5]);
+        const buf = float32ToSlin16(samples);
+        expect(buf.readInt16LE(0)).toBe(32767); // clamped to 1.0
+        expect(buf.readInt16LE(2)).toBe(-32767); // clamped to -1.0
+        expect(buf.readInt16LE(4)).toBe(Math.round(0.5 * 32767));
+    });
+    it('should be inverse of slin16ToFloat32 (roundtrip)', () => {
+        const original = Buffer.alloc(20);
+        for (let i = 0; i < 10; i++) {
+            original.writeInt16LE(i * 1000 - 5000, i * 2);
+        }
+        const float32 = slin16ToFloat32(original);
+        const roundtrip = float32ToSlin16(float32);
+        for (let i = 0; i < 10; i++) {
+            // Allow ±1 rounding error
+            expect(Math.abs(roundtrip.readInt16LE(i * 2) - original.readInt16LE(i * 2))).toBeLessThanOrEqual(1);
+        }
+    });
+});
+describe('ulawToSlin16 / slin16ToUlaw', () => {
+    it('should roundtrip ulaw → slin16 → ulaw with reasonable accuracy', () => {
+        // Create a buffer with all 256 possible ulaw values
+        const ulawBuf = Buffer.alloc(256);
+        for (let i = 0; i < 256; i++) {
+            ulawBuf[i] = i;
+        }
+        const slin16Buf = ulawToSlin16(ulawBuf);
+        expect(slin16Buf.byteLength).toBe(512); // 256 samples × 2 bytes
+        const reEncoded = slin16ToUlaw(slin16Buf);
+        expect(reEncoded.byteLength).toBe(256);
+        // Roundtrip: ulaw → linear → ulaw should be exact (or very close)
+        let exactMatches = 0;
+        for (let i = 0; i < 256; i++) {
+            if (reEncoded[i] === ulawBuf[i])
+                exactMatches++;
+        }
+        // At least 90% should be exact matches
+        expect(exactMatches).toBeGreaterThan(230);
+    });
+    it('should convert ulaw silence (0xFF) to near-zero linear', () => {
+        const ulawBuf = Buffer.from([0xFF]);
+        const slin16Buf = ulawToSlin16(ulawBuf);
+        const sample = slin16Buf.readInt16LE(0);
+        expect(Math.abs(sample)).toBeLessThan(200); // near-silence
+    });
+});
+describe('resample', () => {
+    it('should return same array when rates are equal', () => {
+        const samples = new Float32Array([0.1, 0.2, 0.3]);
+        const result = resample(samples, 16000, 16000);
+        expect(result).toBe(samples); // exact same reference
+    });
+    it('should upsample 16kHz → 24kHz', () => {
+        const samples = new Float32Array(320); // 20ms at 16kHz
+        for (let i = 0; i < 320; i++) {
+            samples[i] = Math.sin(2 * Math.PI * 440 * i / 16000); // 440Hz tone
+        }
+        const result = resample(samples, 16000, 24000);
+        // 320 samples at 16kHz → ~480 samples at 24kHz
+        expect(result.length).toBe(480);
+    });
+    it('should downsample 48kHz → 16kHz', () => {
+        const samples = new Float32Array(960); // 20ms at 48kHz
+        const result = resample(samples, 48000, 16000);
+        expect(result.length).toBe(320);
+    });
+});
+describe('calculateRms', () => {
+    it('should return 0 for empty array', () => {
+        expect(calculateRms(new Float32Array(0))).toBe(0);
+    });
+    it('should return 0 for silence', () => {
+        expect(calculateRms(new Float32Array(320))).toBe(0);
+    });
+    it('should return ~0.707 for full-scale square wave', () => {
+        const samples = new Float32Array(100);
+        for (let i = 0; i < 100; i++) {
+            samples[i] = i % 2 === 0 ? 1.0 : -1.0;
+        }
+        expect(calculateRms(samples)).toBeCloseTo(1.0, 3);
+    });
+    it('should return a value between 0 and 1 for a sine wave', () => {
+        const samples = new Float32Array(1000);
+        for (let i = 0; i < 1000; i++) {
+            samples[i] = Math.sin(2 * Math.PI * i / 1000);
+        }
+        const rms = calculateRms(samples);
+        expect(rms).toBeGreaterThan(0);
+        expect(rms).toBeLessThan(1);
+        expect(rms).toBeCloseTo(Math.SQRT1_2, 1); // sine wave RMS = 1/√2 ≈ 0.707
+    });
+});
+describe('detectVoiceActivity', () => {
+    it('should return false for silence', () => {
+        expect(detectVoiceActivity(new Float32Array(320))).toBe(false);
+    });
+    it('should return true for loud audio', () => {
+        const samples = new Float32Array(320);
+        for (let i = 0; i < 320; i++) {
+            samples[i] = 0.5 * Math.sin(2 * Math.PI * 440 * i / 16000);
+        }
+        expect(detectVoiceActivity(samples)).toBe(true);
+    });
+    it('should respect custom threshold', () => {
+        const samples = new Float32Array(320);
+        for (let i = 0; i < 320; i++) {
+            samples[i] = 0.005; // very quiet
+        }
+        expect(detectVoiceActivity(samples, 0.01)).toBe(false); // default threshold: not voice
+        expect(detectVoiceActivity(samples, 0.001)).toBe(true); // lower threshold: detected
+    });
+});
+//# sourceMappingURL=codec.test.js.map

package/dist/audio/codec.test.js.map

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

package/dist/auth/manager.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Authentication Manager
+ *
+ * Handles API Key → JWT exchange with automatic silent refresh.
+ * Users never need to manage tokens directly.
+ *
+ * Security: Uses RS256 JWTs with short TTL (15 min).
+ * Tokens are refreshed 60 seconds before expiry.
+ */
+import type { Auth, Logger } from '../types/index.js';
+export declare class AuthManager {
+    private readonly auth;
+    private readonly baseUrl;
+    private readonly logger;
+    private cachedToken;
+    private tokenExpiresAt;
+    private refreshPromise;
+    /** Token is refreshed 60 seconds before actual expiry */
+    private static readonly REFRESH_BUFFER_MS;
+    constructor(auth: Auth, baseUrl: string, logger: Logger);
+    /**
+     * Returns a valid bearer token, refreshing if necessary.
+     * Thread-safe: concurrent calls share a single refresh promise.
+     */
+    getToken(): Promise<string>;
+    /** Returns a bearer token header value */
+    getBearerHeader(): Promise<string>;
+    private fetchToken;
+    /** Build authenticated WebSocket URL (token embedded as query param) */
+    buildWsUrl(path: string, params?: Record<string, string>): Promise<string>;
+    /** Build authenticated HTTP URL */
+    buildHttpUrl(path: string, params?: Record<string, string>): string;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/auth/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/auth/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAqBtD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAgC;IAEtD,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAU;gBAEvC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAkBvD;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBjC,0CAA0C;IACpC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;YAI1B,UAAU;IAkDxB,wEAAwE;IAClE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpF,mCAAmC;IACnC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM;CAMxE"}

package/dist/auth/manager.js

@@ -0,0 +1,122 @@
+/**
+ * Authentication Manager
+ *
+ * Handles API Key → JWT exchange with automatic silent refresh.
+ * Users never need to manage tokens directly.
+ *
+ * Security: Uses RS256 JWTs with short TTL (15 min).
+ * Tokens are refreshed 60 seconds before expiry.
+ */
+function parseJwtPayload(token) {
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        throw new Error('Invalid JWT format');
+    }
+    const payload = parts[1];
+    // Base64URL decode
+    const padded = payload.replace(/-/g, '+').replace(/_/g, '/');
+    const json = Buffer.from(padded, 'base64').toString('utf8');
+    return JSON.parse(json);
+}
+export class AuthManager {
+    auth;
+    baseUrl;
+    logger;
+    cachedToken = null;
+    tokenExpiresAt = 0;
+    refreshPromise = null;
+    /** Token is refreshed 60 seconds before actual expiry */
+    static REFRESH_BUFFER_MS = 60_000;
+    constructor(auth, baseUrl, logger) {
+        this.auth = auth;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+        // Pre-load JWT if provided directly
+        if (auth.type === 'jwt') {
+            this.cachedToken = auth.token;
+            try {
+                const payload = parseJwtPayload(auth.token);
+                this.tokenExpiresAt = payload.exp * 1000;
+            }
+            catch {
+                // If we can't parse it, treat as expired so it gets refreshed
+                this.tokenExpiresAt = 0;
+            }
+        }
+    }
+    /**
+     * Returns a valid bearer token, refreshing if necessary.
+     * Thread-safe: concurrent calls share a single refresh promise.
+     */
+    async getToken() {
+        const now = Date.now();
+        const refreshThreshold = this.tokenExpiresAt - AuthManager.REFRESH_BUFFER_MS;
+        if (this.cachedToken && now < refreshThreshold) {
+            return this.cachedToken;
+        }
+        // Coalesce concurrent refresh requests into a single HTTP call
+        if (!this.refreshPromise) {
+            this.refreshPromise = this.fetchToken().finally(() => {
+                this.refreshPromise = null;
+            });
+        }
+        return this.refreshPromise;
+    }
+    /** Returns a bearer token header value */
+    async getBearerHeader() {
+        return `Bearer ${await this.getToken()}`;
+    }
+    async fetchToken() {
+        if (this.auth.type === 'jwt') {
+            // Re-validate JWT — caller supplied a static token
+            const payload = parseJwtPayload(this.auth.token);
+            if (payload.exp * 1000 < Date.now()) {
+                throw new Error('DVGateway: provided JWT has expired. ' +
+                    'Use apiKey auth for automatic token refresh.');
+            }
+            this.cachedToken = this.auth.token;
+            this.tokenExpiresAt = payload.exp * 1000;
+            return this.cachedToken;
+        }
+        // API Key → JWT exchange
+        const url = `${this.baseUrl}/api/v1/auth/token`;
+        this.logger.debug({ url }, 'Fetching new JWT from gateway');
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-Key': this.auth.apiKey,
+            },
+            body: JSON.stringify({ apiKey: this.auth.apiKey }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`DVGateway auth failed (HTTP ${response.status}): ${body}`);
+        }
+        const data = (await response.json());
+        const token = data.token;
+        const payload = parseJwtPayload(token);
+        this.cachedToken = token;
+        this.tokenExpiresAt = payload.exp * 1000;
+        this.logger.debug({ expiresAt: new Date(this.tokenExpiresAt).toISOString() }, 'JWT refreshed successfully');
+        return token;
+    }
+    /** Build authenticated WebSocket URL (token embedded as query param) */
+    async buildWsUrl(path, params = {}) {
+        const token = await this.getToken();
+        const base = this.baseUrl
+            .replace(/^https?:\/\//, (m) => (m.startsWith('https') ? 'wss://' : 'ws://'))
+            .replace(/\/$/, '');
+        const query = new URLSearchParams({ ...params, token });
+        return `${base}${path}?${query.toString()}`;
+    }
+    /** Build authenticated HTTP URL */
+    buildHttpUrl(path, params = {}) {
+        const base = this.baseUrl.replace(/\/$/, '');
+        if (Object.keys(params).length === 0)
+            return `${base}${path}`;
+        const query = new URLSearchParams(params);
+        return `${base}${path}?${query.toString()}`;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/auth/manager.js.map

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

package/dist/auth/manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manager.test.d.ts.map

package/dist/auth/manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.test.d.ts","sourceRoot":"","sources":["../../src/auth/manager.test.ts"],"names":[],"mappings":""}

package/dist/auth/manager.test.js

@@ -0,0 +1,147 @@
+import { AuthManager } from './manager.js';
+// Minimal logger for tests
+const mockLogger = {
+    debug: jest.fn(),
+    info: jest.fn(),
+    warn: jest.fn(),
+    error: jest.fn(),
+};
+// Helper: create a valid JWT with given payload
+function createJwt(payload) {
+    const header = Buffer.from(JSON.stringify({ alg: 'HS256', typ: 'JWT' })).toString('base64url');
+    const body = Buffer.from(JSON.stringify(payload)).toString('base64url');
+    const sig = 'fakesig';
+    return `${header}.${body}.${sig}`;
+}
+describe('AuthManager', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Reset fetch mocks
+        globalThis.fetch = jest.fn();
+    });
+    describe('JWT auth', () => {
+        it('should return the provided token when not expired', async () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600; // 1 hour from now
+            const token = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'user1' });
+            const auth = new AuthManager({ type: 'jwt', token }, 'https://gw.test', mockLogger);
+            const result = await auth.getToken();
+            expect(result).toBe(token);
+        });
+        it('should throw when JWT is expired', async () => {
+            const pastExp = Math.floor(Date.now() / 1000) - 3600; // 1 hour ago
+            const token = createJwt({ exp: pastExp, iat: pastExp - 3600, sub: 'user1' });
+            const auth = new AuthManager({ type: 'jwt', token }, 'https://gw.test', mockLogger);
+            await expect(auth.getToken()).rejects.toThrow('JWT has expired');
+        });
+        it('should treat malformed JWT as expired and throw on getToken', async () => {
+            // Constructor catches parse errors and sets tokenExpiresAt = 0
+            const auth = new AuthManager({ type: 'jwt', token: 'invalid' }, 'https://gw.test', mockLogger);
+            // getToken re-validates → throws "Invalid JWT format"
+            await expect(auth.getToken()).rejects.toThrow('Invalid JWT format');
+        });
+    });
+    describe('API key auth', () => {
+        it('should exchange API key for JWT token', async () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const responseToken = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'api' });
+            globalThis.fetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ token: responseToken }),
+            });
+            const auth = new AuthManager({ type: 'apiKey', apiKey: 'test-key' }, 'https://gw.test', mockLogger);
+            const result = await auth.getToken();
+            expect(result).toBe(responseToken);
+            expect(globalThis.fetch).toHaveBeenCalledWith('https://gw.test/api/v1/auth/token', expect.objectContaining({
+                method: 'POST',
+                headers: expect.objectContaining({
+                    'X-API-Key': 'test-key',
+                }),
+            }));
+        });
+        it('should throw on auth failure', async () => {
+            globalThis.fetch.mockResolvedValueOnce({
+                ok: false,
+                status: 401,
+                text: async () => 'Unauthorized',
+            });
+            const auth = new AuthManager({ type: 'apiKey', apiKey: 'bad-key' }, 'https://gw.test', mockLogger);
+            await expect(auth.getToken()).rejects.toThrow('auth failed (HTTP 401)');
+        });
+        it('should cache token and reuse on subsequent calls', async () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const responseToken = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'api' });
+            globalThis.fetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ token: responseToken }),
+            });
+            const auth = new AuthManager({ type: 'apiKey', apiKey: 'test-key' }, 'https://gw.test', mockLogger);
+            const r1 = await auth.getToken();
+            const r2 = await auth.getToken();
+            expect(r1).toBe(r2);
+            expect(globalThis.fetch).toHaveBeenCalledTimes(1); // Only one HTTP call
+        });
+        it('should coalesce concurrent refresh requests', async () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const responseToken = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'api' });
+            globalThis.fetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ token: responseToken }),
+            });
+            const auth = new AuthManager({ type: 'apiKey', apiKey: 'test-key' }, 'https://gw.test', mockLogger);
+            // Fire multiple concurrent calls
+            const [r1, r2, r3] = await Promise.all([
+                auth.getToken(),
+                auth.getToken(),
+                auth.getToken(),
+            ]);
+            expect(r1).toBe(responseToken);
+            expect(r2).toBe(responseToken);
+            expect(r3).toBe(responseToken);
+            expect(globalThis.fetch).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('getBearerHeader', () => {
+        it('should return Bearer prefix', async () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const token = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'u1' });
+            const auth = new AuthManager({ type: 'jwt', token }, 'https://gw.test', mockLogger);
+            const header = await auth.getBearerHeader();
+            expect(header).toBe(`Bearer ${token}`);
+        });
+    });
+    describe('buildWsUrl', () => {
+        it('should build wss:// URL with token and params', async () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const token = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'u1' });
+            const auth = new AuthManager({ type: 'jwt', token }, 'https://gw.test', mockLogger);
+            const url = await auth.buildWsUrl('/api/v1/ws/stream', { linkedid: 'abc123' });
+            expect(url).toContain('wss://gw.test/api/v1/ws/stream');
+            expect(url).toContain('linkedid=abc123');
+            expect(url).toContain(`token=`);
+        });
+        it('should convert http:// to ws://', async () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const token = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'u1' });
+            const auth = new AuthManager({ type: 'jwt', token }, 'http://gw.test', mockLogger);
+            const url = await auth.buildWsUrl('/test', {});
+            expect(url).toContain('ws://gw.test/test');
+        });
+    });
+    describe('buildHttpUrl', () => {
+        it('should build full URL with path', () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const token = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'u1' });
+            const auth = new AuthManager({ type: 'jwt', token }, 'https://gw.test/', mockLogger);
+            const url = auth.buildHttpUrl('/api/v1/sessions');
+            expect(url).toBe('https://gw.test/api/v1/sessions');
+        });
+        it('should append query params', () => {
+            const futureExp = Math.floor(Date.now() / 1000) + 3600;
+            const token = createJwt({ exp: futureExp, iat: Date.now() / 1000, sub: 'u1' });
+            const auth = new AuthManager({ type: 'jwt', token }, 'https://gw.test', mockLogger);
+            const url = auth.buildHttpUrl('/api', { foo: 'bar' });
+            expect(url).toBe('https://gw.test/api?foo=bar');
+        });
+    });
+});
+//# sourceMappingURL=manager.test.js.map