@karaplay/file-coder 1.3.5 → 1.3.7

package/BUG_FIX_SUMMARY.md

@@ -0,0 +1,101 @@
+# Bug Fix Summary - EMK to KAR Conversion
+
+## ปัญหาที่พบ (Problem Found)
+
+เมื่อแปลงไฟล์ EMK ที่มี MIDI data เสียหายเป็น KAR ได้รับ error message ที่เป็น "undefined":
+
+```
+Error: EMK to KAR conversion failed: undefined
+```
+
+## สาเหตุ (Root Cause)
+
+1. **Primary Issue**: Library `midi-file` throw string error แทนที่จะเป็น Error object
+2. **Code Issue**: ใน `src/emk-to-kar.ts` มีการ catch error และพยายามเข้าถึง `error.message` แต่เมื่อ error เป็น string จะไม่มี property `.message` จึงได้ค่า `undefined`
+3. **File Issue**: ไฟล์ `tests/emk/failed/failed_convert_emk_to_kar.emk` มี MIDI track 2 ที่ประกาศความยาว 1364 bytes แต่ข้อมูลจริงมี 1373 bytes (มากกว่า 9 bytes)
+
+## การแก้ไข (Solution)
+
+แก้ไข error handling ใน `src/emk-to-kar.ts` เพื่อรองรับทั้ง Error object และ string error:
+
+```typescript
+// Before (เดิม):
+throw new Error(`EMK to KAR conversion failed: ${error.message}`);
+
+// After (ใหม่):
+const errorMessage = typeof error === 'string' 
+  ? error 
+  : error?.message || String(error) || 'Unknown error';
+
+throw new Error(`EMK to KAR conversion failed: ${errorMessage}`);
+```
+
+## การทดสอบ (Testing)
+
+เพิ่มไฟล์ทดสอบใหม่ `tests/emk-error-handling.test.ts` ที่มี 4 test cases:
+
+1. ✅ รองรับ corrupted MIDI data พร้อม error message ที่ชัดเจน
+2. ✅ รองรับ string errors จาก third-party libraries
+3. ✅ รองรับ missing input files
+4. ✅ ให้ error message ที่เป็นประโยชน์สำหรับ corrupted EMK structure
+
+**ผลการทดสอบ: 135 tests passed** (รวม test cases ใหม่)
+
+## ผลลัพธ์ (Result)
+
+### Before (ก่อนแก้):
+```
+Error: EMK to KAR conversion failed: undefined
+```
+
+### After (หลังแก้):
+```
+Error: EMK to KAR conversion failed: Bad MIDI file. Expected 'MTrk', got: 'iF'
+```
+
+ตอนนี้ error message บอกปัญหาได้ชัดเจนว่า MIDI file มีปัญหาตรงไหน
+
+## เวอร์ชันที่ปล่อย (Release)
+
+- **Version**: 1.3.5
+- **Published**: December 19, 2025
+- **Package**: @karaplay/file-coder@1.3.5
+- **Status**: ✅ Successfully published to npm
+
+## วิธีอัพเดท (How to Update)
+
+```bash
+npm update @karaplay/file-coder
+```
+
+หรือ
+
+```bash
+npm install @karaplay/file-coder@1.3.5
+```
+
+## ไฟล์ที่แก้ไข (Files Modified)
+
+1. `src/emk-to-kar.ts` - ปรับปรุง error handling (2 locations)
+2. `tests/emk-error-handling.test.ts` - เพิ่ม test suite ใหม่
+3. `package.json` - อัพเดท version เป็น 1.3.5
+4. `RELEASE_v1.3.5.md` - เพิ่ม release notes
+
+## Technical Details
+
+ไฟล์ `failed_convert_emk_to_kar.emk` มีโครงสร้างดังนี้:
+- ✅ Decode EMK สำเร็จ
+- ✅ มี MIDI, Lyric, Cursor data ครบถ้วน
+- ❌ MIDI Track 2 มี length field ผิด (declare 1364 แต่จริง 1373)
+- ❌ ทำให้ MIDI parser หา track ถัดไปไม่เจอ (เจอ 'iF' แทน 'MTrk')
+
+นี่คือสถานการณ์จริงที่อาจเกิดขึ้นกับไฟล์ EMK ที่เสียหายหรือ encode ไม่ถูกต้อง
+
+## สรุป (Conclusion)
+
+✅ แก้ไข bug error handling สำเร็จ
+✅ เพิ่ม test coverage
+✅ ทุก tests ผ่านหมด (135/135)
+✅ Build สำเร็จ
+✅ Publish ไป npm สำเร็จ (v1.3.5)
+

package/FINAL_BUG_FIX_SUMMARY.md

@@ -0,0 +1,151 @@
+# สรุปการแก้ไข Bug - EMK to KAR Conversion
+
+## 🎯 ปัญหาที่แท้จริง (The Real Issue)
+
+คุณพูดถูกครับ! **ไฟล์ MIDI ไม่ได้เสียหาย** แต่มี **track length field ที่ผิด**
+
+### การวิเคราะห์:
+```
+Track 2:
+  - Declared length: 1364 bytes
+  - Actual length:   1373 bytes
+  - Difference:      +9 bytes
+
+ทำให้ MIDI parser หา track ถัดไปที่ตำแหน่งผิด:
+  - คาดหวัง: position 1431 จะเจอ "MTrk"
+  - แต่เจอ:   "iF" (ซึ่งเป็นข้อมูลภายใน track)
+  - ที่จริง:   "MTrk" อยู่ที่ position 1440
+```
+
+## ✅ วิธีแก้ (Solution)
+
+เพิ่มฟังก์ชัน `repairMidiTrackLengths()` ที่:
+
+1. **สแกนหา end-of-track marker** (`FF 2F 00`) ตำแหน่งจริง
+2. **คำนวณความยาวที่ถูกต้อง** จาก marker
+3. **สร้าง MIDI ใหม่** โดยแก้ไข track length fields
+4. **รายงานการแก้ไข** ผ่าน warnings
+
+### Code Implementation:
+
+```typescript
+export function repairMidiTrackLengths(midiBuffer: Buffer): {
+  repaired: Buffer;
+  fixed: boolean;
+  corrections: number;
+} {
+  // Scan each track for end-of-track marker
+  // Calculate actual length
+  // Rebuild MIDI with correct lengths
+}
+```
+
+### การใช้งาน:
+
+```typescript
+// แบบอัตโนมัติ (Auto-repair ใน convertEmkToKar)
+const result = convertEmkToKar({
+  inputEmk: 'song.emk',
+  outputKar: 'song.kar'
+});
+// ✅ Success! warnings: ['Fixed 1 MIDI track length(s)']
+
+// แบบ Manual
+const repaired = repairMidiTrackLengths(midiBuffer);
+if (repaired.fixed) {
+  console.log(`Fixed ${repaired.corrections} track(s)`);
+}
+```
+
+## 📊 ผลการทดสอบ (Test Results)
+
+### Before (v1.3.5):
+```
+❌ Error: EMK to KAR conversion failed: Bad MIDI file. Expected 'MTrk', got: 'iF'
+```
+
+### After (v1.3.6):
+```
+✅ [1/3] Decoding EMK file
+✅ [1/3] ✓ Decoded to: MIDI, Lyric, Cursor  
+✅ [2/3] Converting to KAR: 14 อีกครั้ง - โลโซ (Loso)
+✅ [3/3] ✓ KAR file created: 24,770 bytes
+
+Result:
+  - Success: true
+  - Warnings: ['Fixed 1 MIDI track length(s)', ...]
+  - Output: Valid KAR file with 12 tracks
+  - Metadata: "14 อีกครั้ง " - "โลโซ (Loso)"
+```
+
+### All Tests:
+- **136 tests passed** ✅
+- Including:
+  - ✅ MIDI repair with incorrect lengths
+  - ✅ Don't modify correct MIDIs
+  - ✅ EMK to KAR with auto-repair
+  - ✅ Error handling
+  - ✅ Edge cases
+
+## 🔧 การเปลี่ยนแปลง (Changes)
+
+### ไฟล์ที่แก้ไข:
+1. **src/emk-to-kar.ts**
+   - เพิ่ม `repairMidiTrackLengths()` function (70+ lines)
+   - ใช้ repair function อัตโนมัติก่อน save MIDI
+   - ปรับปรุง error handling
+
+2. **src/index.ts**
+   - Export `repairMidiTrackLengths` เพื่อให้ใช้แบบ manual
+
+3. **tests/emk-error-handling.test.ts**
+   - อัพเดท tests ให้ cover repair functionality
+   - เพิ่ม test cases สำหรับ repair function
+
+### Version History:
+- **v1.3.5**: Fixed error handling (string errors)
+- **v1.3.6**: Added MIDI repair function ⭐
+
+## 📦 Publication
+
+- **Package**: @karaplay/file-coder
+- **Version**: 1.3.6
+- **Status**: ✅ Successfully published to npm
+- **Published**: December 19, 2025
+
+### ตรวจสอบ:
+```bash
+$ npm view @karaplay/file-coder version
+1.3.6
+
+$ npm view @karaplay/file-coder versions --json
+[... "1.3.5", "1.3.6"]
+```
+
+## 🎓 สิ่งที่เรียนรู้ (Lessons Learned)
+
+1. **ไม่ใช่ทุกอย่างที่เป็น error จะเป็น bug**
+   - ก่อนหน้าคิดว่าไฟล์เสียหาย → แต่จริงๆ แค่ metadata ผิด
+   - MIDI data เองใช้งานได้ปกติ
+
+2. **การแก้ปัญหาต้องแก้ที่ root cause**
+   - แค่ปรับ error message ไม่พอ (v1.3.5)
+   - ต้อง **fix the actual problem** (v1.3.6)
+
+3. **Defensive programming**
+   - เพิ่ม auto-repair ทำให้ library robust ขึ้น
+   - User ไม่ต้องทำอะไรเอง
+
+## 🎉 สรุป (Summary)
+
+| Aspect | Result |
+|--------|--------|
+| ปัญหา | MIDI track length ไม่ถูกต้อง ทำให้แปลงไม่ได้ |
+| วิธีแก้ | เพิ่ม automatic MIDI repair function |
+| Tests | 136/136 passed ✅ |
+| Published | v1.3.6 ✅ |
+| Breaking Changes | None |
+| User Action Required | None (auto-repair) |
+
+**คุณพูดถูกครับ - ไฟล์ไม่ได้เสียหาย มันแค่ต้องการการ "ซ่อมแซม" เล็กน้อย! ตอนนี้ library จะจัดการให้อัตโนมัติแล้ว** 🚀
+

package/RELEASE_v1.3.3.md

@@ -0,0 +1,84 @@
+# Release v1.3.4
+
+**Release Date:** December 19, 2025
+
+## Bug Fixes
+
+### Fixed Error Handling for Corrupted MIDI Data
+
+**Issue:** When converting EMK files with corrupted MIDI data, the error message was showing as "undefined" because the `midi-file` library throws string errors instead of Error objects.
+
+**Root Cause:** The EMK to KAR conversion function was catching errors and trying to access `error.message`, but when third-party libraries throw string errors (not Error objects), the `.message` property is undefined.
+
+**Solution:** Updated error handling in `convertEmkToKar` to properly handle both Error objects and string errors:
+
+```typescript
+// Handle both Error objects and string errors (some libraries throw strings)
+const errorMessage = typeof error === 'string' 
+  ? error 
+  : error?.message || String(error) || 'Unknown error';
+
+throw new Error(`EMK to KAR conversion failed: ${errorMessage}`);
+```
+
+**Impact:**
+- ✅ Error messages are now always informative and actionable
+- ✅ Users will see the actual MIDI parsing error (e.g., "Bad MIDI file. Expected 'MTrk', got: 'iF'")
+- ✅ No more "undefined" error messages
+- ✅ Better debugging for corrupted EMK files
+
+## Test Coverage
+
+Added comprehensive test suite `emk-error-handling.test.ts` with 4 test cases:
+
+1. ✅ Handles corrupted MIDI data with proper error message
+2. ✅ Handles string errors from third-party libraries
+3. ✅ Handles missing input files with proper error
+4. ✅ Provides informative errors for corrupted EMK structure
+
+**All 135 tests pass**, including the new error handling tests.
+
+## Example
+
+**Before (v1.3.2):**
+```
+Error: EMK to KAR conversion failed: undefined
+```
+
+**After (v1.3.3):**
+```
+Error: EMK to KAR conversion failed: Bad MIDI file. Expected 'MTrk', got: 'iF'
+```
+
+## Technical Details
+
+### The Corrupted File Case
+
+The test file `tests/emk/failed/failed_convert_emk_to_kar.emk` contains:
+- Valid EMK structure that decodes successfully
+- MIDI data with 8 tracks (format 1, 96 ticks per beat)
+- Track 2 has an incorrect length field (declares 1364 bytes but actually contains 1373 bytes)
+- This causes the MIDI parser to look for the next track at the wrong position
+- The parser encounters 'iF' (part of track data) instead of 'MTrk' (track header)
+
+This is a real-world scenario that can occur with corrupted or improperly encoded EMK files.
+
+## Files Changed
+
+- `src/emk-to-kar.ts` - Improved error handling
+- `tests/emk-error-handling.test.ts` - New comprehensive test suite
+
+## Upgrade Notes
+
+No breaking changes. This is a patch release that improves error messages only.
+
+Upgrade with:
+```bash
+npm update @karaplay/file-coder
+```
+
+Or install specifically:
+```bash
+npm install @karaplay/file-coder@1.3.3
+```
+

package/RELEASE_v1.3.4.md

@@ -0,0 +1,84 @@
+# Release v1.3.4
+
+**Release Date:** December 19, 2025
+
+## Bug Fixes
+
+### Fixed Error Handling for Corrupted MIDI Data
+
+**Issue:** When converting EMK files with corrupted MIDI data, the error message was showing as "undefined" because the `midi-file` library throws string errors instead of Error objects.
+
+**Root Cause:** The EMK to KAR conversion function was catching errors and trying to access `error.message`, but when third-party libraries throw string errors (not Error objects), the `.message` property is undefined.
+
+**Solution:** Updated error handling in `convertEmkToKar` to properly handle both Error objects and string errors:
+
+```typescript
+// Handle both Error objects and string errors (some libraries throw strings)
+const errorMessage = typeof error === 'string' 
+  ? error 
+  : error?.message || String(error) || 'Unknown error';
+
+throw new Error(`EMK to KAR conversion failed: ${errorMessage}`);
+```
+
+**Impact:**
+- ✅ Error messages are now always informative and actionable
+- ✅ Users will see the actual MIDI parsing error (e.g., "Bad MIDI file. Expected 'MTrk', got: 'iF'")
+- ✅ No more "undefined" error messages
+- ✅ Better debugging for corrupted EMK files
+
+## Test Coverage
+
+Added comprehensive test suite `emk-error-handling.test.ts` with 4 test cases:
+
+1. ✅ Handles corrupted MIDI data with proper error message
+2. ✅ Handles string errors from third-party libraries
+3. ✅ Handles missing input files with proper error
+4. ✅ Provides informative errors for corrupted EMK structure
+
+**All 135 tests pass**, including the new error handling tests.
+
+## Example
+
+**Before (v1.3.2):**
+```
+Error: EMK to KAR conversion failed: undefined
+```
+
+**After (v1.3.3):**
+```
+Error: EMK to KAR conversion failed: Bad MIDI file. Expected 'MTrk', got: 'iF'
+```
+
+## Technical Details
+
+### The Corrupted File Case
+
+The test file `tests/emk/failed/failed_convert_emk_to_kar.emk` contains:
+- Valid EMK structure that decodes successfully
+- MIDI data with 8 tracks (format 1, 96 ticks per beat)
+- Track 2 has an incorrect length field (declares 1364 bytes but actually contains 1373 bytes)
+- This causes the MIDI parser to look for the next track at the wrong position
+- The parser encounters 'iF' (part of track data) instead of 'MTrk' (track header)
+
+This is a real-world scenario that can occur with corrupted or improperly encoded EMK files.
+
+## Files Changed
+
+- `src/emk-to-kar.ts` - Improved error handling
+- `tests/emk-error-handling.test.ts` - New comprehensive test suite
+
+## Upgrade Notes
+
+No breaking changes. This is a patch release that improves error messages only.
+
+Upgrade with:
+```bash
+npm update @karaplay/file-coder
+```
+
+Or install specifically:
+```bash
+npm install @karaplay/file-coder@1.3.4
+```
+

package/RELEASE_v1.3.6.md

@@ -0,0 +1,124 @@
+# Release v1.3.6
+
+**Release Date:** December 19, 2025
+
+## 🎉 Major Bug Fix: MIDI Track Length Repair
+
+### Problem
+EMK files that were correctly encoded but contained MIDI data with incorrect track length fields would fail to convert to KAR format with the error:
+```
+Error: EMK to KAR conversion failed: Bad MIDI file. Expected 'MTrk', got: 'iF'
+```
+
+### Root Cause
+Some EMK files contain valid MIDI data, but the track length fields in the MIDI headers are incorrect. For example:
+- Track 2 declares length = 1364 bytes
+- Actual track data = 1373 bytes (9 bytes longer)
+- The MIDI parser looks for the next track at the wrong position and fails
+
+This is **not corrupted data** - the MIDI content itself is valid, just the metadata is wrong.
+
+### Solution
+Added automatic MIDI repair function `repairMidiTrackLengths()` that:
+1. Scans MIDI tracks for the actual end-of-track marker (`FF 2F 00`)
+2. Calculates the correct track length
+3. Rebuilds the MIDI file with corrected length fields
+4. Reports the number of tracks fixed in warnings
+
+The repair happens automatically during EMK to KAR conversion, so no user action required!
+
+### Example
+
+**Before (v1.3.5)**:
+```javascript
+const result = convertEmkToKar({
+  inputEmk: 'song.emk',
+  outputKar: 'song.kar'
+});
+// Error: Bad MIDI file. Expected 'MTrk', got: 'iF'
+```
+
+**After (v1.3.6)**:
+```javascript
+const result = convertEmkToKar({
+  inputEmk: 'song.emk',
+  outputKar: 'song.kar'
+});
+// ✅ Success!
+// warnings: ['Fixed 1 MIDI track length(s)']
+```
+
+## New Features
+
+### 1. `repairMidiTrackLengths()` Function
+Exported function for manually repairing MIDI files:
+
+```typescript
+import { repairMidiTrackLengths } from '@karaplay/file-coder';
+
+const midiBuffer = fs.readFileSync('song.mid');
+const result = repairMidiTrackLengths(midiBuffer);
+
+if (result.fixed) {
+  console.log(`Fixed ${result.corrections} track(s)`);
+  fs.writeFileSync('song_fixed.mid', result.repaired);
+}
+```
+
+### 2. Enhanced Error Messages
+Improved error handling from v1.3.5 to properly catch string errors from third-party libraries.
+
+## Files Changed
+
+- `src/emk-to-kar.ts` - Added MIDI repair function and integration
+- `src/index.ts` - Exported `repairMidiTrackLengths`
+- `tests/emk-error-handling.test.ts` - Updated tests to verify repair functionality
+
+## Test Coverage
+
+**136 tests passed**, including:
+- ✅ MIDI repair with incorrect track lengths
+- ✅ MIDI repair doesn't modify correct files
+- ✅ EMK to KAR conversion with auto-repair
+- ✅ Error handling for string errors
+- ✅ Missing file handling
+
+## Technical Details
+
+The repair function:
+- Searches for end-of-track markers within declared length + 10% buffer
+- Handles edge cases where files are truncated
+- Preserves original file if no issues found
+- Returns detailed information about fixes applied
+
+## Impact
+
+This fix allows conversion of previously "failed" EMK files that actually contain valid data. The failed file at `tests/emk/failed/failed_convert_emk_to_kar.emk` now converts successfully:
+
+```
+✓ KAR file created: 24,770 bytes
+✓ Valid MIDI with 12 tracks
+Metadata: "14 อีกครั้ง" - "โลโซ (Loso)"
+```
+
+## Upgrade Notes
+
+**No breaking changes.** The repair happens automatically - existing code continues to work but now handles more files successfully.
+
+### Upgrade:
+```bash
+npm install @karaplay/file-coder@1.3.6
+```
+
+Or:
+```bash
+npm update @karaplay/file-coder
+```
+
+## Summary
+
+- 🐛 Fixed: EMK files with incorrect MIDI track lengths now convert successfully
+- ✨ New: `repairMidiTrackLengths()` function for manual MIDI repair
+- ✅ Tests: 136/136 passed
+- 📦 Ready: Published to npm as v1.3.6
+

package/RELEASE_v1.3.7.md

@@ -0,0 +1,69 @@
+# Release v1.3.7
+
+**Release Date:** December 19, 2025
+
+## Bug Fix: Package Export Path
+
+### Problem
+Other packages (like `@karaplay/kar-player`) that imported `@karaplay/file-coder/dist/client` were getting a module not found error:
+
+```
+Module not found: Package path ./dist/client is not exported from package 
+@karaplay/file-coder (see exports field in package.json)
+```
+
+### Root Cause
+The package had an export for `./client` but not for `./dist/client`, even though some packages imported it using the full path.
+
+### Solution
+Added explicit export path for `./dist/client` in package.json:
+
+```json
+"exports": {
+  ".": {
+    "types": "./dist/index.d.ts",
+    "default": "./dist/index.js"
+  },
+  "./client": {
+    "types": "./dist/client.d.ts",
+    "default": "./dist/client.js"
+  },
+  "./dist/client": {
+    "types": "./dist/client.d.ts",
+    "default": "./dist/client.js"
+  }
+}
+```
+
+### Impact
+- ✅ Packages can now import using either `@karaplay/file-coder/client` or `@karaplay/file-coder/dist/client`
+- ✅ Backward compatible - existing imports continue to work
+- ✅ All 136 tests pass
+
+## Test Results
+```
+Test Suites: 11 passed, 11 total
+Tests:       136 passed, 136 total
+```
+
+## Changes
+- **package.json**: Added `./dist/client` export path
+
+## Upgrade Notes
+No breaking changes. Update with:
+
+```bash
+npm install @karaplay/file-coder@1.3.7
+```
+
+Or:
+
+```bash
+npm update @karaplay/file-coder
+```
+
+## Version History
+- v1.3.5: Fixed error handling for string errors
+- v1.3.6: Added MIDI repair function for incorrect track lengths
+- v1.3.7: Fixed package export path for `./dist/client` ⭐
+

package/dist/emk-to-kar.d.ts

@@ -2,6 +2,16 @@
  * EMK to KAR Workflow
  * Complete pipeline: EMK file → decode → MIDI + LYR + CUR → convert → KAR file
  */
+/**
+ * Repairs MIDI file with incorrect track lengths by finding actual end-of-track markers
+ * Some EMK files contain MIDI data with incorrect track length fields
+ * This function scans for FF 2F 00 (end of track) markers and corrects the lengths
+ */
+export declare function repairMidiTrackLengths(midiBuffer: Buffer): {
+    repaired: Buffer;
+    fixed: boolean;
+    corrections: number;
+};
 export interface EmkToKarOptions {
     inputEmk: string;
     outputKar: string;

package/dist/emk-to-kar.js

@@ -37,6 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.repairMidiTrackLengths = repairMidiTrackLengths;
 exports.convertEmkToKar = convertEmkToKar;
 exports.convertEmkToKarBatch = convertEmkToKarBatch;
 exports.validateThaiLyricReadability = validateThaiLyricReadability;
@@ -45,6 +46,78 @@ const path = __importStar(require("path"));
 const server_decode_1 = require("./emk/server-decode");
 const ncntokar_1 = require("./ncntokar");
 const iconv = __importStar(require("iconv-lite"));
+/**
+ * Repairs MIDI file with incorrect track lengths by finding actual end-of-track markers
+ * Some EMK files contain MIDI data with incorrect track length fields
+ * This function scans for FF 2F 00 (end of track) markers and corrects the lengths
+ */
+function repairMidiTrackLengths(midiBuffer) {
+    // Check if it's a valid MIDI file
+    if (midiBuffer.length < 14 || midiBuffer.subarray(0, 4).toString('ascii') !== 'MThd') {
+        return { repaired: midiBuffer, fixed: false, corrections: 0 };
+    }
+    const headerLength = midiBuffer.readUInt32BE(4);
+    if (headerLength !== 6) {
+        return { repaired: midiBuffer, fixed: false, corrections: 0 };
+    }
+    const numTracks = midiBuffer.readUInt16BE(10);
+    let corrections = 0;
+    const chunks = [];
+    // Copy header
+    chunks.push(midiBuffer.subarray(0, 14));
+    let pos = 14;
+    for (let trackIdx = 0; trackIdx < numTracks && pos < midiBuffer.length - 8; trackIdx++) {
+        const chunkType = midiBuffer.subarray(pos, pos + 4).toString('ascii');
+        if (chunkType !== 'MTrk') {
+            // Invalid chunk, return original
+            return { repaired: midiBuffer, fixed: false, corrections };
+        }
+        const declaredLength = midiBuffer.readUInt32BE(pos + 4);
+        const trackDataStart = pos + 8;
+        // Search for end of track marker (FF 2F 00)
+        // Search within declared length + extra buffer (some EMK files have incorrect track lengths)
+        let actualEndPos = -1;
+        const extraBuffer = Math.max(100, Math.floor(declaredLength * 0.1)); // 10% or 100 bytes, whichever is larger
+        const searchLimit = Math.min(trackDataStart + declaredLength + extraBuffer, midiBuffer.length - 2);
+        for (let i = trackDataStart; i < searchLimit; i++) {
+            if (midiBuffer[i] === 0xFF && midiBuffer[i + 1] === 0x2F && midiBuffer[i + 2] === 0x00) {
+                actualEndPos = i + 3; // Include the 3 bytes of end marker
+                break;
+            }
+        }
+        if (actualEndPos === -1) {
+            // No end marker found, use declared length
+            chunks.push(midiBuffer.subarray(pos, trackDataStart + declaredLength));
+            pos = trackDataStart + declaredLength;
+            continue;
+        }
+        const actualLength = actualEndPos - trackDataStart;
+        if (actualLength !== declaredLength) {
+            // Need to fix the length
+            corrections++;
+            // Create new track chunk with correct length
+            const trackHeader = Buffer.alloc(8);
+            trackHeader.write('MTrk', 0, 'ascii');
+            trackHeader.writeUInt32BE(actualLength, 4);
+            chunks.push(trackHeader);
+            chunks.push(midiBuffer.subarray(trackDataStart, actualEndPos));
+            pos = actualEndPos;
+        }
+        else {
+            // Length is correct
+            chunks.push(midiBuffer.subarray(pos, trackDataStart + declaredLength));
+            pos = trackDataStart + declaredLength;
+        }
+    }
+    if (corrections > 0) {
+        return {
+            repaired: Buffer.concat(chunks),
+            fixed: true,
+            corrections
+        };
+    }
+    return { repaired: midiBuffer, fixed: false, corrections: 0 };
+}
 /**
  * Complete workflow: Converts EMK file directly to KAR file
  *
@@ -83,6 +156,12 @@ function convertEmkToKar(options) {
             throw new Error('Lyric data not found in EMK file');
         if (!decoded.cursor)
             throw new Error('Cursor data not found in EMK file');
+        // Repair MIDI track lengths if needed (some EMK files have incorrect track length fields)
+        const repairResult = repairMidiTrackLengths(decoded.midi);
+        if (repairResult.fixed) {
+            warnings.push(`Fixed ${repairResult.corrections} MIDI track length(s)`);
+            decoded.midi = repairResult.repaired;
+        }
         // Write intermediate files
         fs.writeFileSync(midiFile, decoded.midi);
         // Lyric is already in TIS-620 encoding from EMK decoder, write as-is

package/dist/index.d.ts

@@ -4,7 +4,7 @@
  */
 export { convertNcnToKar, convertWithDefaults, parseLyricFile, buildKaraokeTrack, buildMetadataTracks, readFileTextTIS620, splitLinesKeepEndings, trimLineEndings, metaEvent, endOfTrack, ensureReadableFile, ensureOutputDoesNotExist, CursorReader, type ConversionOptions, type SongMetadata } from './ncntokar';
 export { readKarFile, validateKarFile, extractLyricsFromKar, type KarFileInfo, type KarTrack } from './kar-reader';
-export { convertEmkToKar, convertEmkToKarBatch, validateThaiLyricReadability, type EmkToKarOptions, type EmkToKarResult } from './emk-to-kar';
+export { convertEmkToKar, convertEmkToKarBatch, validateThaiLyricReadability, repairMidiTrackLengths, type EmkToKarOptions, type EmkToKarResult } from './emk-to-kar';
 export { decodeEmk as decodeEmkServer, parseSongInfo as parseSongInfoServer, xorDecrypt as xorDecryptServer, looksLikeText as looksLikeTextServer, type DecodedEmkParts as DecodedEmkPartsServer } from './emk/server-decode';
 export { decodeEmk as decodeEmkClient, parseSongInfo as parseSongInfoClient, xorDecrypt as xorDecryptClient, looksLikeText as looksLikeTextClient, type DecodedEmkParts as DecodedEmkPartsClient } from './emk/client-decoder';
 export { convertNcnToKarBrowser, parseLyricBuffer, buildKaraokeTrackBrowser, buildMetadataTracksBrowser, fileToBuffer, downloadBuffer, type BrowserConversionOptions, type BrowserConversionResult, } from './ncntokar.browser';

package/dist/index.js

@@ -4,7 +4,7 @@
  * Supports .emk (Extreme Karaoke), .kar (MIDI karaoke), and NCN format conversions
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readKarFileFromBrowser = exports.extractLyricsFromKarBuffer = exports.validateKarBuffer = exports.readKarBuffer = exports.validateThaiLyricReadabilityBrowser = exports.convertEmkFilesBatch = exports.convertEmkFileToKar = exports.convertEmkToKarBrowser = exports.downloadBuffer = exports.fileToBuffer = exports.buildMetadataTracksBrowser = exports.buildKaraokeTrackBrowser = exports.parseLyricBuffer = exports.convertNcnToKarBrowser = exports.looksLikeTextClient = exports.xorDecryptClient = exports.parseSongInfoClient = exports.decodeEmkClient = exports.looksLikeTextServer = exports.xorDecryptServer = exports.parseSongInfoServer = exports.decodeEmkServer = exports.validateThaiLyricReadability = exports.convertEmkToKarBatch = exports.convertEmkToKar = exports.extractLyricsFromKar = exports.validateKarFile = exports.readKarFile = exports.CursorReader = exports.ensureOutputDoesNotExist = exports.ensureReadableFile = exports.endOfTrack = exports.metaEvent = exports.trimLineEndings = exports.splitLinesKeepEndings = exports.readFileTextTIS620 = exports.buildMetadataTracks = exports.buildKaraokeTrack = exports.parseLyricFile = exports.convertWithDefaults = exports.convertNcnToKar = void 0;
+exports.readKarFileFromBrowser = exports.extractLyricsFromKarBuffer = exports.validateKarBuffer = exports.readKarBuffer = exports.validateThaiLyricReadabilityBrowser = exports.convertEmkFilesBatch = exports.convertEmkFileToKar = exports.convertEmkToKarBrowser = exports.downloadBuffer = exports.fileToBuffer = exports.buildMetadataTracksBrowser = exports.buildKaraokeTrackBrowser = exports.parseLyricBuffer = exports.convertNcnToKarBrowser = exports.looksLikeTextClient = exports.xorDecryptClient = exports.parseSongInfoClient = exports.decodeEmkClient = exports.looksLikeTextServer = exports.xorDecryptServer = exports.parseSongInfoServer = exports.decodeEmkServer = exports.repairMidiTrackLengths = exports.validateThaiLyricReadability = exports.convertEmkToKarBatch = exports.convertEmkToKar = exports.extractLyricsFromKar = exports.validateKarFile = exports.readKarFile = exports.CursorReader = exports.ensureOutputDoesNotExist = exports.ensureReadableFile = exports.endOfTrack = exports.metaEvent = exports.trimLineEndings = exports.splitLinesKeepEndings = exports.readFileTextTIS620 = exports.buildMetadataTracks = exports.buildKaraokeTrack = exports.parseLyricFile = exports.convertWithDefaults = exports.convertNcnToKar = void 0;
 // NCN to KAR converter exports
 var ncntokar_1 = require("./ncntokar");
 Object.defineProperty(exports, "convertNcnToKar", { enumerable: true, get: function () { return ncntokar_1.convertNcnToKar; } });
@@ -30,6 +30,7 @@ var emk_to_kar_1 = require("./emk-to-kar");
 Object.defineProperty(exports, "convertEmkToKar", { enumerable: true, get: function () { return emk_to_kar_1.convertEmkToKar; } });
 Object.defineProperty(exports, "convertEmkToKarBatch", { enumerable: true, get: function () { return emk_to_kar_1.convertEmkToKarBatch; } });
 Object.defineProperty(exports, "validateThaiLyricReadability", { enumerable: true, get: function () { return emk_to_kar_1.validateThaiLyricReadability; } });
+Object.defineProperty(exports, "repairMidiTrackLengths", { enumerable: true, get: function () { return emk_to_kar_1.repairMidiTrackLengths; } });
 // EMK server-side decoder exports
 var server_decode_1 = require("./emk/server-decode");
 Object.defineProperty(exports, "decodeEmkServer", { enumerable: true, get: function () { return server_decode_1.decodeEmk; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karaplay/file-coder",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "A comprehensive library for encoding/decoding karaoke files (.emk, .kar, MIDI) with Next.js support. Convert EMK to KAR, read/write karaoke files, full browser and server support.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,6 +15,10 @@
     "./client": {
       "types": "./dist/client.d.ts",
       "default": "./dist/client.js"
+    },
+    "./dist/client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
     }
   },
   "scripts": {