stegdoc 3.0.2 → 5.0.0

package/src/lib/utils.js

@@ -1,227 +1,227 @@
-const crypto = require('crypto');
-
-/**
- * Generate a random hash for file naming
- * @param {number} length - Length of hash in bytes (default 8)
- * @returns {string} Hexadecimal hash string
- */
-function generateHash(length = 8) {
-  return crypto.randomBytes(length).toString('hex');
-}
-
-/**
- * Generate SHA-256 hash of a buffer for integrity verification
- * @param {Buffer} buffer - Data to hash
- * @returns {string} Hexadecimal SHA-256 hash
- */
-function generateContentHash(buffer) {
-  return crypto.createHash('sha256').update(buffer).digest('hex');
-}
-
-/**
- * Parse size string to bytes
- * @param {string} sizeStr - Size string (e.g., "5MB", "100KB", "1GB")
- * @returns {number} Size in bytes
- */
-function parseSizeToBytes(sizeStr) {
-  if (typeof sizeStr === 'number') {
-    return sizeStr;
-  }
-
-  const units = {
-    B: 1,
-    KB: 1024,
-    MB: 1024 * 1024,
-    GB: 1024 * 1024 * 1024,
-  };
-
-  const match = sizeStr.trim().toUpperCase().match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)?$/);
-
-  if (!match) {
-    throw new Error(`Invalid size format: ${sizeStr}. Use format like "5MB", "100KB", etc.`);
-  }
-
-  const value = parseFloat(match[1]);
-  const unit = match[2] || 'B';
-
-  return Math.floor(value * units[unit]);
-}
-
-/**
- * Format bytes to human-readable string
- * @param {number} bytes - Number of bytes
- * @param {number} decimals - Number of decimal places (default 2)
- * @returns {string} Formatted size string
- */
-function formatBytes(bytes, decimals = 2) {
-  if (bytes === 0) return '0 B';
-
-  const k = 1024;
-  const dm = decimals < 0 ? 0 : decimals;
-  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
-
-  const i = Math.floor(Math.log(bytes) / Math.log(k));
-
-  return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
-}
-
-/**
- * Generate a realistic-looking filename that matches the decoy theme
- * Decoy data contains ~4 hours of server logs, so filenames reflect periodic reports
- *
- * @param {string} hash - Hash identifier (used internally for matching parts)
- * @param {number} partNumber - Part number (optional, for split files)
- * @param {number} totalParts - Total number of parts (optional)
- * @param {string} format - Output format ('xlsx' or 'docx'), default 'xlsx'
- * @returns {string} Realistic filename WITH extension
- */
-function generateFilename(hash, partNumber = null, totalParts = null, format = 'xlsx') {
-  const ext = format.toLowerCase() === 'docx' ? 'docx' : 'xlsx';
-
-  // Generate deterministic timestamp based on hash (so all parts match)
-  // Use different parts of hash for day and hour to get better distribution
-  const hashNumLow = parseInt(hash.slice(0, 8), 16) >>> 0;
-  const hashNumHigh = parseInt(hash.slice(8, 16), 16) >>> 0;
-  const daysAgo = hashNumLow % 7; // 0-6 days ago
-  const hourBlock = (hashNumHigh % 6) * 4; // 0, 4, 8, 12, 16, 20
-
-  const now = new Date();
-  const date = new Date(now.getTime() - daysAgo * 24 * 60 * 60 * 1000);
-
-  // Format date in local timezone (YYYYMMDD)
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, '0');
-  const day = String(date.getDate()).padStart(2, '0');
-  const dateStr = `${year}${month}${day}`;
-  const timeStr = String(hourBlock).padStart(2, '0') + '00'; // HH00
-
-  // Use last 4 chars of hash as a "report ID" to keep files linked
-  const reportId = hash.slice(-4).toUpperCase();
-
-  if (format === 'xlsx') {
-    // Server metrics theme - looks like periodic 4-hour monitoring exports
-    if (partNumber !== null && totalParts !== null) {
-      return `server_metrics_${dateStr}_${timeStr}_${reportId}_part${partNumber}.${ext}`;
-    }
-    return `server_metrics_${dateStr}_${timeStr}_${reportId}.${ext}`;
-  } else {
-    // DOCX - use a different theme
-    if (partNumber !== null && totalParts !== null) {
-      return `system_report_${dateStr}_${timeStr}_${reportId}_part${partNumber}.${ext}`;
-    }
-    return `system_report_${dateStr}_${timeStr}_${reportId}.${ext}`;
-  }
-}
-
-/**
- * Legacy alias for backward compatibility
- */
-function generateDocxFilename(hash, partNumber = null, totalParts = null) {
-  return generateFilename(hash, partNumber, totalParts, 'docx').replace(/\.docx$/, '');
-}
-
-/**
- * Parse filename to extract hash, part information, and format
- * @param {string} filename - Filename to parse
- * @returns {object} Object with hash, partNumber, totalParts, baseHash, format
- */
-function parseFilename(filename) {
-  // Detect format from extension
-  let format = 'xlsx';
-  let name = filename;
-
-  if (/\.docx$/i.test(filename)) {
-    format = 'docx';
-    name = filename.replace(/\.docx$/i, '');
-  } else if (/\.xlsx$/i.test(filename)) {
-    format = 'xlsx';
-    name = filename.replace(/\.xlsx$/i, '');
-  }
-
-  // Try new realistic filename format first
-  // Pattern: server_metrics_YYYYMMDD_HH00_XXXX[_partN]
-  // Or: system_report_YYYYMMDD_HH00_XXXX[_partN]
-  const realisticPattern = /^(server_metrics|system_report)_(\d{8})_(\d{4})_([A-F0-9]{4})(?:_part(\d+))?$/i;
-  const realisticMatch = name.match(realisticPattern);
-
-  if (realisticMatch) {
-    const [, prefix, dateStr, timeStr, reportId, partStr] = realisticMatch;
-    // Create a pseudo-hash from the components for matching purposes
-    // The reportId is the last 4 chars of the original hash
-    const baseIdentifier = `${dateStr}_${timeStr}_${reportId}`;
-
-    return {
-      hash: name,
-      baseHash: baseIdentifier,
-      partNumber: partStr ? parseInt(partStr, 10) : null,
-      totalParts: null, // Will be determined from metadata
-      format,
-      // Extra info for matching
-      reportId: reportId.toUpperCase(),
-      dateStr,
-      timeStr,
-    };
-  }
-
-  // Legacy: Check if it's a hex string (old format)
-  if (/^[a-f0-9]+$/i.test(name)) {
-    // Could be either single file or multi-part
-    // Single files are 16 chars (8 bytes), multi-part are 18+ chars (16 + 2 digit part number)
-
-    if (name.length === 16) {
-      // Single file
-      return {
-        hash: name,
-        baseHash: name,
-        partNumber: null,
-        totalParts: null,
-        format,
-      };
-    } else if (name.length >= 18) {
-      // Multi-part: last 2 chars are the part number
-      const baseHash = name.slice(0, -2);
-      const partNumber = parseInt(name.slice(-2), 10);
-
-      return {
-        hash: name,
-        baseHash: baseHash,
-        partNumber: partNumber,
-        totalParts: null, // Will be determined from metadata
-        format,
-      };
-    }
-  }
-
-  return null;
-}
-
-/**
- * Legacy alias for backward compatibility
- */
-function parseDocxFilename(filename) {
-  return parseFilename(filename);
-}
-
-/**
- * Detect file format from extension
- * @param {string} filename - Filename to check
- * @returns {string} 'xlsx', 'docx', or null if unknown
- */
-function detectFormat(filename) {
-  if (/\.xlsx$/i.test(filename)) return 'xlsx';
-  if (/\.docx$/i.test(filename)) return 'docx';
-  return null;
-}
-
-module.exports = {
-  generateHash,
-  generateContentHash,
-  parseSizeToBytes,
-  formatBytes,
-  generateFilename,
-  parseFilename,
-  detectFormat,
-  // Legacy aliases for backward compatibility
-  generateDocxFilename,
-  parseDocxFilename,
-};
+const crypto = require('crypto');
+
+/**
+ * Generate a random hash for file naming
+ * @param {number} length - Length of hash in bytes (default 8)
+ * @returns {string} Hexadecimal hash string
+ */
+function generateHash(length = 8) {
+  return crypto.randomBytes(length).toString('hex');
+}
+
+/**
+ * Generate SHA-256 hash of a buffer for integrity verification
+ * @param {Buffer} buffer - Data to hash
+ * @returns {string} Hexadecimal SHA-256 hash
+ */
+function generateContentHash(buffer) {
+  return crypto.createHash('sha256').update(buffer).digest('hex');
+}
+
+/**
+ * Parse size string to bytes
+ * @param {string} sizeStr - Size string (e.g., "5MB", "100KB", "1GB")
+ * @returns {number} Size in bytes
+ */
+function parseSizeToBytes(sizeStr) {
+  if (typeof sizeStr === 'number') {
+    return sizeStr;
+  }
+
+  const units = {
+    B: 1,
+    KB: 1024,
+    MB: 1024 * 1024,
+    GB: 1024 * 1024 * 1024,
+  };
+
+  const match = sizeStr.trim().toUpperCase().match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)?$/);
+
+  if (!match) {
+    throw new Error(`Invalid size format: ${sizeStr}. Use format like "5MB", "100KB", etc.`);
+  }
+
+  const value = parseFloat(match[1]);
+  const unit = match[2] || 'B';
+
+  return Math.floor(value * units[unit]);
+}
+
+/**
+ * Format bytes to human-readable string
+ * @param {number} bytes - Number of bytes
+ * @param {number} decimals - Number of decimal places (default 2)
+ * @returns {string} Formatted size string
+ */
+function formatBytes(bytes, decimals = 2) {
+  if (bytes === 0) return '0 B';
+
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
+}
+
+/**
+ * Generate a realistic-looking filename that matches the decoy theme
+ * Decoy data contains ~4 hours of server logs, so filenames reflect periodic reports
+ *
+ * @param {string} hash - Hash identifier (used internally for matching parts)
+ * @param {number} partNumber - Part number (optional, for split files)
+ * @param {number} totalParts - Total number of parts (optional)
+ * @param {string} format - Output format ('xlsx' or 'docx'), default 'xlsx'
+ * @returns {string} Realistic filename WITH extension
+ */
+function generateFilename(hash, partNumber = null, totalParts = null, format = 'xlsx') {
+  const ext = format.toLowerCase() === 'docx' ? 'docx' : 'xlsx';
+
+  // Generate deterministic timestamp based on hash (so all parts match)
+  // Use different parts of hash for day and hour to get better distribution
+  const hashNumLow = parseInt(hash.slice(0, 8), 16) >>> 0;
+  const hashNumHigh = parseInt(hash.slice(8, 16), 16) >>> 0;
+  const daysAgo = hashNumLow % 7; // 0-6 days ago
+  const hourBlock = (hashNumHigh % 6) * 4; // 0, 4, 8, 12, 16, 20
+
+  const now = new Date();
+  const date = new Date(now.getTime() - daysAgo * 24 * 60 * 60 * 1000);
+
+  // Format date in local timezone (YYYYMMDD)
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  const dateStr = `${year}${month}${day}`;
+  const timeStr = String(hourBlock).padStart(2, '0') + '00'; // HH00
+
+  // Use last 4 chars of hash as a "report ID" to keep files linked
+  const reportId = hash.slice(-4).toUpperCase();
+
+  if (format === 'xlsx') {
+    // Access log theme - looks like periodic nginx log exports
+    if (partNumber !== null) {
+      return `access_log_${dateStr}_${timeStr}_${reportId}_part${partNumber}.${ext}`;
+    }
+    return `access_log_${dateStr}_${timeStr}_${reportId}.${ext}`;
+  } else {
+    // DOCX - use a different theme
+    if (partNumber !== null) {
+      return `system_report_${dateStr}_${timeStr}_${reportId}_part${partNumber}.${ext}`;
+    }
+    return `system_report_${dateStr}_${timeStr}_${reportId}.${ext}`;
+  }
+}
+
+/**
+ * Legacy alias for backward compatibility
+ */
+function generateDocxFilename(hash, partNumber = null, totalParts = null) {
+  return generateFilename(hash, partNumber, totalParts, 'docx').replace(/\.docx$/, '');
+}
+
+/**
+ * Parse filename to extract hash, part information, and format
+ * @param {string} filename - Filename to parse
+ * @returns {object} Object with hash, partNumber, totalParts, baseHash, format
+ */
+function parseFilename(filename) {
+  // Detect format from extension
+  let format = 'xlsx';
+  let name = filename;
+
+  if (/\.docx$/i.test(filename)) {
+    format = 'docx';
+    name = filename.replace(/\.docx$/i, '');
+  } else if (/\.xlsx$/i.test(filename)) {
+    format = 'xlsx';
+    name = filename.replace(/\.xlsx$/i, '');
+  }
+
+  // Try new realistic filename format first
+  // Pattern: server_metrics_YYYYMMDD_HH00_XXXX[_partN]
+  // Or: system_report_YYYYMMDD_HH00_XXXX[_partN]
+  const realisticPattern = /^(server_metrics|system_report|access_log)_(\d{8})_(\d{4})_([A-F0-9]{4})(?:_part(\d+))?$/i;
+  const realisticMatch = name.match(realisticPattern);
+
+  if (realisticMatch) {
+    const [, prefix, dateStr, timeStr, reportId, partStr] = realisticMatch;
+    // Create a pseudo-hash from the components for matching purposes
+    // The reportId is the last 4 chars of the original hash
+    const baseIdentifier = `${dateStr}_${timeStr}_${reportId}`;
+
+    return {
+      hash: name,
+      baseHash: baseIdentifier,
+      partNumber: partStr ? parseInt(partStr, 10) : null,
+      totalParts: null, // Will be determined from metadata
+      format,
+      // Extra info for matching
+      reportId: reportId.toUpperCase(),
+      dateStr,
+      timeStr,
+    };
+  }
+
+  // Legacy: Check if it's a hex string (old format)
+  if (/^[a-f0-9]+$/i.test(name)) {
+    // Could be either single file or multi-part
+    // Single files are 16 chars (8 bytes), multi-part are 18+ chars (16 + 2 digit part number)
+
+    if (name.length === 16) {
+      // Single file
+      return {
+        hash: name,
+        baseHash: name,
+        partNumber: null,
+        totalParts: null,
+        format,
+      };
+    } else if (name.length >= 18) {
+      // Multi-part: last 2 chars are the part number
+      const baseHash = name.slice(0, -2);
+      const partNumber = parseInt(name.slice(-2), 10);
+
+      return {
+        hash: name,
+        baseHash: baseHash,
+        partNumber: partNumber,
+        totalParts: null, // Will be determined from metadata
+        format,
+      };
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Legacy alias for backward compatibility
+ */
+function parseDocxFilename(filename) {
+  return parseFilename(filename);
+}
+
+/**
+ * Detect file format from extension
+ * @param {string} filename - Filename to check
+ * @returns {string} 'xlsx', 'docx', or null if unknown
+ */
+function detectFormat(filename) {
+  if (/\.xlsx$/i.test(filename)) return 'xlsx';
+  if (/\.docx$/i.test(filename)) return 'docx';
+  return null;
+}
+
+module.exports = {
+  generateHash,
+  generateContentHash,
+  parseSizeToBytes,
+  formatBytes,
+  generateFilename,
+  parseFilename,
+  detectFormat,
+  // Legacy aliases for backward compatibility
+  generateDocxFilename,
+  parseDocxFilename,
+};