@willwade/aac-processors 0.1.21 → 0.2.0

package/dist/processors/gridset/symbolSearch.js

@@ -26,9 +26,9 @@ const io_1 = require("../../utils/io");
  * @param pixFilePath - Path to .pix file
  * @returns Search index
  */
-function parsePixFile(pixFilePath, fileAdapter = io_1.defaultFileAdapter) {
+async function parsePixFile(pixFilePath, fileAdapter = io_1.defaultFileAdapter) {
     const { readTextFromInput, basename } = fileAdapter;
-    const content = readTextFromInput(pixFilePath);
+    const content = await readTextFromInput(pixFilePath);
     const library = basename(pixFilePath, '.pix');
     const searchTerms = new Map();
     const filenames = new Map();
@@ -55,18 +55,18 @@ function parsePixFile(pixFilePath, fileAdapter = io_1.defaultFileAdapter) {
  * @param options - Search options
  * @returns Map of library name to search index
  */
-function loadSearchIndexes(options = {}, fileAdapter = io_1.defaultFileAdapter) {
+async function loadSearchIndexes(options = {}, fileAdapter = io_1.defaultFileAdapter) {
     const { listDir, pathExists, join, basename } = fileAdapter;
     const { grid3Path, locale = 'en-GB', libraries: specifiedLibs } = options;
     if (!grid3Path) {
         throw new Error('grid3Path is required for symbol search');
     }
     const searchIndexesDir = join(grid3Path, 'Locale', locale, 'symbolsearch');
-    if (!pathExists(searchIndexesDir)) {
+    if (!(await pathExists(searchIndexesDir))) {
         throw new Error(`Symbol search directory not found: ${searchIndexesDir}`);
     }
     const indexes = new Map();
-    const files = listDir(searchIndexesDir);
+    const files = await listDir(searchIndexesDir);
     for (const file of files) {
         if (!file.endsWith('.pix')) {
             continue;
@@ -80,7 +80,7 @@ function loadSearchIndexes(options = {}, fileAdapter = io_1.defaultFileAdapter)
         }
         try {
             const pixFilePath = join(searchIndexesDir, file);
-            const index = parsePixFile(pixFilePath);
+            const index = await parsePixFile(pixFilePath);
             indexes.set(libraryName, index);
         }
         catch (error) {
@@ -95,8 +95,8 @@ function loadSearchIndexes(options = {}, fileAdapter = io_1.defaultFileAdapter)
  * @param options - Search options
  * @returns Array of search results
  */
-function searchSymbols(searchTerm, options = {}) {
-    const indexes = loadSearchIndexes(options);
+async function searchSymbols(searchTerm, options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const results = [];
     const lowerSearchTerm = searchTerm.toLowerCase().trim();
     const limit = options.limit || 100;
@@ -149,8 +149,8 @@ function searchSymbols(searchTerm, options = {}) {
  * @param options - Search options
  * @returns Symbol filename or undefined
  */
-function getSymbolFilename(searchTerm, library, options = {}) {
-    const indexes = loadSearchIndexes({
+async function getSymbolFilename(searchTerm, library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -167,8 +167,8 @@ function getSymbolFilename(searchTerm, library, options = {}) {
  * @param options - Search options
  * @returns Display name or undefined
  */
-function getSymbolDisplayName(symbolFilename, library, options = {}) {
-    const indexes = loadSearchIndexes({
+async function getSymbolDisplayName(symbolFilename, library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -184,8 +184,8 @@ function getSymbolDisplayName(symbolFilename, library, options = {}) {
  * @param options - Search options
  * @returns Array of search terms
  */
-function getAllSearchTerms(library, options = {}) {
-    const indexes = loadSearchIndexes({
+async function getAllSearchTerms(library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -201,8 +201,8 @@ function getAllSearchTerms(library, options = {}) {
  * @param options - Search options
  * @returns Array of suggested terms
  */
-function getSearchSuggestions(partialTerm, options = {}) {
-    const indexes = loadSearchIndexes(options);
+async function getSearchSuggestions(partialTerm, options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const suggestions = new Set();
     const lowerPartial = partialTerm.toLowerCase().trim();
     for (const index of indexes.values()) {
@@ -220,8 +220,8 @@ function getSearchSuggestions(partialTerm, options = {}) {
  * @param options - Search options
  * @returns Array of full symbol references
  */
-function searchSymbolsWithReferences(searchTerm, options = {}) {
-    const results = searchSymbols(searchTerm, options);
+async function searchSymbolsWithReferences(searchTerm, options = {}) {
+    const results = await searchSymbols(searchTerm, options);
     return results.map((r) => `[${r.library}]${r.symbolFilename}`);
 }
 /**
@@ -229,8 +229,8 @@ function searchSymbolsWithReferences(searchTerm, options = {}) {
  * @param options - Search options
  * @returns Map of library name to symbol count
  */
-function countLibrarySymbols(options = {}) {
-    const indexes = loadSearchIndexes(options);
+async function countLibrarySymbols(options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const counts = new Map();
     for (const [libraryName, index] of indexes.entries()) {
         counts.set(libraryName, index.searchTerms.size);
@@ -242,8 +242,8 @@ function countLibrarySymbols(options = {}) {
  * @param options - Search options
  * @returns Statistics about available symbols
  */
-function getSymbolSearchStats(options = {}) {
-    const indexes = loadSearchIndexes(options);
+async function getSymbolSearchStats(options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const stats = {
         totalLibraries: indexes.size,
         totalSymbols: 0,

package/dist/processors/gridset/symbols.d.ts

@@ -94,7 +94,7 @@ export declare function isSymbolReference(reference: string): boolean;
  * Get the default Grid 3 installation path for the current platform
  * @returns Default Grid 3 path or empty string if not found
  */
-export declare function getDefaultGrid3Path(fileAdapter?: FileAdapter): string;
+export declare function getDefaultGrid3Path(fileAdapter?: FileAdapter): Promise<string>;
 /**
  * Get the Symbol Libraries directory path
  * Contains .symbols ZIP archives with actual image files
@@ -115,14 +115,14 @@ export declare function getSymbolSearchIndexesDir(grid3Path: string, locale?: st
  * @param options - Resolution options
  * @returns Array of symbol library information
  */
-export declare function getAvailableSymbolLibraries(options?: SymbolResolutionOptions, fileAdapter?: FileAdapter): SymbolLibraryInfo[];
+export declare function getAvailableSymbolLibraries(options?: SymbolResolutionOptions, fileAdapter?: FileAdapter): Promise<SymbolLibraryInfo[]>;
 /**
  * Check if a symbol library exists
  * @param libraryName - Name of the library (e.g., 'widgit', 'tawasl')
  * @param options - Resolution options
  * @returns Symbol library info or undefined if not found
  */
-export declare function getSymbolLibraryInfo(libraryName: string, options?: SymbolResolutionOptions, fileAdapter?: FileAdapter): SymbolLibraryInfo | undefined;
+export declare function getSymbolLibraryInfo(libraryName: string, options?: SymbolResolutionOptions, fileAdapter?: FileAdapter): Promise<SymbolLibraryInfo | undefined>;
 /**
  * Resolve a symbol reference to extract the actual image data
  * @param reference - Symbol reference like "[tawasl]/above bw.png"

package/dist/processors/gridset/symbols.js

@@ -114,12 +114,12 @@ function isSymbolReference(reference) {
  * Get the default Grid 3 installation path for the current platform
  * @returns Default Grid 3 path or empty string if not found
  */
-function getDefaultGrid3Path(fileAdapter) {
+async function getDefaultGrid3Path(fileAdapter) {
     const { pathExists } = fileAdapter ?? io_1.defaultFileAdapter;
     const platform = (typeof process !== 'undefined' && process.platform ? process.platform : 'unknown');
     const defaultPath = DEFAULT_GRID3_PATHS[platform] || '';
     try {
-        if (defaultPath && pathExists(defaultPath)) {
+        if (defaultPath && (await pathExists(defaultPath))) {
             return defaultPath;
         }
         // Try to find Grid 3 in common locations
@@ -131,7 +131,7 @@ function getDefaultGrid3Path(fileAdapter) {
             '/opt/smartbox/grid3',
         ];
         for (const testPath of commonPaths) {
-            if (pathExists(testPath)) {
+            if (await pathExists(testPath)) {
                 return testPath;
             }
         }
@@ -167,22 +167,22 @@ function getSymbolSearchIndexesDir(grid3Path, locale = exports.DEFAULT_LOCALE, f
  * @param options - Resolution options
  * @returns Array of symbol library information
  */
-function getAvailableSymbolLibraries(options = {}, fileAdapter) {
+async function getAvailableSymbolLibraries(options = {}, fileAdapter) {
     const { pathExists, getFileSize, listDir, join, basename } = fileAdapter ?? io_1.defaultFileAdapter;
-    const grid3Path = options.grid3Path || options.symbolDir || getDefaultGrid3Path();
+    const grid3Path = options.grid3Path || options.symbolDir || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return [];
     }
     const symbolsDir = getSymbolLibrariesDir(grid3Path, fileAdapter);
-    if (!pathExists(symbolsDir)) {
+    if (!(await pathExists(symbolsDir))) {
         return [];
     }
     const libraries = [];
-    const files = listDir(symbolsDir);
+    const files = await listDir(symbolsDir);
     for (const file of files) {
         if (file.endsWith('.symbols')) {
             const fullPath = join(symbolsDir, file);
-            const size = getFileSize(fullPath);
+            const size = await getFileSize(fullPath);
             const libraryName = basename(file, '.symbols');
             libraries.push({
                 name: libraryName,
@@ -201,9 +201,9 @@ function getAvailableSymbolLibraries(options = {}, fileAdapter) {
  * @param options - Resolution options
  * @returns Symbol library info or undefined if not found
  */
-function getSymbolLibraryInfo(libraryName, options = {}, fileAdapter) {
+async function getSymbolLibraryInfo(libraryName, options = {}, fileAdapter) {
     const { pathExists, getFileSize, join } = fileAdapter ?? io_1.defaultFileAdapter;
-    const grid3Path = options.grid3Path || options.symbolDir || getDefaultGrid3Path();
+    const grid3Path = options.grid3Path || options.symbolDir || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return undefined;
     }
@@ -217,8 +217,8 @@ function getSymbolLibraryInfo(libraryName, options = {}, fileAdapter) {
     ];
     for (const file of variations) {
         const fullPath = join(symbolsDir, file);
-        if (pathExists(fullPath)) {
-            const size = getFileSize(fullPath);
+        if (await pathExists(fullPath)) {
+            const size = await getFileSize(fullPath);
             return {
                 name: libraryName,
                 pixFile: fullPath,
@@ -245,7 +245,7 @@ async function resolveSymbolReference(reference, options = {}, fileAdapter = io_
             error: 'Invalid symbol reference format',
         };
     }
-    const grid3Path = options.grid3Path || getDefaultGrid3Path();
+    const grid3Path = options.grid3Path || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return {
             reference: parsed,
@@ -253,7 +253,7 @@ async function resolveSymbolReference(reference, options = {}, fileAdapter = io_
             error: 'Grid 3 installation not found. Please specify grid3Path.',
         };
     }
-    const libraryInfo = getSymbolLibraryInfo(parsed.library, { grid3Path });
+    const libraryInfo = await getSymbolLibraryInfo(parsed.library, { grid3Path });
     if (!libraryInfo || !libraryInfo.exists) {
         return {
             reference: parsed,

package/dist/processors/gridsetProcessor.d.ts

@@ -30,7 +30,7 @@ declare class GridsetProcessor extends 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
      */
     extractSymbolsForLLM(filePathOrBuffer: string | Buffer): Promise<ButtonForTranslation[]>;
     /**
@@ -43,7 +43,7 @@ declare class GridsetProcessor extends 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
      */
     processLLMTranslations(filePathOrBuffer: string | Buffer, llmTranslations: LLMLTranslationResult[], outputPath: string, options?: {
         allowPartial?: boolean;

package/dist/processors/gridsetProcessor.js

@@ -401,7 +401,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         const tree = new treeStructure_1.AACTree();
         let zipResult;
         try {
-            const zipInput = readBinaryFromInput(filePathOrBuffer);
+            const zipInput = await readBinaryFromInput(filePathOrBuffer);
             zipResult = await this.options.zipAdapter(zipInput);
         }
         catch (error) {
@@ -1745,7 +1745,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save the translated tree and return its content
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     /**
      * Extract symbol information from a gridset for LLM-based translation.
@@ -1754,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);
@@ -1784,7 +1784,7 @@ 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;
@@ -1826,7 +1826,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
         const files = [];
@@ -1835,7 +1835,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         if (Object.keys(tree.pages).length === 0) {
             // Create empty zip for empty tree
             const zipBuffer = await zip.writeFiles([]);
-            writeBinaryToPath(outputPath, zipBuffer);
+            await writeBinaryToPath(outputPath, zipBuffer);
             return;
         }
         // Collect all unique styles from pages and buttons
@@ -2145,7 +2145,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Write the zip file
         const zipBuffer = await zip.writeFiles(files);
-        writeBinaryToPath(outputPath, zipBuffer);
+        await writeBinaryToPath(outputPath, zipBuffer);
     }
     // Helper method to calculate column definitions based on page layout
     calculateColumnDefinitions(page) {

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

@@ -6,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
@@ -170,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),
@@ -220,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;
                             }
@@ -233,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;
                                 }
@@ -290,7 +288,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         // Detailed logging for debugging input
         const bufferLength = typeof filePathOrBuffer === 'string'
             ? null
-            : readBinaryFromInput(filePathOrBuffer).byteLength;
+            : (await readBinaryFromInput(filePathOrBuffer)).byteLength;
         console.log('[OBF] loadIntoTree called with:', {
             type: typeof filePathOrBuffer,
             isBuffer: typeof Buffer !== 'undefined' && Buffer.isBuffer(filePathOrBuffer),
@@ -300,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 : readTextFromInput(data);
+                const str = typeof data === 'string' ? data : await readTextFromInput(data);
                 // Check for empty or whitespace-only content
                 if (!str.trim()) {
                     return null;
@@ -324,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 = 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);
@@ -353,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 = 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');
@@ -402,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 : 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);
@@ -426,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);
@@ -570,10 +568,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save the translated tree and return its content
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
-        const { writeTextToPath, writeBinaryToPath } = this.options.fileAdapter;
+        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];
@@ -581,7 +579,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 throw new Error('No pages to save');
             }
             const obfBoard = this.createObfBoardFromPage(rootPage, 'Exported Board', tree.metadata);
-            writeTextToPath(outputPath, JSON.stringify(obfBoard, null, 2));
+            await writeTextToPath(outputPath, JSON.stringify(obfBoard, null, 2));
         }
         else {
             const files = Object.values(tree.pages).map((page) => {
@@ -593,9 +591,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                     data: new TextEncoder().encode(obfContent),
                 };
             });
-            const zip = await (0, zip_1.getZipAdapter)(undefined, this.options.fileAdapter);
-            const zipData = await zip.writeFiles(files);
-            writeBinaryToPath(outputPath, zipData);
+            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);
         }
     }
     /**
@@ -628,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);
@@ -658,7 +657,7 @@ 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;
@@ -700,7 +699,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     getObfValidator() {
         try {

package/dist/processors/obfsetProcessor.js

@@ -33,10 +33,9 @@ class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
      */
     async loadIntoTree(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
         const tree = new treeStructure_1.AACTree();
         tree.metadata.format = 'obfset';
-        const content = 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

@@ -53,8 +53,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
     }
     async extractTexts(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(filePathOrBuffer);
         const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
         const data = parser.parse(content);
         const texts = [];
@@ -86,10 +85,9 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.opml';
-        const buffer = readBinaryFromInput(filePathOrBuffer);
-        const content = readTextFromInput(buffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(buffer);
         try {
             if (!content || !content.trim()) {
                 const validationResult = (0, validationTypes_1.buildValidationResultFromMessage)({
@@ -173,8 +171,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
         const { writeBinaryToPath, readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         // Apply translations to text attributes in OPML outline elements
         translations.forEach((translation, originalText) => {
@@ -185,12 +182,11 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             }
         });
         const resultBuffer = (0, io_1.encodeText)(translatedContent);
-        writeBinaryToPath(outputPath, resultBuffer);
+        await writeBinaryToPath(outputPath, resultBuffer);
         return resultBuffer;
     }
     async saveFromTree(tree, outputPath) {
         const { writeTextToPath } = this.options.fileAdapter;
-        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
@@ -260,7 +256,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             attributeNamePrefix: '@_',
         });
         const xml = '<?xml version="1.0" encoding="UTF-8"?>\n' + builder.build(opmlObj);
-        writeTextToPath(outputPath, xml);
+        await writeTextToPath(outputPath, xml);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

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

@@ -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, fileAdapter?: FileAdapter): 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, fileAdapter?: FileAdapter): 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, fileAdapter?: FileAdapter): 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, fileAda
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */
-export declare function findSnapUsers(packageNamePattern?: string, fileAdapter?: FileAdapter): 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, fileAdapter?: FileAdapter): 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, fileAdapter?: FileAdapter): 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, fileAdapter?: FileAdapter): 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[]>;