@newgameplusinc/odyssey-audio-video-sdk-dev 1.0.258 → 1.0.260

package/dist/sdk/index.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Odyssey Mediasoup SDK - Main Entry Point
+ *
+ * A comprehensive WebRTC SDK for real-time audio/video communication
+ * with spatial audio and ML-powered noise suppression.
+ *
+ * @module @odyssey/mediasoup-sdk
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStereoPanner = exports.createPanner = exports.DEFAULT_PIPELINE_CONFIG = exports.connectMonoDownmixChain = exports.createMonoDownmixChain = exports.createLimiter = exports.connectFilterChain = exports.createFilterChain = exports.createMasterChain = exports.DEFAULT_DENOISER_OPTIONS = exports.DEFAULT_SPATIAL_CONFIG = exports.SpatialAudioChannel = exports.isHuddleChannel = exports.SPATIAL_CHANNEL_ID = exports.HuddleChannel = exports.createVoiceFilterChain = exports.calculateAdaptiveHighpass = exports.normalizeVector = exports.calculateProximityWeight = exports.calculateClarityScore = exports.GainTracker = exports.applyStereoPanSmooth = exports.applyGainSmooth = exports.DEFAULT_PAN_SMOOTHER_OPTIONS = exports.PanSmoother = exports.autoConvertToStandard = exports.standardToUnreal = exports.unrealToStandard = exports.SNAP_CONFIG = exports.snapPositionSimple = exports.PositionSnapCache = exports.isLikelyCentimeters = exports.centimetersToMeters = exports.metersToCentimeters = exports.normalizePositionUnits = exports.calculateAngleToSource = exports.computeAzimuthFromPositions = exports.calculateListenerOrientation = exports.getListenerRightFromRotation = exports.getVectorFromListener = exports.parseBodyHeight = exports.computeHeadPosition = exports.panValueToPanning = exports.calculatePanFromPositions = exports.calculateListenerRight = exports.DEFAULT_GAIN_CONFIG = exports.calculateLogarithmicGain = exports.isWithinRange = exports.getHorizontalDistance = exports.getDistanceBetween = void 0;
+exports.SDK_NAME = exports.SDK_VERSION = exports.MediasoupManager = exports.EventManager = exports.MLNoiseSuppressor = exports.DEFAULT_PANNER_CONFIG = exports.createMediaStreamSource = exports.createCompressor = exports.createPeakingFilter = exports.createLowpassFilter = exports.createHighpassFilter = exports.createAnalyser = exports.createGain = void 0;
+// ============================================================================
+// Utils - Spatial Audio Calculations
+// ============================================================================
+var distance_calc_1 = require("../utils/spatial/distance-calc");
+Object.defineProperty(exports, "getDistanceBetween", { enumerable: true, get: function () { return distance_calc_1.getDistanceBetween; } });
+Object.defineProperty(exports, "getHorizontalDistance", { enumerable: true, get: function () { return distance_calc_1.getHorizontalDistance; } });
+Object.defineProperty(exports, "isWithinRange", { enumerable: true, get: function () { return distance_calc_1.isWithinRange; } });
+var gain_calc_1 = require("../utils/spatial/gain-calc");
+Object.defineProperty(exports, "calculateLogarithmicGain", { enumerable: true, get: function () { return gain_calc_1.calculateLogarithmicGain; } });
+Object.defineProperty(exports, "DEFAULT_GAIN_CONFIG", { enumerable: true, get: function () { return gain_calc_1.DEFAULT_GAIN_CONFIG; } });
+var pan_calc_1 = require("../utils/spatial/pan-calc");
+Object.defineProperty(exports, "calculateListenerRight", { enumerable: true, get: function () { return pan_calc_1.calculateListenerRight; } });
+Object.defineProperty(exports, "calculatePanFromPositions", { enumerable: true, get: function () { return pan_calc_1.calculatePanFromPositions; } });
+Object.defineProperty(exports, "panValueToPanning", { enumerable: true, get: function () { return pan_calc_1.panValueToPanning; } });
+var head_position_1 = require("../utils/spatial/head-position");
+Object.defineProperty(exports, "computeHeadPosition", { enumerable: true, get: function () { return head_position_1.computeHeadPosition; } });
+Object.defineProperty(exports, "parseBodyHeight", { enumerable: true, get: function () { return head_position_1.parseBodyHeight; } });
+Object.defineProperty(exports, "getVectorFromListener", { enumerable: true, get: function () { return head_position_1.getVectorFromListener; } });
+var listener_calc_1 = require("../utils/spatial/listener-calc");
+Object.defineProperty(exports, "getListenerRightFromRotation", { enumerable: true, get: function () { return listener_calc_1.getListenerRightFromRotation; } });
+Object.defineProperty(exports, "calculateListenerOrientation", { enumerable: true, get: function () { return listener_calc_1.calculateListenerOrientation; } });
+var angle_calc_1 = require("../utils/spatial/angle-calc");
+Object.defineProperty(exports, "computeAzimuthFromPositions", { enumerable: true, get: function () { return angle_calc_1.computeAzimuthFromPositions; } });
+Object.defineProperty(exports, "calculateAngleToSource", { enumerable: true, get: function () { return angle_calc_1.calculateAngleToSource; } });
+// ============================================================================
+// Utils - Position Processing
+// ============================================================================
+var normalize_1 = require("../utils/position/normalize");
+Object.defineProperty(exports, "normalizePositionUnits", { enumerable: true, get: function () { return normalize_1.normalizePositionUnits; } });
+Object.defineProperty(exports, "metersToCentimeters", { enumerable: true, get: function () { return normalize_1.metersToCentimeters; } });
+Object.defineProperty(exports, "centimetersToMeters", { enumerable: true, get: function () { return normalize_1.centimetersToMeters; } });
+Object.defineProperty(exports, "isLikelyCentimeters", { enumerable: true, get: function () { return normalize_1.isLikelyCentimeters; } });
+var snap_1 = require("../utils/position/snap");
+Object.defineProperty(exports, "PositionSnapCache", { enumerable: true, get: function () { return snap_1.PositionSnapCache; } });
+Object.defineProperty(exports, "snapPositionSimple", { enumerable: true, get: function () { return snap_1.snapPositionSimple; } });
+Object.defineProperty(exports, "SNAP_CONFIG", { enumerable: true, get: function () { return snap_1.SNAP_CONFIG; } });
+var coordinates_1 = require("../utils/position/coordinates");
+Object.defineProperty(exports, "unrealToStandard", { enumerable: true, get: function () { return coordinates_1.unrealToStandard; } });
+Object.defineProperty(exports, "standardToUnreal", { enumerable: true, get: function () { return coordinates_1.standardToUnreal; } });
+Object.defineProperty(exports, "autoConvertToStandard", { enumerable: true, get: function () { return coordinates_1.autoConvertToStandard; } });
+// ============================================================================
+// Utils - Audio Smoothing
+// ============================================================================
+var pan_smoothing_1 = require("../utils/smoothing/pan-smoothing");
+Object.defineProperty(exports, "PanSmoother", { enumerable: true, get: function () { return pan_smoothing_1.PanSmoother; } });
+Object.defineProperty(exports, "DEFAULT_PAN_SMOOTHER_OPTIONS", { enumerable: true, get: function () { return pan_smoothing_1.DEFAULT_PAN_SMOOTHER_OPTIONS; } });
+var gain_smoothing_1 = require("../utils/smoothing/gain-smoothing");
+Object.defineProperty(exports, "applyGainSmooth", { enumerable: true, get: function () { return gain_smoothing_1.applyGainSmooth; } });
+Object.defineProperty(exports, "applyStereoPanSmooth", { enumerable: true, get: function () { return gain_smoothing_1.applyStereoPanSmooth; } });
+Object.defineProperty(exports, "GainTracker", { enumerable: true, get: function () { return gain_smoothing_1.GainTracker; } });
+// ============================================================================
+// Utils - Audio Quality
+// ============================================================================
+var clarity_score_1 = require("../utils/audio/clarity-score");
+Object.defineProperty(exports, "calculateClarityScore", { enumerable: true, get: function () { return clarity_score_1.calculateClarityScore; } });
+Object.defineProperty(exports, "calculateProximityWeight", { enumerable: true, get: function () { return clarity_score_1.calculateProximityWeight; } });
+Object.defineProperty(exports, "normalizeVector", { enumerable: true, get: function () { return clarity_score_1.normalizeVector; } });
+var voice_filter_1 = require("../utils/audio/voice-filter");
+Object.defineProperty(exports, "calculateAdaptiveHighpass", { enumerable: true, get: function () { return voice_filter_1.calculateAdaptiveHighpass; } });
+Object.defineProperty(exports, "createVoiceFilterChain", { enumerable: true, get: function () { return voice_filter_1.createVoiceFilterChain; } });
+// ============================================================================
+// Channels
+// ============================================================================
+var HuddleChannel_1 = require("../channels/huddle/HuddleChannel");
+Object.defineProperty(exports, "HuddleChannel", { enumerable: true, get: function () { return HuddleChannel_1.HuddleChannel; } });
+var HuddleTypes_1 = require("../channels/huddle/HuddleTypes");
+Object.defineProperty(exports, "SPATIAL_CHANNEL_ID", { enumerable: true, get: function () { return HuddleTypes_1.SPATIAL_CHANNEL_ID; } });
+Object.defineProperty(exports, "isHuddleChannel", { enumerable: true, get: function () { return HuddleTypes_1.isHuddleChannel; } });
+var SpatialAudioChannel_1 = require("../channels/spatial/SpatialAudioChannel");
+Object.defineProperty(exports, "SpatialAudioChannel", { enumerable: true, get: function () { return SpatialAudioChannel_1.SpatialAudioChannel; } });
+var SpatialAudioTypes_1 = require("../channels/spatial/SpatialAudioTypes");
+Object.defineProperty(exports, "DEFAULT_SPATIAL_CONFIG", { enumerable: true, get: function () { return SpatialAudioTypes_1.DEFAULT_SPATIAL_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_DENOISER_OPTIONS", { enumerable: true, get: function () { return SpatialAudioTypes_1.DEFAULT_DENOISER_OPTIONS; } });
+// ============================================================================
+// Audio Processing
+// ============================================================================
+var AudioPipeline_1 = require("../audio/AudioPipeline");
+Object.defineProperty(exports, "createMasterChain", { enumerable: true, get: function () { return AudioPipeline_1.createMasterChain; } });
+Object.defineProperty(exports, "createFilterChain", { enumerable: true, get: function () { return AudioPipeline_1.createFilterChain; } });
+Object.defineProperty(exports, "connectFilterChain", { enumerable: true, get: function () { return AudioPipeline_1.connectFilterChain; } });
+Object.defineProperty(exports, "createLimiter", { enumerable: true, get: function () { return AudioPipeline_1.createLimiter; } });
+Object.defineProperty(exports, "createMonoDownmixChain", { enumerable: true, get: function () { return AudioPipeline_1.createMonoDownmixChain; } });
+Object.defineProperty(exports, "connectMonoDownmixChain", { enumerable: true, get: function () { return AudioPipeline_1.connectMonoDownmixChain; } });
+Object.defineProperty(exports, "DEFAULT_PIPELINE_CONFIG", { enumerable: true, get: function () { return AudioPipeline_1.DEFAULT_PIPELINE_CONFIG; } });
+var AudioNodeFactory_1 = require("../audio/AudioNodeFactory");
+Object.defineProperty(exports, "createPanner", { enumerable: true, get: function () { return AudioNodeFactory_1.createPanner; } });
+Object.defineProperty(exports, "createStereoPanner", { enumerable: true, get: function () { return AudioNodeFactory_1.createStereoPanner; } });
+Object.defineProperty(exports, "createGain", { enumerable: true, get: function () { return AudioNodeFactory_1.createGain; } });
+Object.defineProperty(exports, "createAnalyser", { enumerable: true, get: function () { return AudioNodeFactory_1.createAnalyser; } });
+Object.defineProperty(exports, "createHighpassFilter", { enumerable: true, get: function () { return AudioNodeFactory_1.createHighpassFilter; } });
+Object.defineProperty(exports, "createLowpassFilter", { enumerable: true, get: function () { return AudioNodeFactory_1.createLowpassFilter; } });
+Object.defineProperty(exports, "createPeakingFilter", { enumerable: true, get: function () { return AudioNodeFactory_1.createPeakingFilter; } });
+Object.defineProperty(exports, "createCompressor", { enumerable: true, get: function () { return AudioNodeFactory_1.createCompressor; } });
+Object.defineProperty(exports, "createMediaStreamSource", { enumerable: true, get: function () { return AudioNodeFactory_1.createMediaStreamSource; } });
+Object.defineProperty(exports, "DEFAULT_PANNER_CONFIG", { enumerable: true, get: function () { return AudioNodeFactory_1.DEFAULT_PANNER_CONFIG; } });
+var MLNoiseSuppressor_1 = require("../audio/MLNoiseSuppressor");
+Object.defineProperty(exports, "MLNoiseSuppressor", { enumerable: true, get: function () { return MLNoiseSuppressor_1.MLNoiseSuppressor; } });
+// ============================================================================
+// Core
+// ============================================================================
+var EventManager_1 = require("../core/EventManager");
+Object.defineProperty(exports, "EventManager", { enumerable: true, get: function () { return EventManager_1.EventManager; } });
+var MediasoupManager_1 = require("../core/MediasoupManager");
+Object.defineProperty(exports, "MediasoupManager", { enumerable: true, get: function () { return MediasoupManager_1.MediasoupManager; } });
+// ============================================================================
+// SDK Version
+// ============================================================================
+exports.SDK_VERSION = '2.0.0';
+exports.SDK_NAME = 'Odyssey Mediasoup SDK';

package/dist/types/events.d.ts

@@ -0,0 +1,154 @@
+/**
+ * SDK Event Types
+ */
+import { Participant, MediaState, ParticipantSnapshot } from './participant';
+import { Position, Direction } from './position';
+/**
+ * Participants snapshot event from server
+ */
+export interface ParticipantsSnapshotEvent {
+    roomId: string;
+    participants: ParticipantSnapshot[];
+}
+/**
+ * Room joined event data
+ */
+export interface RoomJoinedEvent {
+    roomId: string;
+    participantId: string;
+    participants: Participant[];
+    routerRtpCapabilities: any;
+    iceServers: any[];
+}
+/**
+ * Consumer created event data
+ */
+export interface ConsumerCreatedEvent {
+    participant: Participant;
+    track: MediaStreamTrack;
+    consumer: any;
+    isScreenshare?: boolean;
+    appData?: any;
+}
+/**
+ * Consumer closed event data
+ */
+export interface ConsumerClosedEvent {
+    consumerId: string;
+    participantId: string;
+    kind: string;
+    isScreenshare?: boolean;
+}
+/**
+ * Consumer paused event data
+ */
+export interface ConsumerPausedEvent {
+    consumerId: string;
+    participantId: string;
+}
+/**
+ * Consumer resumed event data
+ */
+export interface ConsumerResumedEvent {
+    consumerId: string;
+    participantId: string;
+}
+/**
+ * Participant joined event data
+ */
+export interface ParticipantJoinedEvent {
+    participantId: string;
+    userId: string;
+    deviceId: string;
+    position: Position;
+    direction: Direction;
+    mediaState: MediaState;
+    bodyHeight?: string;
+    bodyShape?: string;
+    userName?: string;
+    userEmail?: string;
+}
+/**
+ * Participant left event data
+ */
+export interface ParticipantLeftEvent {
+    participantId: string;
+}
+/**
+ * Participant position updated event data
+ */
+export interface ParticipantPositionEvent {
+    participantId: string;
+    conferenceId: string;
+    roomId: string;
+    position: Position;
+    direction: Direction;
+    mediaState: MediaState;
+    consumerIds: string[];
+    timestamp: number;
+    bodyHeight?: string;
+    bodyShape?: string;
+    userName?: string;
+    userEmail?: string;
+    currentChannel?: string;
+    rot?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    pan?: number;
+    dxLocal?: number;
+}
+/**
+ * Mute state changed event data
+ */
+export interface MuteStateChangedEvent {
+    participantId: string;
+    muted: boolean;
+}
+/**
+ * Huddle invite received event data
+ */
+export interface HuddleInviteReceivedEvent {
+    inviteId: string;
+    fromParticipantId: string;
+    fromUserName?: string;
+    huddleId?: string;
+}
+/**
+ * Huddle response event data
+ */
+export interface HuddleResponseEvent {
+    success: boolean;
+    huddleId?: string;
+    channelId?: string;
+    participants?: string[];
+    error?: string;
+}
+/**
+ * All SDK event types
+ */
+export type OdysseyEvent = "connected" | "disconnected" | "room-joined" | "all-participants-update" | "new-participant" | "participant-left" | "producer-created" | "consumer-created" | "consumer-closed" | "participant-media-state-updated" | "participant-position-updated" | "error" | "huddle-invite-received" | "private-huddle-started" | "huddle-updated" | "huddle-invite-rejected" | "huddle-ended" | "participant-channel-changed" | "mute-requested";
+/**
+ * Event map for type-safe event handling
+ */
+export interface OdysseyEventMap {
+    'connected': void;
+    'disconnected': void;
+    'room-joined': RoomJoinedEvent;
+    'all-participants-update': Participant[];
+    'new-participant': Participant;
+    'participant-left': string;
+    'consumer-created': ConsumerCreatedEvent;
+    'consumer-closed': ConsumerClosedEvent;
+    'participant-media-state-updated': Participant;
+    'participant-position-updated': Participant;
+    'error': Error;
+    'huddle-invite-received': HuddleInviteReceivedEvent;
+    'private-huddle-started': HuddleResponseEvent;
+    'huddle-updated': any;
+    'huddle-invite-rejected': any;
+    'huddle-ended': any;
+    'participant-channel-changed': any;
+    'mute-requested': any;
+}

package/dist/{types.js → types/events.js}

@@ -1,2 +1,5 @@
 "use strict";
+/**
+ * SDK Event Types
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Types module - Re-exports all type definitions
+ */
+export * from './position';
+export * from './participant';
+export * from './events';
+export * from './room';

package/dist/types/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Types module - Re-exports all type definitions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./position"), exports);
+__exportStar(require("./participant"), exports);
+__exportStar(require("./events"), exports);
+__exportStar(require("./room"), exports);

package/dist/types/participant.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Participant Types
+ */
+import { Position, Direction } from './position';
+/**
+ * Media state for a participant
+ */
+export interface MediaState {
+    audio: boolean;
+    video: boolean;
+    sharescreen: boolean;
+}
+/**
+ * Full participant data
+ */
+export interface Participant {
+    participantId: string;
+    userId: string;
+    deviceId: string;
+    name?: string;
+    avatarUrl?: string;
+    isLocal: boolean;
+    audioTrack?: MediaStreamTrack;
+    videoTrack?: MediaStreamTrack;
+    producers: Map<string, any>;
+    consumers: Map<string, any>;
+    position: Position;
+    direction: Direction;
+    mediaState: MediaState;
+    rot?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    pan?: number;
+    dxLocal?: number;
+    bodyHeight?: string;
+    bodyShape?: string;
+    userName?: string;
+    userEmail?: string;
+    currentChannel?: string;
+}
+/**
+ * Participant snapshot from server updates
+ */
+export interface ParticipantSnapshot {
+    participantId: string;
+    userId: string;
+    deviceId: string;
+    position: Position;
+    direction: Direction;
+    rot?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    pan?: number;
+    dxLocal?: number;
+    bodyHeight: string;
+    bodyShape: string;
+    userName: string;
+    userEmail: string;
+    mediaState: MediaState;
+    currentChannel?: string;
+}

package/dist/types/participant.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Participant Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/position.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Position and Direction Types
+ *
+ * Coordinate system conventions:
+ * - Unreal Engine: X=forward, Y=right, Z=up (centimeters)
+ * - Standard/WebAudio: X=right, Y=up, Z=forward (meters)
+ */
+/**
+ * 3D position in space
+ */
+export interface Position {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * 3D direction vector (normalized)
+ */
+export interface Direction {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Rotation in degrees (Euler angles)
+ */
+export interface Rotation {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Listener right-ear vector (2D projection on XZ plane)
+ * Used for stereo panning calculations
+ */
+export interface ListenerRight {
+    x: number;
+    z: number;
+}
+/**
+ * Position in Unreal Engine coordinates (centimeters)
+ */
+export type UnrealPosition = Position;
+/**
+ * Position in standard coordinates (meters)
+ */
+export type StandardPosition = Position;

package/dist/types/position.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Position and Direction Types
+ *
+ * Coordinate system conventions:
+ * - Unreal Engine: X=forward, Y=right, Z=up (centimeters)
+ * - Standard/WebAudio: X=right, Y=up, Z=forward (meters)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/room.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Room and Transport Types
+ */
+import { Participant } from './participant';
+import { Position, Direction } from './position';
+/**
+ * Room state
+ */
+export interface Room {
+    id: string;
+    participants: Map<string, Participant>;
+}
+/**
+ * Room joined data from server
+ */
+export interface RoomJoinedData {
+    participants: Participant[];
+    routerRtpCapabilities: any;
+    participantId: string;
+    roomId: string;
+    iceServers: any[];
+}
+/**
+ * Join room request data
+ */
+export interface JoinRoomData {
+    roomId: string;
+    userId: string;
+    deviceId: string;
+    participantId?: string;
+    position: Position;
+    direction: Direction;
+    bodyHeight?: string;
+    bodyShape?: string;
+    userName?: string;
+    userEmail?: string;
+}
+/**
+ * Consumer created data from server
+ */
+export interface ConsumerCreatedData {
+    consumerId: string;
+    producerId: string;
+    kind: 'audio' | 'video';
+    rtpParameters: any;
+    participantId: string;
+    conferenceId: string;
+    roomId: string;
+    position: Position;
+    direction: Direction;
+    mediaState: {
+        audio: boolean;
+        video: boolean;
+        sharescreen: boolean;
+    };
+    timestamp: number;
+    bodyHeight?: string;
+    bodyShape?: string;
+    userName?: string;
+    userEmail?: string;
+    appData?: {
+        isScreenshare?: boolean;
+    };
+}
+/**
+ * WebRTC transport options
+ */
+export interface TransportOptions {
+    id: string;
+    iceParameters: any;
+    iceCandidates: any[];
+    dtlsParameters: any;
+}
+/**
+ * Producer options
+ */
+export interface ProducerOptions {
+    track: MediaStreamTrack;
+    appData?: {
+        isScreenshare?: boolean;
+    };
+}

package/dist/types/room.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Room and Transport Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/audio/clarity-score.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Clarity Score Calculations
+ *
+ * Functions for calculating voice clarity based on distance and direction
+ */
+import { Position } from '../../types/position';
+/**
+ * Calculate clarity score based on distance and direction
+ * Used for adjusting audio quality based on proximity and facing direction
+ *
+ * @param distance Distance to source
+ * @param vectorToSource Vector from listener to source
+ * @param listenerForward Listener's forward direction (optional)
+ * @returns Clarity score from 0 to 1
+ */
+export declare function calculateClarityScore(distance: number, vectorToSource: Position, listenerForward?: Position): number;
+/**
+ * Calculate proximity weight based on distance
+ *
+ * @param distance Distance in meters
+ * @param closeRange Distance for full weight (default: 0.85m)
+ * @param fadeRange Distance for zero weight (default: 18m)
+ * @returns Weight from 0 to 1
+ */
+export declare function calculateProximityWeight(distance: number, closeRange?: number, fadeRange?: number): number;
+/**
+ * Normalize a vector to unit length
+ *
+ * @param vector Vector to normalize
+ * @param fallback Fallback if vector is zero length
+ * @returns Normalized vector
+ */
+export declare function normalizeVector(vector: Position, fallback?: Position): Position;

package/dist/utils/audio/clarity-score.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Clarity Score Calculations
+ *
+ * Functions for calculating voice clarity based on distance and direction
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateClarityScore = calculateClarityScore;
+exports.calculateProximityWeight = calculateProximityWeight;
+exports.normalizeVector = normalizeVector;
+/**
+ * Calculate clarity score based on distance and direction
+ * Used for adjusting audio quality based on proximity and facing direction
+ *
+ * @param distance Distance to source
+ * @param vectorToSource Vector from listener to source
+ * @param listenerForward Listener's forward direction (optional)
+ * @returns Clarity score from 0 to 1
+ */
+function calculateClarityScore(distance, vectorToSource, listenerForward) {
+    const proximityWeight = calculateProximityWeight(distance);
+    const focusWeight = listenerForward
+        ? calculateDirectionFocus(vectorToSource, listenerForward)
+        : 0.5;
+    return clamp(0.2 + proximityWeight * 0.6 + focusWeight * 0.2, 0, 1);
+}
+/**
+ * Calculate proximity weight based on distance
+ *
+ * @param distance Distance in meters
+ * @param closeRange Distance for full weight (default: 0.85m)
+ * @param fadeRange Distance for zero weight (default: 18m)
+ * @returns Weight from 0 to 1
+ */
+function calculateProximityWeight(distance, closeRange = 0.85, fadeRange = 18) {
+    if (distance <= closeRange) {
+        return 1;
+    }
+    if (distance >= fadeRange) {
+        return 0;
+    }
+    return 1 - (distance - closeRange) / (fadeRange - closeRange);
+}
+/**
+ * Calculate direction focus weight
+ * How much the listener is facing the source
+ *
+ * @param vectorToSource Vector from listener to source
+ * @param listenerForward Listener's forward direction
+ * @returns Focus weight from 0 to 1
+ */
+function calculateDirectionFocus(vectorToSource, listenerForward) {
+    const forward = normalizeVector(listenerForward);
+    const source = normalizeVector(vectorToSource, { x: 0, y: 0, z: 1 });
+    const dot = forward.x * source.x + forward.y * source.y + forward.z * source.z;
+    return clamp((dot + 1) / 2, 0, 1);
+}
+/**
+ * Normalize a vector to unit length
+ *
+ * @param vector Vector to normalize
+ * @param fallback Fallback if vector is zero length
+ * @returns Normalized vector
+ */
+function normalizeVector(vector, fallback = { x: 0, y: 0, z: 1 }) {
+    const length = Math.hypot(vector.x, vector.y, vector.z);
+    if (length < 1e-4) {
+        return { ...fallback };
+    }
+    return {
+        x: vector.x / length,
+        y: vector.y / length,
+        z: vector.z / length,
+    };
+}
+/**
+ * Clamp value between min and max
+ */
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}

package/dist/utils/audio/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Audio utilities - Re-exports all audio utility functions
+ */
+export * from './clarity-score';
+export * from './voice-filter';