fix: Cannot read properties of undefined (reading 'getEnforcing') in web

Author: zeevenn

README.md

@@ -39,6 +39,16 @@ or
 yarn add @nodefinity/react-native-music-library
 ```
 
+## Platform Support
+
+This library supports multiple platforms with automatic platform detection:
+
+- **Android**: Full native music library access  
+- **iOS**: Full native music library access (coming soon)
+- **Web**: Fallback implementation with warnings (for React Native Web projects)
+
+The library automatically provides the appropriate implementation based on your platform. On web, all methods will return empty results and show development warnings to help with development and testing.
+
 ### Android Setup
 
 For Android, add the following permission to your `android/app/src/main/AndroidManifest.xml`:

README_ZH.md

@@ -39,6 +39,16 @@ npm install @nodefinity/react-native-music-library
 yarn add @nodefinity/react-native-music-library
 ```
 
+## 平台支持
+
+此库支持多个平台，具有自动平台检测功能：
+
+- **Android**：完整的原生音乐库访问
+- **iOS**：完整的原生音乐库访问（即将推出）
+- **Web**：回退实现并提供警告（适用于 React Native Web 项目）
+
+该库会根据您的平台自动提供相应的实现。在 web 平台上，所有方法都会返回空结果并显示开发警告，以帮助开发和测试。
+
 ### Android 设置
 
 对于 Android，在 `android/app/src/main/AndroidManifest.xml` 中添加以下权限：

package.json

@@ -103,7 +103,10 @@
   "commitlint": {
     "extends": [
       "@commitlint/config-conventional"
-    ]
+    ],
+    "rules": {
+      "subject-case": [0]
+    }
   },
   "release-it": {
     "git": {

src/MusicLibraryImpl.native.ts

@@ -0,0 +1,19 @@
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+import type {
+  MusicLibraryModule,
+  InternalAssetsOptions,
+  TrackResult,
+  AlbumResult,
+  ArtistResult,
+  GenreResult,
+} from './types';
+
+interface Spec extends TurboModule, MusicLibraryModule {
+  getTracksAsync(options: InternalAssetsOptions): Promise<TrackResult>;
+  getAlbumsAsync(options: InternalAssetsOptions): Promise<AlbumResult>;
+  getArtistsAsync(options: InternalAssetsOptions): Promise<ArtistResult>;
+  getGenresAsync(options: InternalAssetsOptions): Promise<GenreResult>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('MusicLibrary');

src/MusicLibraryImpl.ts

@@ -0,0 +1,5 @@
+// This is the default implementation that exports the native module
+// React Native Metro bundler will pick platform-specific versions when available:
+// - MusicLibraryImpl.native.ts for iOS/Android
+// - MusicLibraryImpl.web.ts for web
+export { default } from './MusicLibraryImpl.native';

src/MusicLibraryImpl.web.ts

@@ -0,0 +1,61 @@
+import type {
+  MusicLibraryModule,
+  TrackResult,
+  AlbumResult,
+  ArtistResult,
+  GenreResult,
+} from './types';
+
+const showWebWarning = () => {
+  if (__DEV__) {
+    console.warn(
+      'MusicLibrary: This library is not supported on web platform. ' +
+        'Music library access is only available on iOS and Android.'
+    );
+  }
+};
+
+// Web fallback implementation
+const MusicLibrary: MusicLibraryModule = {
+  async getTracksAsync(): Promise<TrackResult> {
+    showWebWarning();
+    return {
+      items: [],
+      hasNextPage: false,
+      endCursor: undefined,
+      totalCount: 0,
+    };
+  },
+
+  async getAlbumsAsync(): Promise<AlbumResult> {
+    showWebWarning();
+    return {
+      items: [],
+      hasNextPage: false,
+      endCursor: undefined,
+      totalCount: 0,
+    };
+  },
+
+  async getArtistsAsync(): Promise<ArtistResult> {
+    showWebWarning();
+    return {
+      items: [],
+      hasNextPage: false,
+      endCursor: undefined,
+      totalCount: 0,
+    };
+  },
+
+  async getGenresAsync(): Promise<GenreResult> {
+    showWebWarning();
+    return {
+      items: [],
+      hasNextPage: false,
+      endCursor: undefined,
+      totalCount: 0,
+    };
+  },
+};
+
+export default MusicLibrary;

src/NativeMusicLibrary.ts

@@ -1,247 +1,10 @@
-import type { TurboModule } from 'react-native';
-import { TurboModuleRegistry } from 'react-native';
+// Re-export all types from the shared types file
+export * from './types';
 
-/**
- * Sorting keys for music library items
- */
-export type SortByKey =
-  | 'default'
-  | 'artist'
-  | 'album'
-  | 'duration'
-  | 'createdAt'
-  | 'modifiedAt'
-  | 'genre'
-  | 'trackCount';
-export type SortByValue = [SortByKey, boolean] | SortByKey;
+// Platform-specific module import
+// React Native Metro bundler will automatically pick the right file based on platform:
+// - MusicLibraryImpl.native.ts for iOS/Android
+// - MusicLibraryImpl.web.ts for web
+import MusicLibrary from './MusicLibraryImpl';
 
-export type InternalSortByValue = `${SortByKey} ${'ASC' | 'DESC'}`;
-
-export const SortByObject = {
-  default: 'default',
-  artist: 'artist',
-  album: 'album',
-  duration: 'duration',
-  createdAt: 'createdAt',
-  modifiedAt: 'modifiedAt',
-  genre: 'genre',
-  trackCount: 'trackCount',
-};
-
-/**
- * Basic assets options
- */
-export interface AssetsOptions {
-  /**
-   * Cursor for pagination - ID of the last item from previous page
-   * @default undefined
-   */
-  after?: string;
-
-  /**
-   * Maximum number of items to return
-   * @default 20
-   */
-  first?: number;
-
-  /**
-   * Sorting configuration
-   * Can be a single key or a tuple of [key, ascending]
-   * @example
-   * 'title' // Sort by title descending (default)
-   * ['title', true] // Sort by title ascending
-   */
-  sortBy?: SortByValue | SortByValue[];
-
-  /**
-   * Directory path to search for tracks
-   * @default undefined
-   */
-  directory?: string;
-}
-
-/**
- * Internal assets options used by native module
- */
-export interface InternalAssetsOptions {
-  after?: string;
-  first: number;
-  sortBy: InternalSortByValue[];
-  directory?: string;
-}
-
-export interface IPaginatedResult<T> {
-  /**
-   * Array of items returned
-   * @default []
-   */
-  items: T[];
-
-  /**
-   * Whether there are more items available
-   * @default false
-   */
-  hasNextPage: boolean;
-
-  /**
-   * Cursor for next page (ID of last item)
-   * @default undefined
-   */
-  endCursor?: string;
-
-  /**
-   * Total count of items (optional, may be expensive to compute)
-   * @default undefined
-   */
-  totalCount?: number;
-}
-
-export interface Track {
-  id: string;
-
-  /**
-   * Track title
-   * @default ''
-   */
-  title: string;
-
-  /** Track artwork (file URI) */
-  artwork: string;
-
-  /**
-   * Artist name
-   * @default ''
-   */
-  artist: string;
-
-  /**
-   * Album name
-   * @default ''
-   */
-  album: string;
-
-  /** Music genre */
-  genre: string;
-
-  /**
-   * Duration in seconds
-   * @default 0
-   */
-  duration: number;
-
-  /**
-   * File URI or path
-   * @default ''
-   */
-  uri: string;
-
-  /**
-   * Date added to library (Unix timestamp, optional)
-   * @default undefined
-   */
-  createdAt?: number;
-
-  /**
-   * Date modified (Unix timestamp, optional)
-   * @default undefined
-   */
-  modifiedAt?: number;
-
-  /**
-   * File size in bytes (optional)
-   * @default undefined
-   */
-  fileSize?: number;
-}
-
-export interface Album {
-  id: string;
-
-  /**
-   * Album name
-   * @default ''
-   */
-  title: string;
-
-  /**
-   * Primary artist
-   * @default ''
-   */
-  artist: string;
-
-  /**
-   * Album artwork (base64 encoded image or URL, optional)
-   * @default undefined
-   */
-  artwork?: string;
-
-  /**
-   * Number of tracks in album
-   * @default 0
-   */
-  trackCount: number;
-
-  /**
-   * Total duration in seconds
-   * @default 0
-   */
-  duration: number;
-
-  /**
-   * Release year (optional)
-   * @default undefined
-   */
-  year?: number;
-}
-
-export interface Artist {
-  id: string;
-
-  /**
-   * Artist name
-   * @default ''
-   */
-  title: string;
-
-  /**
-   * Number of albums
-   * @default 0
-   */
-  albumCount: number;
-
-  /**
-   * Total number of tracks
-   * @default 0
-   */
-  trackCount: number;
-}
-
-export interface Genre {
-  id: string;
-
-  /**
-   * Genre name
-   * @default ''
-   */
-  title: string;
-
-  /**
-   * Number of tracks in this genre
-   * @default 0
-   */
-  trackCount: number;
-}
-
-export type TrackResult = IPaginatedResult<Track>;
-export type AlbumResult = IPaginatedResult<Album>;
-export type ArtistResult = IPaginatedResult<Artist>;
-export type GenreResult = IPaginatedResult<Genre>;
-
-export interface Spec extends TurboModule {
-  getTracksAsync(options: InternalAssetsOptions): Promise<TrackResult>;
-  getAlbumsAsync(options: InternalAssetsOptions): Promise<AlbumResult>;
-  getArtistsAsync(options: InternalAssetsOptions): Promise<ArtistResult>;
-  getGenresAsync(options: InternalAssetsOptions): Promise<GenreResult>;
-}
-
-export default TurboModuleRegistry.getEnforcing<Spec>('MusicLibrary');
+export default MusicLibrary;