@tensamin/audio 0.1.1 → 0.1.3

package/dist/chunk-XO6B3D4A.mjs

@@ -0,0 +1,67 @@
+// src/noise-suppression/rnnoise-node.ts
+var RNNoisePlugin = class {
+  name = "rnnoise-ns";
+  wasmBuffer = null;
+  async createNode(context, config) {
+    const { loadRnnoise, RnnoiseWorkletNode } = await import("@sapphi-red/web-noise-suppressor");
+    if (!config?.enabled) {
+      console.log("Noise suppression disabled, using passthrough node");
+      const pass = context.createGain();
+      return pass;
+    }
+    if (!config?.wasmUrl || !config?.simdUrl || !config?.workletUrl) {
+      const error = new Error(
+        `RNNoisePlugin requires 'wasmUrl', 'simdUrl', and 'workletUrl' to be configured. Please download the assets from @sapphi-red/web-noise-suppressor and provide the URLs in the config. Current config: wasmUrl=${config?.wasmUrl}, simdUrl=${config?.simdUrl}, workletUrl=${config?.workletUrl}
+To disable noise suppression, set noiseSuppression.enabled to false.`
+      );
+      console.error(error.message);
+      throw error;
+    }
+    try {
+      if (!this.wasmBuffer) {
+        console.log("Loading RNNoise WASM binary...");
+        this.wasmBuffer = await loadRnnoise({
+          url: config.wasmUrl,
+          simdUrl: config.simdUrl
+        });
+        console.log("RNNoise WASM loaded successfully");
+      }
+    } catch (error) {
+      const err = new Error(
+        `Failed to load RNNoise WASM binary: ${error instanceof Error ? error.message : String(error)}`
+      );
+      console.error(err);
+      throw err;
+    }
+    const workletUrl = config.workletUrl;
+    try {
+      await context.audioWorklet.addModule(workletUrl);
+      console.log("RNNoise worklet loaded successfully");
+    } catch (e) {
+      const error = new Error(
+        `Failed to load RNNoise worklet from ${workletUrl}: ${e instanceof Error ? e.message : String(e)}. Ensure the workletUrl points to a valid RNNoise worklet script.`
+      );
+      console.error(error.message);
+      throw error;
+    }
+    try {
+      const node = new RnnoiseWorkletNode(context, {
+        wasmBinary: this.wasmBuffer,
+        maxChannels: 1
+        // Mono for now
+      });
+      console.log("RNNoise worklet node created successfully");
+      return node;
+    } catch (error) {
+      const err = new Error(
+        `Failed to create RNNoise worklet node: ${error instanceof Error ? error.message : String(error)}`
+      );
+      console.error(err);
+      throw err;
+    }
+  }
+};
+
+export {
+  RNNoisePlugin
+};

package/dist/context/audio-context.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Manages a shared AudioContext for the application.
+ */
+/**
+ * Gets the shared AudioContext, creating it if necessary.
+ * @param options Optional AudioContextOptions
+ */
+declare function getAudioContext(options?: AudioContextOptions): AudioContext;
+/**
+ * Registers a pipeline usage. Keeps track of active users.
+ */
+declare function registerPipeline(): void;
+/**
+ * Unregisters a pipeline usage.
+ * Optionally closes the context if no pipelines are active (not implemented by default to avoid churn).
+ */
+declare function unregisterPipeline(): void;
+/**
+ * Resumes the shared AudioContext.
+ * Should be called in response to a user gesture.
+ */
+declare function resumeAudioContext(): Promise<void>;
+/**
+ * Suspends the shared AudioContext.
+ */
+declare function suspendAudioContext(): Promise<void>;
+/**
+ * Closes the shared AudioContext and releases resources.
+ */
+declare function closeAudioContext(): Promise<void>;
+
+export { closeAudioContext, getAudioContext, registerPipeline, resumeAudioContext, suspendAudioContext, unregisterPipeline };

package/dist/context/audio-context.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Manages a shared AudioContext for the application.
+ */
+/**
+ * Gets the shared AudioContext, creating it if necessary.
+ * @param options Optional AudioContextOptions
+ */
+declare function getAudioContext(options?: AudioContextOptions): AudioContext;
+/**
+ * Registers a pipeline usage. Keeps track of active users.
+ */
+declare function registerPipeline(): void;
+/**
+ * Unregisters a pipeline usage.
+ * Optionally closes the context if no pipelines are active (not implemented by default to avoid churn).
+ */
+declare function unregisterPipeline(): void;
+/**
+ * Resumes the shared AudioContext.
+ * Should be called in response to a user gesture.
+ */
+declare function resumeAudioContext(): Promise<void>;
+/**
+ * Suspends the shared AudioContext.
+ */
+declare function suspendAudioContext(): Promise<void>;
+/**
+ * Closes the shared AudioContext and releases resources.
+ */
+declare function closeAudioContext(): Promise<void>;
+
+export { closeAudioContext, getAudioContext, registerPipeline, resumeAudioContext, suspendAudioContext, unregisterPipeline };

package/dist/context/audio-context.js

@@ -0,0 +1,75 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/context/audio-context.ts
+var audio_context_exports = {};
+__export(audio_context_exports, {
+  closeAudioContext: () => closeAudioContext,
+  getAudioContext: () => getAudioContext,
+  registerPipeline: () => registerPipeline,
+  resumeAudioContext: () => resumeAudioContext,
+  suspendAudioContext: () => suspendAudioContext,
+  unregisterPipeline: () => unregisterPipeline
+});
+module.exports = __toCommonJS(audio_context_exports);
+var sharedContext = null;
+var activePipelines = 0;
+function getAudioContext(options) {
+  if (typeof window === "undefined" || typeof AudioContext === "undefined") {
+    throw new Error(
+      "AudioContext is not supported in this environment (browser only)."
+    );
+  }
+  if (!sharedContext || sharedContext.state === "closed") {
+    sharedContext = new AudioContext(options);
+  }
+  return sharedContext;
+}
+function registerPipeline() {
+  activePipelines++;
+}
+function unregisterPipeline() {
+  activePipelines = Math.max(0, activePipelines - 1);
+}
+async function resumeAudioContext() {
+  if (sharedContext && sharedContext.state === "suspended") {
+    await sharedContext.resume();
+  }
+}
+async function suspendAudioContext() {
+  if (sharedContext && sharedContext.state === "running") {
+    await sharedContext.suspend();
+  }
+}
+async function closeAudioContext() {
+  if (sharedContext && sharedContext.state !== "closed") {
+    await sharedContext.close();
+  }
+  sharedContext = null;
+  activePipelines = 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  closeAudioContext,
+  getAudioContext,
+  registerPipeline,
+  resumeAudioContext,
+  suspendAudioContext,
+  unregisterPipeline
+});

package/dist/context/audio-context.mjs

@@ -0,0 +1,16 @@
+import {
+  closeAudioContext,
+  getAudioContext,
+  registerPipeline,
+  resumeAudioContext,
+  suspendAudioContext,
+  unregisterPipeline
+} from "../chunk-OZ7KMC4S.mjs";
+export {
+  closeAudioContext,
+  getAudioContext,
+  registerPipeline,
+  resumeAudioContext,
+  suspendAudioContext,
+  unregisterPipeline
+};

package/dist/extensibility/plugins.d.mts

@@ -0,0 +1,9 @@
+import { NoiseSuppressionPlugin, VADPlugin } from '../types.mjs';
+import 'mitt';
+
+declare function registerNoiseSuppressionPlugin(plugin: NoiseSuppressionPlugin): void;
+declare function registerVADPlugin(plugin: VADPlugin): void;
+declare function getNoiseSuppressionPlugin(name?: string): NoiseSuppressionPlugin;
+declare function getVADPlugin(name?: string): VADPlugin;
+
+export { getNoiseSuppressionPlugin, getVADPlugin, registerNoiseSuppressionPlugin, registerVADPlugin };

package/dist/extensibility/plugins.d.ts

@@ -0,0 +1,9 @@
+import { NoiseSuppressionPlugin, VADPlugin } from '../types.js';
+import 'mitt';
+
+declare function registerNoiseSuppressionPlugin(plugin: NoiseSuppressionPlugin): void;
+declare function registerVADPlugin(plugin: VADPlugin): void;
+declare function getNoiseSuppressionPlugin(name?: string): NoiseSuppressionPlugin;
+declare function getVADPlugin(name?: string): VADPlugin;
+
+export { getNoiseSuppressionPlugin, getVADPlugin, registerNoiseSuppressionPlugin, registerVADPlugin };

package/dist/extensibility/plugins.js

@@ -0,0 +1,238 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/extensibility/plugins.ts
+var plugins_exports = {};
+__export(plugins_exports, {
+  getNoiseSuppressionPlugin: () => getNoiseSuppressionPlugin,
+  getVADPlugin: () => getVADPlugin,
+  registerNoiseSuppressionPlugin: () => registerNoiseSuppressionPlugin,
+  registerVADPlugin: () => registerVADPlugin
+});
+module.exports = __toCommonJS(plugins_exports);
+
+// src/noise-suppression/rnnoise-node.ts
+var RNNoisePlugin = class {
+  name = "rnnoise-ns";
+  wasmBuffer = null;
+  async createNode(context, config) {
+    const { loadRnnoise, RnnoiseWorkletNode } = await import("@sapphi-red/web-noise-suppressor");
+    if (!config?.enabled) {
+      console.log("Noise suppression disabled, using passthrough node");
+      const pass = context.createGain();
+      return pass;
+    }
+    if (!config?.wasmUrl || !config?.simdUrl || !config?.workletUrl) {
+      const error = new Error(
+        `RNNoisePlugin requires 'wasmUrl', 'simdUrl', and 'workletUrl' to be configured. Please download the assets from @sapphi-red/web-noise-suppressor and provide the URLs in the config. Current config: wasmUrl=${config?.wasmUrl}, simdUrl=${config?.simdUrl}, workletUrl=${config?.workletUrl}
+To disable noise suppression, set noiseSuppression.enabled to false.`
+      );
+      console.error(error.message);
+      throw error;
+    }
+    try {
+      if (!this.wasmBuffer) {
+        console.log("Loading RNNoise WASM binary...");
+        this.wasmBuffer = await loadRnnoise({
+          url: config.wasmUrl,
+          simdUrl: config.simdUrl
+        });
+        console.log("RNNoise WASM loaded successfully");
+      }
+    } catch (error) {
+      const err = new Error(
+        `Failed to load RNNoise WASM binary: ${error instanceof Error ? error.message : String(error)}`
+      );
+      console.error(err);
+      throw err;
+    }
+    const workletUrl = config.workletUrl;
+    try {
+      await context.audioWorklet.addModule(workletUrl);
+      console.log("RNNoise worklet loaded successfully");
+    } catch (e) {
+      const error = new Error(
+        `Failed to load RNNoise worklet from ${workletUrl}: ${e instanceof Error ? e.message : String(e)}. Ensure the workletUrl points to a valid RNNoise worklet script.`
+      );
+      console.error(error.message);
+      throw error;
+    }
+    try {
+      const node = new RnnoiseWorkletNode(context, {
+        wasmBinary: this.wasmBuffer,
+        maxChannels: 1
+        // Mono for now
+      });
+      console.log("RNNoise worklet node created successfully");
+      return node;
+    } catch (error) {
+      const err = new Error(
+        `Failed to create RNNoise worklet node: ${error instanceof Error ? error.message : String(error)}`
+      );
+      console.error(err);
+      throw err;
+    }
+  }
+};
+
+// src/vad/vad-node.ts
+var energyVadWorkletCode = `
+class EnergyVadProcessor extends AudioWorkletProcessor {
+  constructor() {
+    super();
+    this.smoothing = 0.95;
+    this.energy = 0;
+    this.noiseFloor = 0.001;
+  }
+
+  process(inputs, outputs, parameters) {
+    const input = inputs[0];
+    if (!input || !input.length) return true;
+    const channel = input[0];
+    
+    // Calculate RMS
+    let sum = 0;
+    for (let i = 0; i < channel.length; i++) {
+      sum += channel[i] * channel[i];
+    }
+    const rms = Math.sqrt(sum / channel.length);
+
+    // Simple adaptive noise floor (very basic)
+    if (rms < this.noiseFloor) {
+      this.noiseFloor = this.noiseFloor * 0.99 + rms * 0.01;
+    } else {
+      this.noiseFloor = this.noiseFloor * 0.999 + rms * 0.001;
+    }
+
+    // Calculate "probability" based on SNR
+    // This is a heuristic mapping from energy to 0-1
+    const snr = rms / (this.noiseFloor + 1e-6);
+    const probability = Math.min(1, Math.max(0, (snr - 1.5) / 10)); // Arbitrary scaling
+
+    this.port.postMessage({ probability });
+
+    return true;
+  }
+}
+registerProcessor('energy-vad-processor', EnergyVadProcessor);
+`;
+var EnergyVADPlugin = class {
+  name = "energy-vad";
+  async createNode(context, config, onDecision) {
+    if (!config?.enabled) {
+      console.log("VAD disabled, using passthrough node");
+      const pass = context.createGain();
+      return pass;
+    }
+    const blob = new Blob([energyVadWorkletCode], {
+      type: "application/javascript"
+    });
+    const url = URL.createObjectURL(blob);
+    try {
+      await context.audioWorklet.addModule(url);
+      console.log("Energy VAD worklet loaded successfully");
+    } catch (e) {
+      const error = new Error(
+        `Failed to load Energy VAD worklet: ${e instanceof Error ? e.message : String(e)}`
+      );
+      console.error(error.message);
+      URL.revokeObjectURL(url);
+      throw error;
+    }
+    URL.revokeObjectURL(url);
+    let node;
+    try {
+      node = new AudioWorkletNode(context, "energy-vad-processor");
+      console.log("Energy VAD node created successfully");
+    } catch (e) {
+      const error = new Error(
+        `Failed to create Energy VAD node: ${e instanceof Error ? e.message : String(e)}`
+      );
+      console.error(error.message);
+      throw error;
+    }
+    node.port.onmessage = (event) => {
+      try {
+        const { probability } = event.data;
+        if (typeof probability === "number" && !isNaN(probability)) {
+          onDecision(probability);
+        } else {
+          console.warn("Invalid VAD probability received:", event.data);
+        }
+      } catch (error) {
+        console.error("Error in VAD message handler:", error);
+      }
+    };
+    node.port.onmessageerror = (event) => {
+      console.error("VAD port message error:", event);
+    };
+    return node;
+  }
+};
+
+// src/extensibility/plugins.ts
+var nsPlugins = /* @__PURE__ */ new Map();
+var vadPlugins = /* @__PURE__ */ new Map();
+var defaultNs = new RNNoisePlugin();
+nsPlugins.set(defaultNs.name, defaultNs);
+var defaultVad = new EnergyVADPlugin();
+vadPlugins.set(defaultVad.name, defaultVad);
+function registerNoiseSuppressionPlugin(plugin) {
+  nsPlugins.set(plugin.name, plugin);
+}
+function registerVADPlugin(plugin) {
+  vadPlugins.set(plugin.name, plugin);
+}
+function getNoiseSuppressionPlugin(name) {
+  if (!name) return defaultNs;
+  const plugin = nsPlugins.get(name);
+  if (!plugin) {
+    console.warn(
+      `Noise suppression plugin '${name}' not found, falling back to default.`
+    );
+    return defaultNs;
+  }
+  return plugin;
+}
+function getVADPlugin(name) {
+  if (!name) return defaultVad;
+  const plugin = vadPlugins.get(name);
+  if (!plugin) {
+    console.warn(`VAD plugin '${name}' not found, falling back to default.`);
+    return defaultVad;
+  }
+  return plugin;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getNoiseSuppressionPlugin,
+  getVADPlugin,
+  registerNoiseSuppressionPlugin,
+  registerVADPlugin
+});

package/dist/extensibility/plugins.mjs

@@ -0,0 +1,14 @@
+import {
+  getNoiseSuppressionPlugin,
+  getVADPlugin,
+  registerNoiseSuppressionPlugin,
+  registerVADPlugin
+} from "../chunk-6P2RDBW5.mjs";
+import "../chunk-XO6B3D4A.mjs";
+import "../chunk-R5JVHKWA.mjs";
+export {
+  getNoiseSuppressionPlugin,
+  getVADPlugin,
+  registerNoiseSuppressionPlugin,
+  registerVADPlugin
+};