aillom-vox-client 2.1.0 → 2.1.2

package/README.md

@@ -28,6 +28,7 @@ npm install aillom-vox-client
 
 | Doc | Purpose |
 | :--- | :--- |
+| [docs/NPM_QUICKSTART.md](docs/NPM_QUICKSTART.md) | Copy/paste npm tests for browser and terminal |
 | [docs/PROTOCOL.md](docs/PROTOCOL.md) | WebSocket lifecycle, handshake JSON, PCM rules |
 | [docs/PROVIDERS.md](docs/PROVIDERS.md) | Provider matrix, **public USD/min rate card**, `tts_engine` for `aillomvox` |
 | [docs/VOICES.md](docs/VOICES.md) | Voice catalog notes |
@@ -51,6 +52,36 @@ Hosted docs: `https://vox.aillom.com/docs`
 
 ## Quick start
 
+### Test the published npm package
+
+Full browser test with UI:
+
+```bash
+git clone https://github.com/aillom/aillom-vox-client.git
+cd aillom-vox-client/examples/npm-quickstart
+npm install
+npm run dev
+```
+
+Open the Vite URL, paste your `av_...` key, click **Carregar vozes**, then **Iniciar chamada**.
+
+Terminal smoke test:
+
+```bash
+mkdir vox-smoke && cd vox-smoke
+npm init -y
+npm install aillom-vox-client
+node -e "const { AillomVox } = require('aillom-vox-client'); Promise.all([AillomVox.fetchProviders({ includeVoices: false }), AillomVox.fetchPricing()]).then(([providers, pricing]) => console.log({ providers: providers.count, pricing: pricing.count }))"
+```
+
+Expected output:
+
+```text
+{ providers: 7, pricing: 7 }
+```
+
+### Use the SDK
+
 ```typescript
 import { AillomVox } from 'aillom-vox-client';
 
@@ -154,6 +185,7 @@ See **[examples/README.md](examples/README.md)** for how to run the browser demo
 
 | Path | Description |
 | :--- | :--- |
+| [examples/npm-quickstart/](examples/npm-quickstart/) | Published npm package test app with voice catalog, mic, playback, transcripts and text input |
 | [examples/sdk-usage.ts](examples/sdk-usage.ts) | TypeScript sample with catalog fetch + handlers |
 | [examples/01-basic/](examples/01-basic/) | Minimal browser demo |
 | [examples/02-advanced-dashboard/](examples/02-advanced-dashboard/) | Larger UI example |
@@ -168,12 +200,6 @@ See **[examples/README.md](examples/README.md)** for how to run the browser demo
 
 ---
 
-## n8n
-
-Community node under [integrations/n8n-nodes-aillomvox/](integrations/n8n-nodes-aillomvox/) (REST operations).
-
----
-
 ## License
 
 ISC © Aillom Technologies

package/dist/AillomVox.d.ts

@@ -2,7 +2,7 @@ import { AillomVoxConfig, CloneVoiceOptions, CloneVoiceResult, DeleteVoiceOption
 import WebSocket from 'isomorphic-ws';
 export type ClientEvent = 'audio' | 'transcript' | 'tool_call' | 'error' | 'connected' | 'disconnected' | 'interruption' | 'playback_clear_buffer' | 'state' | 'control' | 'raw';
 export interface VoxClientEventMap {
-    audio: ArrayBuffer | Buffer;
+    audio: ArrayBuffer | ArrayBufferView;
     transcript: TranscriptEvent;
     tool_call: ToolCallEvent;
     error: ErrorEvent | WebSocket.ErrorEvent | unknown;
@@ -44,7 +44,7 @@ export declare class AillomVox {
     /**
      * Send microphone capture to the model. PCM16 LE mono at the configured `sampleRate`.
      */
-    sendAudio(chunk: ArrayBuffer | Int16Array | Buffer): void;
+    sendAudio(chunk: ArrayBuffer | ArrayBufferView): void;
     /**
      * Reply to a `tool_call` event within 15 seconds or the model may stall.
      */

package/dist/AillomVox.js

@@ -112,7 +112,7 @@ class AillomVox {
     sendAudio(chunk) {
         if (!this.ws || this.ws.readyState !== isomorphic_ws_1.default.OPEN)
             return;
-        if (chunk instanceof Int16Array) {
+        if (ArrayBuffer.isView(chunk)) {
             this.ws.send(chunk.buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength));
             return;
         }

package/dist/types.d.ts

@@ -9,7 +9,7 @@ export interface ClientTool {
     description: string;
     /** JSON Schema parameters for the function (OpenAI-style). */
     parameters?: Record<string, unknown>;
-    /** Backward-compatible location used by some dashboard / n8n tool presets. */
+    /** Backward-compatible location used by some dashboard tool presets. */
     config?: Record<string, unknown>;
     /** Optional server-side endpoint metadata, including `aillom-connect://...` tools. */
     url?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aillom-vox-client",
-    "version": "2.1.0",
+    "version": "2.1.2",
     "description": "Enterprise-Grade Voice AI SDK for Speech-to-Speech, Audio-to-Audio, and Realtime Multimodal applications.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",