refactor: optimize interface

Author: zeevenn

README.md

@@ -112,25 +112,25 @@ interface TrackMetadata {
   id: string;              // Track ID
 
   // audio header
-  duration?: number;       // Duration in seconds
-  bitrate?: number;        // Bitrate in kbps
-  sampleRate?: number;     // Sample rate in Hz
-  channels?: number;       // Number of channels
-  format?: string;         // Audio format
+  duration: number;       // Duration in seconds
+  bitrate: number;        // Bitrate in kbps
+  sampleRate: number;     // Sample rate in Hz
+  channels: number;       // Number of channels
+  format: string;         // Audio format
 
   // tag info
-  title?: string;          // Track title
-  artist?: string;         // Artist name
-  album?: string;          // Album name
-  year?: number;           // Release year
-  genre?: string;          // Music genre
-  track?: number;          // Track number
-  disc?: number;           // Disc number
-  composer?: string;       // Composer
-  lyricist?: string;       // Lyricist
-  lyrics?: string;         // Lyrics content
-  albumArtist?: string;    // Album artist
-  comment?: string;        // Comment
+  title: string;          // Track title
+  artist: string;         // Artist name
+  album: string;          // Album name
+  year: number;           // Release year
+  genre: string;          // Music genre
+  track: number;          // Track number
+  disc: number;           // Disc number
+  composer: string;       // Composer
+  lyricist: string;       // Lyricist
+  lyrics: string;         // Lyrics content
+  albumArtist: string;    // Album artist
+  comment: string;        // Comment
 }
 ```
 
@@ -152,16 +152,15 @@ console.log('Additional metadata:', metadata.additionalMetadata);
 ```typescript
 interface Track {
   id: string;
-  title: string;           // Track title
-  artist?: string;         // Artist name
-  artwork?: string;        // Artwork file URI
-  album?: string;          // Album name
-  lyrics?: string          // Lyrics
-  duration: number;        // Duration in seconds
-  url: string;             // File URL or path
-  createdAt?: number;      // Date added (Unix timestamp)
-  modifiedAt?: number;     // Date modified (Unix timestamp)
-  fileSize?: number;       // File size in bytes
+  title: string;          // Track title
+  artist: string;         // Artist name
+  artwork: string;        // Artwork file URI
+  album: string;          // Album name
+  duration: number;       // Duration in seconds
+  url: string;            // File URL or path
+  createdAt: number;      // Date added (Unix timestamp)
+  modifiedAt: number;     // Date modified (Unix timestamp)
+  fileSize: number;       // File size in bytes
 }
 ```
 

README_ZH.md

@@ -112,25 +112,25 @@ interface TrackMetadata {
   id: string;              // 曲目 ID
 
   // audio header
-  duration?: number;       // 持续时间（秒）
-  bitrate?: number;        // 比特率（kbps）
-  sampleRate?: number;     // 采样率（Hz）
-  channels?: number;       // 通道数
-  format?: string;         // 音频格式
+  duration: number;       // 持续时间（秒）
+  bitrate: number;        // 比特率（kbps）
+  sampleRate: number;     // 采样率（Hz）
+  channels: number;       // 通道数
+  format: string;         // 音频格式
 
   // tag info
-  title?: string;          // 曲目标题
-  artist?: string;         // 艺术家名称
-  album?: string;          // 专辑名称
-  year?: number;           // 发行年份
-  genre?: string;          // 音乐流派
-  track?: number;          // 曲目编号
-  disc?: number;           // 碟片编号
-  composer?: string;       // 作曲家
-  lyricist?: string;       // 作词家
-  lyrics?: string;         // 歌词内容
-  albumArtist?: string;    // 专辑艺术家
-  comment?: string;        // 注释
+  title: string;          // 曲目标题
+  artist: string;         // 艺术家名称
+  album: string;          // 专辑名称
+  year: number;           // 发行年份
+  genre: string;          // 音乐流派
+  track: number;          // 曲目编号
+  disc: number;           // 碟片编号
+  composer: string;       // 作曲家
+  lyricist: string;       // 作词家
+  lyrics: string;         // 歌词内容
+  albumArtist: string;    // 专辑艺术家
+  comment: string;        // 注释
 }
 ```
 
@@ -152,15 +152,15 @@ console.log('额外元数据:', metadata.additionalMetadata);
 ```typescript
 interface Track {
   id: string;
-  title: string;           // 曲目标题
-  artist?: string;         // 艺术家名称
-  artwork?: string;        // 专辑封面 URI
-  album?: string;          // 专辑名称
-  duration: number;        // 持续时间（秒）
-  url: string;             // 文件 URL 或路径
-  createdAt?: number;      // 添加日期（Unix 时间戳）
-  modifiedAt?: number;     // 修改日期（Unix 时间戳）
-  fileSize?: number;       // 文件大小（字节）
+  title: string;          // 曲目标题
+  artist: string;         // 艺术家名称
+  artwork: string;        // 专辑封面 URI
+  album: string;          // 专辑名称
+  duration: number;       // 持续时间（秒）
+  url: string;            // 文件 URL 或路径
+  createdAt: number;      // 添加日期（Unix 时间戳）
+  modifiedAt: number;     // 修改日期（Unix 时间戳）
+  fileSize: number;       // 文件大小（字节）
 }
 ```
 

src/NativeMusicLibrary.ts

@@ -101,13 +101,13 @@ export interface Track {
   title: string;
 
   /** Artist name */
-  artist?: string;
+  artist: string;
 
   /** Track artwork (file URI) */
-  artwork?: string;
+  artwork: string;
 
   /** Album name */
-  album?: string;
+  album: string;
 
   /** Duration in seconds */
   duration: number;
@@ -116,10 +116,10 @@ export interface Track {
   url: string;
 
   /** Date added to library (Unix timestamp, optional) */
-  createdAt?: number;
+  createdAt: number;
 
   /** Date modified (Unix timestamp, optional) */
-  modifiedAt?: number;
+  modifiedAt: number;
 
   /** File size in bytes */
   fileSize: number;
@@ -130,25 +130,25 @@ export interface TrackMetadata {
   id: string;
 
   /** Audio header */
-  duration?: number;
-  bitrate?: number;
-  sampleRate?: number;
-  channels?: number;
-  format?: string;
+  duration: number; // in seconds
+  bitrate: number; // in kbps
+  sampleRate: number; // in Hz
+  channels: number;
+  format: string;
 
   /** Tag info */
-  title?: string;
-  artist?: string;
-  album?: string;
-  year?: number;
-  genre?: string;
-  track?: number;
-  disc?: number;
-  composer?: string;
-  lyricist?: string;
-  lyrics?: string;
-  albumArtist?: string;
-  comment?: string;
+  title: string;
+  artist: string;
+  album: string;
+  year: number;
+  genre: string;
+  track: number;
+  disc: number;
+  composer: string;
+  lyricist: string;
+  lyrics: string;
+  albumArtist: string;
+  comment: string;
 }
 
 export interface Album {

src/NativeMusicLibrary.web.ts

@@ -62,6 +62,23 @@ const MusicLibrary: Spec = {
     showWebWarning();
     return {
       id: trackId,
+      duration: 0,
+      bitrate: 0,
+      sampleRate: 0,
+      channels: 0,
+      format: '',
+      title: '',
+      artist: '',
+      album: '',
+      year: 0,
+      genre: '',
+      track: 0,
+      disc: 0,
+      composer: '',
+      lyricist: '',
+      lyrics: '',
+      albumArtist: '',
+      comment: '',
     };
   },
 };