docxmlater 11.0.10 → 12.1.0

package/dist/xml/XMLParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"XMLParser.js","sourceRoot":"","sources":["../../src/xml/XMLParser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * XMLParser - Simple position-based XML parser\n * Avoids regex backtracking issues that can cause ReDoS attacks\n * Completes the DocXML framework (XMLBuilder + XMLParser)\n */\n\nimport { getGlobalLogger, createScopedLogger, ILogger } from '../utils/logger.js';\nimport { XMLBuilder } from './XMLBuilder.js';\n\n// Create scoped logger for XMLParser operations\nfunction getLogger(): ILogger {\n  return createScopedLogger(getGlobalLogger(), 'XMLParser');\n}\n\n/**\n * Default maximum nesting depth for XML parsing.\n * Prevents stack overflow on deeply nested documents.\n */\nexport const DEFAULT_MAX_NESTING_DEPTH = 256;\n\n/**\n * Options for XML-to-object parsing\n */\nexport interface ParseToObjectOptions {\n  /** Ignore attributes (default: false) */\n  ignoreAttributes?: boolean;\n\n  /** Attribute name prefix (default: '@_') */\n  attributeNamePrefix?: string;\n\n  /** Text node property name (default: '#text') */\n  textNodeName?: string;\n\n  /** Remove namespace prefixes from element names (default: false) */\n  ignoreNamespace?: boolean;\n\n  /** Parse numeric attribute values (default: true) */\n  parseAttributeValue?: boolean;\n\n  /** Trim whitespace from text values (default: true) */\n  trimValues?: boolean;\n\n  /** Always return arrays for elements (default: false) */\n  alwaysArray?: boolean;\n\n  /** Maximum nesting depth (default: 256). Prevents stack overflow on deeply nested documents. */\n  maxNestingDepth?: number;\n}\n\n/**\n * Parsed XML object structure\n * Can be a string, object, array, or nested structure\n */\nexport type ParsedXMLValue =\n  | string\n  | number\n  | boolean\n  | ParsedXMLObject\n  | ParsedXMLObject[]\n  | null\n  | undefined;\n\n/**\n * Parsed XML object with dynamic keys\n */\nexport interface ParsedXMLObject {\n  [key: string]: ParsedXMLValue;\n}\n\n/**\n * Internal structure for tracking parsed elements during parsing\n */\ninterface ParsedElement {\n  name: string;\n  value: ParsedXMLValue;\n}\n\n/**\n * Simple XML parser using position-based parsing instead of regex\n * Prevents catastrophic backtracking (ReDoS attacks) by avoiding nested regex patterns\n */\nexport class XMLParser {\n  /**\n   * Extracts the body content from a Word document XML\n   * @param docXml - The complete document.xml content\n   * @returns The body content, or empty string if not found\n   */\n  static extractBody(docXml: string): string {\n    const startTag = '<w:body';\n    const endTag = '</w:body>';\n\n    const startIdx = docXml.indexOf(startTag);\n    if (startIdx === -1) return '';\n\n    // Find the closing > of opening tag\n    const openEnd = docXml.indexOf('>', startIdx);\n    if (openEnd === -1) return '';\n\n    // Find matching closing tag\n    const endIdx = docXml.indexOf(endTag, openEnd);\n    if (endIdx === -1) return '';\n\n    return docXml.substring(openEnd + 1, endIdx);\n  }\n\n  /**\n   * Extracts all elements of a given type using position-based parsing\n   * Handles nested tags correctly by tracking depth\n   * @param xml - XML content to parse\n   * @param tagName - Tag name to extract (e.g., 'w:p', 'w:r')\n   * @returns Array of XML strings for each element\n   */\n  static extractElements(xml: string, tagName: string): string[] {\n    const elements: string[] = [];\n    const openTag = `<${tagName}`;\n    const closeTag = `</${tagName}>`;\n    const selfClosingEnd = '/>';\n\n    let pos = 0;\n    while (pos < xml.length) {\n      const startIdx = xml.indexOf(openTag, pos);\n      if (startIdx === -1) break;\n\n      // Verify this is the exact tag (not a prefix match like <w:p matching <w:pPr>)\n      // The character after the tag name must be either '>', '/', whitespace, or '=' (for attributes)\n      const charAfterTag = xml[startIdx + openTag.length];\n      if (\n        charAfterTag &&\n        charAfterTag !== '>' &&\n        charAfterTag !== '/' &&\n        charAfterTag !== ' ' &&\n        charAfterTag !== '\\t' &&\n        charAfterTag !== '\\n' &&\n        charAfterTag !== '\\r' &&\n        charAfterTag !== '='\n      ) {\n        // This is a prefix match (e.g., <w:pPr> when looking for <w:p>), skip it (Issue #5)\n        pos = startIdx + openTag.length;\n        continue;\n      }\n\n      // Find the end of opening tag\n      const openEnd = xml.indexOf('>', startIdx);\n      if (openEnd === -1) break;\n\n      // Check if self-closing\n      if (xml.substring(openEnd - 1, openEnd + 1) === selfClosingEnd) {\n        elements.push(xml.substring(startIdx, openEnd + 1));\n        pos = openEnd + 1;\n        continue;\n      }\n\n      // Find matching closing tag (handle nesting)\n      let depth = 1;\n      let searchPos = openEnd + 1;\n\n      while (depth > 0 && searchPos < xml.length) {\n        // Find next potential opening tag\n        let nextOpen = -1;\n        let openSearchPos = searchPos;\n        while (true) {\n          const candidateOpen = xml.indexOf(openTag, openSearchPos);\n          if (candidateOpen === -1) {\n            break;\n          }\n          // Verify it's an exact match (not a prefix)\n          const charAfter = xml[candidateOpen + openTag.length];\n          if (\n            charAfter &&\n            charAfter !== '>' &&\n            charAfter !== '/' &&\n            charAfter !== ' ' &&\n            charAfter !== '\\t' &&\n            charAfter !== '\\n' &&\n            charAfter !== '\\r'\n          ) {\n            // Prefix match, keep searching\n            openSearchPos = candidateOpen + openTag.length;\n            continue;\n          }\n          nextOpen = candidateOpen;\n          break;\n        }\n\n        const nextClose = xml.indexOf(closeTag, searchPos);\n\n        if (nextClose === -1) break;\n\n        if (nextOpen !== -1 && nextOpen < nextClose) {\n          depth++;\n          searchPos = nextOpen + openTag.length;\n        } else {\n          depth--;\n          if (depth === 0) {\n            elements.push(xml.substring(startIdx, nextClose + closeTag.length));\n            pos = nextClose + closeTag.length;\n          } else {\n            searchPos = nextClose + closeTag.length;\n          }\n        }\n      }\n\n      if (depth > 0) {\n        // Unclosed tag - skip it\n        pos = startIdx + openTag.length;\n      }\n    }\n\n    return elements;\n  }\n\n  /**\n   * Extracts attribute value from an XML string\n   * @param xml - XML content\n   * @param attributeName - Attribute name (e.g., 'w:val')\n   * @returns Attribute value or undefined\n   */\n  static extractAttribute(xml: string, attributeName: string): string | undefined {\n    // Use simple indexOf for bounded string search (safe)\n    const attrPattern = `${attributeName}=\"`;\n    const startIdx = xml.indexOf(attrPattern);\n    if (startIdx === -1) return undefined;\n\n    const valueStart = startIdx + attrPattern.length;\n    const valueEnd = xml.indexOf('\"', valueStart);\n    if (valueEnd === -1) return undefined;\n\n    const rawValue = xml.substring(valueStart, valueEnd);\n    // Unescape XML entities to get the actual value\n    // This prevents double-escaping when the value is later re-serialized\n    return XMLBuilder.unescapeXml(rawValue);\n  }\n\n  /**\n   * Checks if an XML string contains a self-closing tag\n   * @param xml - XML content\n   * @param tagName - Tag name to check\n   * @returns True if the tag exists as self-closing\n   */\n  static hasSelfClosingTag(xml: string, tagName: string): boolean {\n    return xml.includes(`<${tagName}/>`) || xml.includes(`<${tagName} `);\n  }\n\n  /**\n   * Checks if a boolean property tag is enabled (w:val=\"1\" or w:val=\"true\")\n   * Per ECMA-376, boolean properties can be:\n   * - Present with w:val=\"1\" or w:val=\"true\" (enabled)\n   * - Present with w:val=\"0\" or w:val=\"false\" (explicitly disabled)\n   * - Absent (disabled by default)\n   *\n   * @param xml - XML content to search\n   * @param tagName - Tag name (e.g., 'w:keepNext')\n   * @returns True if tag exists with w:val=\"1\" or w:val=\"true\", false otherwise\n   *\n   * @example\n   * hasBooleanProperty('<w:pPr><w:keepNext w:val=\"1\"/></w:pPr>', 'w:keepNext'); // true\n   * hasBooleanProperty('<w:pPr><w:keepNext w:val=\"0\"/></w:pPr>', 'w:keepNext'); // false\n   * hasBooleanProperty('<w:pPr><w:spacing/></w:pPr>', 'w:keepNext'); // false\n   */\n  static hasBooleanProperty(xml: string, tagName: string): boolean {\n    // Check for tag with w:val=\"1\" or w:val=\"true\"\n    if (xml.includes(`<${tagName} w:val=\"1\"`) || xml.includes(`<${tagName} w:val=\"true\"`)) {\n      return true;\n    }\n\n    // Check for self-closing tag without w:val attribute (means true per ECMA-376)\n    // Example: <w:b/> means bold=true\n    if (xml.includes(`<${tagName}/>`)) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Extracts text content from within tags\n   * Finds all <w:t>...</w:t> tags and extracts their text\n   * @param xml - XML content\n   * @returns Combined text content\n   */\n  static extractText(xml: string): string {\n    const texts: string[] = [];\n    const openTag = '<w:t';\n    const closeTag = '</w:t>';\n\n    let pos = 0;\n    while (pos < xml.length) {\n      const startIdx = xml.indexOf(openTag, pos);\n      if (startIdx === -1) break;\n\n      // Find the end of opening tag\n      const openEnd = xml.indexOf('>', startIdx);\n      if (openEnd === -1) break;\n\n      // Find closing tag\n      const closeIdx = xml.indexOf(closeTag, openEnd);\n      if (closeIdx === -1) break;\n\n      // Extract text between tags\n      const text = xml.substring(openEnd + 1, closeIdx);\n      texts.push(text);\n\n      pos = closeIdx + closeTag.length;\n    }\n\n    return texts.join('');\n  }\n\n  /**\n   * Validates input size to prevent excessive memory usage\n   * @param xml - XML content\n   * @param maxSize - Maximum size in bytes (default: 10MB)\n   * @throws Error if XML exceeds max size\n   */\n  static validateSize(xml: string, maxSize: number = 10 * 1024 * 1024): void {\n    if (xml.length > maxSize) {\n      throw new Error(\n        `XML content too large for parsing (${(xml.length / 1024 / 1024).toFixed(1)}MB). ` +\n          `Maximum allowed: ${(maxSize / 1024 / 1024).toFixed(0)}MB`\n      );\n    }\n  }\n\n  /**\n   * Extracts content between two specific tags\n   * More efficient than regex for large documents\n   * @param xml - XML content\n   * @param startTag - Opening tag (e.g., '<w:pPr')\n   * @param endTag - Closing tag (e.g., '</w:pPr>')\n   * @returns Content between tags, or undefined if not found\n   */\n  static extractBetweenTags(xml: string, startTag: string, endTag: string): string | undefined {\n    const startIdx = xml.indexOf(startTag);\n    if (startIdx === -1) return undefined;\n\n    // Find the end of the opening tag\n    const openEnd = xml.indexOf('>', startIdx);\n    if (openEnd === -1) return undefined;\n\n    // Find the closing tag\n    const endIdx = xml.indexOf(endTag, openEnd);\n    if (endIdx === -1) return undefined;\n\n    return xml.substring(openEnd + 1, endIdx);\n  }\n\n  /**\n   * Extracts a complete self-closing tag with its attributes\n   * Handles cases where multiple similar tags exist (e.g., <w:sz.../> and <w:szCs.../>)\n   *\n   * @param xml - XML string to search\n   * @param tagName - Tag name to find (e.g., \"w:color\", \"w:sz\")\n   * @returns The complete tag content (attributes portion) or undefined if not found\n   *\n   * @example\n   * const xml = '<w:sz w:val=\"36\"/><w:color w:val=\"FF0000\"/>';\n   * const colorTag = XMLParser.extractSelfClosingTag(xml, 'w:color');\n   * // Returns: ' w:val=\"FF0000\"'\n   */\n  static extractSelfClosingTag(xml: string, tagName: string): string | undefined {\n    const startPattern = `<${tagName}`;\n    let searchPos = 0;\n\n    // Search for the exact tag (not tags that start with this pattern)\n    while (true) {\n      const startIdx = xml.indexOf(startPattern, searchPos);\n      if (startIdx === -1) return undefined;\n\n      // Check what character follows the tag name\n      const charAfterTag = xml[startIdx + startPattern.length];\n\n      // Valid separators after tag name: space, '/', or '>'\n      if (charAfterTag === ' ' || charAfterTag === '/' || charAfterTag === '>') {\n        // Found the exact tag, now find its end\n        const endIdx = xml.indexOf('/>', startIdx);\n        if (endIdx === -1) {\n          // Try finding a closing tag instead (non-self-closing)\n          const closeTagStart = xml.indexOf('>', startIdx);\n          if (closeTagStart === -1) return undefined;\n\n          // Return attributes portion\n          return xml.substring(startIdx + startPattern.length, closeTagStart);\n        }\n\n        // Return attributes portion (between tag name and />)\n        return xml.substring(startIdx + startPattern.length, endIdx);\n      }\n\n      // Not the exact tag (e.g., found \"w:sz\" when looking for \"w:s\")\n      // Continue searching\n      searchPos = startIdx + 1;\n    }\n  }\n\n  /**\n   * Parse XML string to JavaScript object\n   * Compatible with fast-xml-parser output format\n   *\n   * @param xml - XML string to parse\n   * @param options - Parsing options\n   * @returns Parsed JavaScript object\n   *\n   * @example\n   * const xml = '<Relationships><Relationship Id=\"rId1\" Target=\"https://example.com\"/></Relationships>';\n   * const obj = XMLParser.parseToObject(xml);\n   * // Returns: { Relationships: { Relationship: { '@_Id': 'rId1', '@_Target': 'https://example.com' } } }\n   *\n   * @example\n   * // Multiple elements become arrays\n   * const xml = '<Items><Item id=\"1\"/><Item id=\"2\"/></Items>';\n   * const obj = XMLParser.parseToObject(xml);\n   * // Returns: { Items: { Item: [{ '@_id': '1' }, { '@_id': '2' }] } }\n   */\n  static parseToObject(xml: string, options?: ParseToObjectOptions): ParsedXMLObject {\n    const logger = getLogger();\n    logger.debug('Parsing XML to object', { xmlSize: xml.length });\n\n    // Default options\n    const opts: Required<ParseToObjectOptions> = {\n      ignoreAttributes: options?.ignoreAttributes ?? false,\n      attributeNamePrefix: options?.attributeNamePrefix ?? '@_',\n      textNodeName: options?.textNodeName ?? '#text',\n      ignoreNamespace: options?.ignoreNamespace ?? false,\n      parseAttributeValue: options?.parseAttributeValue ?? true,\n      trimValues: options?.trimValues ?? true,\n      alwaysArray: options?.alwaysArray ?? false,\n      maxNestingDepth: options?.maxNestingDepth ?? DEFAULT_MAX_NESTING_DEPTH,\n    };\n\n    // Validate input size\n    XMLParser.validateSize(xml);\n\n    // Remove XML declaration and trim\n    xml = xml.replace(/<\\?xml[^>]*\\?>\\s*/g, '').trim();\n\n    if (!xml) {\n      return {};\n    }\n\n    // Parse root element (start at depth 0)\n    const result = XMLParser.parseElementToObject(xml, 0, opts, 0);\n    logger.debug('XML parsed to object');\n    return result.value as ParsedXMLObject;\n  }\n\n  /**\n   * Parses a single XML element into an object\n   * @private\n   */\n  private static parseElementToObject(\n    xml: string,\n    startPos: number,\n    options: Required<ParseToObjectOptions>,\n    depth: number\n  ): { value: ParsedXMLValue; endPos: number } {\n    // Check nesting depth to prevent stack overflow\n    if (depth > options.maxNestingDepth) {\n      throw new Error(\n        `XML nesting depth exceeds maximum of ${options.maxNestingDepth}. ` +\n          `This may indicate malformed XML or an attack attempt. ` +\n          `Use the maxNestingDepth option to increase the limit if needed.`\n      );\n    }\n\n    // Find opening tag\n    const openTagStart = xml.indexOf('<', startPos);\n    if (openTagStart === -1) {\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Skip comments\n    if (xml.substring(openTagStart, openTagStart + 4) === '<!--') {\n      const commentEnd = xml.indexOf('-->', openTagStart + 4);\n      if (commentEnd !== -1) {\n        return XMLParser.parseElementToObject(xml, commentEnd + 3, options, depth);\n      }\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Extract element name\n    const nameMatch = /^([a-zA-Z0-9:_-]+)/.exec(xml.substring(openTagStart + 1));\n    if (!nameMatch) {\n      return { value: {}, endPos: openTagStart + 1 };\n    }\n\n    const originalElementName: string = nameMatch[1] || '';\n    let elementName: string = originalElementName;\n    const tagHeaderEnd = xml.indexOf('>', openTagStart);\n    if (tagHeaderEnd === -1) {\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Remove namespace if requested (but keep original for offset calculations)\n    if (options.ignoreNamespace && elementName.includes(':')) {\n      elementName = elementName.split(':')[1] || elementName;\n    }\n\n    // Extract attributes using ORIGINAL element name length for correct offset\n    const tagHeader = xml.substring(openTagStart + 1 + originalElementName.length, tagHeaderEnd);\n    const attributes = XMLParser.extractAttributesFromTag(tagHeader, options);\n\n    // Check if self-closing\n    const isSelfClosing = tagHeader.trim().endsWith('/') || xml[tagHeaderEnd - 1] === '/';\n\n    if (isSelfClosing) {\n      // Self-closing tag - return object with attributes only\n      const elementValue: ParsedXMLObject = { ...attributes };\n      return {\n        value: { [elementName]: elementValue },\n        endPos: tagHeaderEnd + 1,\n      };\n    }\n\n    // Find closing tag (use original name with namespace for correct matching)\n    const closingTag = `</${originalElementName}>`;\n    const contentStart = tagHeaderEnd + 1;\n    const closingTagPos = XMLParser.findClosingTag(xml, originalElementName, contentStart);\n\n    if (closingTagPos === -1) {\n      // No closing tag found - treat as self-closing\n      return {\n        value: { [elementName]: { ...attributes } },\n        endPos: tagHeaderEnd + 1,\n      };\n    }\n\n    // Extract content between tags\n    const content = xml.substring(contentStart, closingTagPos);\n\n    // Parse content (children or text)\n    const children: ParsedElement[] = [];\n    let textContent = '';\n    let pos = 0;\n\n    while (pos < content.length) {\n      const nextTag = content.indexOf('<', pos);\n\n      if (nextTag === -1) {\n        // No more tags - rest is text\n        const text = content.substring(pos);\n        // When trimValues is false, preserve whitespace-only text\n        // When trimValues is true, only include text that has non-whitespace content\n        if (text.length > 0 && (!options.trimValues || text.trim())) {\n          // Unescape XML entities in text content (e.g., &lt; -> <)\n          textContent += XMLBuilder.unescapeXml(text);\n        }\n        break;\n      }\n\n      // Collect text before next tag\n      if (nextTag > pos) {\n        const text = content.substring(pos, nextTag);\n        // When trimValues is false, preserve whitespace-only text\n        // When trimValues is true, only include text that has non-whitespace content\n        if (text.length > 0 && (!options.trimValues || text.trim())) {\n          // Unescape XML entities in text content (e.g., &lt; -> <)\n          textContent += XMLBuilder.unescapeXml(text);\n        }\n      }\n\n      // Parse child element (increment depth for children)\n      const childResult = XMLParser.parseElementToObject(content, nextTag, options, depth + 1);\n      const childObj = childResult.value as ParsedXMLObject;\n\n      // Extract child name and value\n      const childKeys = Object.keys(childObj);\n      if (childKeys.length > 0) {\n        const childName = childKeys[0];\n        if (childName) {\n          const childValue = childObj[childName];\n          children.push({ name: childName, value: childValue });\n        }\n      }\n\n      pos = childResult.endPos;\n    }\n\n    // Build element value\n    let elementValue: ParsedXMLValue = {};\n\n    // Add attributes\n    if (!options.ignoreAttributes && Object.keys(attributes).length > 0) {\n      elementValue = { ...attributes };\n    }\n\n    // Add text content\n    // When trimValues is false, include whitespace-only text\n    // When trimValues is true, only include text with non-whitespace content\n    if (textContent.length > 0 && (!options.trimValues || textContent.trim())) {\n      const text = options.trimValues ? textContent.trim() : textContent;\n      if (typeof elementValue === 'object' && !Array.isArray(elementValue)) {\n        if (Object.keys(elementValue).length === 0) {\n          // Only text, no attributes - return as direct value if simple\n          elementValue = text;\n        } else {\n          // Text with attributes\n          elementValue[options.textNodeName] = text;\n        }\n      }\n    }\n\n    // Add children\n    if (children.length > 0) {\n      const coalescedChildren = XMLParser.coalesceChildren(children, options);\n      if (typeof elementValue === 'object' && !Array.isArray(elementValue)) {\n        elementValue = { ...elementValue, ...coalescedChildren };\n      } else {\n        elementValue = coalescedChildren;\n      }\n    }\n\n    // If element has no content, attributes, or children - return empty object\n    if (\n      typeof elementValue === 'object' &&\n      !Array.isArray(elementValue) &&\n      Object.keys(elementValue).length === 0\n    ) {\n      elementValue = {};\n    }\n\n    return {\n      value: { [elementName]: elementValue },\n      endPos: closingTagPos + closingTag.length,\n    };\n  }\n\n  /**\n   * Extracts attributes from a tag header\n   * @private\n   */\n  private static extractAttributesFromTag(\n    tagHeader: string,\n    options: Required<ParseToObjectOptions>\n  ): Record<string, string | number | boolean> {\n    const attributes: Record<string, string | number | boolean> = {};\n\n    if (options.ignoreAttributes) {\n      return attributes;\n    }\n\n    // Simple attribute extraction using position-based parsing\n    let pos = 0;\n    while (pos < tagHeader.length) {\n      // Skip whitespace\n      while (pos < tagHeader.length) {\n        const char = tagHeader[pos];\n        if (char && /\\s/.test(char)) {\n          pos++;\n        } else {\n          break;\n        }\n      }\n\n      if (pos >= tagHeader.length || tagHeader[pos] === '/') {\n        break;\n      }\n\n      // Extract attribute name\n      const nameStart = pos;\n      while (pos < tagHeader.length) {\n        const char = tagHeader[pos];\n        if (char && /[a-zA-Z0-9:_-]/.test(char)) {\n          pos++;\n        } else {\n          break;\n        }\n      }\n\n      if (pos === nameStart) {\n        break;\n      }\n\n      let attrName = tagHeader.substring(nameStart, pos);\n\n      // Skip whitespace and '='\n      while (pos < tagHeader.length) {\n        const char = tagHeader[pos];\n        if (char && /[\\s=]/.test(char)) {\n          pos++;\n        } else {\n          break;\n        }\n      }\n\n      // Extract attribute value\n      let attrValue = '';\n      if (pos < tagHeader.length && (tagHeader[pos] === '\"' || tagHeader[pos] === \"'\")) {\n        const quote = tagHeader[pos];\n        pos++; // Skip opening quote\n        const valueStart = pos;\n\n        while (pos < tagHeader.length && tagHeader[pos] !== quote) {\n          pos++;\n        }\n\n        attrValue = tagHeader.substring(valueStart, pos);\n        pos++; // Skip closing quote\n      }\n\n      // Remove namespace from attribute name if requested\n      if (options.ignoreNamespace && attrName.includes(':')) {\n        attrName = attrName.split(':')[1] || attrName;\n      }\n\n      // Add prefix to attribute name\n      const prefixedName = options.attributeNamePrefix + attrName;\n\n      // Parse attribute value\n      attributes[prefixedName] = options.parseAttributeValue\n        ? XMLParser.parseValue(attrValue)\n        : attrValue;\n    }\n\n    return attributes;\n  }\n\n  /**\n   * Finds the closing tag for an element, handling nesting\n   * @private\n   */\n  private static findClosingTag(xml: string, elementName: string, startPos: number): number {\n    const openTag = `<${elementName}`;\n    const closeTag = `</${elementName}>`;\n    let depth = 1;\n    let pos = startPos;\n\n    while (depth > 0 && pos < xml.length) {\n      const nextClose = xml.indexOf(closeTag, pos);\n\n      if (nextClose === -1) {\n        return -1; // No closing tag found\n      }\n\n      // Find the next REAL opening tag (not a prefix match like <w:pPrChange for <w:pPr)\n      // Must search for all potential matches and verify each one\n      let realOpenPos = -1;\n      let searchPos = pos;\n      while (searchPos < nextClose) {\n        const candidateOpen = xml.indexOf(openTag, searchPos);\n        if (candidateOpen === -1 || candidateOpen >= nextClose) {\n          break; // No more candidates before the closing tag\n        }\n\n        const charAfter = xml[candidateOpen + openTag.length];\n        if (\n          charAfter === '>' ||\n          charAfter === ' ' ||\n          charAfter === '/' ||\n          charAfter === '\\t' ||\n          charAfter === '\\n' ||\n          charAfter === '\\r'\n        ) {\n          // This looks like a real opening tag - but check if it's self-closing\n          // Self-closing tags like <w:rPr/> should NOT increase depth\n          const tagEnd = xml.indexOf('>', candidateOpen);\n          if (tagEnd !== -1 && xml[tagEnd - 1] === '/') {\n            // Self-closing tag - skip it (don't affect depth)\n            searchPos = tagEnd + 1;\n            continue;\n          }\n          // This is a real opening tag (not self-closing)\n          realOpenPos = candidateOpen;\n          break;\n        }\n\n        // False positive (e.g., <w:pPrChange when looking for <w:pPr)\n        // Keep searching from after this position\n        searchPos = candidateOpen + openTag.length;\n      }\n\n      if (realOpenPos !== -1) {\n        // Found a real opening tag before the closing tag - increase depth\n        depth++;\n        pos = realOpenPos + openTag.length;\n      } else {\n        // No real opening tag before this closing tag - decrease depth\n        depth--;\n        if (depth === 0) {\n          return nextClose;\n        }\n        pos = nextClose + closeTag.length;\n      }\n    }\n\n    return -1;\n  }\n\n  /**\n   * Coalesces children with duplicate names into arrays\n   * @private\n   */\n  private static coalesceChildren(\n    children: ParsedElement[],\n    options: Required<ParseToObjectOptions>\n  ): ParsedXMLObject {\n    const result: ParsedXMLObject = {};\n    const nameCounts: Record<string, number> = {};\n    const nameIndices: Record<string, number> = {};\n\n    // Track element order for correct run content parsing (tabs, breaks, text)\n    // This is critical for preserving the order of mixed content like: text -> tab -> text\n    const orderedChildren: { type: string; index: number }[] = [];\n\n    // Count occurrences of each child name\n    for (const child of children) {\n      nameCounts[child.name] = (nameCounts[child.name] || 0) + 1;\n    }\n\n    // Build result object while tracking order\n    for (const child of children) {\n      const shouldBeArray = options.alwaysArray || (nameCounts[child.name] || 0) > 1;\n\n      // Track element order with its index in the array\n      const currentIndex = nameIndices[child.name] || 0;\n      orderedChildren.push({ type: child.name, index: currentIndex });\n      nameIndices[child.name] = currentIndex + 1;\n\n      if (shouldBeArray) {\n        if (!result[child.name]) {\n          result[child.name] = [];\n        }\n        (result[child.name] as ParsedXMLValue[]).push(child.value);\n      } else {\n        result[child.name] = child.value;\n      }\n    }\n\n    // Add _orderedChildren to track element order (used by DocumentParser for runs)\n    if (orderedChildren.length > 0) {\n      result._orderedChildren = orderedChildren;\n    }\n\n    return result;\n  }\n\n  /**\n   * Parses a string value to number or boolean if applicable\n   * @private\n   */\n  private static parseValue(value: string): string | number | boolean {\n    if (value === 'true') return true;\n    if (value === 'false') return false;\n\n    // Preserve 6-character hex color codes (OpenXML standard for colors)\n    // This includes \"000000\" (black) which should stay as a string\n    if (/^[0-9A-Fa-f]{6}$/.test(value)) {\n      return value.toUpperCase(); // Normalize to uppercase per Microsoft convention\n    }\n\n    // Preserve long digit-only strings (e.g., cnfStyle binary strings like \"100000000000\")\n    // These should not be converted to numbers to avoid losing leading zeros\n    if (/^\\d{7,}$/.test(value)) {\n      return value; // Keep as string for values with 7+ digits\n    }\n\n    // Try parsing as number\n    // 3-character values like \"240\" will be parsed as numbers\n    // 6-character hex values are already handled above\n    if (/^-?\\d+$/.test(value)) {\n      const num = parseInt(value, 10);\n      if (!isNaN(num)) return num;\n    }\n\n    if (/^-?\\d+\\.\\d+$/.test(value)) {\n      const num = parseFloat(value);\n      if (!isNaN(num)) return num;\n    }\n\n    // Preserve 3-character hex codes (like \"F0A\") that have letters\n    // Pure numeric 3-char values (like \"240\") are already parsed as numbers above\n    if (/^[0-9A-Fa-f]{3}$/.test(value) && /[A-Fa-f]/.test(value)) {\n      return value.toUpperCase();\n    }\n\n    return value;\n  }\n}\n"]}
+{"version":3,"file":"XMLParser.js","sourceRoot":"","sources":["../../src/xml/XMLParser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * XMLParser - Simple position-based XML parser\n * Avoids regex backtracking issues that can cause ReDoS attacks\n * Completes the DocXML framework (XMLBuilder + XMLParser)\n */\n\nimport { getGlobalLogger, createScopedLogger, ILogger } from '../utils/logger.js';\nimport { XMLBuilder } from './XMLBuilder.js';\n\n// Create scoped logger for XMLParser operations\nfunction getLogger(): ILogger {\n  return createScopedLogger(getGlobalLogger(), 'XMLParser');\n}\n\n/**\n * Default maximum nesting depth for XML parsing.\n * Prevents stack overflow on deeply nested documents.\n */\nexport const DEFAULT_MAX_NESTING_DEPTH = 256;\n\n/**\n * Options for XML-to-object parsing\n */\nexport interface ParseToObjectOptions {\n  /** Ignore attributes (default: false) */\n  ignoreAttributes?: boolean;\n\n  /** Attribute name prefix (default: '@_') */\n  attributeNamePrefix?: string;\n\n  /** Text node property name (default: '#text') */\n  textNodeName?: string;\n\n  /** Remove namespace prefixes from element names (default: false) */\n  ignoreNamespace?: boolean;\n\n  /** Parse numeric attribute values (default: true) */\n  parseAttributeValue?: boolean;\n\n  /** Trim whitespace from text values (default: true) */\n  trimValues?: boolean;\n\n  /** Always return arrays for elements (default: false) */\n  alwaysArray?: boolean;\n\n  /** Maximum nesting depth (default: 256). Prevents stack overflow on deeply nested documents. */\n  maxNestingDepth?: number;\n}\n\n/**\n * Parsed XML object structure\n * Can be a string, object, array, or nested structure\n */\nexport type ParsedXMLValue =\n  | string\n  | number\n  | boolean\n  | ParsedXMLObject\n  | ParsedXMLObject[]\n  | null\n  | undefined;\n\n/**\n * Parsed XML object with dynamic keys\n */\nexport interface ParsedXMLObject {\n  [key: string]: ParsedXMLValue;\n}\n\n/**\n * Internal structure for tracking parsed elements during parsing\n */\ninterface ParsedElement {\n  name: string;\n  value: ParsedXMLValue;\n}\n\n/**\n * Simple XML parser using position-based parsing instead of regex\n * Prevents catastrophic backtracking (ReDoS attacks) by avoiding nested regex patterns\n */\nexport class XMLParser {\n  /**\n   * Extracts the body content from a Word document XML\n   * @param docXml - The complete document.xml content\n   * @returns The body content, or empty string if not found\n   */\n  static extractBody(docXml: string): string {\n    const startTag = '<w:body';\n    const endTag = '</w:body>';\n\n    const startIdx = docXml.indexOf(startTag);\n    if (startIdx === -1) return '';\n\n    // Find the closing > of opening tag\n    const openEnd = docXml.indexOf('>', startIdx);\n    if (openEnd === -1) return '';\n\n    // Find matching closing tag\n    const endIdx = docXml.indexOf(endTag, openEnd);\n    if (endIdx === -1) return '';\n\n    return docXml.substring(openEnd + 1, endIdx);\n  }\n\n  /**\n   * Extracts all elements of a given type using position-based parsing\n   * Handles nested tags correctly by tracking depth\n   * @param xml - XML content to parse\n   * @param tagName - Tag name to extract (e.g., 'w:p', 'w:r')\n   * @returns Array of XML strings for each element\n   */\n  static extractElements(xml: string, tagName: string): string[] {\n    const elements: string[] = [];\n    const openTag = `<${tagName}`;\n    const closeTag = `</${tagName}>`;\n    const selfClosingEnd = '/>';\n\n    let pos = 0;\n    while (pos < xml.length) {\n      const startIdx = xml.indexOf(openTag, pos);\n      if (startIdx === -1) break;\n\n      // Verify this is the exact tag (not a prefix match like <w:p matching <w:pPr>)\n      // The character after the tag name must be either '>', '/', whitespace, or '=' (for attributes)\n      const charAfterTag = xml[startIdx + openTag.length];\n      if (\n        charAfterTag &&\n        charAfterTag !== '>' &&\n        charAfterTag !== '/' &&\n        charAfterTag !== ' ' &&\n        charAfterTag !== '\\t' &&\n        charAfterTag !== '\\n' &&\n        charAfterTag !== '\\r' &&\n        charAfterTag !== '='\n      ) {\n        // This is a prefix match (e.g., <w:pPr> when looking for <w:p>), skip it (Issue #5)\n        pos = startIdx + openTag.length;\n        continue;\n      }\n\n      // Find the end of opening tag (quote-aware: attribute values may\n      // legally contain a raw '>')\n      const openEnd = XMLParser.findTagEnd(xml, startIdx);\n      if (openEnd === -1) break;\n\n      // Check if self-closing\n      if (xml.substring(openEnd - 1, openEnd + 1) === selfClosingEnd) {\n        elements.push(xml.substring(startIdx, openEnd + 1));\n        pos = openEnd + 1;\n        continue;\n      }\n\n      // Find matching closing tag (handle nesting)\n      let depth = 1;\n      let searchPos = openEnd + 1;\n\n      while (depth > 0 && searchPos < xml.length) {\n        // Find next potential opening tag\n        let nextOpen = -1;\n        let openSearchPos = searchPos;\n        while (true) {\n          const candidateOpen = xml.indexOf(openTag, openSearchPos);\n          if (candidateOpen === -1) {\n            break;\n          }\n          // Verify it's an exact match (not a prefix)\n          const charAfter = xml[candidateOpen + openTag.length];\n          if (\n            charAfter &&\n            charAfter !== '>' &&\n            charAfter !== '/' &&\n            charAfter !== ' ' &&\n            charAfter !== '\\t' &&\n            charAfter !== '\\n' &&\n            charAfter !== '\\r'\n          ) {\n            // Prefix match, keep searching\n            openSearchPos = candidateOpen + openTag.length;\n            continue;\n          }\n          nextOpen = candidateOpen;\n          break;\n        }\n\n        const nextClose = xml.indexOf(closeTag, searchPos);\n\n        if (nextClose === -1) break;\n\n        if (nextOpen !== -1 && nextOpen < nextClose) {\n          depth++;\n          searchPos = nextOpen + openTag.length;\n        } else {\n          depth--;\n          if (depth === 0) {\n            elements.push(xml.substring(startIdx, nextClose + closeTag.length));\n            pos = nextClose + closeTag.length;\n          } else {\n            searchPos = nextClose + closeTag.length;\n          }\n        }\n      }\n\n      if (depth > 0) {\n        // Unclosed tag - skip it\n        pos = startIdx + openTag.length;\n      }\n    }\n\n    return elements;\n  }\n\n  /**\n   * Extracts attribute value from an XML string\n   * @param xml - XML content\n   * @param attributeName - Attribute name (e.g., 'w:val')\n   * @returns Attribute value or undefined\n   */\n  static extractAttribute(xml: string, attributeName: string): string | undefined {\n    // Use simple indexOf for bounded string search (safe)\n    const attrPattern = `${attributeName}=\"`;\n    const startIdx = xml.indexOf(attrPattern);\n    if (startIdx === -1) return undefined;\n\n    const valueStart = startIdx + attrPattern.length;\n    const valueEnd = xml.indexOf('\"', valueStart);\n    if (valueEnd === -1) return undefined;\n\n    const rawValue = xml.substring(valueStart, valueEnd);\n    // Unescape XML entities to get the actual value\n    // This prevents double-escaping when the value is later re-serialized\n    return XMLBuilder.unescapeXml(rawValue);\n  }\n\n  /**\n   * Checks if an XML string contains a self-closing tag\n   * @param xml - XML content\n   * @param tagName - Tag name to check\n   * @returns True if the tag exists as self-closing\n   */\n  static hasSelfClosingTag(xml: string, tagName: string): boolean {\n    return xml.includes(`<${tagName}/>`) || xml.includes(`<${tagName} `);\n  }\n\n  /**\n   * Checks if a boolean property tag is enabled (w:val=\"1\" or w:val=\"true\")\n   * Per ECMA-376, boolean properties can be:\n   * - Present with w:val=\"1\" or w:val=\"true\" (enabled)\n   * - Present with w:val=\"0\" or w:val=\"false\" (explicitly disabled)\n   * - Absent (disabled by default)\n   *\n   * @param xml - XML content to search\n   * @param tagName - Tag name (e.g., 'w:keepNext')\n   * @returns True if tag exists with w:val=\"1\" or w:val=\"true\", false otherwise\n   *\n   * @example\n   * hasBooleanProperty('<w:pPr><w:keepNext w:val=\"1\"/></w:pPr>', 'w:keepNext'); // true\n   * hasBooleanProperty('<w:pPr><w:keepNext w:val=\"0\"/></w:pPr>', 'w:keepNext'); // false\n   * hasBooleanProperty('<w:pPr><w:spacing/></w:pPr>', 'w:keepNext'); // false\n   */\n  static hasBooleanProperty(xml: string, tagName: string): boolean {\n    // Check for tag with w:val=\"1\" or w:val=\"true\"\n    if (xml.includes(`<${tagName} w:val=\"1\"`) || xml.includes(`<${tagName} w:val=\"true\"`)) {\n      return true;\n    }\n\n    // Check for self-closing tag without w:val attribute (means true per ECMA-376)\n    // Example: <w:b/> means bold=true\n    if (xml.includes(`<${tagName}/>`)) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Extracts text content from within tags\n   * Finds all <w:t>...</w:t> tags and extracts their text\n   * @param xml - XML content\n   * @returns Combined text content\n   */\n  static extractText(xml: string): string {\n    const texts: string[] = [];\n    const openTag = '<w:t';\n    const closeTag = '</w:t>';\n\n    let pos = 0;\n    while (pos < xml.length) {\n      const startIdx = xml.indexOf(openTag, pos);\n      if (startIdx === -1) break;\n\n      // Find the end of opening tag\n      const openEnd = xml.indexOf('>', startIdx);\n      if (openEnd === -1) break;\n\n      // Find closing tag\n      const closeIdx = xml.indexOf(closeTag, openEnd);\n      if (closeIdx === -1) break;\n\n      // Extract text between tags\n      const text = xml.substring(openEnd + 1, closeIdx);\n      texts.push(text);\n\n      pos = closeIdx + closeTag.length;\n    }\n\n    return texts.join('');\n  }\n\n  /**\n   * Validates input size to prevent excessive memory usage\n   * @param xml - XML content\n   * @param maxSize - Maximum size in bytes (default: 10MB)\n   * @throws Error if XML exceeds max size\n   */\n  static validateSize(xml: string, maxSize: number = 10 * 1024 * 1024): void {\n    if (xml.length > maxSize) {\n      throw new Error(\n        `XML content too large for parsing (${(xml.length / 1024 / 1024).toFixed(1)}MB). ` +\n          `Maximum allowed: ${(maxSize / 1024 / 1024).toFixed(0)}MB`\n      );\n    }\n  }\n\n  /**\n   * Extracts content between two specific tags\n   * More efficient than regex for large documents\n   * @param xml - XML content\n   * @param startTag - Opening tag (e.g., '<w:pPr')\n   * @param endTag - Closing tag (e.g., '</w:pPr>')\n   * @returns Content between tags, or undefined if not found\n   */\n  static extractBetweenTags(xml: string, startTag: string, endTag: string): string | undefined {\n    const startIdx = xml.indexOf(startTag);\n    if (startIdx === -1) return undefined;\n\n    // Find the end of the opening tag (quote-aware: attribute values may\n    // legally contain a raw '>')\n    const openEnd = XMLParser.findTagEnd(xml, startIdx);\n    if (openEnd === -1) return undefined;\n\n    // Find the closing tag\n    const endIdx = xml.indexOf(endTag, openEnd);\n    if (endIdx === -1) return undefined;\n\n    return xml.substring(openEnd + 1, endIdx);\n  }\n\n  /**\n   * Finds the first '>' at or after startPos that is not inside a quoted\n   * attribute value. XML 1.0 §2.3 permits a raw '>' inside attribute values\n   * (only '<', '&', and the delimiting quote must be escaped), so a bare\n   * indexOf('>') can end a tag header mid-attribute.\n   * @private\n   */\n  private static findTagEnd(xml: string, startPos: number): number {\n    let quote: string | undefined;\n    for (let pos = startPos; pos < xml.length; pos++) {\n      const ch = xml[pos];\n      if (quote) {\n        if (ch === quote) quote = undefined;\n      } else if (ch === '\"' || ch === \"'\") {\n        quote = ch;\n      } else if (ch === '>') {\n        return pos;\n      }\n    }\n    return -1;\n  }\n\n  /**\n   * Extracts a complete self-closing tag with its attributes\n   * Handles cases where multiple similar tags exist (e.g., <w:sz.../> and <w:szCs.../>)\n   *\n   * @param xml - XML string to search\n   * @param tagName - Tag name to find (e.g., \"w:color\", \"w:sz\")\n   * @returns The complete tag content (attributes portion) or undefined if not found\n   *\n   * @example\n   * const xml = '<w:sz w:val=\"36\"/><w:color w:val=\"FF0000\"/>';\n   * const colorTag = XMLParser.extractSelfClosingTag(xml, 'w:color');\n   * // Returns: ' w:val=\"FF0000\"'\n   */\n  static extractSelfClosingTag(xml: string, tagName: string): string | undefined {\n    const startPattern = `<${tagName}`;\n    let searchPos = 0;\n\n    // Search for the exact tag (not tags that start with this pattern)\n    while (true) {\n      const startIdx = xml.indexOf(startPattern, searchPos);\n      if (startIdx === -1) return undefined;\n\n      // Check what character follows the tag name\n      const charAfterTag = xml[startIdx + startPattern.length];\n\n      // Valid separators after tag name: space, '/', or '>'\n      if (charAfterTag === ' ' || charAfterTag === '/' || charAfterTag === '>') {\n        // Found the exact tag. Bound the search to this element's own tag\n        // header: a global indexOf('/>') can land inside a later sibling\n        // when the target is written in expanded form (<tag ...></tag>),\n        // attributing the sibling's attributes to this tag.\n        const tagEnd = XMLParser.findTagEnd(xml, startIdx + startPattern.length);\n        if (tagEnd === -1) return undefined;\n\n        // Self-closing: exclude the trailing '/'; expanded form: attributes\n        // run up to the '>' of the open tag.\n        const attrEnd = xml[tagEnd - 1] === '/' ? tagEnd - 1 : tagEnd;\n        return xml.substring(startIdx + startPattern.length, attrEnd);\n      }\n\n      // Not the exact tag (e.g., found \"w:sz\" when looking for \"w:s\")\n      // Continue searching\n      searchPos = startIdx + 1;\n    }\n  }\n\n  /**\n   * Parse XML string to JavaScript object\n   * Compatible with fast-xml-parser output format\n   *\n   * @param xml - XML string to parse\n   * @param options - Parsing options\n   * @returns Parsed JavaScript object\n   *\n   * @example\n   * const xml = '<Relationships><Relationship Id=\"rId1\" Target=\"https://example.com\"/></Relationships>';\n   * const obj = XMLParser.parseToObject(xml);\n   * // Returns: { Relationships: { Relationship: { '@_Id': 'rId1', '@_Target': 'https://example.com' } } }\n   *\n   * @example\n   * // Multiple elements become arrays\n   * const xml = '<Items><Item id=\"1\"/><Item id=\"2\"/></Items>';\n   * const obj = XMLParser.parseToObject(xml);\n   * // Returns: { Items: { Item: [{ '@_id': '1' }, { '@_id': '2' }] } }\n   */\n  static parseToObject(xml: string, options?: ParseToObjectOptions): ParsedXMLObject {\n    const logger = getLogger();\n    logger.debug('Parsing XML to object', { xmlSize: xml.length });\n\n    // Default options\n    const opts: Required<ParseToObjectOptions> = {\n      ignoreAttributes: options?.ignoreAttributes ?? false,\n      attributeNamePrefix: options?.attributeNamePrefix ?? '@_',\n      textNodeName: options?.textNodeName ?? '#text',\n      ignoreNamespace: options?.ignoreNamespace ?? false,\n      parseAttributeValue: options?.parseAttributeValue ?? true,\n      trimValues: options?.trimValues ?? true,\n      alwaysArray: options?.alwaysArray ?? false,\n      maxNestingDepth: options?.maxNestingDepth ?? DEFAULT_MAX_NESTING_DEPTH,\n    };\n\n    // Validate input size\n    XMLParser.validateSize(xml);\n\n    // Remove XML declaration and trim\n    xml = xml.replace(/<\\?xml[^>]*\\?>\\s*/g, '').trim();\n\n    if (!xml) {\n      return {};\n    }\n\n    // Parse root element (start at depth 0)\n    const result = XMLParser.parseElementToObject(xml, 0, opts, 0);\n    logger.debug('XML parsed to object');\n    return result.value as ParsedXMLObject;\n  }\n\n  /**\n   * Parses a single XML element into an object\n   * @private\n   */\n  private static parseElementToObject(\n    xml: string,\n    startPos: number,\n    options: Required<ParseToObjectOptions>,\n    depth: number\n  ): { value: ParsedXMLValue; endPos: number } {\n    // Check nesting depth to prevent stack overflow\n    if (depth > options.maxNestingDepth) {\n      throw new Error(\n        `XML nesting depth exceeds maximum of ${options.maxNestingDepth}. ` +\n          `This may indicate malformed XML or an attack attempt. ` +\n          `Use the maxNestingDepth option to increase the limit if needed.`\n      );\n    }\n\n    // Find opening tag\n    const openTagStart = xml.indexOf('<', startPos);\n    if (openTagStart === -1) {\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Skip comments\n    if (xml.substring(openTagStart, openTagStart + 4) === '<!--') {\n      const commentEnd = xml.indexOf('-->', openTagStart + 4);\n      if (commentEnd !== -1) {\n        return XMLParser.parseElementToObject(xml, commentEnd + 3, options, depth);\n      }\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Skip processing instructions (e.g. <?mso-application ...?>); without\n    // this, '?' fails the element-name match and the PI body is mangled\n    // into text one character at a time\n    if (xml.substring(openTagStart, openTagStart + 2) === '<?') {\n      const piEnd = xml.indexOf('?>', openTagStart + 2);\n      if (piEnd !== -1) {\n        return XMLParser.parseElementToObject(xml, piEnd + 2, options, depth);\n      }\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Skip CDATA found where an element is expected (e.g. at the root);\n    // CDATA inside element content is preserved by the content loop below\n    if (xml.substring(openTagStart, openTagStart + 9) === '<![CDATA[') {\n      const cdataEnd = xml.indexOf(']]>', openTagStart + 9);\n      if (cdataEnd !== -1) {\n        return XMLParser.parseElementToObject(xml, cdataEnd + 3, options, depth);\n      }\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Extract element name\n    const nameMatch = /^([a-zA-Z0-9:_-]+)/.exec(xml.substring(openTagStart + 1));\n    if (!nameMatch) {\n      return { value: {}, endPos: openTagStart + 1 };\n    }\n\n    const originalElementName: string = nameMatch[1] || '';\n    let elementName: string = originalElementName;\n    // Quote-aware scan: attribute values may legally contain a raw '>'\n    const tagHeaderEnd = XMLParser.findTagEnd(xml, openTagStart);\n    if (tagHeaderEnd === -1) {\n      return { value: {}, endPos: xml.length };\n    }\n\n    // Remove namespace if requested (but keep original for offset calculations)\n    if (options.ignoreNamespace && elementName.includes(':')) {\n      elementName = elementName.split(':')[1] || elementName;\n    }\n\n    // Extract attributes using ORIGINAL element name length for correct offset\n    const tagHeader = xml.substring(openTagStart + 1 + originalElementName.length, tagHeaderEnd);\n    const attributes = XMLParser.extractAttributesFromTag(tagHeader, options);\n\n    // Check if self-closing\n    const isSelfClosing = tagHeader.trim().endsWith('/') || xml[tagHeaderEnd - 1] === '/';\n\n    if (isSelfClosing) {\n      // Self-closing tag - return object with attributes only\n      const elementValue: ParsedXMLObject = { ...attributes };\n      return {\n        value: { [elementName]: elementValue },\n        endPos: tagHeaderEnd + 1,\n      };\n    }\n\n    // Find closing tag (use original name with namespace for correct matching)\n    const closingTag = `</${originalElementName}>`;\n    const contentStart = tagHeaderEnd + 1;\n    const closingTagPos = XMLParser.findClosingTag(xml, originalElementName, contentStart);\n\n    if (closingTagPos === -1) {\n      // No closing tag found - treat as self-closing\n      return {\n        value: { [elementName]: { ...attributes } },\n        endPos: tagHeaderEnd + 1,\n      };\n    }\n\n    // Extract content between tags\n    const content = xml.substring(contentStart, closingTagPos);\n\n    // Parse content (children or text)\n    const children: ParsedElement[] = [];\n    let textContent = '';\n    let pos = 0;\n\n    while (pos < content.length) {\n      const nextTag = content.indexOf('<', pos);\n\n      if (nextTag === -1) {\n        // No more tags - rest is text\n        const text = content.substring(pos);\n        // When trimValues is false, preserve whitespace-only text\n        // When trimValues is true, only include text that has non-whitespace content\n        if (text.length > 0 && (!options.trimValues || text.trim())) {\n          // Unescape XML entities in text content (e.g., &lt; -> <)\n          textContent += XMLBuilder.unescapeXml(text);\n        }\n        break;\n      }\n\n      // Collect text before next tag\n      if (nextTag > pos) {\n        const text = content.substring(pos, nextTag);\n        // When trimValues is false, preserve whitespace-only text\n        // When trimValues is true, only include text that has non-whitespace content\n        if (text.length > 0 && (!options.trimValues || text.trim())) {\n          // Unescape XML entities in text content (e.g., &lt; -> <)\n          textContent += XMLBuilder.unescapeXml(text);\n        }\n      }\n\n      // CDATA: append the payload verbatim — its content is by definition\n      // already unescaped, so entity decoding must not be applied\n      if (content.startsWith('<![CDATA[', nextTag)) {\n        const cdataEnd = content.indexOf(']]>', nextTag + 9);\n        if (cdataEnd === -1) {\n          textContent += content.substring(nextTag + 9);\n          break;\n        }\n        textContent += content.substring(nextTag + 9, cdataEnd);\n        pos = cdataEnd + 3;\n        continue;\n      }\n\n      // Parse child element (increment depth for children)\n      const childResult = XMLParser.parseElementToObject(content, nextTag, options, depth + 1);\n      const childObj = childResult.value as ParsedXMLObject;\n\n      // Extract child name and value\n      const childKeys = Object.keys(childObj);\n      if (childKeys.length > 0) {\n        const childName = childKeys[0];\n        if (childName) {\n          const childValue = childObj[childName];\n          children.push({ name: childName, value: childValue });\n        }\n      }\n\n      pos = childResult.endPos;\n    }\n\n    // Build element value\n    let elementValue: ParsedXMLValue = {};\n\n    // Add attributes\n    if (!options.ignoreAttributes && Object.keys(attributes).length > 0) {\n      elementValue = { ...attributes };\n    }\n\n    // Add text content\n    // When trimValues is false, include whitespace-only text\n    // When trimValues is true, only include text with non-whitespace content\n    if (textContent.length > 0 && (!options.trimValues || textContent.trim())) {\n      const text = options.trimValues ? textContent.trim() : textContent;\n      if (typeof elementValue === 'object' && !Array.isArray(elementValue)) {\n        if (Object.keys(elementValue).length === 0) {\n          // Only text, no attributes - return as direct value if simple\n          elementValue = text;\n        } else {\n          // Text with attributes\n          elementValue[options.textNodeName] = text;\n        }\n      }\n    }\n\n    // Add children\n    if (children.length > 0) {\n      const coalescedChildren = XMLParser.coalesceChildren(children, options);\n      // Mixed content with no attributes leaves elementValue as a bare\n      // string; fold it into object form so merging children keeps the text\n      if (typeof elementValue === 'string') {\n        elementValue = { [options.textNodeName]: elementValue };\n      }\n      if (typeof elementValue === 'object' && !Array.isArray(elementValue)) {\n        elementValue = { ...elementValue, ...coalescedChildren };\n      } else {\n        elementValue = coalescedChildren;\n      }\n    }\n\n    // If element has no content, attributes, or children - return empty object\n    if (\n      typeof elementValue === 'object' &&\n      !Array.isArray(elementValue) &&\n      Object.keys(elementValue).length === 0\n    ) {\n      elementValue = {};\n    }\n\n    return {\n      value: { [elementName]: elementValue },\n      endPos: closingTagPos + closingTag.length,\n    };\n  }\n\n  /**\n   * Extracts attributes from a tag header\n   * @private\n   */\n  private static extractAttributesFromTag(\n    tagHeader: string,\n    options: Required<ParseToObjectOptions>\n  ): Record<string, string | number | boolean> {\n    const attributes: Record<string, string | number | boolean> = {};\n\n    if (options.ignoreAttributes) {\n      return attributes;\n    }\n\n    // Simple attribute extraction using position-based parsing\n    let pos = 0;\n    while (pos < tagHeader.length) {\n      // Skip whitespace\n      while (pos < tagHeader.length) {\n        const char = tagHeader[pos];\n        if (char && /\\s/.test(char)) {\n          pos++;\n        } else {\n          break;\n        }\n      }\n\n      if (pos >= tagHeader.length || tagHeader[pos] === '/') {\n        break;\n      }\n\n      // Extract attribute name\n      const nameStart = pos;\n      while (pos < tagHeader.length) {\n        const char = tagHeader[pos];\n        if (char && /[a-zA-Z0-9:_-]/.test(char)) {\n          pos++;\n        } else {\n          break;\n        }\n      }\n\n      if (pos === nameStart) {\n        break;\n      }\n\n      let attrName = tagHeader.substring(nameStart, pos);\n\n      // Skip whitespace and '='\n      while (pos < tagHeader.length) {\n        const char = tagHeader[pos];\n        if (char && /[\\s=]/.test(char)) {\n          pos++;\n        } else {\n          break;\n        }\n      }\n\n      // Extract attribute value\n      let attrValue = '';\n      if (pos < tagHeader.length && (tagHeader[pos] === '\"' || tagHeader[pos] === \"'\")) {\n        const quote = tagHeader[pos];\n        pos++; // Skip opening quote\n        const valueStart = pos;\n\n        while (pos < tagHeader.length && tagHeader[pos] !== quote) {\n          pos++;\n        }\n\n        attrValue = tagHeader.substring(valueStart, pos);\n        pos++; // Skip closing quote\n      }\n\n      // Remove namespace from attribute name if requested\n      if (options.ignoreNamespace && attrName.includes(':')) {\n        attrName = attrName.split(':')[1] || attrName;\n      }\n\n      // Add prefix to attribute name\n      const prefixedName = options.attributeNamePrefix + attrName;\n\n      // Unescape XML entities so stored attribute values are the actual\n      // decoded strings, matching text-node handling and extractAttribute.\n      // This prevents double-escaping when the value is later re-serialized.\n      const decodedValue = XMLBuilder.unescapeXml(attrValue);\n\n      // Parse attribute value\n      attributes[prefixedName] = options.parseAttributeValue\n        ? XMLParser.parseValue(decodedValue)\n        : decodedValue;\n    }\n\n    return attributes;\n  }\n\n  /**\n   * Finds the closing tag for an element, handling nesting\n   * @private\n   */\n  private static findClosingTag(xml: string, elementName: string, startPos: number): number {\n    const openTag = `<${elementName}`;\n    const closeTag = `</${elementName}>`;\n    let depth = 1;\n    let pos = startPos;\n\n    while (depth > 0 && pos < xml.length) {\n      const nextClose = xml.indexOf(closeTag, pos);\n\n      if (nextClose === -1) {\n        return -1; // No closing tag found\n      }\n\n      // Find the next REAL opening tag (not a prefix match like <w:pPrChange for <w:pPr)\n      // Must search for all potential matches and verify each one\n      let realOpenPos = -1;\n      let searchPos = pos;\n      while (searchPos < nextClose) {\n        const candidateOpen = xml.indexOf(openTag, searchPos);\n        if (candidateOpen === -1 || candidateOpen >= nextClose) {\n          break; // No more candidates before the closing tag\n        }\n\n        const charAfter = xml[candidateOpen + openTag.length];\n        if (\n          charAfter === '>' ||\n          charAfter === ' ' ||\n          charAfter === '/' ||\n          charAfter === '\\t' ||\n          charAfter === '\\n' ||\n          charAfter === '\\r'\n        ) {\n          // This looks like a real opening tag - but check if it's self-closing\n          // Self-closing tags like <w:rPr/> should NOT increase depth\n          const tagEnd = xml.indexOf('>', candidateOpen);\n          if (tagEnd !== -1 && xml[tagEnd - 1] === '/') {\n            // Self-closing tag - skip it (don't affect depth)\n            searchPos = tagEnd + 1;\n            continue;\n          }\n          // This is a real opening tag (not self-closing)\n          realOpenPos = candidateOpen;\n          break;\n        }\n\n        // False positive (e.g., <w:pPrChange when looking for <w:pPr)\n        // Keep searching from after this position\n        searchPos = candidateOpen + openTag.length;\n      }\n\n      if (realOpenPos !== -1) {\n        // Found a real opening tag before the closing tag - increase depth\n        depth++;\n        pos = realOpenPos + openTag.length;\n      } else {\n        // No real opening tag before this closing tag - decrease depth\n        depth--;\n        if (depth === 0) {\n          return nextClose;\n        }\n        pos = nextClose + closeTag.length;\n      }\n    }\n\n    return -1;\n  }\n\n  /**\n   * Coalesces children with duplicate names into arrays\n   * @private\n   */\n  private static coalesceChildren(\n    children: ParsedElement[],\n    options: Required<ParseToObjectOptions>\n  ): ParsedXMLObject {\n    const result: ParsedXMLObject = {};\n    const nameCounts: Record<string, number> = {};\n    const nameIndices: Record<string, number> = {};\n\n    // Track element order for correct run content parsing (tabs, breaks, text)\n    // This is critical for preserving the order of mixed content like: text -> tab -> text\n    const orderedChildren: { type: string; index: number }[] = [];\n\n    // Count occurrences of each child name\n    for (const child of children) {\n      nameCounts[child.name] = (nameCounts[child.name] || 0) + 1;\n    }\n\n    // Build result object while tracking order\n    for (const child of children) {\n      const shouldBeArray = options.alwaysArray || (nameCounts[child.name] || 0) > 1;\n\n      // Track element order with its index in the array\n      const currentIndex = nameIndices[child.name] || 0;\n      orderedChildren.push({ type: child.name, index: currentIndex });\n      nameIndices[child.name] = currentIndex + 1;\n\n      if (shouldBeArray) {\n        if (!result[child.name]) {\n          result[child.name] = [];\n        }\n        (result[child.name] as ParsedXMLValue[]).push(child.value);\n      } else {\n        result[child.name] = child.value;\n      }\n    }\n\n    // Add _orderedChildren to track element order (used by DocumentParser for runs)\n    if (orderedChildren.length > 0) {\n      result._orderedChildren = orderedChildren;\n    }\n\n    return result;\n  }\n\n  /**\n   * Parses a string value to number or boolean if applicable\n   * @private\n   */\n  private static parseValue(value: string): string | number | boolean {\n    if (value === 'true') return true;\n    if (value === 'false') return false;\n\n    // Preserve 6-character hex color codes (OpenXML standard for colors)\n    // This includes \"000000\" (black) which should stay as a string\n    if (/^[0-9A-Fa-f]{6}$/.test(value)) {\n      return value.toUpperCase(); // Normalize to uppercase per Microsoft convention\n    }\n\n    // Preserve long digit-only strings (e.g., cnfStyle binary strings like \"100000000000\")\n    // These should not be converted to numbers to avoid losing leading zeros\n    if (/^\\d{7,}$/.test(value)) {\n      return value; // Keep as string for values with 7+ digits\n    }\n\n    // Try parsing as number\n    // 3-character values like \"240\" will be parsed as numbers\n    // 6-character hex values are already handled above\n    if (/^-?\\d+$/.test(value)) {\n      const num = parseInt(value, 10);\n      if (!isNaN(num)) return num;\n    }\n\n    if (/^-?\\d+\\.\\d+$/.test(value)) {\n      const num = parseFloat(value);\n      if (!isNaN(num)) return num;\n    }\n\n    // Preserve 3-character hex codes (like \"F0A\") that have letters\n    // Pure numeric 3-char values (like \"240\") are already parsed as numbers above\n    if (/^[0-9A-Fa-f]{3}$/.test(value) && /[A-Fa-f]/.test(value)) {\n      return value.toUpperCase();\n    }\n\n    return value;\n  }\n}\n"]}

package/dist/zip/ZipHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZipHandler.d.ts","sourceRoot":"","sources":["../../src/zip/ZipHandler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ZipHandler.d.ts","sourceRoot":"","sources":["../../src/zip/ZipHandler.ts"],"names":[],"mappings":"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"}

package/dist/zip/ZipHandler.js

@@ -37,7 +37,9 @@ exports.ZipHandler = void 0;
 const ZipReader_js_1 = require("./ZipReader.js");
 const ZipWriter_js_1 = require("./ZipWriter.js");
 const types_js_1 = require("./types.js");
+const errors_js_1 = require("./errors.js");
 const logger_js_1 = require("../utils/logger.js");
+const validation_js_1 = require("../utils/validation.js");
 function getLogger() {
     return (0, logger_js_1.createScopedLogger)((0, logger_js_1.getGlobalLogger)(), 'ZipHandler');
 }
@@ -54,7 +56,7 @@ class ZipHandler {
         const { warningSizeMB, maxSizeMB } = limits;
         if (maxSizeMB > 0 && sizeMB > maxSizeMB) {
             logger.error('Document exceeds maximum size', { sizeMB: sizeMB.toFixed(1), maxSizeMB });
-            throw new Error(`Document size (${sizeMB.toFixed(1)}MB) exceeds maximum supported size (${maxSizeMB}MB). ` +
+            throw new errors_js_1.ResourceLimitError(`Document size (${sizeMB.toFixed(1)}MB) exceeds maximum supported size (${maxSizeMB}MB). ` +
                 `This would likely cause out-of-memory errors. Consider:\n` +
                 `- Compressing/optimizing images\n` +
                 `- Splitting into multiple documents\n` +
@@ -79,12 +81,20 @@ class ZipHandler {
         const sizeMB = stats.size / (1024 * 1024);
         const limits = this.getSizeLimits(options);
         this.validateDocumentSize(sizeMB, limits);
-        await this.reader.loadFromFile(filePath, options);
-        const files = this.reader.getAllFiles();
-        this.writer.clear();
-        this.writer.addFiles(files);
-        this.mode = 'modify';
-        logger.info('DOCX file loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });
+        try {
+            await this.reader.loadFromFile(filePath, options);
+            const files = this.reader.getAllFiles();
+            this.writer.clear();
+            this.writer.addFiles(files);
+            this.mode = 'modify';
+            logger.info('DOCX file loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });
+        }
+        catch (error) {
+            this.writer.clear();
+            this.reader = new ZipReader_js_1.ZipReader();
+            this.mode = 'write';
+            throw error;
+        }
     }
     async loadFromBuffer(buffer, options = {}) {
         const logger = getLogger();
@@ -92,12 +102,20 @@ class ZipHandler {
         const sizeMB = buffer.length / (1024 * 1024);
         const limits = this.getSizeLimits(options);
         this.validateDocumentSize(sizeMB, limits);
-        await this.reader.loadFromBuffer(buffer, options);
-        const files = this.reader.getAllFiles();
-        this.writer.clear();
-        this.writer.addFiles(files);
-        this.mode = 'modify';
-        logger.info('DOCX buffer loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });
+        try {
+            await this.reader.loadFromBuffer(buffer, options);
+            const files = this.reader.getAllFiles();
+            this.writer.clear();
+            this.writer.addFiles(files);
+            this.mode = 'modify';
+            logger.info('DOCX buffer loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });
+        }
+        catch (error) {
+            this.writer.clear();
+            this.reader = new ZipReader_js_1.ZipReader();
+            this.mode = 'write';
+            throw error;
+        }
     }
     addFile(filePath, content, options = {}) {
         this.writer.addFile(filePath, content, options);
@@ -160,6 +178,9 @@ class ZipHandler {
         if (!file) {
             return false;
         }
+        if ((0, validation_js_1.normalizePath)(oldPath) === (0, validation_js_1.normalizePath)(newPath)) {
+            return true;
+        }
         this.addFile(newPath, file.content, {
             binary: file.isBinary,
             date: file.date,
@@ -182,6 +203,9 @@ class ZipHandler {
         if (!this.copyFile(srcPath, destPath)) {
             return false;
         }
+        if ((0, validation_js_1.normalizePath)(srcPath) === (0, validation_js_1.normalizePath)(destPath)) {
+            return true;
+        }
         this.removeFile(srcPath);
         return true;
     }

package/dist/zip/ZipHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ZipHandler.js","sourceRoot":"","sources":["../../src/zip/ZipHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ZipHandler - Main facade for ZIP archive operations\n * Provides a unified interface for reading and writing DOCX files\n */\n\nimport { ZipReader } from './ZipReader.js';\nimport { ZipWriter } from './ZipWriter.js';\nimport {\n  ZipFile,\n  FileMap,\n  LoadOptions,\n  SaveOptions,\n  AddFileOptions,\n  SizeLimitOptions,\n  DEFAULT_SIZE_LIMITS,\n} from './types.js';\nimport { getGlobalLogger, createScopedLogger, ILogger } from '../utils/logger.js';\n\n// Create scoped logger for ZipHandler operations\nfunction getLogger(): ILogger {\n  return createScopedLogger(getGlobalLogger(), 'ZipHandler');\n}\n\n/**\n * Main class for handling ZIP archives (DOCX files)\n * Combines reading and writing operations into a single interface\n */\nexport class ZipHandler {\n  private reader: ZipReader;\n  private writer: ZipWriter;\n  private mode: 'read' | 'write' | 'modify' = 'write';\n\n  constructor() {\n    this.reader = new ZipReader();\n    this.writer = new ZipWriter();\n  }\n\n  // ==================== SIZE VALIDATION ====================\n\n  /**\n   * Validates document size against configured limits\n   * @param sizeMB - Size in megabytes\n   * @param limits - Size limit options (merged with defaults)\n   * @throws Error if size exceeds maximum\n   */\n  private validateDocumentSize(sizeMB: number, limits: Required<SizeLimitOptions>): void {\n    const logger = getLogger();\n    const { warningSizeMB, maxSizeMB } = limits;\n\n    // Check maximum size (if enabled)\n    if (maxSizeMB > 0 && sizeMB > maxSizeMB) {\n      logger.error('Document exceeds maximum size', { sizeMB: sizeMB.toFixed(1), maxSizeMB });\n      throw new Error(\n        `Document size (${sizeMB.toFixed(1)}MB) exceeds maximum supported size (${maxSizeMB}MB). ` +\n          `This would likely cause out-of-memory errors. Consider:\\n` +\n          `- Compressing/optimizing images\\n` +\n          `- Splitting into multiple documents\\n` +\n          `- Processing on a machine with more memory\\n` +\n          `- Increasing maxSizeMB via LoadOptions.sizeLimits (not recommended)`\n      );\n    }\n\n    // Warn on large files (if enabled)\n    if (warningSizeMB > 0 && sizeMB > warningSizeMB) {\n      logger.warn('Large document detected', { sizeMB: sizeMB.toFixed(1), warningSizeMB });\n    }\n  }\n\n  /**\n   * Gets merged size limits from options and defaults\n   * @param options - Load options that may contain size limits\n   * @returns Merged size limits with all values defined\n   */\n  private getSizeLimits(options: LoadOptions): Required<SizeLimitOptions> {\n    return {\n      ...DEFAULT_SIZE_LIMITS,\n      ...options.sizeLimits,\n    };\n  }\n\n  // ==================== LOADING ====================\n\n  /**\n   * Loads a DOCX file from the filesystem\n   * @param filePath - Path to the DOCX file\n   * @param options - Load options (including configurable size limits)\n   */\n  async load(filePath: string, options: LoadOptions = {}): Promise<void> {\n    const logger = getLogger();\n    logger.info('Loading DOCX file', { path: filePath });\n\n    // Check file size before loading\n    const { promises: fs } = await import('fs');\n    const stats = await fs.stat(filePath);\n    const sizeMB = stats.size / (1024 * 1024);\n\n    // Validate against configurable limits\n    const limits = this.getSizeLimits(options);\n    this.validateDocumentSize(sizeMB, limits);\n\n    await this.reader.loadFromFile(filePath, options);\n\n    // Copy all files from reader to writer for modification\n    const files = this.reader.getAllFiles();\n    this.writer.clear();\n    this.writer.addFiles(files);\n\n    this.mode = 'modify';\n    logger.info('DOCX file loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });\n  }\n\n  /**\n   * Loads a DOCX file from a buffer\n   * @param buffer - Buffer containing the DOCX data\n   * @param options - Load options (including configurable size limits)\n   */\n  async loadFromBuffer(buffer: Buffer, options: LoadOptions = {}): Promise<void> {\n    const logger = getLogger();\n    logger.info('Loading DOCX from buffer', { bufferSize: buffer.length });\n\n    // Check buffer size before loading\n    const sizeMB = buffer.length / (1024 * 1024);\n\n    // Validate against configurable limits\n    const limits = this.getSizeLimits(options);\n    this.validateDocumentSize(sizeMB, limits);\n\n    await this.reader.loadFromBuffer(buffer, options);\n\n    // Copy all files from reader to writer for modification\n    const files = this.reader.getAllFiles();\n    this.writer.clear();\n    this.writer.addFiles(files);\n\n    this.mode = 'modify';\n    logger.info('DOCX buffer loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });\n  }\n\n  // ==================== FILE OPERATIONS ====================\n\n  /**\n   * Adds a file to the archive\n   * @param filePath - Path where the file will be stored in the archive\n   * @param content - File content (string or Buffer)\n   * @param options - Options for adding the file\n   */\n  addFile(filePath: string, content: string | Buffer, options: AddFileOptions = {}): void {\n    this.writer.addFile(filePath, content, options);\n  }\n\n  /**\n   * Adds multiple files to the archive\n   * @param files - Map of file paths to contents\n   * @param options - Options for adding files\n   */\n  addFiles(files: FileMap, options: AddFileOptions = {}): void {\n    this.writer.addFiles(files, options);\n  }\n\n  /**\n   * Updates an existing file in the archive\n   * @param filePath - Path to the file to update\n   * @param content - New content\n   * @param options - Options for updating the file\n   * @returns True if the file was updated, false if it didn't exist\n   */\n  updateFile(filePath: string, content: string | Buffer, options: AddFileOptions = {}): boolean {\n    if (!this.hasFile(filePath)) {\n      return false;\n    }\n    this.addFile(filePath, content, options);\n    return true;\n  }\n\n  /**\n   * Removes a file from the archive\n   * @param filePath - Path to the file to remove\n   * @returns True if the file was removed, false if it didn't exist\n   */\n  removeFile(filePath: string): boolean {\n    return this.writer.removeFile(filePath);\n  }\n\n  /**\n   * Gets a specific file from the archive\n   * @param filePath - Path to the file within the archive\n   * @returns The file data, or undefined if not found\n   */\n  getFile(filePath: string): ZipFile | undefined {\n    return this.writer.getFile(filePath);\n  }\n\n  /**\n   * Gets the content of a specific file as a string\n   * @param filePath - Path to the file within the archive\n   * @returns The file content as a UTF-8 string, or undefined if not found\n   * @throws Error if attempting to convert a binary file to string (Issue #12 fix)\n   *\n   * **Encoding Note:**\n   * - Returns UTF-8 decoded string content for text files\n   * - All text content in DOCX files must be UTF-8 per OpenXML specification\n   * - For binary files (images, fonts), throws an error to prevent garbage output\n   * - Use getFileAsBuffer() for binary files instead\n   */\n  getFileAsString(filePath: string): string | undefined {\n    const file = this.getFile(filePath);\n    if (!file) {\n      return undefined;\n    }\n\n    // Issue #12 fix: Prevent converting binary files to UTF-8 strings\n    // This produces garbage output for images, fonts, etc.\n    if (file.isBinary) {\n      throw new Error(\n        `Cannot convert binary file \"${filePath}\" to string. ` +\n          `Binary files (images, fonts, etc.) cannot be safely converted to UTF-8 strings. ` +\n          `Use getFileAsBuffer() instead to access the raw bytes.`\n      );\n    }\n\n    // After ZipWriter fix (Issue #4), check actual content type instead of flag\n    // Content from ZipWriter is always Buffer, content from ZipReader may be string\n    if (Buffer.isBuffer(file.content)) {\n      // Convert buffer to UTF-8 string\n      return file.content.toString('utf8');\n    }\n\n    return file.content;\n  }\n\n  /**\n   * Gets the content of a specific file as a buffer\n   * @param filePath - Path to the file within the archive\n   * @returns The file content as a Buffer, or undefined if not found\n   *\n   * **Encoding Note:**\n   * - Returns Buffer with UTF-8 encoded content for text files\n   * - For binary files, returns raw bytes unchanged\n   * - All text content is guaranteed to be UTF-8 encoded\n   */\n  getFileAsBuffer(filePath: string): Buffer | undefined {\n    const file = this.getFile(filePath);\n    if (!file) {\n      return undefined;\n    }\n\n    // After ZipWriter fix (Issue #4), check actual content type instead of flag\n    // Content from ZipWriter is always Buffer, content from ZipReader may be string\n    if (Buffer.isBuffer(file.content)) {\n      return file.content;\n    }\n\n    // Encode string content as UTF-8 Buffer (for content from ZipReader)\n    return Buffer.from(file.content, 'utf8');\n  }\n\n  /**\n   * Gets all files from the archive\n   * @returns Map of file paths to file data\n   */\n  getAllFiles(): FileMap {\n    return this.writer.getAllFiles();\n  }\n\n  /**\n   * Gets a list of all file paths in the archive\n   * @returns Array of file paths\n   */\n  getFilePaths(): string[] {\n    return this.writer.getFilePaths();\n  }\n\n  /**\n   * Checks if a file exists in the archive\n   * @param filePath - Path to check\n   * @returns True if the file exists\n   */\n  hasFile(filePath: string): boolean {\n    return this.writer.hasFile(filePath);\n  }\n\n  /**\n   * Gets the number of files in the archive\n   * @returns Number of files\n   */\n  getFileCount(): number {\n    return this.writer.getFileCount();\n  }\n\n  // ==================== HELPER METHODS ====================\n\n  /**\n   * Renames a file in the archive\n   * @param oldPath - Current path of the file\n   * @param newPath - New path for the file\n   * @returns True if the file was renamed, false if it didn't exist\n   */\n  renameFile(oldPath: string, newPath: string): boolean {\n    const file = this.getFile(oldPath);\n    if (!file) {\n      return false;\n    }\n    this.addFile(newPath, file.content, {\n      binary: file.isBinary,\n      date: file.date,\n    });\n    this.removeFile(oldPath);\n    return true;\n  }\n\n  /**\n   * Copies a file within the archive\n   * @param srcPath - Source file path\n   * @param destPath - Destination file path\n   * @returns True if the file was copied, false if source didn't exist\n   */\n  copyFile(srcPath: string, destPath: string): boolean {\n    const file = this.getFile(srcPath);\n    if (!file) {\n      return false;\n    }\n    this.addFile(destPath, file.content, {\n      binary: file.isBinary,\n      date: file.date,\n    });\n    return true;\n  }\n\n  /**\n   * Moves a file within the archive (copy and delete)\n   * @param srcPath - Source file path\n   * @param destPath - Destination file path\n   * @returns True if the file was moved, false if source didn't exist\n   */\n  moveFile(srcPath: string, destPath: string): boolean {\n    if (!this.copyFile(srcPath, destPath)) {\n      return false;\n    }\n    this.removeFile(srcPath);\n    return true;\n  }\n\n  /**\n   * Checks if a file exists, throws if it doesn't\n   * @param filePath - Path to check\n   * @throws {Error} If file doesn't exist\n   */\n  existsOrThrow(filePath: string): void {\n    if (!this.hasFile(filePath)) {\n      throw new Error(`File not found in archive: ${filePath}`);\n    }\n  }\n\n  /**\n   * Removes multiple files from the archive\n   * @param filePaths - Array of file paths to remove\n   * @returns Number of files successfully removed\n   */\n  removeFiles(filePaths: string[]): number {\n    let count = 0;\n    for (const filePath of filePaths) {\n      if (this.removeFile(filePath)) {\n        count++;\n      }\n    }\n    return count;\n  }\n\n  /**\n   * Gets all files with a specific extension\n   * @param extension - File extension (with or without leading dot)\n   * @returns Array of files with the specified extension\n   */\n  getFilesByExtension(extension: string): ZipFile[] {\n    const ext = extension.startsWith('.') ? extension : `.${extension}`;\n    const files: ZipFile[] = [];\n    for (const [path, file] of this.getAllFiles()) {\n      if (path.toLowerCase().endsWith(ext.toLowerCase())) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Gets the total uncompressed size of all files in the archive\n   * @returns Total size in bytes\n   */\n  getTotalSize(): number {\n    let totalSize = 0;\n    for (const file of this.getAllFiles().values()) {\n      totalSize += file.size;\n    }\n    return totalSize;\n  }\n\n  /**\n   * Gets comprehensive statistics about the archive\n   * @returns Statistics object\n   */\n  getStats(): {\n    fileCount: number;\n    totalSize: number;\n    textFileCount: number;\n    binaryFileCount: number;\n    avgFileSize: number;\n  } {\n    let textCount = 0;\n    let binaryCount = 0;\n    const totalSize = this.getTotalSize();\n    const fileCount = this.getFileCount();\n\n    for (const file of this.getAllFiles().values()) {\n      if (file.isBinary) {\n        binaryCount++;\n      } else {\n        textCount++;\n      }\n    }\n\n    return {\n      fileCount,\n      totalSize,\n      textFileCount: textCount,\n      binaryFileCount: binaryCount,\n      avgFileSize: fileCount > 0 ? Math.round(totalSize / fileCount) : 0,\n    };\n  }\n\n  /**\n   * Checks if the archive is empty\n   * @returns True if the archive has no files\n   */\n  isEmpty(): boolean {\n    return this.getFileCount() === 0;\n  }\n\n  /**\n   * Gets all text (non-binary) files from the archive\n   * @returns Array of text files\n   */\n  getTextFiles(): ZipFile[] {\n    const files: ZipFile[] = [];\n    for (const file of this.getAllFiles().values()) {\n      if (!file.isBinary) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Gets all binary files from the archive\n   * @returns Array of binary files\n   */\n  getBinaryFiles(): ZipFile[] {\n    const files: ZipFile[] = [];\n    for (const file of this.getAllFiles().values()) {\n      if (file.isBinary) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Gets all media files from the word/media/ directory\n   * @returns Array of media files\n   */\n  getMediaFiles(): ZipFile[] {\n    const files: ZipFile[] = [];\n    for (const [path, file] of this.getAllFiles()) {\n      if (path.startsWith('word/media/')) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Exports a file from the archive to the filesystem\n   * @param internalPath - Path of the file within the archive\n   * @param outputPath - Path where the file will be saved\n   */\n  async exportFile(internalPath: string, outputPath: string): Promise<void> {\n    const { promises: fs } = await import('fs');\n    const content = this.getFileAsBuffer(internalPath);\n    if (!content) {\n      throw new Error(`File not found in archive: ${internalPath}`);\n    }\n    await fs.writeFile(outputPath, content);\n  }\n\n  /**\n   * Imports a file from the filesystem into the archive\n   * @param sourcePath - Path to the file on filesystem\n   * @param internalPath - Path where the file will be stored in archive\n   * @param options - Options for adding the file\n   */\n  async importFile(\n    sourcePath: string,\n    internalPath: string,\n    options: AddFileOptions = {}\n  ): Promise<void> {\n    const { promises: fs } = await import('fs');\n    const content = await fs.readFile(sourcePath);\n    this.addFile(internalPath, content, {\n      ...options,\n      binary: options.binary !== undefined ? options.binary : true,\n    });\n  }\n\n  // ==================== SAVING ====================\n\n  /**\n   * Saves the archive to a file\n   * @param filePath - Path where the file will be saved\n   * @param options - Save options\n   */\n  async save(filePath: string, options: SaveOptions = {}): Promise<void> {\n    const logger = getLogger();\n    logger.info('Saving DOCX file', { path: filePath, fileCount: this.getFileCount() });\n    await this.writer.saveToFile(filePath, options);\n    logger.info('DOCX file saved', { path: filePath });\n  }\n\n  /**\n   * Generates the ZIP archive as a buffer\n   * @param options - Save options\n   * @returns Buffer containing the ZIP archive\n   */\n  async toBuffer(options: SaveOptions = {}): Promise<Buffer> {\n    const logger = getLogger();\n    logger.info('Generating DOCX buffer', { fileCount: this.getFileCount() });\n    const buffer = await this.writer.toBuffer(options);\n    logger.info('DOCX buffer generated', { bufferSize: buffer.length });\n    return buffer;\n  }\n\n  // ==================== VALIDATION ====================\n\n  /**\n   * Validates the DOCX structure\n   * @throws {MissingRequiredFileError} If required files are missing\n   */\n  validate(): void {\n    const logger = getLogger();\n    logger.info('Validating DOCX structure');\n    this.writer.validate();\n    logger.info('DOCX structure valid');\n  }\n\n  // ==================== UTILITY ====================\n\n  /**\n   * Creates a new empty archive\n   */\n  clear(): void {\n    this.reader.clear();\n    this.writer.clear();\n    this.mode = 'write';\n  }\n\n  /**\n   * Gets the current mode of the handler\n   * @returns Current mode ('read', 'write', or 'modify')\n   */\n  getMode(): 'read' | 'write' | 'modify' {\n    return this.mode;\n  }\n\n  /**\n   * Checks if the archive has been loaded\n   * @returns True if loaded\n   */\n  isLoaded(): boolean {\n    return this.reader.isLoaded();\n  }\n\n  /**\n   * Creates a clone of this handler with all its files\n   * @returns A new ZipHandler instance with the same files\n   */\n  clone(): ZipHandler {\n    const newHandler = new ZipHandler();\n    newHandler.writer = this.writer.clone();\n    newHandler.mode = this.mode;\n    return newHandler;\n  }\n\n  // ==================== CONVENIENCE METHODS ====================\n\n  /**\n   * Reads a DOCX file, modifies it, and saves it back\n   * @param inputPath - Path to the input DOCX file\n   * @param outputPath - Path to save the modified file\n   * @param modifier - Function that modifies the handler\n   * @param loadOptions - Options for loading\n   * @param saveOptions - Options for saving\n   */\n  static async modify(\n    inputPath: string,\n    outputPath: string,\n    modifier: (handler: ZipHandler) => void | Promise<void>,\n    loadOptions: LoadOptions = {},\n    saveOptions: SaveOptions = {}\n  ): Promise<void> {\n    const handler = new ZipHandler();\n    await handler.load(inputPath, loadOptions);\n    await modifier(handler);\n    await handler.save(outputPath, saveOptions);\n  }\n\n  /**\n   * Creates a new DOCX file with the provided files\n   * @param outputPath - Path to save the new file\n   * @param files - Map of file paths to contents\n   * @param saveOptions - Options for saving\n   */\n  static async create(\n    outputPath: string,\n    files: FileMap,\n    saveOptions: SaveOptions = {}\n  ): Promise<void> {\n    const handler = new ZipHandler();\n    handler.addFiles(files);\n    await handler.save(outputPath, saveOptions);\n  }\n}\n"]}
+{"version":3,"file":"ZipHandler.js","sourceRoot":"","sources":["../../src/zip/ZipHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ZipHandler - Main facade for ZIP archive operations\n * Provides a unified interface for reading and writing DOCX files\n */\n\nimport { ZipReader } from './ZipReader.js';\nimport { ZipWriter } from './ZipWriter.js';\nimport {\n  ZipFile,\n  FileMap,\n  LoadOptions,\n  SaveOptions,\n  AddFileOptions,\n  SizeLimitOptions,\n  DEFAULT_SIZE_LIMITS,\n} from './types.js';\nimport { ResourceLimitError } from './errors.js';\nimport { getGlobalLogger, createScopedLogger, ILogger } from '../utils/logger.js';\nimport { normalizePath } from '../utils/validation.js';\n\n// Create scoped logger for ZipHandler operations\nfunction getLogger(): ILogger {\n  return createScopedLogger(getGlobalLogger(), 'ZipHandler');\n}\n\n/**\n * Main class for handling ZIP archives (DOCX files)\n * Combines reading and writing operations into a single interface\n */\nexport class ZipHandler {\n  private reader: ZipReader;\n  private writer: ZipWriter;\n  private mode: 'read' | 'write' | 'modify' = 'write';\n\n  constructor() {\n    this.reader = new ZipReader();\n    this.writer = new ZipWriter();\n  }\n\n  // ==================== SIZE VALIDATION ====================\n\n  /**\n   * Validates document size against configured limits\n   * @param sizeMB - Size in megabytes\n   * @param limits - Size limit options (merged with defaults)\n   * @throws {ResourceLimitError} If the compressed size exceeds maxSizeMB\n   */\n  private validateDocumentSize(sizeMB: number, limits: Required<SizeLimitOptions>): void {\n    const logger = getLogger();\n    const { warningSizeMB, maxSizeMB } = limits;\n\n    // Check maximum size (if enabled). Throw the typed ResourceLimitError so this\n    // compressed-size guard is catchable by the same type as the uncompressed/ratio/\n    // entry-count guards enforced downstream in ZipReader — callers can distinguish a\n    // hostile/oversized payload from a genuinely corrupt archive.\n    if (maxSizeMB > 0 && sizeMB > maxSizeMB) {\n      logger.error('Document exceeds maximum size', { sizeMB: sizeMB.toFixed(1), maxSizeMB });\n      throw new ResourceLimitError(\n        `Document size (${sizeMB.toFixed(1)}MB) exceeds maximum supported size (${maxSizeMB}MB). ` +\n          `This would likely cause out-of-memory errors. Consider:\\n` +\n          `- Compressing/optimizing images\\n` +\n          `- Splitting into multiple documents\\n` +\n          `- Processing on a machine with more memory\\n` +\n          `- Increasing maxSizeMB via LoadOptions.sizeLimits (not recommended)`\n      );\n    }\n\n    // Warn on large files (if enabled)\n    if (warningSizeMB > 0 && sizeMB > warningSizeMB) {\n      logger.warn('Large document detected', { sizeMB: sizeMB.toFixed(1), warningSizeMB });\n    }\n  }\n\n  /**\n   * Gets merged size limits from options and defaults\n   * @param options - Load options that may contain size limits\n   * @returns Merged size limits with all values defined\n   */\n  private getSizeLimits(options: LoadOptions): Required<SizeLimitOptions> {\n    return {\n      ...DEFAULT_SIZE_LIMITS,\n      ...options.sizeLimits,\n    };\n  }\n\n  // ==================== LOADING ====================\n\n  /**\n   * Loads a DOCX file from the filesystem\n   * @param filePath - Path to the DOCX file\n   * @param options - Load options (including configurable size limits)\n   */\n  async load(filePath: string, options: LoadOptions = {}): Promise<void> {\n    const logger = getLogger();\n    logger.info('Loading DOCX file', { path: filePath });\n\n    // Check file size before loading\n    const { promises: fs } = await import('fs');\n    const stats = await fs.stat(filePath);\n    const sizeMB = stats.size / (1024 * 1024);\n\n    // Validate against configurable limits\n    const limits = this.getSizeLimits(options);\n    this.validateDocumentSize(sizeMB, limits);\n\n    try {\n      await this.reader.loadFromFile(filePath, options);\n\n      // Copy all files from reader to writer for modification\n      const files = this.reader.getAllFiles();\n      this.writer.clear();\n      this.writer.addFiles(files);\n\n      this.mode = 'modify';\n      logger.info('DOCX file loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });\n    } catch (error) {\n      // A failed reload must not leave the handler serving the previously loaded\n      // archive. Reset to a deterministically empty state so getFile/save/etc.\n      // cannot silently return stale content. A fresh reader discards any\n      // partially-extracted files and the stale `loaded` flag.\n      this.writer.clear();\n      this.reader = new ZipReader();\n      this.mode = 'write';\n      throw error;\n    }\n  }\n\n  /**\n   * Loads a DOCX file from a buffer\n   * @param buffer - Buffer containing the DOCX data\n   * @param options - Load options (including configurable size limits)\n   */\n  async loadFromBuffer(buffer: Buffer, options: LoadOptions = {}): Promise<void> {\n    const logger = getLogger();\n    logger.info('Loading DOCX from buffer', { bufferSize: buffer.length });\n\n    // Check buffer size before loading\n    const sizeMB = buffer.length / (1024 * 1024);\n\n    // Validate against configurable limits\n    const limits = this.getSizeLimits(options);\n    this.validateDocumentSize(sizeMB, limits);\n\n    try {\n      await this.reader.loadFromBuffer(buffer, options);\n\n      // Copy all files from reader to writer for modification\n      const files = this.reader.getAllFiles();\n      this.writer.clear();\n      this.writer.addFiles(files);\n\n      this.mode = 'modify';\n      logger.info('DOCX buffer loaded', { fileCount: files.size, sizeMB: sizeMB.toFixed(2) });\n    } catch (error) {\n      // A failed reload must not leave the handler serving the previously loaded\n      // archive. Reset to a deterministically empty state so getFile/save/etc.\n      // cannot silently return stale content. A fresh reader discards any\n      // partially-extracted files and the stale `loaded` flag.\n      this.writer.clear();\n      this.reader = new ZipReader();\n      this.mode = 'write';\n      throw error;\n    }\n  }\n\n  // ==================== FILE OPERATIONS ====================\n\n  /**\n   * Adds a file to the archive\n   * @param filePath - Path where the file will be stored in the archive\n   * @param content - File content (string or Buffer)\n   * @param options - Options for adding the file\n   */\n  addFile(filePath: string, content: string | Buffer, options: AddFileOptions = {}): void {\n    this.writer.addFile(filePath, content, options);\n  }\n\n  /**\n   * Adds multiple files to the archive\n   * @param files - Map of file paths to contents\n   * @param options - Options for adding files\n   */\n  addFiles(files: FileMap, options: AddFileOptions = {}): void {\n    this.writer.addFiles(files, options);\n  }\n\n  /**\n   * Updates an existing file in the archive\n   * @param filePath - Path to the file to update\n   * @param content - New content\n   * @param options - Options for updating the file\n   * @returns True if the file was updated, false if it didn't exist\n   */\n  updateFile(filePath: string, content: string | Buffer, options: AddFileOptions = {}): boolean {\n    if (!this.hasFile(filePath)) {\n      return false;\n    }\n    this.addFile(filePath, content, options);\n    return true;\n  }\n\n  /**\n   * Removes a file from the archive\n   * @param filePath - Path to the file to remove\n   * @returns True if the file was removed, false if it didn't exist\n   */\n  removeFile(filePath: string): boolean {\n    return this.writer.removeFile(filePath);\n  }\n\n  /**\n   * Gets a specific file from the archive\n   * @param filePath - Path to the file within the archive\n   * @returns The file data, or undefined if not found\n   */\n  getFile(filePath: string): ZipFile | undefined {\n    return this.writer.getFile(filePath);\n  }\n\n  /**\n   * Gets the content of a specific file as a string\n   * @param filePath - Path to the file within the archive\n   * @returns The file content as a UTF-8 string, or undefined if not found\n   * @throws Error if attempting to convert a binary file to string (Issue #12 fix)\n   *\n   * **Encoding Note:**\n   * - Returns UTF-8 decoded string content for text files\n   * - All text content in DOCX files must be UTF-8 per OpenXML specification\n   * - For binary files (images, fonts), throws an error to prevent garbage output\n   * - Use getFileAsBuffer() for binary files instead\n   */\n  getFileAsString(filePath: string): string | undefined {\n    const file = this.getFile(filePath);\n    if (!file) {\n      return undefined;\n    }\n\n    // Issue #12 fix: Prevent converting binary files to UTF-8 strings\n    // This produces garbage output for images, fonts, etc.\n    if (file.isBinary) {\n      throw new Error(\n        `Cannot convert binary file \"${filePath}\" to string. ` +\n          `Binary files (images, fonts, etc.) cannot be safely converted to UTF-8 strings. ` +\n          `Use getFileAsBuffer() instead to access the raw bytes.`\n      );\n    }\n\n    // After ZipWriter fix (Issue #4), check actual content type instead of flag\n    // Content from ZipWriter is always Buffer, content from ZipReader may be string\n    if (Buffer.isBuffer(file.content)) {\n      // Convert buffer to UTF-8 string\n      return file.content.toString('utf8');\n    }\n\n    return file.content;\n  }\n\n  /**\n   * Gets the content of a specific file as a buffer\n   * @param filePath - Path to the file within the archive\n   * @returns The file content as a Buffer, or undefined if not found\n   *\n   * **Encoding Note:**\n   * - Returns Buffer with UTF-8 encoded content for text files\n   * - For binary files, returns raw bytes unchanged\n   * - All text content is guaranteed to be UTF-8 encoded\n   */\n  getFileAsBuffer(filePath: string): Buffer | undefined {\n    const file = this.getFile(filePath);\n    if (!file) {\n      return undefined;\n    }\n\n    // After ZipWriter fix (Issue #4), check actual content type instead of flag\n    // Content from ZipWriter is always Buffer, content from ZipReader may be string\n    if (Buffer.isBuffer(file.content)) {\n      return file.content;\n    }\n\n    // Encode string content as UTF-8 Buffer (for content from ZipReader)\n    return Buffer.from(file.content, 'utf8');\n  }\n\n  /**\n   * Gets all files from the archive\n   * @returns Map of file paths to file data\n   */\n  getAllFiles(): FileMap {\n    return this.writer.getAllFiles();\n  }\n\n  /**\n   * Gets a list of all file paths in the archive\n   * @returns Array of file paths\n   */\n  getFilePaths(): string[] {\n    return this.writer.getFilePaths();\n  }\n\n  /**\n   * Checks if a file exists in the archive\n   * @param filePath - Path to check\n   * @returns True if the file exists\n   */\n  hasFile(filePath: string): boolean {\n    return this.writer.hasFile(filePath);\n  }\n\n  /**\n   * Gets the number of files in the archive\n   * @returns Number of files\n   */\n  getFileCount(): number {\n    return this.writer.getFileCount();\n  }\n\n  // ==================== HELPER METHODS ====================\n\n  /**\n   * Renames a file in the archive\n   * @param oldPath - Current path of the file\n   * @param newPath - New path for the file\n   * @returns True if the file was renamed, false if it didn't exist\n   */\n  renameFile(oldPath: string, newPath: string): boolean {\n    const file = this.getFile(oldPath);\n    if (!file) {\n      return false;\n    }\n    // Guard against degenerate rename where source and destination collapse to\n    // the same archive key (identical strings or backslash/forward-slash variants).\n    // Without this, addFile would overwrite the single entry and the subsequent\n    // removeFile would delete it, silently destroying the file.\n    if (normalizePath(oldPath) === normalizePath(newPath)) {\n      return true;\n    }\n    this.addFile(newPath, file.content, {\n      binary: file.isBinary,\n      date: file.date,\n    });\n    this.removeFile(oldPath);\n    return true;\n  }\n\n  /**\n   * Copies a file within the archive\n   * @param srcPath - Source file path\n   * @param destPath - Destination file path\n   * @returns True if the file was copied, false if source didn't exist\n   */\n  copyFile(srcPath: string, destPath: string): boolean {\n    const file = this.getFile(srcPath);\n    if (!file) {\n      return false;\n    }\n    this.addFile(destPath, file.content, {\n      binary: file.isBinary,\n      date: file.date,\n    });\n    return true;\n  }\n\n  /**\n   * Moves a file within the archive (copy and delete)\n   * @param srcPath - Source file path\n   * @param destPath - Destination file path\n   * @returns True if the file was moved, false if source didn't exist\n   */\n  moveFile(srcPath: string, destPath: string): boolean {\n    if (!this.copyFile(srcPath, destPath)) {\n      return false;\n    }\n    // Guard against degenerate move where source and destination collapse to the\n    // same archive key. copyFile already re-added the (identical) entry, so the\n    // removeFile below would delete it, silently destroying the file.\n    if (normalizePath(srcPath) === normalizePath(destPath)) {\n      return true;\n    }\n    this.removeFile(srcPath);\n    return true;\n  }\n\n  /**\n   * Checks if a file exists, throws if it doesn't\n   * @param filePath - Path to check\n   * @throws {Error} If file doesn't exist\n   */\n  existsOrThrow(filePath: string): void {\n    if (!this.hasFile(filePath)) {\n      throw new Error(`File not found in archive: ${filePath}`);\n    }\n  }\n\n  /**\n   * Removes multiple files from the archive\n   * @param filePaths - Array of file paths to remove\n   * @returns Number of files successfully removed\n   */\n  removeFiles(filePaths: string[]): number {\n    let count = 0;\n    for (const filePath of filePaths) {\n      if (this.removeFile(filePath)) {\n        count++;\n      }\n    }\n    return count;\n  }\n\n  /**\n   * Gets all files with a specific extension\n   * @param extension - File extension (with or without leading dot)\n   * @returns Array of files with the specified extension\n   */\n  getFilesByExtension(extension: string): ZipFile[] {\n    const ext = extension.startsWith('.') ? extension : `.${extension}`;\n    const files: ZipFile[] = [];\n    for (const [path, file] of this.getAllFiles()) {\n      if (path.toLowerCase().endsWith(ext.toLowerCase())) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Gets the total uncompressed size of all files in the archive\n   * @returns Total size in bytes\n   */\n  getTotalSize(): number {\n    let totalSize = 0;\n    for (const file of this.getAllFiles().values()) {\n      totalSize += file.size;\n    }\n    return totalSize;\n  }\n\n  /**\n   * Gets comprehensive statistics about the archive\n   * @returns Statistics object\n   */\n  getStats(): {\n    fileCount: number;\n    totalSize: number;\n    textFileCount: number;\n    binaryFileCount: number;\n    avgFileSize: number;\n  } {\n    let textCount = 0;\n    let binaryCount = 0;\n    const totalSize = this.getTotalSize();\n    const fileCount = this.getFileCount();\n\n    for (const file of this.getAllFiles().values()) {\n      if (file.isBinary) {\n        binaryCount++;\n      } else {\n        textCount++;\n      }\n    }\n\n    return {\n      fileCount,\n      totalSize,\n      textFileCount: textCount,\n      binaryFileCount: binaryCount,\n      avgFileSize: fileCount > 0 ? Math.round(totalSize / fileCount) : 0,\n    };\n  }\n\n  /**\n   * Checks if the archive is empty\n   * @returns True if the archive has no files\n   */\n  isEmpty(): boolean {\n    return this.getFileCount() === 0;\n  }\n\n  /**\n   * Gets all text (non-binary) files from the archive\n   * @returns Array of text files\n   */\n  getTextFiles(): ZipFile[] {\n    const files: ZipFile[] = [];\n    for (const file of this.getAllFiles().values()) {\n      if (!file.isBinary) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Gets all binary files from the archive\n   * @returns Array of binary files\n   */\n  getBinaryFiles(): ZipFile[] {\n    const files: ZipFile[] = [];\n    for (const file of this.getAllFiles().values()) {\n      if (file.isBinary) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Gets all media files from the word/media/ directory\n   * @returns Array of media files\n   */\n  getMediaFiles(): ZipFile[] {\n    const files: ZipFile[] = [];\n    for (const [path, file] of this.getAllFiles()) {\n      if (path.startsWith('word/media/')) {\n        files.push(file);\n      }\n    }\n    return files;\n  }\n\n  /**\n   * Exports a file from the archive to the filesystem\n   * @param internalPath - Path of the file within the archive\n   * @param outputPath - Path where the file will be saved\n   */\n  async exportFile(internalPath: string, outputPath: string): Promise<void> {\n    const { promises: fs } = await import('fs');\n    const content = this.getFileAsBuffer(internalPath);\n    if (!content) {\n      throw new Error(`File not found in archive: ${internalPath}`);\n    }\n    await fs.writeFile(outputPath, content);\n  }\n\n  /**\n   * Imports a file from the filesystem into the archive\n   * @param sourcePath - Path to the file on filesystem\n   * @param internalPath - Path where the file will be stored in archive\n   * @param options - Options for adding the file\n   */\n  async importFile(\n    sourcePath: string,\n    internalPath: string,\n    options: AddFileOptions = {}\n  ): Promise<void> {\n    const { promises: fs } = await import('fs');\n    const content = await fs.readFile(sourcePath);\n    this.addFile(internalPath, content, {\n      ...options,\n      binary: options.binary !== undefined ? options.binary : true,\n    });\n  }\n\n  // ==================== SAVING ====================\n\n  /**\n   * Saves the archive to a file\n   * @param filePath - Path where the file will be saved\n   * @param options - Save options\n   */\n  async save(filePath: string, options: SaveOptions = {}): Promise<void> {\n    const logger = getLogger();\n    logger.info('Saving DOCX file', { path: filePath, fileCount: this.getFileCount() });\n    await this.writer.saveToFile(filePath, options);\n    logger.info('DOCX file saved', { path: filePath });\n  }\n\n  /**\n   * Generates the ZIP archive as a buffer\n   * @param options - Save options\n   * @returns Buffer containing the ZIP archive\n   */\n  async toBuffer(options: SaveOptions = {}): Promise<Buffer> {\n    const logger = getLogger();\n    logger.info('Generating DOCX buffer', { fileCount: this.getFileCount() });\n    const buffer = await this.writer.toBuffer(options);\n    logger.info('DOCX buffer generated', { bufferSize: buffer.length });\n    return buffer;\n  }\n\n  // ==================== VALIDATION ====================\n\n  /**\n   * Validates the DOCX structure\n   * @throws {MissingRequiredFileError} If required files are missing\n   */\n  validate(): void {\n    const logger = getLogger();\n    logger.info('Validating DOCX structure');\n    this.writer.validate();\n    logger.info('DOCX structure valid');\n  }\n\n  // ==================== UTILITY ====================\n\n  /**\n   * Creates a new empty archive\n   */\n  clear(): void {\n    this.reader.clear();\n    this.writer.clear();\n    this.mode = 'write';\n  }\n\n  /**\n   * Gets the current mode of the handler\n   * @returns Current mode ('read', 'write', or 'modify')\n   */\n  getMode(): 'read' | 'write' | 'modify' {\n    return this.mode;\n  }\n\n  /**\n   * Checks if the archive has been loaded\n   * @returns True if loaded\n   */\n  isLoaded(): boolean {\n    return this.reader.isLoaded();\n  }\n\n  /**\n   * Creates a clone of this handler with all its files\n   * @returns A new ZipHandler instance with the same files\n   */\n  clone(): ZipHandler {\n    const newHandler = new ZipHandler();\n    newHandler.writer = this.writer.clone();\n    newHandler.mode = this.mode;\n    return newHandler;\n  }\n\n  // ==================== CONVENIENCE METHODS ====================\n\n  /**\n   * Reads a DOCX file, modifies it, and saves it back\n   * @param inputPath - Path to the input DOCX file\n   * @param outputPath - Path to save the modified file\n   * @param modifier - Function that modifies the handler\n   * @param loadOptions - Options for loading\n   * @param saveOptions - Options for saving\n   */\n  static async modify(\n    inputPath: string,\n    outputPath: string,\n    modifier: (handler: ZipHandler) => void | Promise<void>,\n    loadOptions: LoadOptions = {},\n    saveOptions: SaveOptions = {}\n  ): Promise<void> {\n    const handler = new ZipHandler();\n    await handler.load(inputPath, loadOptions);\n    await modifier(handler);\n    await handler.save(outputPath, saveOptions);\n  }\n\n  /**\n   * Creates a new DOCX file with the provided files\n   * @param outputPath - Path to save the new file\n   * @param files - Map of file paths to contents\n   * @param saveOptions - Options for saving\n   */\n  static async create(\n    outputPath: string,\n    files: FileMap,\n    saveOptions: SaveOptions = {}\n  ): Promise<void> {\n    const handler = new ZipHandler();\n    handler.addFiles(files);\n    await handler.save(outputPath, saveOptions);\n  }\n}\n"]}

package/dist/zip/ZipReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZipReader.d.ts","sourceRoot":"","sources":["../../src/zip/ZipReader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiB3D,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAS;IAOjB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAuChE,YAAY;IAmD1B,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAgB9C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IA0BrD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAoBrD,WAAW,IAAI,OAAO;IAStB,YAAY,IAAI,MAAM,EAAE;IAUxB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWlC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;IAqB7C,OAAO,CAAC,YAAY;IAUpB,QAAQ,IAAI,OAAO;IAOnB,KAAK,IAAI,IAAI;CAKd"}
+{"version":3,"file":"ZipReader.d.ts","sourceRoot":"","sources":["../../src/zip/ZipReader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAyC,MAAM,YAAY,CAAC;AAqClG,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAS;IAOjB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCxE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YA+DhE,YAAY;IA0H1B,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAgB9C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IA0BrD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAoBrD,WAAW,IAAI,OAAO;IAStB,YAAY,IAAI,MAAM,EAAE;IAUxB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWlC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;IAqB7C,OAAO,CAAC,YAAY;IAUpB,QAAQ,IAAI,OAAO;IAOnB,KAAK,IAAI,IAAI;CAKd"}