@absolutejs/voice 0.0.22-beta.502 → 0.0.22-beta.504

package/dist/client/browserNoiseSuppression.d.ts

@@ -0,0 +1,42 @@
+export type BrowserNoiseSuppressorOptions = {
+    /** Existing AudioContext to reuse. If omitted, a fresh one is created at 48kHz. */
+    audioContext?: AudioContext;
+    /** Optional message sent to the worklet via port.postMessage on init. */
+    initialPort?: Record<string, unknown>;
+    /** AudioWorkletNode options forwarded to the constructor. */
+    nodeOptions?: AudioWorkletNodeOptions;
+    /** Registered AudioWorkletProcessor name to instantiate. */
+    processorName: string;
+    /** Caller-supplied input stream from getUserMedia or similar. */
+    stream: MediaStream;
+    /** URL of the AudioWorklet script that registers `processorName`. */
+    workletUrl: string;
+};
+export type BrowserNoiseSuppressorHandle = {
+    /** The worklet node — operators can postMessage to tune at runtime. */
+    node: AudioWorkletNode;
+    /** A MediaStream containing the denoised audio track. */
+    stream: MediaStream;
+    /** Tears down the worklet + closes the AudioContext when this helper created it. */
+    stop: () => Promise<void>;
+};
+export declare const applyBrowserNoiseSuppression: (options: BrowserNoiseSuppressorOptions) => Promise<BrowserNoiseSuppressorHandle>;
+export type BrowserNoiseSuppressorPreset = {
+    initialPort?: Record<string, unknown>;
+    /** Display label for UI affordances. */
+    label: string;
+    nodeOptions?: AudioWorkletNodeOptions;
+    processorName: string;
+    workletUrl: string;
+};
+/**
+ * Convenience presets pointing at well-known open-source worklets. Operators
+ * still install the underlying npm package and copy the worklet file to a
+ * URL their site can serve.
+ */
+export declare const BROWSER_NOISE_SUPPRESSOR_PRESETS: {
+    /** DeepFilterNet 2023 model — best quality open-source pick. */
+    readonly deepfilternet: (workletUrl: string) => BrowserNoiseSuppressorPreset;
+    /** Jitsi @jitsi/rnnoise-wasm — ships a `rnnoise-processor` worklet. */
+    readonly rnnoise: (workletUrl: string) => BrowserNoiseSuppressorPreset;
+};

package/dist/client/htmxAttributes.d.ts

@@ -0,0 +1,28 @@
+export type VoiceHTMXPollingAttributes = {
+    /** Set true to emit hx-get/hx-trigger when refreshUrl is also provided. */
+    poll?: boolean;
+    /** Polling cadence. Default 5_000ms. Clamped to >= 1_000ms. */
+    pollIntervalMs?: number;
+    /** Extra HTMX attributes to splice in. Keys without the 'hx-' prefix have it added. */
+    pushAttributes?: Record<string, string>;
+    /** URL hx-get fires against. Without it, polling is skipped. */
+    refreshUrl?: string;
+    /** hx-swap value. Default 'outerHTML'. */
+    swap?: string;
+    /** Optional hx-target selector. */
+    target?: string;
+};
+export declare const buildVoiceHTMXAttributes: (attrs: VoiceHTMXPollingAttributes | undefined) => string;
+/**
+ * Injects HTMX polling attributes into the first opening tag of an HTML string.
+ * Returns the original HTML unchanged when attrs produce no attributes.
+ */
+export declare const wrapVoiceHTMLWithHTMXPolling: (html: string, attrs: VoiceHTMXPollingAttributes | undefined) => string;
+/**
+ * Wraps arbitrary HTML in a self-refreshing div that polls refreshUrl.
+ * Use this when the inner HTML doesn't have a stable root element to mutate.
+ */
+export declare const wrapVoiceHTMLInHTMXContainer: (html: string, attrs: VoiceHTMXPollingAttributes & {
+    className?: string;
+    elementTag?: string;
+}) => string;

package/dist/client/htmxDashboardRenderers.d.ts

@@ -3,16 +3,8 @@ import type { VoiceCallReviewArtifact } from "../testing/review";
 import { type VoiceCostDashboardBucket, type VoiceCostDashboardOptions, type VoiceCostDashboardReport } from "./costDashboard";
 import { type LiveCallViewState, type LiveCallViewer } from "./liveCallViewer";
 import { type ReplayTimelineReport } from "./replayTimeline";
-export type VoiceDashboardHTMXAttributes = {
-    /** Set true to wrap the fragment in an hx-get + hx-trigger="every Ns" polling shell. */
-    poll?: boolean;
-    /** Polling cadence when poll is true. Default 5 seconds. */
-    pollIntervalMs?: number;
-    /** Route the renderer points hx-get at. Default mirrors the route the handler is mounted on. */
-    refreshUrl?: string;
-    /** hx-swap value. Default 'outerHTML'. */
-    swap?: string;
-};
+import { type VoiceHTMXPollingAttributes } from "./htmxAttributes";
+export type VoiceDashboardHTMXAttributes = VoiceHTMXPollingAttributes;
 export type VoiceCostDashboardHTMXInput = {
     attributes?: VoiceDashboardHTMXAttributes;
     currency?: string;

package/dist/index.d.ts

@@ -110,6 +110,14 @@ export { createInMemoryVoiceCallQuota } from "./callQuota";
 export type { CreateInMemoryVoiceCallQuotaOptions, VoiceCallQuota, VoiceCallQuotaRejection, VoiceCallQuotaResult, VoiceCallQuotaTier, VoiceCallReservation, } from "./callQuota";
 export { createVoiceBearerAuthVerifier, createVoiceHMACAuthVerifier, createVoiceRouteAuth, } from "./routeAuth";
 export type { VoiceRouteAuthDecision, VoiceRouteAuthInput, VoiceRouteAuthOptions, VoiceRouteAuthVerifier, } from "./routeAuth";
+export { BROWSER_NOISE_SUPPRESSOR_PRESETS, applyBrowserNoiseSuppression, } from "./client/browserNoiseSuppression";
+export type { BrowserNoiseSuppressorHandle, BrowserNoiseSuppressorOptions, BrowserNoiseSuppressorPreset, } from "./client/browserNoiseSuppression";
+export { buildVoiceHTMXAttributes, wrapVoiceHTMLInHTMXContainer, wrapVoiceHTMLWithHTMXPolling, } from "./client/htmxAttributes";
+export type { VoiceHTMXPollingAttributes } from "./client/htmxAttributes";
+export { createLiveCallViewerFromOptions, renderVoiceCostDashboardFromEvents, renderVoiceCostDashboardHTMX, renderVoiceLiveCallViewerFromState, renderVoiceLiveCallViewerFromViewer, renderVoiceLiveCallViewerHTMX, renderVoiceReplayTimelineFromArtifact, renderVoiceReplayTimelineHTMX, resolveVoiceDashboardRenderers, } from "./client/htmxDashboardRenderers";
+export type { ResolvedVoiceDashboardRenderers, VoiceCostDashboardHTMXInput, VoiceCostDashboardRenderer, VoiceDashboardHTMXAttributes, VoiceDashboardHTMXRendererConfig, VoiceLiveCallViewerHTMXInput, VoiceLiveCallViewerRenderer, VoiceReplayTimelineHTMXInput, VoiceReplayTimelineRenderer, } from "./client/htmxDashboardRenderers";
+export { createVoiceCostDashboardHTMXRoute, createVoiceHTMXDashboardRoutes, createVoiceHTMXDashboardRoutesFromStores, createVoiceLiveCallViewerHTMXRoute, createVoiceReplayTimelineHTMXRoute, } from "./htmxDashboardRoutes";
+export type { CreateVoiceHTMXDashboardRoutesFromStoresOptions, VoiceHTMXCostDashboardRoutesOptions, VoiceHTMXDashboardRoutesOptions, VoiceHTMXLiveCallViewerRoutesOptions, VoiceHTMXReplayTimelineRoutesOptions, } from "./htmxDashboardRoutes";
 export { buildVoiceCostDashboardReport } from "./client/costDashboard";
 export type { VoiceCostDashboardBucket, VoiceCostDashboardOptions, VoiceCostDashboardReport, } from "./client/costDashboard";
 export { createLiveCallViewer } from "./client/liveCallViewer";