@idealyst/microphone 1.1.2

package/src/hooks/useMicrophone.web.ts

@@ -0,0 +1,43 @@
+import { createUseMicrophoneHook } from './createUseMicrophoneHook';
+import { createMicrophone } from '../microphone.web';
+
+/**
+ * React hook for microphone access on web platforms.
+ *
+ * @example
+ * ```tsx
+ * import { useMicrophone, AUDIO_PROFILES } from '@idealyst/microphone';
+ *
+ * function VoiceInput() {
+ *   const {
+ *     isRecording,
+ *     level,
+ *     start,
+ *     stop,
+ *     subscribeToAudioData
+ *   } = useMicrophone({
+ *     config: AUDIO_PROFILES.speech,
+ *     autoRequestPermission: true,
+ *   });
+ *
+ *   useEffect(() => {
+ *     if (!isRecording) return;
+ *
+ *     return subscribeToAudioData((pcmData) => {
+ *       // Process audio data
+ *       console.log('Got', pcmData.samples.length, 'samples');
+ *     });
+ *   }, [isRecording, subscribeToAudioData]);
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={isRecording ? stop : start}>
+ *         {isRecording ? 'Stop' : 'Start'}
+ *       </button>
+ *       <div>Level: {Math.round(level.current * 100)}%</div>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useMicrophone = createUseMicrophoneHook(createMicrophone);

package/src/hooks/useRecorder.native.ts

@@ -0,0 +1,37 @@
+import { createUseRecorderHook } from './createUseRecorderHook';
+import { createRecorder } from '../recorder/recorder.native';
+
+/**
+ * React hook for recording audio to file on React Native platforms.
+ *
+ * @example
+ * ```tsx
+ * import { useRecorder } from '@idealyst/microphone';
+ * import { View, Button, Text } from 'react-native';
+ *
+ * function AudioRecorder() {
+ *   const { isRecording, duration, startRecording, stopRecording } = useRecorder();
+ *   const [recording, setRecording] = useState<RecordingResult | null>(null);
+ *
+ *   const handleStop = async () => {
+ *     const result = await stopRecording();
+ *     setRecording(result);
+ *
+ *     // Get the base64 data for upload
+ *     const base64Data = await result.getData();
+ *     console.log('Recording size:', result.size, 'bytes');
+ *   };
+ *
+ *   return (
+ *     <View>
+ *       <Text>Duration: {Math.floor(duration / 1000)}s</Text>
+ *       <Button
+ *         title={isRecording ? 'Stop' : 'Record'}
+ *         onPress={isRecording ? handleStop : () => startRecording()}
+ *       />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export const useRecorder = createUseRecorderHook(createRecorder);

package/src/hooks/useRecorder.web.ts

@@ -0,0 +1,37 @@
+import { createUseRecorderHook } from './createUseRecorderHook';
+import { createRecorder } from '../recorder/recorder.web';
+
+/**
+ * React hook for recording audio to file on web platforms.
+ *
+ * @example
+ * ```tsx
+ * import { useRecorder } from '@idealyst/microphone';
+ *
+ * function AudioRecorder() {
+ *   const { isRecording, duration, startRecording, stopRecording } = useRecorder();
+ *   const [recording, setRecording] = useState<RecordingResult | null>(null);
+ *
+ *   const handleStop = async () => {
+ *     const result = await stopRecording();
+ *     setRecording(result);
+ *
+ *     // Download the recording
+ *     const link = document.createElement('a');
+ *     link.href = result.uri;
+ *     link.download = 'recording.wav';
+ *     link.click();
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Duration: {Math.floor(duration / 1000)}s</p>
+ *       <button onClick={isRecording ? handleStop : () => startRecording()}>
+ *         {isRecording ? 'Stop' : 'Record'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useRecorder = createUseRecorderHook(createRecorder);

package/src/index.native.ts

@@ -0,0 +1,79 @@
+// Types
+export type {
+  // Audio config types
+  SampleRate,
+  BitDepth,
+  ChannelCount,
+  AudioConfig,
+
+  // PCM data types
+  PCMData,
+  AudioLevel,
+
+  // Permission types
+  PermissionStatus,
+  PermissionResult,
+
+  // Microphone state types
+  MicrophoneState,
+  MicrophoneStatus,
+
+  // Error types
+  MicrophoneErrorCode,
+  MicrophoneError,
+
+  // Callback types
+  AudioDataCallback,
+  AudioLevelCallback,
+  StateChangeCallback,
+  ErrorCallback,
+
+  // Interface types
+  IMicrophone,
+  IRecorder,
+
+  // Recording types
+  RecordingFormat,
+  RecordingOptions,
+  RecordingResult,
+
+  // Hook types
+  UseMicrophoneOptions,
+  UseMicrophoneResult,
+  UseRecorderOptions,
+  UseRecorderResult,
+} from './types';
+
+// Constants
+export {
+  DEFAULT_AUDIO_CONFIG,
+  DEFAULT_AUDIO_LEVEL,
+  DEFAULT_LEVEL_UPDATE_INTERVAL,
+  AUDIO_PROFILES,
+  BIT_DEPTH_MAX_VALUES,
+} from './constants';
+
+// Utilities
+export {
+  base64ToArrayBuffer,
+  arrayBufferToBase64,
+  createPCMTypedArray,
+  calculateAudioLevels,
+  float32ToInt16,
+  float32ToInt8,
+  createWavHeader,
+  createWavFile,
+  concatArrayBuffers,
+} from './utils';
+
+// Hooks
+export { useMicrophone, useRecorder } from './hooks/index.native';
+
+// Microphone class
+export { NativeMicrophone, createMicrophone } from './microphone.native';
+
+// Recorder class
+export { NativeRecorder, createRecorder } from './recorder/recorder.native';
+
+// Permissions
+export { checkPermission, requestPermission } from './permissions/permissions.native';

package/src/index.ts

@@ -0,0 +1,79 @@
+// Types
+export type {
+  // Audio config types
+  SampleRate,
+  BitDepth,
+  ChannelCount,
+  AudioConfig,
+
+  // PCM data types
+  PCMData,
+  AudioLevel,
+
+  // Permission types
+  PermissionStatus,
+  PermissionResult,
+
+  // Microphone state types
+  MicrophoneState,
+  MicrophoneStatus,
+
+  // Error types
+  MicrophoneErrorCode,
+  MicrophoneError,
+
+  // Callback types
+  AudioDataCallback,
+  AudioLevelCallback,
+  StateChangeCallback,
+  ErrorCallback,
+
+  // Interface types
+  IMicrophone,
+  IRecorder,
+
+  // Recording types
+  RecordingFormat,
+  RecordingOptions,
+  RecordingResult,
+
+  // Hook types
+  UseMicrophoneOptions,
+  UseMicrophoneResult,
+  UseRecorderOptions,
+  UseRecorderResult,
+} from './types';
+
+// Constants
+export {
+  DEFAULT_AUDIO_CONFIG,
+  DEFAULT_AUDIO_LEVEL,
+  DEFAULT_LEVEL_UPDATE_INTERVAL,
+  AUDIO_PROFILES,
+  BIT_DEPTH_MAX_VALUES,
+} from './constants';
+
+// Utilities
+export {
+  base64ToArrayBuffer,
+  arrayBufferToBase64,
+  createPCMTypedArray,
+  calculateAudioLevels,
+  float32ToInt16,
+  float32ToInt8,
+  createWavHeader,
+  createWavFile,
+  concatArrayBuffers,
+} from './utils';
+
+// Hooks
+export { useMicrophone, useRecorder } from './hooks/index.web';
+
+// Microphone class
+export { WebMicrophone, createMicrophone } from './microphone.web';
+
+// Recorder class
+export { WebRecorder, createRecorder } from './recorder/recorder.web';
+
+// Permissions
+export { checkPermission, requestPermission } from './permissions/permissions.web';

package/src/index.web.ts

@@ -0,0 +1,79 @@
+// Types
+export type {
+  // Audio config types
+  SampleRate,
+  BitDepth,
+  ChannelCount,
+  AudioConfig,
+
+  // PCM data types
+  PCMData,
+  AudioLevel,
+
+  // Permission types
+  PermissionStatus,
+  PermissionResult,
+
+  // Microphone state types
+  MicrophoneState,
+  MicrophoneStatus,
+
+  // Error types
+  MicrophoneErrorCode,
+  MicrophoneError,
+
+  // Callback types
+  AudioDataCallback,
+  AudioLevelCallback,
+  StateChangeCallback,
+  ErrorCallback,
+
+  // Interface types
+  IMicrophone,
+  IRecorder,
+
+  // Recording types
+  RecordingFormat,
+  RecordingOptions,
+  RecordingResult,
+
+  // Hook types
+  UseMicrophoneOptions,
+  UseMicrophoneResult,
+  UseRecorderOptions,
+  UseRecorderResult,
+} from './types';
+
+// Constants
+export {
+  DEFAULT_AUDIO_CONFIG,
+  DEFAULT_AUDIO_LEVEL,
+  DEFAULT_LEVEL_UPDATE_INTERVAL,
+  AUDIO_PROFILES,
+  BIT_DEPTH_MAX_VALUES,
+} from './constants';
+
+// Utilities
+export {
+  base64ToArrayBuffer,
+  arrayBufferToBase64,
+  createPCMTypedArray,
+  calculateAudioLevels,
+  float32ToInt16,
+  float32ToInt8,
+  createWavHeader,
+  createWavFile,
+  concatArrayBuffers,
+} from './utils';
+
+// Hooks
+export { useMicrophone, useRecorder } from './hooks/index.web';
+
+// Microphone class
+export { WebMicrophone, createMicrophone } from './microphone.web';
+
+// Recorder class
+export { WebRecorder, createRecorder } from './recorder/recorder.web';
+
+// Permissions
+export { checkPermission, requestPermission } from './permissions/permissions.web';