@willwade/aac-processors 0.1.20 → 0.2.0

package/dist/processors/gridsetProcessor.js

@@ -1,27 +1,4 @@
 "use strict";
-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.GridsetProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
@@ -40,7 +17,6 @@ const resolver_2 = require("./gridset/resolver");
 const idGenerator_1 = require("../utilities/analytics/utils/idGenerator");
 const symbolAlignment_1 = require("./gridset/symbolAlignment");
 const io_1 = require("../utils/io");
-const zip_1 = require("../utils/zip");
 class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
@@ -421,19 +397,18 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         const tree = new treeStructure_1.AACTree();
         let zipResult;
         try {
-            const zipInput = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
-            zipResult = this.options.zipAdapter
-                ? await this.options.zipAdapter(zipInput)
-                : await (0, zip_1.openZipFromInput)(zipInput);
+            const zipInput = await readBinaryFromInput(filePathOrBuffer);
+            zipResult = await this.options.zipAdapter(zipInput);
         }
         catch (error) {
             throw new Error(`Invalid ZIP file format: ${error.message}`);
         }
         const password = this.getGridsetPassword(filePathOrBuffer);
-        const entries = (0, password_1.getZipEntriesFromAdapter)(zipResult.zip, password);
+        const entries = (0, password_1.getZipEntriesFromAdapter)(zipResult, password);
         const options = {
             ignoreAttributes: false,
             ignoreDeclaration: true,
@@ -1709,6 +1684,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         return tree;
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         // Load the tree, apply translations, and save to new file
         const tree = await this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
@@ -1769,7 +1745,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save the translated tree and return its content
         await this.saveFromTree(tree, outputPath);
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     /**
      * Extract symbol information from a gridset for LLM-based translation.
@@ -1778,7 +1754,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
      * This method uses shared translation utilities that work across all AAC formats.
      *
      * @param filePathOrBuffer - Path to gridset file or buffer
-     * @returns Array of symbol information for LLM processing
+     * @returns Promise resolving to symbol information for LLM processing
      */
     async extractSymbolsForLLM(filePathOrBuffer) {
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -1808,9 +1784,10 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
      * @param llmTranslations - Array of LLM translations with symbol info
      * @param outputPath - Where to save the translated gridset
      * @param options - Translation options (e.g., allowPartial for testing)
-     * @returns Buffer of the translated gridset
+     * @returns Promise resolving to a buffer of the translated gridset
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         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));
@@ -1849,40 +1826,16 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
-        const useNodeZip = (0, io_1.isNodeRuntime)();
-        let addText;
-        let addBinary;
-        let finalizeZip;
-        if (useNodeZip) {
-            const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
-            const zip = new AdmZip();
-            addText = (entryPath, content) => {
-                zip.addFile(entryPath, Buffer.from(content, 'utf8'));
-            };
-            addBinary = (entryPath, content) => {
-                zip.addFile(entryPath, Buffer.from(content));
-            };
-            finalizeZip = () => Promise.resolve(zip.toBuffer());
-        }
-        else {
-            const module = await Promise.resolve().then(() => __importStar(require('jszip')));
-            const JSZip = module.default || module;
-            const zip = new JSZip();
-            addText = (entryPath, content) => {
-                zip.file(entryPath, content, { binary: false });
-            };
-            addBinary = (entryPath, content) => {
-                zip.file(entryPath, content);
-            };
-            finalizeZip = async () => zip.generateAsync({ type: 'uint8array' });
-        }
+        const files = [];
+        const { writeBinaryToPath } = this.options.fileAdapter;
+        const zip = await this.options.zipAdapter();
         if (Object.keys(tree.pages).length === 0) {
             // Create empty zip for empty tree
-            const zipBuffer = await finalizeZip();
-            (0, io_1.writeBinaryToPath)(outputPath, zipBuffer);
+            const zipBuffer = await zip.writeFiles([]);
+            await writeBinaryToPath(outputPath, zipBuffer);
             return;
         }
         // Collect all unique styles from pages and buttons
@@ -1954,7 +1907,10 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             suppressEmptyNode: true,
         });
         const settingsXmlContent = settingsBuilder.build(settingsData);
-        addText('Settings0/settings.xml', settingsXmlContent);
+        files.push({
+            name: 'Settings0/settings.xml',
+            data: settingsXmlContent,
+        });
         // Create Settings0/Styles/style.xml if there are styles
         if (uniqueStyles.size > 0) {
             const stylesArray = Array.from(uniqueStyles.values()).map(({ id, style }) => {
@@ -1987,7 +1943,10 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                 indentBy: '  ',
             });
             const styleXmlContent = styleBuilder.build(styleData);
-            addText('Settings0/Styles/styles.xml', styleXmlContent);
+            files.push({
+                name: 'Settings0/Styles/styles.xml',
+                data: styleXmlContent,
+            });
         }
         // Collect grid file paths for FileMap.xml
         const gridFilePaths = [];
@@ -2128,14 +2087,20 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             // Add to zip in Grids folder with proper Grid3 naming
             const gridPath = `Grids/${page.name || page.id}/grid.xml`;
             gridFilePaths.push(gridPath);
-            addText(gridPath, xmlContent);
+            files.push({
+                name: gridPath,
+                data: xmlContent,
+            });
         });
         // Write image files to ZIP
         buttonImages.forEach((imgData) => {
             if (imgData.imageData && imgData.imageData.length > 0) {
                 // Create image path in the grid's directory
                 const imagePath = `Grids/${imgData.pageName}/${imgData.x}-${imgData.y}-0-text-0.${imgData.ext}`;
-                addBinary(imagePath, imgData.imageData);
+                files.push({
+                    name: imagePath,
+                    data: imgData.imageData,
+                });
             }
         });
         // Create FileMap.xml to map all grid files with their dynamic image files
@@ -2174,10 +2139,13 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             indentBy: '  ',
         });
         const fileMapXmlContent = fileMapBuilder.build(fileMapData);
-        addText('FileMap.xml', fileMapXmlContent);
+        files.push({
+            name: 'FileMap.xml',
+            data: fileMapXmlContent,
+        });
         // Write the zip file
-        const zipBuffer = await finalizeZip();
-        (0, io_1.writeBinaryToPath)(outputPath, zipBuffer);
+        const zipBuffer = await zip.writeFiles(files);
+        await writeBinaryToPath(outputPath, zipBuffer);
     }
     // Helper method to calculate column definitions based on page layout
     calculateColumnDefinitions(page) {
@@ -2274,7 +2242,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return gridsetValidator_1.GridsetValidator.validateFile(filePath);
+        return gridsetValidator_1.GridsetValidator.validateFile(filePath, this.options.fileAdapter);
     }
 }
 exports.GridsetProcessor = GridsetProcessor;

package/dist/processors/obfProcessor.d.ts

@@ -46,7 +46,7 @@ declare class ObfProcessor extends BaseProcessor {
      * This method uses shared translation utilities that work across all AAC formats.
      *
      * @param filePathOrBuffer - Path to OBF/OBZ file or buffer
-     * @returns Array of symbol information for LLM processing
+     * @returns Promise resolving to symbol information for LLM processing
      */
     extractSymbolsForLLM(filePathOrBuffer: ProcessorInput): Promise<ButtonForTranslation[]>;
     /**
@@ -59,7 +59,7 @@ declare class ObfProcessor extends BaseProcessor {
      * @param llmTranslations - Array of LLM translations with symbol info
      * @param outputPath - Where to save the translated OBF/OBZ file
      * @param options - Translation options (e.g., allowPartial for testing)
-     * @returns Buffer of the translated OBF/OBZ file
+     * @returns Promise resolving to a buffer of the translated OBF/OBZ file
      */
     processLLMTranslations(filePathOrBuffer: ProcessorInput, llmTranslations: LLMLTranslationResult[], outputPath: string, options?: {
         allowPartial?: boolean;

package/dist/processors/obfProcessor.js

@@ -1,27 +1,4 @@
 "use strict";
-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");
@@ -29,7 +6,6 @@ const treeStructure_1 = require("../core/treeStructure");
 const idGenerator_1 = require("../utilities/analytics/utils/idGenerator");
 const translationProcessor_1 = require("../utilities/translation/translationProcessor");
 const io_1 = require("../utils/io");
-const zip_1 = require("../utils/zip");
 const OBF_FORMAT_VERSION = 'open-board-0.1';
 /**
  * Map OBF hidden value to AAC standard visibility
@@ -193,8 +169,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 buttonParameters.image_id = btn.image_id;
             }
             return new treeStructure_1.AACButton({
-                // Make button ID unique by combining page ID and button ID
-                id: `${pageId}::${btn?.id || ''}`,
+                id: String(btn.id),
                 label: String(btn?.label || ''),
                 message: String(btn?.vocalization || btn?.label || ''),
                 visibility: mapObfVisibility(btn.hidden),
@@ -243,7 +218,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                                 return;
                             if (rowIndex >= rows || colIndex >= cols)
                                 return;
-                            const aacBtn = buttonMap.get(`${pageId}::${cellId}`);
+                            const aacBtn = buttonMap.get(String(cellId));
                             if (aacBtn) {
                                 grid[rowIndex][colIndex] = aacBtn;
                             }
@@ -256,7 +231,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                             const row = Math.floor(btn.box_id / cols);
                             const col = btn.box_id % cols;
                             if (row < rows && col < cols) {
-                                const aacBtn = buttonMap.get(`${pageId}::${btn.id}`);
+                                const aacBtn = buttonMap.get(String(btn.id));
                                 if (aacBtn) {
                                     grid[row][col] = aacBtn;
                                 }
@@ -309,10 +284,11 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         // Detailed logging for debugging input
         const bufferLength = typeof filePathOrBuffer === 'string'
             ? null
-            : (0, io_1.readBinaryFromInput)(filePathOrBuffer).byteLength;
+            : (await readBinaryFromInput(filePathOrBuffer)).byteLength;
         console.log('[OBF] loadIntoTree called with:', {
             type: typeof filePathOrBuffer,
             isBuffer: typeof Buffer !== 'undefined' && Buffer.isBuffer(filePathOrBuffer),
@@ -322,9 +298,9 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         const tree = new treeStructure_1.AACTree();
         // Helper: try to parse JSON OBF
-        function tryParseObfJson(data) {
+        async function tryParseObfJson(data) {
             try {
-                const str = typeof data === 'string' ? data : (0, io_1.readTextFromInput)(data);
+                const str = typeof data === 'string' ? data : await readTextFromInput(data);
                 // Check for empty or whitespace-only content
                 if (!str.trim()) {
                     return null;
@@ -346,8 +322,8 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         // If input is a string path and ends with .obf, treat as JSON
         if (typeof filePathOrBuffer === 'string' && filePathOrBuffer.toLowerCase().endsWith('.obf')) {
             try {
-                const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
-                const boardData = tryParseObfJson(content);
+                const content = await readTextFromInput(filePathOrBuffer);
+                const boardData = await tryParseObfJson(content);
                 if (boardData) {
                     console.log('[OBF] Detected .obf file, parsed as JSON');
                     const page = await this.processBoard(boardData, filePathOrBuffer, false);
@@ -375,17 +351,17 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             }
         }
         // Detect likely zip signature first
-        function isLikelyZip(input) {
+        async function isLikelyZip(input) {
             if (typeof input === 'string') {
                 const lowered = input.toLowerCase();
                 return lowered.endsWith('.zip') || lowered.endsWith('.obz');
             }
-            const bytes = (0, io_1.readBinaryFromInput)(input);
+            const bytes = await readBinaryFromInput(input);
             return bytes.length >= 2 && bytes[0] === 0x50 && bytes[1] === 0x4b;
         }
         // Check if input is a buffer or string that parses as OBF JSON; throw if neither JSON nor ZIP
-        if (!isLikelyZip(filePathOrBuffer)) {
-            const asJson = tryParseObfJson(filePathOrBuffer);
+        if (!(await isLikelyZip(filePathOrBuffer))) {
+            const asJson = await tryParseObfJson(filePathOrBuffer);
             if (!asJson)
                 throw new Error('Invalid OBF content: not JSON and not ZIP');
             console.log('[OBF] Detected buffer/string as OBF JSON');
@@ -406,10 +382,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             return tree;
         }
         try {
-            const zipResult = this.options.zipAdapter
-                ? await this.options.zipAdapter(filePathOrBuffer)
-                : await (0, zip_1.openZipFromInput)(filePathOrBuffer);
-            this.zipFile = zipResult.zip;
+            this.zipFile = await this.options.zipAdapter(filePathOrBuffer);
         }
         catch (err) {
             console.error('[OBF] Error loading ZIP:', err);
@@ -427,7 +400,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             try {
                 const content = await this.zipFile.readFile(manifestFile[0]);
                 const data = (0, io_1.decodeText)(content);
-                const str = typeof data === 'string' ? data : (0, io_1.readTextFromInput)(data);
+                const str = typeof data === 'string' ? data : await readTextFromInput(data);
                 if (!str.trim())
                     throw new Error('Manifest object missing');
                 const manifestObject = JSON.parse(str);
@@ -451,7 +424,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         for (const entryName of obfEntries) {
             try {
                 const content = await this.zipFile.readFile(entryName);
-                const boardData = tryParseObfJson((0, io_1.decodeText)(content));
+                const boardData = await tryParseObfJson((0, io_1.decodeText)(content));
                 if (boardData) {
                     const page = await this.processBoard(boardData, entryName, true);
                     tree.addPage(page);
@@ -565,6 +538,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         };
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         // Load the tree, apply translations, and save to new file
         const tree = await this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
@@ -594,9 +568,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save the translated tree and return its content
         await this.saveFromTree(tree, outputPath);
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
+        const { writeTextToPath, writeBinaryToPath, pathExists } = this.options.fileAdapter;
         if (outputPath.endsWith('.obf')) {
             // Save as single OBF JSON file
             const rootPage = tree.rootId ? tree.getPage(tree.rootId) : Object.values(tree.pages)[0];
@@ -604,35 +579,22 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 throw new Error('No pages to save');
             }
             const obfBoard = this.createObfBoardFromPage(rootPage, 'Exported Board', tree.metadata);
-            (0, io_1.writeTextToPath)(outputPath, JSON.stringify(obfBoard, null, 2));
+            await writeTextToPath(outputPath, JSON.stringify(obfBoard, null, 2));
         }
         else {
-            // Save as OBZ (zip with multiple OBF files)
-            if ((0, io_1.isNodeRuntime)()) {
-                const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
-                const zip = new AdmZip();
-                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'));
-                });
-                const zipBuffer = zip.toBuffer();
-                const { writeBinaryToPath } = await Promise.resolve().then(() => __importStar(require('../utils/io')));
-                writeBinaryToPath(outputPath, zipBuffer);
-            }
-            else {
-                const module = await Promise.resolve().then(() => __importStar(require('jszip')));
-                const JSZip = module.default || module;
-                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.file(`${page.id}.obf`, obfContent);
-                });
-                const zipBuffer = await zip.generateAsync({ type: 'uint8array' });
-                const { writeBinaryToPath } = await Promise.resolve().then(() => __importStar(require('../utils/io')));
-                writeBinaryToPath(outputPath, zipBuffer);
-            }
+            const files = Object.values(tree.pages).map((page) => {
+                const obfBoard = this.createObfBoardFromPage(page, 'Board', tree.metadata);
+                const obfContent = JSON.stringify(obfBoard, null, 2);
+                const name = page.id.endsWith('.obf') ? page.id : `${page.id}.obf`;
+                return {
+                    name,
+                    data: new TextEncoder().encode(obfContent),
+                };
+            });
+            const fileExists = await pathExists(outputPath);
+            this.zipFile = await this.options.zipAdapter(fileExists ? outputPath : undefined, this.options.fileAdapter);
+            const zipData = await this.zipFile.writeFiles(files);
+            await writeBinaryToPath(outputPath, zipData);
         }
     }
     /**
@@ -656,7 +618,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      */
     async validate(filePath) {
         const ObfValidator = this.getObfValidator();
-        return ObfValidator.validateFile(filePath);
+        return ObfValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Extract symbol information from an OBF/OBZ file for LLM-based translation.
@@ -665,7 +627,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      * This method uses shared translation utilities that work across all AAC formats.
      *
      * @param filePathOrBuffer - Path to OBF/OBZ file or buffer
-     * @returns Array of symbol information for LLM processing
+     * @returns Promise resolving to symbol information for LLM processing
      */
     async extractSymbolsForLLM(filePathOrBuffer) {
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -695,9 +657,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      * @param llmTranslations - Array of LLM translations with symbol info
      * @param outputPath - Where to save the translated OBF/OBZ file
      * @param options - Translation options (e.g., allowPartial for testing)
-     * @returns Buffer of the translated OBF/OBZ file
+     * @returns Promise resolving to a buffer of the translated OBF/OBZ file
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         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));
@@ -736,7 +699,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     getObfValidator() {
         try {

package/dist/processors/obfsetProcessor.js

@@ -8,7 +8,6 @@ exports.ObfsetProcessor = void 0;
 const treeStructure_1 = require("../core/treeStructure");
 const treeStructure_2 = require("../core/treeStructure");
 const baseProcessor_1 = require("../core/baseProcessor");
-const io_1 = require("../utils/io");
 class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options = {}) {
         super(options);
@@ -33,10 +32,10 @@ class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
      * Load an .obfset file (JSON array of boards)
      */
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readTextFromInput } = this.options.fileAdapter;
         const tree = new treeStructure_1.AACTree();
         tree.metadata.format = 'obfset';
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const content = await readTextFromInput(filePathOrBuffer);
         const boards = JSON.parse(content);
         // Track board ID mappings
         const boardMap = new Map();

package/dist/processors/opmlProcessor.js

@@ -3,7 +3,6 @@ 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 validationTypes_1 = require("../validation/validationTypes");
 const io_1 = require("../utils/io");
@@ -53,8 +52,8 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
         return { page, childPages };
     }
     async extractTexts(filePathOrBuffer) {
-        await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { readTextFromInput } = this.options.fileAdapter;
+        const content = await readTextFromInput(filePathOrBuffer);
         const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
         const data = parser.parse(content);
         const texts = [];
@@ -85,10 +84,10 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         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);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(buffer);
         try {
             if (!content || !content.trim()) {
                 const validationResult = (0, validationTypes_1.buildValidationResultFromMessage)({
@@ -171,8 +170,8 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
-        await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { writeBinaryToPath, readTextFromInput } = this.options.fileAdapter;
+        const content = await readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         // Apply translations to text attributes in OPML outline elements
         translations.forEach((translation, originalText) => {
@@ -183,11 +182,11 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             }
         });
         const resultBuffer = (0, io_1.encodeText)(translatedContent);
-        (0, io_1.writeBinaryToPath)(outputPath, resultBuffer);
+        await writeBinaryToPath(outputPath, resultBuffer);
         return resultBuffer;
     }
     async saveFromTree(tree, outputPath) {
-        await Promise.resolve();
+        const { writeTextToPath } = this.options.fileAdapter;
         // Helper to recursively build outline nodes with cycle detection
         function buildOutline(page, visited = new Set()) {
             // Prevent infinite recursion by tracking visited pages
@@ -257,7 +256,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             attributeNamePrefix: '@_',
         });
         const xml = '<?xml version="1.0" encoding="UTF-8"?>\n' + builder.build(opmlObj);
-        (0, io_1.writeTextToPath)(outputPath, xml);
+        await writeTextToPath(outputPath, xml);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

package/dist/processors/snap/helpers.d.ts

@@ -1,5 +1,5 @@
 import { AACTree, AACSemanticCategory, AACSemanticIntent } from '../../core/treeStructure';
-import { ProcessorInput } from '../../utils/io';
+import { FileAdapter, ProcessorInput } from '../../utils/io';
 /**
  * Build a map of button IDs to resolved image entries for a specific page.
  * Mirrors the Grid helper for consumers that expect image reference data.
@@ -16,7 +16,7 @@ export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
  * @param entryPath Symbol identifier (e.g., "SYM:12345")
  * @returns Image data buffer or null if not found
  */
-export declare function openImage(dbOrFile: ProcessorInput, entryPath: string): Buffer | null;
+export declare function openImage(dbOrFile: ProcessorInput, entryPath: string, fileAdapter?: FileAdapter): Promise<Buffer | null>;
 /**
  * Snap package path information
  */
@@ -53,14 +53,14 @@ export interface SnapUsageEntry {
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Array of Snap package path information
  */
-export declare function findSnapPackages(packageNamePattern?: string): SnapPackagePath[];
+export declare function findSnapPackages(packageNamePattern?: string, fileAdapter?: FileAdapter): Promise<SnapPackagePath[]>;
 /**
  * Find the first Snap package path matching the pattern
  * Convenience method for when you expect only one Snap installation
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Path to the first matching Snap package, or null if not found
  */
-export declare function findSnapPackagePath(packageNamePattern?: string): string | null;
+export declare function findSnapPackagePath(packageNamePattern?: string, fileAdapter?: FileAdapter): Promise<string | null>;
 /**
  * Find Snap user directories and their vocab files (.sps/.spb)
  * Typical path:
@@ -68,14 +68,14 @@ export declare function findSnapPackagePath(packageNamePattern?: string): string
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */
-export declare function findSnapUsers(packageNamePattern?: string): SnapUserInfo[];
+export declare function findSnapUsers(packageNamePattern?: string, fileAdapter?: FileAdapter): Promise<SnapUserInfo[]>;
 /**
  * Find vocab files for a specific Snap user (or all users)
  * @param userId Optional user identifier filter (case-sensitive directory name)
  * @param packageNamePattern Optional package filter
  * @returns Array of vocab file paths
  */
-export declare function findSnapUserVocabularies(userId?: string, packageNamePattern?: string): string[];
+export declare function findSnapUserVocabularies(userId?: string, packageNamePattern?: string, fileAdapter?: FileAdapter): Promise<string[]>;
 /**
  * Attempt to find history/analytics files for a Snap user by name
  * Currently searches for files containing "history" under the user directory
@@ -83,7 +83,7 @@ export declare function findSnapUserVocabularies(userId?: string, packageNamePat
  * @param packageNamePattern Optional package filter
  * @returns Array of history file paths (may be empty if not found)
  */
-export declare function findSnapUserHistory(userId: string, packageNamePattern?: string): string[];
+export declare function findSnapUserHistory(userId: string, packageNamePattern?: string, fileAdapter?: FileAdapter): Promise<string[]>;
 /**
  * Check whether TD Snap appears to be installed (Windows only)
  */
@@ -91,8 +91,8 @@ export declare function isSnapInstalled(packageNamePattern?: string): boolean;
 /**
  * Read Snap usage history from a pageset file (.sps/.spb)
  */
-export declare function readSnapUsage(pagesetPath: string): SnapUsageEntry[];
+export declare function readSnapUsage(pagesetPath: string, fileAdapter?: FileAdapter): Promise<SnapUsageEntry[]>;
 /**
  * Read Snap usage history for a user (all pagesets)
  */
-export declare function readSnapUsageForUser(userId?: string, packageNamePattern?: string): SnapUsageEntry[];
+export declare function readSnapUsageForUser(userId?: string, packageNamePattern?: string): Promise<SnapUsageEntry[]>;