@hazeljs/realtime 0.2.0-rc.3

package/dist/realtime.module.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * RealtimeModule - Real-time voice AI for HazelJS
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var RealtimeModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeModule = void 0;
+const core_1 = require("@hazeljs/core");
+const realtime_service_1 = require("./realtime.service");
+const realtime_gateway_1 = require("./realtime.gateway");
+const realtime_bootstrap_service_1 = require("./realtime-bootstrap.service");
+let RealtimeModule = RealtimeModule_1 = class RealtimeModule {
+    /**
+     * Configure Realtime module with OpenAI Realtime API
+     */
+    static forRoot(options = {}) {
+        const realtimeService = new realtime_service_1.RealtimeService({
+            defaultProvider: options.defaultProvider ?? 'openai',
+            openaiApiKey: options.openaiApiKey ?? process.env.OPENAI_API_KEY,
+            defaultSessionConfig: options.defaultSessionConfig,
+        });
+        const realtimeGateway = new realtime_gateway_1.RealtimeGateway(realtimeService, {
+            path: options.path ?? '/realtime',
+        });
+        return {
+            module: RealtimeModule_1,
+            providers: [
+                { provide: realtime_service_1.RealtimeService, useValue: realtimeService },
+                { provide: realtime_gateway_1.RealtimeGateway, useValue: realtimeGateway },
+                {
+                    provide: realtime_bootstrap_service_1.RealtimeBootstrapService,
+                    useClass: realtime_bootstrap_service_1.RealtimeBootstrapService,
+                },
+            ],
+            exports: [realtime_service_1.RealtimeService, realtime_gateway_1.RealtimeGateway],
+            global: true,
+        };
+    }
+    /**
+     * Configure Realtime module asynchronously (e.g. from config service)
+     */
+    static forRootAsync(options) {
+        return {
+            module: RealtimeModule_1,
+            providers: [
+                {
+                    provide: 'REALTIME_OPTIONS',
+                    useFactory: options.useFactory,
+                    inject: options.inject ?? [],
+                },
+                {
+                    provide: realtime_service_1.RealtimeService,
+                    useFactory: (opts) => new realtime_service_1.RealtimeService({
+                        defaultProvider: opts.defaultProvider ?? 'openai',
+                        openaiApiKey: opts.openaiApiKey ?? process.env.OPENAI_API_KEY,
+                        defaultSessionConfig: opts.defaultSessionConfig,
+                    }),
+                    inject: ['REALTIME_OPTIONS'],
+                },
+                {
+                    provide: realtime_gateway_1.RealtimeGateway,
+                    useFactory: (service, opts) => new realtime_gateway_1.RealtimeGateway(service, { path: opts.path ?? '/realtime' }),
+                    inject: [realtime_service_1.RealtimeService, 'REALTIME_OPTIONS'],
+                },
+                {
+                    provide: realtime_bootstrap_service_1.RealtimeBootstrapService,
+                    useClass: realtime_bootstrap_service_1.RealtimeBootstrapService,
+                },
+            ],
+            exports: [realtime_service_1.RealtimeService, realtime_gateway_1.RealtimeGateway],
+            global: true,
+        };
+    }
+};
+exports.RealtimeModule = RealtimeModule;
+exports.RealtimeModule = RealtimeModule = RealtimeModule_1 = __decorate([
+    (0, core_1.HazelModule)({
+        providers: [],
+        exports: [],
+    })
+], RealtimeModule);

package/dist/realtime.service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * RealtimeService - manages realtime voice sessions and provider config
+ */
+import { OpenAIRealtimeSession, type RealtimeClientAdapter } from './providers/openai';
+import type { RealtimeProvider, RealtimeSessionConfig } from './realtime.types';
+export interface RealtimeServiceOptions {
+    defaultProvider?: RealtimeProvider;
+    openaiApiKey?: string;
+    defaultSessionConfig?: RealtimeSessionConfig;
+}
+export declare class RealtimeService {
+    private readonly options;
+    private sessions;
+    constructor(options?: RealtimeServiceOptions);
+    /**
+     * Create and connect an OpenAI Realtime session for a client
+     */
+    createOpenAISession(client: RealtimeClientAdapter, overrides?: {
+        model?: string;
+        sessionConfig?: RealtimeSessionConfig;
+    }): Promise<OpenAIRealtimeSession>;
+    /**
+     * Get session by client ID
+     */
+    getSession(clientId: string): OpenAIRealtimeSession | undefined;
+    /**
+     * Remove and disconnect session
+     */
+    removeSession(clientId: string): void;
+    /**
+     * Get all active session stats
+     */
+    getStats(): Array<{
+        clientId: string;
+    } & ReturnType<OpenAIRealtimeSession['getStats']>>;
+    /**
+     * Get session count
+     */
+    getSessionCount(): number;
+}
+//# sourceMappingURL=realtime.service.d.ts.map

package/dist/realtime.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.service.d.ts","sourceRoot":"","sources":["../src/realtime.service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,qBAAqB,CAAC;CAC9C;AAED,qBACa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAA4C;gBAEhD,OAAO,GAAE,sBAA2B;IAShD;;OAEG;IACG,mBAAmB,CACvB,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,qBAAqB,CAAA;KAAE,GACpE,OAAO,CAAC,qBAAqB,CAAC;IAmBjC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI/D;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQrC;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;IAOvF;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B"}

package/dist/realtime.service.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * RealtimeService - manages realtime voice sessions and provider config
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeService = void 0;
+const core_1 = require("@hazeljs/core");
+const openai_1 = require("./providers/openai");
+let RealtimeService = class RealtimeService {
+    constructor(options = {}) {
+        this.sessions = new Map();
+        this.options = {
+            defaultProvider: options.defaultProvider ?? 'openai',
+            openaiApiKey: options.openaiApiKey ?? process.env.OPENAI_API_KEY,
+            defaultSessionConfig: options.defaultSessionConfig,
+            ...options,
+        };
+    }
+    /**
+     * Create and connect an OpenAI Realtime session for a client
+     */
+    async createOpenAISession(client, overrides) {
+        const apiKey = this.options.openaiApiKey;
+        if (!apiKey) {
+            throw new Error('OPENAI_API_KEY is required for OpenAI Realtime. Set env or openaiApiKey in RealtimeModule.');
+        }
+        const session = new openai_1.OpenAIRealtimeSession(client, {
+            apiKey,
+            model: overrides?.model,
+            sessionConfig: overrides?.sessionConfig ?? this.options.defaultSessionConfig,
+        });
+        await session.connect();
+        this.sessions.set(client.id, session);
+        return session;
+    }
+    /**
+     * Get session by client ID
+     */
+    getSession(clientId) {
+        return this.sessions.get(clientId);
+    }
+    /**
+     * Remove and disconnect session
+     */
+    removeSession(clientId) {
+        const session = this.sessions.get(clientId);
+        if (session) {
+            session.disconnect();
+            this.sessions.delete(clientId);
+        }
+    }
+    /**
+     * Get all active session stats
+     */
+    getStats() {
+        return Array.from(this.sessions.entries()).map(([clientId, session]) => ({
+            clientId,
+            ...session.getStats(),
+        }));
+    }
+    /**
+     * Get session count
+     */
+    getSessionCount() {
+        return this.sessions.size;
+    }
+};
+exports.RealtimeService = RealtimeService;
+exports.RealtimeService = RealtimeService = __decorate([
+    (0, core_1.Service)(),
+    __metadata("design:paramtypes", [Object])
+], RealtimeService);

package/dist/realtime.service.test.d.ts

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

package/dist/realtime.service.test.d.ts.map

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

package/dist/realtime.service.test.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const realtime_service_1 = require("./realtime.service");
+const openai_1 = require("./providers/openai");
+jest.mock('./providers/openai', () => ({
+    OpenAIRealtimeSession: jest.fn().mockImplementation((client, _options) => ({
+        connect: jest.fn().mockResolvedValue(undefined),
+        disconnect: jest.fn(),
+        handleClientMessage: jest.fn(),
+        getStats: jest.fn().mockReturnValue({
+            sessionId: client.id,
+            provider: 'openai',
+            connectedAt: Date.now(),
+            audioChunksReceived: 0,
+            audioChunksSent: 0,
+            eventsReceived: 0,
+            eventsSent: 0,
+        }),
+        isConnected: true,
+    })),
+}));
+describe('RealtimeService', () => {
+    const mockClient = {
+        id: 'client-1',
+        send: jest.fn(),
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        process.env.OPENAI_API_KEY = 'test-key';
+    });
+    afterEach(() => {
+        delete process.env.OPENAI_API_KEY;
+    });
+    describe('constructor', () => {
+        it('should use default provider openai', () => {
+            const service = new realtime_service_1.RealtimeService({});
+            expect(service.getSessionCount()).toBe(0);
+        });
+        it('should use provided options', () => {
+            const service = new realtime_service_1.RealtimeService({
+                defaultProvider: 'openai',
+                openaiApiKey: 'custom-key',
+            });
+            expect(service.getSessionCount()).toBe(0);
+        });
+    });
+    describe('createOpenAISession', () => {
+        it('should create and return a session', async () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            const session = await service.createOpenAISession(mockClient);
+            expect(session).toBeDefined();
+            expect(service.getSession('client-1')).toBe(session);
+            expect(service.getSessionCount()).toBe(1);
+        });
+        it('should throw when OPENAI_API_KEY is missing', async () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: undefined });
+            delete process.env.OPENAI_API_KEY;
+            await expect(service.createOpenAISession(mockClient)).rejects.toThrow('OPENAI_API_KEY is required for OpenAI Realtime');
+        });
+        it('should pass overrides to session', async () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            await service.createOpenAISession(mockClient, {
+                model: 'gpt-4o',
+                sessionConfig: { instructions: 'Custom instructions' },
+            });
+            expect(openai_1.OpenAIRealtimeSession).toHaveBeenCalledWith(mockClient, expect.objectContaining({
+                apiKey: 'test-key',
+                model: 'gpt-4o',
+                sessionConfig: { instructions: 'Custom instructions' },
+            }));
+        });
+    });
+    describe('getSession', () => {
+        it('should return session when exists', async () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            const session = await service.createOpenAISession(mockClient);
+            expect(service.getSession('client-1')).toBe(session);
+        });
+        it('should return undefined when session does not exist', () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            expect(service.getSession('non-existent')).toBeUndefined();
+        });
+    });
+    describe('removeSession', () => {
+        it('should remove and disconnect session', async () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            const session = await service.createOpenAISession(mockClient);
+            const disconnectSpy = jest.spyOn(session, 'disconnect');
+            service.removeSession('client-1');
+            expect(disconnectSpy).toHaveBeenCalled();
+            expect(service.getSession('client-1')).toBeUndefined();
+            expect(service.getSessionCount()).toBe(0);
+        });
+        it('should do nothing when session does not exist', () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            expect(() => service.removeSession('non-existent')).not.toThrow();
+        });
+    });
+    describe('getStats', () => {
+        it('should return stats for all sessions', async () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            await service.createOpenAISession(mockClient);
+            const stats = service.getStats();
+            expect(stats).toHaveLength(1);
+            expect(stats[0]).toMatchObject({
+                clientId: 'client-1',
+                sessionId: 'client-1',
+                provider: 'openai',
+            });
+        });
+        it('should return empty array when no sessions', () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            expect(service.getStats()).toEqual([]);
+        });
+    });
+    describe('getSessionCount', () => {
+        it('should return correct count', async () => {
+            const service = new realtime_service_1.RealtimeService({ openaiApiKey: 'test-key' });
+            expect(service.getSessionCount()).toBe(0);
+            await service.createOpenAISession(mockClient);
+            expect(service.getSessionCount()).toBe(1);
+            const mockClient2 = { id: 'client-2', send: jest.fn() };
+            await service.createOpenAISession(mockClient2);
+            expect(service.getSessionCount()).toBe(2);
+            service.removeSession('client-1');
+            expect(service.getSessionCount()).toBe(1);
+        });
+    });
+});

package/dist/realtime.types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @hazeljs/realtime - Shared types for real-time voice AI
+ */
+/**
+ * Supported real-time voice providers
+ */
+export type RealtimeProvider = 'openai' | 'gemini';
+/**
+ * OpenAI Realtime voice options
+ */
+export type OpenAIVoice = 'alloy' | 'ash' | 'ballad' | 'coral' | 'echo' | 'sage' | 'shimmer' | 'verse' | 'marin' | 'cedar';
+/**
+ * Audio format for real-time sessions
+ */
+export interface RealtimeAudioFormat {
+    type: 'audio/pcm' | 'audio/pcmu' | 'audio/pcma';
+    rate?: 8000 | 16000 | 24000;
+}
+/**
+ * Session configuration for real-time voice
+ */
+export interface RealtimeSessionConfig {
+    /** System instructions for the model */
+    instructions?: string;
+    /** Voice for audio output (OpenAI) */
+    voice?: OpenAIVoice;
+    /** Output modalities: audio, text, or both */
+    outputModalities?: ('audio' | 'text')[];
+    /** Audio input format */
+    inputFormat?: RealtimeAudioFormat;
+    /** Audio output format */
+    outputFormat?: RealtimeAudioFormat;
+    /** Enable turn detection (VAD) - when disabled, use manual commit */
+    turnDetection?: boolean;
+    /** Model to use (OpenAI: gpt-realtime) */
+    model?: string;
+}
+/**
+ * OpenAI Realtime API client event (client → server)
+ */
+export interface RealtimeClientEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * OpenAI Realtime API server event (server → client)
+ */
+export interface RealtimeServerEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Realtime session lifecycle events
+ */
+export type RealtimeSessionEvent = 'session.created' | 'session.updated' | 'session.ended' | 'error' | 'response.output_audio.delta' | 'response.output_audio.done' | 'response.output_text.delta' | 'response.output_text.done' | 'response.done' | 'input_audio_buffer.speech_started' | 'input_audio_buffer.speech_stopped';
+/**
+ * Realtime module options
+ */
+export interface RealtimeModuleOptions {
+    /** Default provider */
+    defaultProvider?: RealtimeProvider;
+    /** OpenAI API key (or use OPENAI_API_KEY env) */
+    openaiApiKey?: string;
+    /** WebSocket path for realtime endpoint */
+    path?: string;
+    /** Default session config */
+    defaultSessionConfig?: RealtimeSessionConfig;
+}
+/**
+ * Realtime session stats
+ */
+export interface RealtimeSessionStats {
+    sessionId: string;
+    provider: RealtimeProvider;
+    connectedAt: number;
+    audioChunksReceived: number;
+    audioChunksSent: number;
+    eventsReceived: number;
+    eventsSent: number;
+}
+//# sourceMappingURL=realtime.types.d.ts.map

package/dist/realtime.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.types.d.ts","sourceRoot":"","sources":["../src/realtime.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,KAAK,GACL,QAAQ,GACR,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;IAChD,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IACxC,yBAAyB;IACzB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,0BAA0B;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,OAAO,GACP,6BAA6B,GAC7B,4BAA4B,GAC5B,4BAA4B,GAC5B,2BAA2B,GAC3B,eAAe,GACf,mCAAmC,GACnC,mCAAmC,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,oBAAoB,CAAC,EAAE,qBAAqB,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/realtime.types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * @hazeljs/realtime - Shared types for real-time voice AI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/realtime.types.test.d.ts

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

package/dist/realtime.types.test.d.ts.map

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

package/dist/realtime.types.test.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+describe('realtime.types', () => {
+    describe('RealtimeProvider', () => {
+        it('should allow openai and gemini', () => {
+            const providers = ['openai', 'gemini'];
+            expect(providers).toContain('openai');
+            expect(providers).toContain('gemini');
+        });
+    });
+    describe('RealtimeSessionConfig', () => {
+        it('should accept valid config', () => {
+            const config = {
+                instructions: 'Be helpful',
+                voice: 'marin',
+                outputModalities: ['audio', 'text'],
+                turnDetection: true,
+            };
+            expect(config.instructions).toBe('Be helpful');
+            expect(config.voice).toBe('marin');
+        });
+    });
+    describe('RealtimeModuleOptions', () => {
+        it('should accept valid options', () => {
+            const options = {
+                defaultProvider: 'openai',
+                openaiApiKey: 'sk-test',
+                path: '/realtime',
+                defaultSessionConfig: { instructions: 'Test' },
+            };
+            expect(options.path).toBe('/realtime');
+        });
+    });
+    describe('OpenAIVoice', () => {
+        it('should include standard voices', () => {
+            const voices = [
+                'alloy',
+                'ash',
+                'ballad',
+                'coral',
+                'echo',
+                'sage',
+                'shimmer',
+                'verse',
+                'marin',
+                'cedar',
+            ];
+            expect(voices).toHaveLength(10);
+        });
+    });
+    describe('RealtimeAudioFormat', () => {
+        it('should accept PCM formats', () => {
+            const format = {
+                type: 'audio/pcm',
+                rate: 24000,
+            };
+            expect(format.type).toBe('audio/pcm');
+            expect(format.rate).toBe(24000);
+        });
+    });
+});

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@hazeljs/realtime",
+  "version": "0.2.0-rc.3",
+  "description": "Real-time voice AI for HazelJS - OpenAI Realtime API & Gemini Live integration for low-latency speech-to-speech",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --coverage --passWithNoTests",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@hazeljs/websocket": "^0.2.0-rc.3"
+  },
+  "peerDependencies": {
+    "@hazeljs/core": ">=0.2.0-beta.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.50",
+    "@types/ws": "^8.5.13",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hazel-js/hazeljs.git",
+    "directory": "packages/realtime"
+  },
+  "keywords": [
+    "hazeljs",
+    "realtime",
+    "voice",
+    "speech-to-speech",
+    "openai",
+    "realtime-api",
+    "ai",
+    "websocket"
+  ],
+  "author": "Muhammad Arslan <muhammad.arslan@hazeljs.ai>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/hazeljs/hazel-js/issues"
+  },
+  "homepage": "https://hazeljs.com",
+  "gitHead": "2e173141ee8e35a9db7f3975bbbc78216ac850f7"
+}