@willwade/aac-processors 0.0.29 → 0.1.0

package/dist/processors/obfProcessor.js

@@ -1,16 +1,59 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObfProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
 const idGenerator_1 = require("../utilities/analytics/utils/idGenerator");
-const adm_zip_1 = __importDefault(require("adm-zip"));
-const fs_1 = __importDefault(require("fs"));
-const obfValidator_1 = require("../validation/obfValidator");
 const translationProcessor_1 = require("../utilities/translation/translationProcessor");
+const io_1 = require("../utils/io");
+let JSZipModuleObf;
+async function getJSZipObf() {
+    if (!JSZipModuleObf) {
+        try {
+            // Try ES module import first (browser/Vite)
+            const module = await Promise.resolve().then(() => __importStar(require('jszip')));
+            JSZipModuleObf = module.default || module;
+        }
+        catch (error) {
+            // Fall back to CommonJS require (Node.js)
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const module = require('jszip');
+                JSZipModuleObf = module.default || module;
+            }
+            catch (err2) {
+                throw new Error('Zip handling requires JSZip in this environment.');
+            }
+        }
+    }
+    if (!JSZipModuleObf) {
+        throw new Error('Zip handling requires JSZip in this environment.');
+    }
+    return JSZipModuleObf;
+}
 const OBF_FORMAT_VERSION = 'open-board-0.1';
 /**
  * Map OBF hidden value to AAC standard visibility
@@ -31,7 +74,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Extract an image from the ZIP file as a Buffer
      */
-    extractImageAsBuffer(imageId, images) {
+    async extractImageAsBuffer(imageId, images) {
         if (!this.zipFile || !images) {
             return null;
         }
@@ -48,9 +91,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         ].filter(Boolean);
         for (const imagePath of possiblePaths) {
             try {
-                const entry = this.zipFile.getEntry(imagePath);
-                if (entry) {
-                    return entry.getData(); // Return raw Buffer
+                const file = this.zipFile.file(imagePath);
+                if (file) {
+                    const buffer = await file.async('nodebuffer');
+                    return buffer;
                 }
             }
             catch (err) {
@@ -62,7 +106,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Extract an image from the ZIP file and convert to data URL
      */
-    extractImageAsDataUrl(imageId, images) {
+    async extractImageAsDataUrl(imageId, images) {
         // Check cache first
         if (this.imageCache.has(imageId)) {
             return this.imageCache.get(imageId) ?? null;
@@ -84,12 +128,12 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         ].filter(Boolean);
         for (const imagePath of possiblePaths) {
             try {
-                const entry = this.zipFile.getEntry(imagePath);
-                if (entry) {
-                    const buffer = entry.getData();
+                const file = this.zipFile.file(imagePath);
+                if (file) {
+                    const buffer = await file.async('uint8array');
                     const contentType = imageData.content_type ||
                         this.getMimeTypeFromFilename(imagePath);
-                    const dataUrl = `data:${contentType};base64,${buffer.toString('base64')}`;
+                    const dataUrl = `data:${contentType};base64,${(0, io_1.encodeBase64)(buffer)}`;
                     this.imageCache.set(imageId, dataUrl);
                     return dataUrl;
                 }
@@ -125,7 +169,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 return 'image/png';
         }
     }
-    processBoard(boardData, _boardPath) {
+    async processBoard(boardData, _boardPath) {
         const sourceButtons = boardData.buttons || [];
         // Calculate page ID first (used to make button IDs unique)
         const pageId = _boardPath && _boardPath.endsWith('.obf') && !_boardPath.includes('/')
@@ -133,7 +177,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             : boardData?.id
                 ? String(boardData.id)
                 : _boardPath?.split('/').pop() || '';
-        const buttons = sourceButtons.map((btn) => {
+        const buttons = await Promise.all(sourceButtons.map(async (btn) => {
             const semanticAction = btn.load_board
                 ? {
                     category: treeStructure_1.AACSemanticCategory.NAVIGATION,
@@ -157,8 +201,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             let resolvedImage;
             let imageBuffer;
             if (btn.image_id && boardData.images) {
-                resolvedImage = this.extractImageAsDataUrl(btn.image_id, boardData.images) || undefined;
-                imageBuffer = this.extractImageAsBuffer(btn.image_id, boardData.images) || undefined;
+                resolvedImage =
+                    (await this.extractImageAsDataUrl(btn.image_id, boardData.images)) || undefined;
+                imageBuffer =
+                    (await this.extractImageAsBuffer(btn.image_id, boardData.images)) || undefined;
             }
             // Build parameters object for Grid3 export compatibility
             const buttonParameters = {};
@@ -186,7 +232,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 targetPageId: btn.load_board?.path,
                 semantic_id: btn.semantic_id, // Extract semantic_id if present
             });
-        });
+        }));
         const buttonMap = new Map(buttons.map((btn) => [btn.id, btn]));
         const page = new treeStructure_1.AACPage({
             id: pageId, // Use the page ID we calculated earlier
@@ -269,8 +315,8 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         }
         return page;
     }
-    extractTexts(filePathOrBuffer) {
-        const tree = this.loadIntoTree(filePathOrBuffer);
+    async extractTexts(filePathOrBuffer) {
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         const texts = [];
         for (const pageId in tree.pages) {
             const page = tree.pages[pageId];
@@ -285,20 +331,23 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         }
         return texts;
     }
-    loadIntoTree(filePathOrBuffer) {
+    async loadIntoTree(filePathOrBuffer) {
         // Detailed logging for debugging input
+        const bufferLength = typeof filePathOrBuffer === 'string'
+            ? null
+            : (0, io_1.readBinaryFromInput)(filePathOrBuffer).byteLength;
         console.log('[OBF] loadIntoTree called with:', {
             type: typeof filePathOrBuffer,
-            isBuffer: Buffer.isBuffer(filePathOrBuffer),
+            isBuffer: typeof Buffer !== 'undefined' && Buffer.isBuffer(filePathOrBuffer),
             value: typeof filePathOrBuffer === 'string'
                 ? filePathOrBuffer
-                : '[Buffer of length ' + filePathOrBuffer.length + ']',
+                : `[Buffer of length ${bufferLength ?? 0}]`,
         });
         const tree = new treeStructure_1.AACTree();
         // Helper: try to parse JSON OBF
         function tryParseObfJson(data) {
             try {
-                const str = typeof data === 'string' ? data : data.toString('utf8');
+                const str = typeof data === 'string' ? data : (0, io_1.readTextFromInput)(data);
                 // Check for empty or whitespace-only content
                 if (!str.trim()) {
                     return null;
@@ -320,11 +369,11 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         // If input is a string path and ends with .obf, treat as JSON
         if (typeof filePathOrBuffer === 'string' && filePathOrBuffer.endsWith('.obf')) {
             try {
-                const content = fs_1.default.readFileSync(filePathOrBuffer, 'utf8');
+                const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
                 const boardData = tryParseObfJson(content);
                 if (boardData) {
                     console.log('[OBF] Detected .obf file, parsed as JSON');
-                    const page = this.processBoard(boardData, filePathOrBuffer);
+                    const page = await this.processBoard(boardData, filePathOrBuffer);
                     tree.addPage(page);
                     // Set metadata from root board
                     tree.metadata.format = 'obf';
@@ -352,7 +401,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         const asJson = tryParseObfJson(filePathOrBuffer);
         if (asJson) {
             console.log('[OBF] Detected buffer/string as OBF JSON');
-            const page = this.processBoard(asJson, '[bufferOrString]');
+            const page = await this.processBoard(asJson, '[bufferOrString]');
             tree.addPage(page);
             // Set metadata from root board
             tree.metadata.format = 'obf';
@@ -372,32 +421,42 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         function isLikelyZip(input) {
             if (typeof input === 'string')
                 return input.endsWith('.zip') || input.endsWith('.obz');
-            if (Buffer.isBuffer(input) && input.length >= 2) {
-                return input[0] === 0x50 && input[1] === 0x4b; // 'PK'
-            }
-            return false;
+            const bytes = (0, io_1.readBinaryFromInput)(input);
+            return bytes.length >= 2 && bytes[0] === 0x50 && bytes[1] === 0x4b;
         }
         if (!isLikelyZip(filePathOrBuffer)) {
             throw new Error('Invalid OBF content: not JSON and not ZIP');
         }
+        const JSZip = await getJSZipObf();
         let zip;
         try {
-            zip = new adm_zip_1.default(filePathOrBuffer);
+            const zipInput = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+            zip = await JSZip.loadAsync(zipInput);
         }
         catch (err) {
-            console.error('[OBF] Error instantiating AdmZip with input:', err);
+            console.error('[OBF] Error loading ZIP with JSZip:', err);
             throw err;
         }
         // Store the ZIP file reference for image extraction
         this.zipFile = zip;
         this.imageCache.clear(); // Clear cache for new file
         console.log('[OBF] Detected zip archive, extracting .obf files');
-        zip.getEntries().forEach((entry) => {
-            if (entry.entryName.endsWith('.obf')) {
-                const content = entry.getData().toString('utf8');
+        // Collect all .obf entries
+        const obfEntries = [];
+        zip.forEach((relativePath, file) => {
+            if (file.dir)
+                return;
+            if (relativePath.endsWith('.obf')) {
+                obfEntries.push({ name: relativePath, file });
+            }
+        });
+        // Process each .obf entry
+        for (const entry of obfEntries) {
+            try {
+                const content = await entry.file.async('string');
                 const boardData = tryParseObfJson(content);
                 if (boardData) {
-                    const page = this.processBoard(boardData, entry.entryName);
+                    const page = await this.processBoard(boardData, entry.name);
                     tree.addPage(page);
                     // Set metadata if not already set (use first board as reference)
                     if (!tree.metadata.format) {
@@ -414,10 +473,13 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                     }
                 }
                 else {
-                    console.warn('[OBF] Skipped entry (not valid OBF JSON):', entry.entryName);
+                    console.warn('[OBF] Skipped entry (not valid OBF JSON):', entry.name);
                 }
             }
-        });
+            catch (err) {
+                console.warn('[OBF] Error processing entry:', entry.name, err);
+            }
+        }
         return tree;
     }
     buildGridMetadata(page) {
@@ -497,9 +559,9 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             sounds: Array.isArray(page.sounds) ? page.sounds : [],
         };
     }
-    processTexts(filePathOrBuffer, translations, outputPath) {
+    async processTexts(filePathOrBuffer, translations, outputPath) {
         // Load the tree, apply translations, and save to new file
-        const tree = this.loadIntoTree(filePathOrBuffer);
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
         Object.values(tree.pages).forEach((page) => {
             // Translate page names
@@ -526,10 +588,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         // Save the translated tree and return its content
-        this.saveFromTree(tree, outputPath);
-        return fs_1.default.readFileSync(outputPath);
+        await this.saveFromTree(tree, outputPath);
+        return (0, io_1.readBinaryFromInput)(outputPath);
     }
-    saveFromTree(tree, outputPath) {
+    async saveFromTree(tree, outputPath) {
         if (outputPath.endsWith('.obf')) {
             // Save as single OBF JSON file
             const rootPage = tree.rootId ? tree.getPage(tree.rootId) : Object.values(tree.pages)[0];
@@ -537,17 +599,20 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 throw new Error('No pages to save');
             }
             const obfBoard = this.createObfBoardFromPage(rootPage, 'Exported Board', tree.metadata);
-            fs_1.default.writeFileSync(outputPath, JSON.stringify(obfBoard, null, 2));
+            (0, io_1.writeTextToPath)(outputPath, JSON.stringify(obfBoard, null, 2));
         }
         else {
             // Save as OBZ (zip with multiple OBF files)
-            const zip = new adm_zip_1.default();
+            const JSZip = await getJSZipObf();
+            const zip = new JSZip();
             Object.values(tree.pages).forEach((page) => {
                 const obfBoard = this.createObfBoardFromPage(page, 'Board', tree.metadata);
                 const obfContent = JSON.stringify(obfBoard, null, 2);
-                zip.addFile(`${page.id}.obf`, Buffer.from(obfContent, 'utf8'));
+                zip.file(`${page.id}.obf`, obfContent);
             });
-            zip.writeZip(outputPath);
+            const zipBuffer = await zip.generateAsync({ type: 'uint8array' });
+            const { writeBinaryToPath } = await Promise.resolve().then(() => __importStar(require('../utils/io')));
+            writeBinaryToPath(outputPath, zipBuffer);
         }
     }
     /**
@@ -570,7 +635,8 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return obfValidator_1.ObfValidator.validateFile(filePath);
+        const ObfValidator = this.getObfValidator();
+        return ObfValidator.validateFile(filePath);
     }
     /**
      * Extract symbol information from an OBF/OBZ file for LLM-based translation.
@@ -581,8 +647,8 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      * @param filePathOrBuffer - Path to OBF/OBZ file or buffer
      * @returns Array of symbol information for LLM processing
      */
-    extractSymbolsForLLM(filePathOrBuffer) {
-        const tree = this.loadIntoTree(filePathOrBuffer);
+    async extractSymbolsForLLM(filePathOrBuffer) {
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         // Collect all buttons from all pages
         const allButtons = [];
         Object.values(tree.pages).forEach((page) => {
@@ -611,8 +677,8 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      * @param options - Translation options (e.g., allowPartial for testing)
      * @returns Buffer of the translated OBF/OBZ file
      */
-    processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
-        const tree = this.loadIntoTree(filePathOrBuffer);
+    async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         // Validate translations using shared utility
         const buttonIds = Object.values(tree.pages).flatMap((page) => page.buttons.map((b) => b.id));
         (0, translationProcessor_1.validateTranslationResults)(llmTranslations, buttonIds, options);
@@ -649,8 +715,17 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         // Save and return
-        this.saveFromTree(tree, outputPath);
-        return fs_1.default.readFileSync(outputPath);
+        await this.saveFromTree(tree, outputPath);
+        return (0, io_1.readBinaryFromInput)(outputPath);
+    }
+    getObfValidator() {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-return
+            return require('../validation/obfValidator').ObfValidator;
+        }
+        catch (error) {
+            throw new Error('Validation utilities are not available in this environment.');
+        }
     }
 }
 exports.ObfProcessor = ObfProcessor;

package/dist/processors/obfsetProcessor.d.ts

@@ -4,23 +4,24 @@
  */
 import { AACTree } from '../core/treeStructure';
 import { BaseProcessor, ProcessorOptions } from '../core/baseProcessor';
+import { ProcessorInput } from '../utils/io';
 export declare class ObfsetProcessor extends BaseProcessor {
     constructor(options?: ProcessorOptions);
     /**
      * Extract all text content
      */
-    extractTexts(filePathOrBuffer: string | Buffer): string[];
+    extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
     /**
      * Load an .obfset file (JSON array of boards)
      */
-    loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
+    loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;
     /**
      * Process texts (not supported for .obfset currently)
      */
-    processTexts(_filePathOrBuffer: string | Buffer, _translations: Map<string, string>, _outputPath: string): Buffer;
+    processTexts(_filePathOrBuffer: ProcessorInput, _translations: Map<string, string>, _outputPath: string): Promise<Uint8Array>;
     /**
      * Save tree structure back to file
      */
-    saveFromTree(_tree: AACTree, _outputPath: string): void;
+    saveFromTree(_tree: AACTree, _outputPath: string): Promise<void>;
     supportsExtension(extension: string): boolean;
 }

package/dist/processors/obfsetProcessor.js

@@ -3,15 +3,12 @@
  * OBF Set Processor - Handles JSON-formatted .obfset files
  * These are pre-extracted board sets in JSON array format
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObfsetProcessor = void 0;
 const treeStructure_1 = require("../core/treeStructure");
 const treeStructure_2 = require("../core/treeStructure");
-const fs_1 = __importDefault(require("fs"));
 const baseProcessor_1 = require("../core/baseProcessor");
+const io_1 = require("../utils/io");
 class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options = {}) {
         super(options);
@@ -19,8 +16,8 @@ class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Extract all text content
      */
-    extractTexts(filePathOrBuffer) {
-        const tree = this.loadIntoTree(filePathOrBuffer);
+    async extractTexts(filePathOrBuffer) {
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         const texts = new Set();
         Object.values(tree.pages).forEach((page) => {
             if (page.name)
@@ -35,16 +32,11 @@ class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Load an .obfset file (JSON array of boards)
      */
-    loadIntoTree(filePathOrBuffer) {
+    async loadIntoTree(filePathOrBuffer) {
+        await Promise.resolve();
         const tree = new treeStructure_1.AACTree();
         tree.metadata.format = 'obfset';
-        let content;
-        if (Buffer.isBuffer(filePathOrBuffer)) {
-            content = filePathOrBuffer.toString('utf-8');
-        }
-        else {
-            content = fs_1.default.readFileSync(filePathOrBuffer, 'utf-8');
-        }
+        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         const boards = JSON.parse(content);
         // Track board ID mappings
         const boardMap = new Map();
@@ -164,13 +156,15 @@ class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Process texts (not supported for .obfset currently)
      */
-    processTexts(_filePathOrBuffer, _translations, _outputPath) {
+    async processTexts(_filePathOrBuffer, _translations, _outputPath) {
+        await Promise.resolve();
         throw new Error('processTexts is not supported for .obfset currently');
     }
     /**
      * Save tree structure back to file
      */
-    saveFromTree(_tree, _outputPath) {
+    async saveFromTree(_tree, _outputPath) {
+        await Promise.resolve();
         throw new Error('saveFromTree is not supported for .obfset currently');
     }
     supportsExtension(extension) {

package/dist/processors/opmlProcessor.d.ts

@@ -1,12 +1,13 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ProcessorInput } from '../utils/io';
 declare class OpmlProcessor extends BaseProcessor {
     constructor(options?: ProcessorOptions);
     private processOutline;
-    extractTexts(filePathOrBuffer: string | Buffer): string[];
-    loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
-    processTexts(filePathOrBuffer: string | Buffer, translations: Map<string, string>, outputPath: string): Buffer;
-    saveFromTree(tree: AACTree, outputPath: string): void;
+    extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
+    loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;
+    processTexts(filePathOrBuffer: ProcessorInput, translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
+    saveFromTree(tree: AACTree, outputPath: string): Promise<void>;
     /**
      * Extract strings with metadata for aac-tools-platform compatibility
      * Uses the generic implementation from BaseProcessor

package/dist/processors/opmlProcessor.js

@@ -1,16 +1,12 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpmlProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
 // Removed unused import: FileProcessor
 const fast_xml_parser_1 = require("fast-xml-parser");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const validation_1 = require("../validation");
+const validationTypes_1 = require("../validation/validationTypes");
+const io_1 = require("../utils/io");
 class OpmlProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
@@ -56,10 +52,9 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             return { page: null, childPages: [] };
         return { page, childPages };
     }
-    extractTexts(filePathOrBuffer) {
-        const content = typeof filePathOrBuffer === 'string'
-            ? fs_1.default.readFileSync(filePathOrBuffer, 'utf8')
-            : filePathOrBuffer.toString('utf8');
+    async extractTexts(filePathOrBuffer) {
+        await Promise.resolve();
+        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
         const data = parser.parse(content);
         const texts = [];
@@ -89,15 +84,14 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
         outlines.forEach(processNode);
         return texts;
     }
-    loadIntoTree(filePathOrBuffer) {
-        const filename = typeof filePathOrBuffer === 'string' ? path_1.default.basename(filePathOrBuffer) : 'upload.opml';
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
-        const content = buffer.toString('utf8');
+    async loadIntoTree(filePathOrBuffer) {
+        await Promise.resolve();
+        const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.opml';
+        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+        const content = (0, io_1.readTextFromInput)(buffer);
         try {
             if (!content || !content.trim()) {
-                const validationResult = (0, validation_1.buildValidationResultFromMessage)({
+                const validationResult = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
                     filesize: buffer.byteLength,
                     format: 'opml',
@@ -105,13 +99,13 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
                     type: 'content',
                     description: 'OPML content is empty',
                 });
-                throw new validation_1.ValidationFailureError('Empty OPML content', validationResult);
+                throw new validationTypes_1.ValidationFailureError('Empty OPML content', validationResult);
             }
             // Validate XML before parsing, fast-xml-parser is permissive by default
             const validationResult = fast_xml_parser_1.XMLValidator.validate(content);
             if (validationResult !== true) {
                 const reason = validationResult?.err?.msg || JSON.stringify(validationResult);
-                const structured = (0, validation_1.buildValidationResultFromMessage)({
+                const structured = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
                     filesize: buffer.byteLength,
                     format: 'opml',
@@ -119,7 +113,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
                     type: 'xml',
                     description: 'OPML XML validation',
                 });
-                throw new validation_1.ValidationFailureError('Invalid OPML XML', structured);
+                throw new validationTypes_1.ValidationFailureError('Invalid OPML XML', structured);
             }
             const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
             const data = parser.parse(content);
@@ -128,7 +122,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             // Handle case where body.outline might not exist or be in different formats
             const bodyOutline = data.opml?.body?.outline;
             if (!bodyOutline) {
-                const structured = (0, validation_1.buildValidationResultFromMessage)({
+                const structured = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
                     filesize: buffer.byteLength,
                     format: 'opml',
@@ -136,7 +130,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
                     type: 'structure',
                     description: 'OPML outline root',
                 });
-                throw new validation_1.ValidationFailureError('Invalid OPML structure', structured);
+                throw new validationTypes_1.ValidationFailureError('Invalid OPML structure', structured);
             }
             const outlines = Array.isArray(bodyOutline) ? bodyOutline : [bodyOutline];
             let firstRootId = null;
@@ -162,10 +156,10 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             return tree;
         }
         catch (err) {
-            if (err instanceof validation_1.ValidationFailureError) {
+            if (err instanceof validationTypes_1.ValidationFailureError) {
                 throw err;
             }
-            const validationResult = (0, validation_1.buildValidationResultFromMessage)({
+            const validationResult = (0, validationTypes_1.buildValidationResultFromMessage)({
                 filename,
                 filesize: buffer.byteLength,
                 format: 'opml',
@@ -173,13 +167,12 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
                 type: 'parse',
                 description: 'Parse OPML XML',
             });
-            throw new validation_1.ValidationFailureError('Failed to load OPML file', validationResult, err);
+            throw new validationTypes_1.ValidationFailureError('Failed to load OPML file', validationResult, err);
         }
     }
-    processTexts(filePathOrBuffer, translations, outputPath) {
-        const content = typeof filePathOrBuffer === 'string'
-            ? fs_1.default.readFileSync(filePathOrBuffer, 'utf8')
-            : filePathOrBuffer.toString('utf8');
+    async processTexts(filePathOrBuffer, translations, outputPath) {
+        await Promise.resolve();
+        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         let translatedContent = content;
         // Apply translations to text attributes in OPML outline elements
         translations.forEach((translation, originalText) => {
@@ -189,12 +182,12 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
                 translatedContent = translatedContent.replace(textAttrRegex, `text="${translation}"`);
             }
         });
-        const resultBuffer = Buffer.from(translatedContent, 'utf8');
-        // Save to output path
-        fs_1.default.writeFileSync(outputPath, resultBuffer);
+        const resultBuffer = (0, io_1.encodeText)(translatedContent);
+        (0, io_1.writeBinaryToPath)(outputPath, resultBuffer);
         return resultBuffer;
     }
-    saveFromTree(tree, outputPath) {
+    async saveFromTree(tree, outputPath) {
+        await Promise.resolve();
         // Helper to recursively build outline nodes with cycle detection
         function buildOutline(page, visited = new Set()) {
             // Prevent infinite recursion by tracking visited pages
@@ -264,7 +257,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             attributeNamePrefix: '@_',
         });
         const xml = '<?xml version="1.0" encoding="UTF-8"?>\n' + builder.build(opmlObj);
-        fs_1.default.writeFileSync(outputPath, xml, 'utf8');
+        (0, io_1.writeTextToPath)(outputPath, xml);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility