@willwade/aac-processors 0.1.21 → 0.2.1

package/dist/browser/processors/gridset/symbols.js

@@ -93,12 +93,12 @@ export 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
  */
-export function getDefaultGrid3Path(fileAdapter) {
+export async function getDefaultGrid3Path(fileAdapter) {
     const { pathExists } = fileAdapter ?? 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
@@ -110,7 +110,7 @@ export function getDefaultGrid3Path(fileAdapter) {
             '/opt/smartbox/grid3',
         ];
         for (const testPath of commonPaths) {
-            if (pathExists(testPath)) {
+            if (await pathExists(testPath)) {
                 return testPath;
             }
         }
@@ -146,22 +146,22 @@ export function getSymbolSearchIndexesDir(grid3Path, locale = DEFAULT_LOCALE, fi
  * @param options - Resolution options
  * @returns Array of symbol library information
  */
-export function getAvailableSymbolLibraries(options = {}, fileAdapter) {
+export async function getAvailableSymbolLibraries(options = {}, fileAdapter) {
     const { pathExists, getFileSize, listDir, join, basename } = fileAdapter ?? 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,
@@ -180,9 +180,9 @@ export function getAvailableSymbolLibraries(options = {}, fileAdapter) {
  * @param options - Resolution options
  * @returns Symbol library info or undefined if not found
  */
-export function getSymbolLibraryInfo(libraryName, options = {}, fileAdapter) {
+export async function getSymbolLibraryInfo(libraryName, options = {}, fileAdapter) {
     const { pathExists, getFileSize, join } = fileAdapter ?? defaultFileAdapter;
-    const grid3Path = options.grid3Path || options.symbolDir || getDefaultGrid3Path();
+    const grid3Path = options.grid3Path || options.symbolDir || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return undefined;
     }
@@ -196,8 +196,8 @@ export 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,
@@ -224,7 +224,7 @@ export async function resolveSymbolReference(reference, options = {}, fileAdapte
             error: 'Invalid symbol reference format',
         };
     }
-    const grid3Path = options.grid3Path || getDefaultGrid3Path();
+    const grid3Path = options.grid3Path || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return {
             reference: parsed,
@@ -232,7 +232,7 @@ export async function resolveSymbolReference(reference, options = {}, fileAdapte
             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/browser/processors/gridsetProcessor.js

@@ -398,7 +398,7 @@ class GridsetProcessor extends BaseProcessor {
         const tree = new AACTree();
         let zipResult;
         try {
-            const zipInput = readBinaryFromInput(filePathOrBuffer);
+            const zipInput = await readBinaryFromInput(filePathOrBuffer);
             zipResult = await this.options.zipAdapter(zipInput);
         }
         catch (error) {
@@ -1742,7 +1742,7 @@ class GridsetProcessor extends 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.
@@ -1751,7 +1751,7 @@ 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
      */
     async extractSymbolsForLLM(filePathOrBuffer) {
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -1781,7 +1781,7 @@ 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
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
         const { readBinaryFromInput } = this.options.fileAdapter;
@@ -1823,7 +1823,7 @@ class GridsetProcessor extends BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
         const files = [];
@@ -1832,7 +1832,7 @@ class GridsetProcessor extends 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
@@ -2142,7 +2142,7 @@ class GridsetProcessor extends 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/browser/processors/obfProcessor.js

@@ -3,7 +3,6 @@ import { AACTree, AACPage, AACButton, AACSemanticCategory, AACSemanticIntent, }
 import { generateCloneId } from '../utilities/analytics/utils/idGenerator';
 import { extractAllButtonsForTranslation, validateTranslationResults, } from '../utilities/translation/translationProcessor';
 import { encodeBase64, decodeText } from '../utils/io';
-import { getZipAdapter } from '../utils/zip';
 const OBF_FORMAT_VERSION = 'open-board-0.1';
 /**
  * Map OBF hidden value to AAC standard visibility
@@ -63,35 +62,42 @@ class ObfProcessor extends BaseProcessor {
         if (this.imageCache.has(imageId)) {
             return this.imageCache.get(imageId) ?? null;
         }
-        if (!this.zipFile || !images) {
+        if (!images)
             return null;
-        }
         // Find the image metadata
         const imageData = images.find((img) => img.id === imageId);
         if (!imageData) {
             return null;
         }
-        // Try to get the image file from the ZIP
-        // Images are typically stored in an 'images' folder or root
-        const possiblePaths = [
-            imageData.path, // Explicit path if provided
-            `images/${imageData.filename || imageId}`, // Standard images folder
-            imageData.id, // Just the ID
-        ].filter(Boolean);
-        for (const imagePath of possiblePaths) {
-            try {
-                const buffer = await this.zipFile.readFile(imagePath);
-                if (buffer) {
-                    const contentType = imageData.content_type ||
-                        this.getMimeTypeFromFilename(imagePath);
-                    const dataUrl = `data:${contentType};base64,${encodeBase64(buffer)}`;
-                    this.imageCache.set(imageId, dataUrl);
-                    return dataUrl;
+        // If image has data property, use that
+        if (imageData.data) {
+            const dataUrl = imageData.data;
+            this.imageCache.set(imageId, dataUrl);
+            return dataUrl;
+        }
+        if (this.zipFile) {
+            // Try to get the image file from the ZIP
+            // Images are typically stored in an 'images' folder or root
+            const possiblePaths = [
+                imageData.path, // Explicit path if provided
+                `images/${imageData.filename || imageId}`, // Standard images folder
+                imageData.id, // Just the ID
+            ].filter(Boolean);
+            for (const imagePath of possiblePaths) {
+                try {
+                    const buffer = await this.zipFile.readFile(imagePath);
+                    if (buffer) {
+                        const contentType = imageData.content_type ||
+                            this.getMimeTypeFromFilename(imagePath);
+                        const dataUrl = `data:${contentType};base64,${encodeBase64(buffer)}`;
+                        this.imageCache.set(imageId, dataUrl);
+                        return dataUrl;
+                    }
+                }
+                catch (err) {
+                    // Continue to next path
+                    continue;
                 }
-            }
-            catch (err) {
-                // Continue to next path
-                continue;
             }
         }
         // If image has a URL, use that as fallback
@@ -167,8 +173,7 @@ class ObfProcessor extends BaseProcessor {
                 buttonParameters.image_id = btn.image_id;
             }
             return new 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),
@@ -217,7 +222,7 @@ class ObfProcessor extends 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;
                             }
@@ -230,7 +235,7 @@ class ObfProcessor extends 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;
                                 }
@@ -287,7 +292,7 @@ class ObfProcessor extends 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),
@@ -297,9 +302,9 @@ class ObfProcessor extends BaseProcessor {
         });
         const tree = new 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;
@@ -321,8 +326,8 @@ class ObfProcessor extends 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);
@@ -350,17 +355,17 @@ class ObfProcessor extends 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');
@@ -399,7 +404,7 @@ class ObfProcessor extends BaseProcessor {
             try {
                 const content = await this.zipFile.readFile(manifestFile[0]);
                 const data = 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);
@@ -423,7 +428,7 @@ class ObfProcessor extends BaseProcessor {
         for (const entryName of obfEntries) {
             try {
                 const content = await this.zipFile.readFile(entryName);
-                const boardData = tryParseObfJson(decodeText(content));
+                const boardData = await tryParseObfJson(decodeText(content));
                 if (boardData) {
                     const page = await this.processBoard(boardData, entryName, true);
                     tree.addPage(page);
@@ -530,6 +535,7 @@ class ObfProcessor extends BaseProcessor {
                     border_color: button.style?.borderColor,
                     box_id: buttonPositions.get(String(button.id ?? '')),
                     image_id: imageId,
+                    hidden: button.visibility === 'Hidden' || false,
                 };
             }),
             images: Array.isArray(page.images) ? page.images : [],
@@ -567,10 +573,10 @@ class ObfProcessor extends 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];
@@ -578,7 +584,7 @@ class ObfProcessor extends 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) => {
@@ -590,9 +596,10 @@ class ObfProcessor extends BaseProcessor {
                     data: new TextEncoder().encode(obfContent),
                 };
             });
-            const zip = await 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);
         }
     }
     /**
@@ -625,7 +632,7 @@ 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
      */
     async extractSymbolsForLLM(filePathOrBuffer) {
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -655,7 +662,7 @@ 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
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
         const { readBinaryFromInput } = this.options.fileAdapter;
@@ -697,7 +704,7 @@ class ObfProcessor extends BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     getObfValidator() {
         try {

package/dist/browser/processors/opmlProcessor.js

@@ -50,8 +50,7 @@ class OpmlProcessor extends BaseProcessor {
     }
     async extractTexts(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(filePathOrBuffer);
         const parser = new XMLParser({ ignoreAttributes: false });
         const data = parser.parse(content);
         const texts = [];
@@ -83,10 +82,9 @@ class OpmlProcessor extends BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
         const filename = typeof filePathOrBuffer === 'string' ? 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 = buildValidationResultFromMessage({
@@ -170,8 +168,7 @@ class OpmlProcessor extends 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) => {
@@ -182,12 +179,11 @@ class OpmlProcessor extends BaseProcessor {
             }
         });
         const resultBuffer = 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
@@ -257,7 +253,7 @@ class OpmlProcessor extends 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/browser/processors/snap/helpers.js

@@ -10,7 +10,7 @@ import { requireBetterSqlite3 } from '../../utils/sqlite';
 // We extract PNG/JPEG images but skip vector graphics (requires renderer).
 // NOTE: Snap buttons currently do not populate resolvedImageEntry; these helpers
 // therefore return empty collections until image resolution is implemented.
-function collectFiles(root, matcher, maxDepth = 3, fileAdapter = defaultFileAdapter) {
+async function collectFiles(root, matcher, maxDepth = 3, fileAdapter = defaultFileAdapter) {
     const { listDir, join, isDirectory } = fileAdapter;
     const results = new Set();
     const stack = [{ dir: root, depth: 0 }];
@@ -22,14 +22,14 @@ function collectFiles(root, matcher, maxDepth = 3, fileAdapter = defaultFileAdap
             continue;
         let entries;
         try {
-            entries = listDir(current.dir);
+            entries = await listDir(current.dir);
         }
         catch (error) {
             continue;
         }
         for (const entry of entries) {
             const fullPath = join(current.dir, entry);
-            if (isDirectory(entry)) {
+            if (await isDirectory(entry)) {
                 stack.push({ dir: fullPath, depth: current.depth + 1 });
             }
             else if (matcher(fullPath)) {
@@ -83,15 +83,15 @@ export function getAllowedImageEntries(tree) {
  * @param entryPath Symbol identifier (e.g., "SYM:12345")
  * @returns Image data buffer or null if not found
  */
-export function openImage(dbOrFile, entryPath, fileAdapter = defaultFileAdapter) {
+export async function openImage(dbOrFile, entryPath, fileAdapter = defaultFileAdapter) {
     const { mkTempDir, join, writeBinaryToPath, removePath, dirname } = fileAdapter;
     let dbPath;
     let cleanupNeeded = false;
     // Handle Buffer input by writing to temp file
     if (Buffer.isBuffer(dbOrFile)) {
-        const tempDir = mkTempDir(join(process.cwd(), 'snap-'));
+        const tempDir = await mkTempDir(join(process.cwd(), 'snap-'));
         dbPath = join(tempDir, 'temp.sps');
-        writeBinaryToPath(dbPath, dbOrFile);
+        await writeBinaryToPath(dbPath, dbOrFile);
         cleanupNeeded = true;
     }
     else if (typeof dbOrFile === 'string') {
@@ -126,9 +126,9 @@ export function openImage(dbOrFile, entryPath, fileAdapter = defaultFileAdapter)
         }
         if (cleanupNeeded && dbPath) {
             try {
-                removePath(dbPath);
+                await removePath(dbPath);
                 const dir = dirname(dbPath);
-                removePath(dir);
+                await removePath(dir);
             }
             catch (e) {
                 // Ignore cleanup errors
@@ -142,7 +142,7 @@ export function openImage(dbOrFile, entryPath, fileAdapter = defaultFileAdapter)
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Array of Snap package path information
  */
-export function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
+export async function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
     const { join, listDir, isDirectory, pathExists } = fileAdapter;
     const results = [];
     // Only works on Windows
@@ -156,13 +156,13 @@ export function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapte
         }
         const packagesPath = join(localAppData, 'Packages');
         // Check if Packages directory exists
-        if (!pathExists(packagesPath)) {
+        if (!(await pathExists(packagesPath))) {
             return results;
         }
         // Enumerate packages
-        const packages = listDir(packagesPath);
+        const packages = await listDir(packagesPath);
         for (const packageDir of packages) {
-            if (!isDirectory(packageDir))
+            if (!(await isDirectory(packageDir)))
                 continue;
             const packageName = packageDir;
             // Filter by pattern
@@ -185,8 +185,8 @@ export function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapte
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Path to the first matching Snap package, or null if not found
  */
-export function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
-    const packages = findSnapPackages(packageNamePattern, fileAdapter);
+export async function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const packages = await findSnapPackages(packageNamePattern, fileAdapter);
     return packages.length > 0 ? packages[0].packagePath : null;
 }
 /**
@@ -196,28 +196,28 @@ export function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAda
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */
-export function findSnapUsers(packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
+export async function findSnapUsers(packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
     const { join, listDir, isDirectory, pathExists } = fileAdapter;
     const results = [];
     if (process.platform !== 'win32') {
         return results;
     }
-    const packagePath = findSnapPackagePath(packageNamePattern, fileAdapter);
+    const packagePath = await findSnapPackagePath(packageNamePattern, fileAdapter);
     if (!packagePath) {
         return results;
     }
     const usersRoot = join(packagePath, 'LocalState', 'Users');
-    if (!pathExists(usersRoot)) {
+    if (!(await pathExists(usersRoot))) {
         return results;
     }
-    const entries = listDir(usersRoot);
+    const entries = await listDir(usersRoot);
     for (const entry of entries) {
-        if (!isDirectory(entry))
+        if (!(await isDirectory(entry)))
             continue;
         if (entry.toLowerCase().startsWith('swiftkey'))
             continue;
         const userPath = join(usersRoot, entry);
-        const vocabPaths = collectFiles(userPath, (full) => {
+        const vocabPaths = await collectFiles(userPath, (full) => {
             const ext = extname(full).toLowerCase();
             return ext === '.sps' || ext === '.spb';
         }, 2, fileAdapter);
@@ -235,8 +235,9 @@ export function findSnapUsers(packageNamePattern = 'TobiiDynavox', fileAdapter =
  * @param packageNamePattern Optional package filter
  * @returns Array of vocab file paths
  */
-export function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox', fileAdapter) {
-    const users = findSnapUsers(packageNamePattern, fileAdapter).filter((u) => !userId || u.userId === userId);
+export async function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const allUsers = await findSnapUsers(packageNamePattern, fileAdapter);
+    const users = allUsers.filter((u) => !userId || u.userId === userId);
     return users.flatMap((u) => u.vocabPaths);
 }
 /**
@@ -246,12 +247,13 @@ export function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDyna
  * @param packageNamePattern Optional package filter
  * @returns Array of history file paths (may be empty if not found)
  */
-export function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
+export async function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
     const { basename } = fileAdapter;
-    const user = findSnapUsers(packageNamePattern, fileAdapter).find((u) => u.userId === userId);
+    const allUsers = await findSnapUsers(packageNamePattern, fileAdapter);
+    const user = allUsers.find((u) => u.userId === userId);
     if (!user)
         return [];
-    return collectFiles(user.userPath, (full) => basename(full).toLowerCase().includes('history'), 2, fileAdapter);
+    return await collectFiles(user.userPath, (full) => basename(full).toLowerCase().includes('history'), 2, fileAdapter);
 }
 /**
  * Check whether TD Snap appears to be installed (Windows only)
@@ -264,9 +266,9 @@ export function isSnapInstalled(packageNamePattern = 'TobiiDynavox') {
 /**
  * Read Snap usage history from a pageset file (.sps/.spb)
  */
-export function readSnapUsage(pagesetPath, fileAdapter = defaultFileAdapter) {
+export async function readSnapUsage(pagesetPath, fileAdapter = defaultFileAdapter) {
     const { pathExists } = fileAdapter;
-    if (!pathExists(pagesetPath))
+    if (!(await pathExists(pagesetPath)))
         return [];
     const Database = requireBetterSqlite3();
     const db = new Database(pagesetPath, { readonly: true });
@@ -323,8 +325,10 @@ export function readSnapUsage(pagesetPath, fileAdapter = defaultFileAdapter) {
 /**
  * Read Snap usage history for a user (all pagesets)
  */
-export function readSnapUsageForUser(userId, packageNamePattern = 'TobiiDynavox') {
-    const users = findSnapUsers(packageNamePattern).filter((u) => !userId || u.userId === userId);
+export async function readSnapUsageForUser(userId, packageNamePattern = 'TobiiDynavox') {
+    const allUsers = await findSnapUsers(packageNamePattern);
+    const users = allUsers.filter((u) => !userId || u.userId === userId);
     const pagesets = users.flatMap((u) => u.vocabPaths);
-    return pagesets.flatMap((p) => readSnapUsage(p));
+    const usage = await Promise.all(pagesets.map(async (p) => await readSnapUsage(p)));
+    return usage.flat();
 }