@hubui/client 0.1.0

package/dist/internal/realtime.d.ts

@@ -0,0 +1,9 @@
+/**
+ * HubUI Client SDK - Internal Realtime Adapter
+ * @hubui/client
+ *
+ * This file isolates transport imports to keep them internal.
+ * The bundler inlines runtime internals from end users.
+ */
+export { Room, RoomEvent, ConnectionState, Track, TrackPublication, Participant, RemoteParticipant, LocalParticipant, DataPacket_Kind, ParticipantKind, LogLevel, setLogLevel, } from 'livekit-client';
+export type { RoomOptions, RoomConnectOptions, TranscriptionSegment, } from 'livekit-client';

package/dist/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * HubUI Client SDK - Type Definitions
+ * @hubui/client
+ */
+/**
+ * Configuration for connecting to a HubUI agent
+ */
+export interface HubUIConfig {
+    /** The agent ID from your HubUI dashboard */
+    agentId: string;
+    /** Your API key (pk_live_xxx) from the HubUI dashboard. Required unless `token` is provided. */
+    apiKey?: string;
+    /** Pre-fetched connection token. When provided, the SDK skips API key validation and token fetch. Requires `serverUrl`. */
+    token?: string;
+    /** WebSocket server URL. Required when using `token` directly. */
+    serverUrl?: string;
+    /** Connection mode: 'voice' for audio calls, 'text' for chat */
+    mode: 'voice' | 'text';
+    /** Optional: Display name for the end user */
+    userName?: string;
+    /** Optional: Email for the end user (for analytics) */
+    userEmail?: string;
+    /** Optional: Specific audio input device ID */
+    audioInput?: string;
+    /** Optional: Specific audio output device ID */
+    audioOutput?: string;
+    /** Optional: Custom API base URL (for enterprise) */
+    apiBaseUrl?: string;
+    /** Optional: Enable debug logging to the browser console (default: false) */
+    debug?: boolean;
+}
+/**
+ * Connection states for a HubUI session
+ */
+export type HubUIConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/**
+ * A single transcript entry
+ */
+export interface HubUITranscriptEntry {
+    /** Unique ID for this entry */
+    id: string;
+    /** Who spoke: 'user' or 'agent' */
+    speaker: 'user' | 'agent';
+    /** The transcribed or sent text */
+    text: string;
+    /** When this entry was created */
+    timestamp: Date;
+    /** Whether this is a final transcript (vs interim) */
+    isFinal: boolean;
+}
+/**
+ * Audio device information
+ */
+export interface AudioDevice {
+    /** Device ID to use when setting input/output */
+    deviceId: string;
+    /** Human-readable device name */
+    label: string;
+    /** Device type */
+    kind: 'audioinput' | 'audiooutput';
+}
+/**
+ * Event handler types
+ */
+export interface HubUIEvents {
+    /** Fired when successfully connected to the agent */
+    'connected': () => void;
+    /** Fired when disconnected from the agent */
+    'disconnected': () => void;
+    /** Fired when an error occurs */
+    'error': (error: HubUIError) => void;
+    /** Fired when transcript is received (voice mode) */
+    'transcript': (text: string, speaker: 'user' | 'agent', isFinal: boolean) => void;
+    /** Fired when a text message is received */
+    'message': (text: string) => void;
+    /** Fired when connection state changes */
+    'connectionStateChanged': (state: HubUIConnectionState) => void;
+    /** Fired when audio playback is blocked (mobile browsers) */
+    'audioPlaybackBlocked': () => void;
+}
+/**
+ * Error class for HubUI-specific errors
+ */
+export declare class HubUIError extends Error {
+    code: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Response from the token endpoint
+ */
+export interface TokenResponse {
+    token: string;
+    hubui_url: string;
+    room_name: string;
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@hubui/client",
+  "version": "0.1.0",
+  "description": "HubUI Client SDK - Connect to AI voice and text agents",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist/**/*.cjs",
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "hubui",
+    "ai",
+    "voice",
+    "chat",
+    "sdk",
+    "realtime",
+    "agents"
+  ],
+  "author": "HubUI",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HubUI-AI/hubui-client.git"
+  },
+  "homepage": "https://hubui.ai",
+  "bugs": {
+    "url": "https://github.com/HubUI-AI/hubui-client/issues"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "rollup": "^4.9.6",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "livekit-client": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}