1. /**
  2. * Binary File Handling Utility - Optimized for Memory Usage
  3. */
  4. const binaryFileHandler = {
  6. /**
  7. * Reads a binary file into a Uint8Array.
  8. * @param {File} file The File object to read.
  9. * @returns {Promise<Uint8Array>} A Promise resolving to the Uint8Array.
  10. * @throws {Error} If file reading fails.
  11. */
  12. readBinaryFile: async (file) => {
  13. return new Promise((resolve, reject) => {
  14. const reader = new FileReader();
  16. reader.onload = (event) => {
  17. resolve(new Uint8Array(event.target.result));
  18. };
  20. reader.onerror = (error) => {
  21. reject(error);
  22. };
  24. reader.readAsArrayBuffer(file); // Read as ArrayBuffer for efficient processing
  25. });
  26. },
  28. /**
  29. * Writes a Uint8Array to a binary file.
  30. * @param {Uint8Array} data The data to write.
  31. * @param {string} filePath The file path to write to.
  32. * @returns {Promise<void>} A Promise resolving when the write is complete.
  33. * @throws {Error} If file writing fails.
  34. */
  35. writeBinaryFile: async (data, filePath) => {
  36. return new Promise((resolve, reject) => {
  37. const writer = new FileWriter(filePath, 'w'); // Use FileWriter for file writing
  39. writer.write(data);
  41. writer.onwriteend = () => {
  42. resolve();
  43. };
  45. writer.onerror = (error) => {
  46. reject(error);
  47. };
  48. });
  49. },
  51. /**
  52. * Calculates the MD5 hash of a Uint8Array.
  53. * @param {Uint8Array} data The data to hash.
  54. * @returns {string} The MD5 hash in hexadecimal format.
  55. */
  56. calculateMD5: (data) => {
  57. const crypto = require('crypto'); // Ensure crypto is available (Node.js environment)
  58. const hash = crypto.createHash('md5');
  59. hash.update(data);
  60. return hash.digest('hex');
  61. },
  63. /**
  64. * Calculates the SHA256 hash of a Uint8Array.
  65. * @param {Uint8Array} data The data to hash.
  66. * @returns {string} The SHA256 hash in hexadecimal format.
  67. */
  68. calculateSHA256: (data) => {
  69. const crypto = require('crypto');
  70. const hash = crypto.createHash('sha256');
  71. hash.update(data);
  72. return hash.digest('hex');
  73. },
  75. /**
  76. * Efficiently reads a binary file in chunks.
  77. * @param {string} filePath The path to the binary file.
  78. * @param {number} chunkSize The size of each chunk to read (in bytes).
  79. * @returns {Promise<Uint8Array>} A Promise resolving to an array of Uint8Arrays.
  80. */
  81. readBinaryFileChunks: async (filePath, chunkSize) => {
  82. return new Promise((resolve, reject) => {
  83. const fs = require('fs'); // Ensure fs is available (Node.js environment)
  84. const fileStream = fs.createReadStream(filePath);
  85. const chunks = [];
  86. let currentChunk = [];
  88. fileStream.on('data', (chunk) => {
  89. currentChunk = currentChunk.concat(chunk);
  90. if (currentChunk.length >= chunkSize) {
  91. chunks.push(new Uint8Array(currentChunk));
  92. currentChunk = [];
  93. }
  94. });
  96. fileStream.on('end', () => {
  97. if (currentChunk.length > 0) {
  98. chunks.push(new Uint8Array(currentChunk));
  99. }
  100. resolve(chunks);
  101. });
  103. fileStream.on('error', (error) => {
  104. reject(error);
  105. });
  106. });
  107. },
  109. /**
  110. * Writes an array of Uint8Arrays to a binary file.
  111. * @param {Uint8Array[]} dataArray The array of Uint8Arrays to write.
  112. * @param {string} filePath The path to the file to write.
  113. * @returns {Promise<void>} A Promise that resolves when writing is complete.
  114. */
  115. writeBinaryFileChunks: async (dataArray,

Add your comment