@absolutejs/voice 0.0.22-beta.566 → 0.0.22-beta.568

package/LICENSE

@@ -0,0 +1,88 @@
+# Business Source License 1.1
+
+**Licensor:** Alex Kahn
+
+**Licensed Work:** @absolutejs/voice (https://github.com/absolutejs/voice)
+
+**Change Date:** May 29, 2030
+
+**Change License:** Apache License, Version 2.0
+
+---
+
+## Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, permitting limited production use.
+
+### Additional Use Grant
+
+You may use the Licensed Work in production, provided your use does not include
+any of the following:
+
+1. **Offering a Competing Service.** You may not offer the Licensed Work, or
+   any derivative or substantial portion of it, to third parties as a hosted or
+   managed service that competes with a hosted voice AI, voice agent, conversational voice, or voice-as-a-service platform (including, but not limited to, services like Vapi, Retell, Bland, Phonely, Air, or LiveKit Agents). This includes any
+   product whose primary value to its users is the functionality the Licensed
+   Work provides.
+
+2. **Resale or Redistribution as a Standalone Product.** You may not sell,
+   license, or distribute the Licensed Work, or any derivative or fork of it,
+   as a standalone commercial product.
+
+3. **Removal of Attribution.** Any derivative work, fork, or redistribution of
+   the Licensed Work must prominently credit AbsoluteJS and include a link to
+   the original project repository (https://github.com/absolutejs/voice).
+
+For clarity, the following uses are expressly permitted:
+
+- Using the Licensed Work to build and operate your own applications, websites,
+  internal tools, or SaaS products (whether commercial or non-commercial), so
+  long as the Licensed Work itself is not the primary product you are selling.
+- Using the Licensed Work as a dependency in commercial software you build and
+  sell, as long as the software is not itself a competing managed service of
+  the kind described in clause 1.
+- Providing consulting, development, or professional services to clients using
+  the Licensed Work.
+- Forking and modifying the Licensed Work for your own internal use, provided
+  attribution is maintained.
+
+### Change Date and Change License
+
+On the Change Date specified above, or on such other date as the Licensor may
+specify by written notice, the Licensed Work will be made available under the
+Change License (Apache License, Version 2.0). Until the Change Date, the terms
+of this Business Source License 1.1 apply.
+
+### Trademark
+
+This license does not grant you any rights to use the "AbsoluteJS" or
+"@absolutejs" name, logo, or any related trademarks. Forks and derivative works
+must not be named or branded in a manner that suggests endorsement by or
+affiliation with AbsoluteJS or the Licensor.
+
+### Notices
+
+You must not remove or obscure any licensing, copyright, or other notices
+included in the Licensed Work.
+
+### No Warranty
+
+THE LICENSED WORK IS PROVIDED "AS IS". THE LICENSOR HEREBY DISCLAIMS ALL
+WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE LICENSOR 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 LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE
+LICENSED WORK.
+
+---
+
+## Contact
+
+For commercial licensing inquiries or additional permissions, contact:
+
+- **Alex Kahn**
+- alexkahndev@gmail.com
+- alexkahndev.github.io

package/dist/client/htmxBootstrap.js

@@ -1529,6 +1529,7 @@ var createVoiceController = (path, options = {}) => {
 
 // src/client/audioPlayer.ts
 var DEFAULT_LOOKAHEAD_MS = 15;
+var DEFAULT_VOLUME = 1;
 var createInitialState3 = () => ({
   activeSourceCount: 0,
   error: null,
@@ -1545,6 +1546,12 @@ var getAudioContextCtor = () => {
   }
   return window.AudioContext ?? window.webkitAudioContext;
 };
+var clampVolume = (volume) => {
+  if (typeof volume !== "number" || !Number.isFinite(volume)) {
+    return DEFAULT_VOLUME;
+  }
+  return Math.min(1, Math.max(0, volume));
+};
 var decodePCM16LEChunk = (audioContext, chunk) => {
   const { format } = chunk;
   if (format.container !== "raw" || format.encoding !== "pcm_s16le") {
@@ -1577,6 +1584,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
   let state = createInitialState3();
   let audioContext = null;
   let outputNode = null;
+  let volume = clampVolume(options.volume);
   let queueEndTime = 0;
   let syncPromise = Promise.resolve();
   let interruptStartedAt = null;
@@ -1625,11 +1633,11 @@ var createVoiceAudioPlayer = (source, options = {}) => {
     }
     return Math.max(0, ((context.baseLatency ?? 0) + (context.outputLatency ?? 0)) * 1000);
   };
-  const restoreOutputGain = (context) => {
+  const applyOutputGain = (context) => {
     if (!outputNode) {
       return;
     }
-    const gainValue = 1;
+    const gainValue = volume;
     if (outputNode.gain.setValueAtTime) {
       outputNode.gain.setValueAtTime(gainValue, context?.currentTime ?? 0);
       return;
@@ -1840,11 +1848,15 @@ var createVoiceAudioPlayer = (source, options = {}) => {
     get queuedChunkCount() {
       return state.queuedChunkCount;
     },
+    setVolume: (nextVolume) => {
+      volume = clampVolume(nextVolume);
+      applyOutputGain(audioContext);
+    },
     start: async () => {
       try {
         clearError();
         const context = await ensureAudioContext();
-        restoreOutputGain(context);
+        applyOutputGain(context);
         if (context.state === "suspended") {
           await context.resume();
         }
@@ -1868,6 +1880,9 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return () => {
         subscribers.delete(subscriber);
       };
+    },
+    get volume() {
+      return volume;
     }
   };
   return player;

package/dist/client/index.js

@@ -372,6 +372,7 @@ var createVoiceConnection = (path, options = {}) => {
 };
 // src/client/audioPlayer.ts
 var DEFAULT_LOOKAHEAD_MS = 15;
+var DEFAULT_VOLUME = 1;
 var createInitialState = () => ({
   activeSourceCount: 0,
   error: null,
@@ -388,6 +389,12 @@ var getAudioContextCtor = () => {
   }
   return window.AudioContext ?? window.webkitAudioContext;
 };
+var clampVolume = (volume) => {
+  if (typeof volume !== "number" || !Number.isFinite(volume)) {
+    return DEFAULT_VOLUME;
+  }
+  return Math.min(1, Math.max(0, volume));
+};
 var decodePCM16LEChunk = (audioContext, chunk) => {
   const { format } = chunk;
   if (format.container !== "raw" || format.encoding !== "pcm_s16le") {
@@ -420,6 +427,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
   let state = createInitialState();
   let audioContext = null;
   let outputNode = null;
+  let volume = clampVolume(options.volume);
   let queueEndTime = 0;
   let syncPromise = Promise.resolve();
   let interruptStartedAt = null;
@@ -468,11 +476,11 @@ var createVoiceAudioPlayer = (source, options = {}) => {
     }
     return Math.max(0, ((context.baseLatency ?? 0) + (context.outputLatency ?? 0)) * 1000);
   };
-  const restoreOutputGain = (context) => {
+  const applyOutputGain = (context) => {
     if (!outputNode) {
       return;
     }
-    const gainValue = 1;
+    const gainValue = volume;
     if (outputNode.gain.setValueAtTime) {
       outputNode.gain.setValueAtTime(gainValue, context?.currentTime ?? 0);
       return;
@@ -683,11 +691,15 @@ var createVoiceAudioPlayer = (source, options = {}) => {
     get queuedChunkCount() {
       return state.queuedChunkCount;
     },
+    setVolume: (nextVolume) => {
+      volume = clampVolume(nextVolume);
+      applyOutputGain(audioContext);
+    },
     start: async () => {
       try {
         clearError();
         const context = await ensureAudioContext();
-        restoreOutputGain(context);
+        applyOutputGain(context);
         if (context.state === "suspended") {
           await context.resume();
         }
@@ -711,6 +723,9 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return () => {
         subscribers.delete(subscriber);
       };
+    },
+    get volume() {
+      return volume;
     }
   };
   return player;

package/dist/core/types.d.ts

@@ -1183,6 +1183,7 @@ export type VoiceAudioPlayerOptions = {
     autoStart?: boolean;
     createAudioContext?: () => AudioContext;
     lookaheadMs?: number;
+    volume?: number;
 };
 export type VoiceDuplexControllerOptions = VoiceControllerOptions & {
     audioPlayer?: VoiceAudioPlayerOptions;
@@ -1314,8 +1315,10 @@ export type VoiceAudioPlayer = {
     pause: () => Promise<void>;
     processedChunkCount: number;
     queuedChunkCount: number;
+    setVolume: (volume: number) => void;
     start: () => Promise<void>;
     subscribe: (subscriber: () => void) => () => void;
+    volume: number;
 };
 export type VoiceBargeInBinding = {
     close: () => void;

package/dist/testing/index.js

@@ -1579,6 +1579,7 @@ var buildSessionCorrectionAudit = (raw, generic, experimental, benchmarkSeeded,
 };
 // src/client/audioPlayer.ts
 var DEFAULT_LOOKAHEAD_MS = 15;
+var DEFAULT_VOLUME = 1;
 var createInitialState = () => ({
   activeSourceCount: 0,
   error: null,
@@ -1595,6 +1596,12 @@ var getAudioContextCtor = () => {
   }
   return window.AudioContext ?? window.webkitAudioContext;
 };
+var clampVolume = (volume) => {
+  if (typeof volume !== "number" || !Number.isFinite(volume)) {
+    return DEFAULT_VOLUME;
+  }
+  return Math.min(1, Math.max(0, volume));
+};
 var decodePCM16LEChunk = (audioContext, chunk) => {
   const { format } = chunk;
   if (format.container !== "raw" || format.encoding !== "pcm_s16le") {
@@ -1627,6 +1634,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
   let state = createInitialState();
   let audioContext = null;
   let outputNode = null;
+  let volume = clampVolume(options.volume);
   let queueEndTime = 0;
   let syncPromise = Promise.resolve();
   let interruptStartedAt = null;
@@ -1675,11 +1683,11 @@ var createVoiceAudioPlayer = (source, options = {}) => {
     }
     return Math.max(0, ((context.baseLatency ?? 0) + (context.outputLatency ?? 0)) * 1000);
   };
-  const restoreOutputGain = (context) => {
+  const applyOutputGain = (context) => {
     if (!outputNode) {
       return;
     }
-    const gainValue = 1;
+    const gainValue = volume;
     if (outputNode.gain.setValueAtTime) {
       outputNode.gain.setValueAtTime(gainValue, context?.currentTime ?? 0);
       return;
@@ -1890,11 +1898,15 @@ var createVoiceAudioPlayer = (source, options = {}) => {
     get queuedChunkCount() {
       return state.queuedChunkCount;
     },
+    setVolume: (nextVolume) => {
+      volume = clampVolume(nextVolume);
+      applyOutputGain(audioContext);
+    },
     start: async () => {
       try {
         clearError();
         const context = await ensureAudioContext();
-        restoreOutputGain(context);
+        applyOutputGain(context);
         if (context.state === "suspended") {
           await context.resume();
         }
@@ -1918,6 +1930,9 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return () => {
         subscribers.delete(subscriber);
       };
+    },
+    get volume() {
+      return volume;
     }
   };
   return player;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.566",
+  "version": "0.0.22-beta.568",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",
@@ -12,7 +12,7 @@
   ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "license": "CC BY-NC 4.0",
+  "license": "BSL-1.1",
   "author": "Alex Kahn",
   "scripts": {
     "build": "rm -rf dist && bun build ./src/index.ts ./src/client/index.ts ./src/react/index.ts ./src/vue/index.ts ./src/svelte/index.ts ./src/angular/index.ts ./src/testing/index.ts ./src/drizzle/index.ts --outdir dist --target bun --external elysia --external react --external vue --external @angular/core --external @absolutejs/absolute --external @absolutejs/ai --external @absolutejs/media --external drizzle-orm && bun build ./src/client/htmxBootstrap.ts --outdir dist/client --target browser --format esm && bun build ./src/embed/index.ts --outfile dist/embed/voice-widget.js --target browser --format iife --minify && bun build ./src/embed/index.ts --outdir dist/embed --target browser --format esm && tsc --emitDeclarationOnly --project tsconfig.json",