@willwade/aac-processors 0.1.21 → 0.2.0

package/dist/processors/snap/helpers.js

@@ -23,7 +23,7 @@ const sqlite_1 = require("../../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 = io_1.defaultFileAdapter) {
+async function collectFiles(root, matcher, maxDepth = 3, fileAdapter = io_1.defaultFileAdapter) {
     const { listDir, join, isDirectory } = fileAdapter;
     const results = new Set();
     const stack = [{ dir: root, depth: 0 }];
@@ -35,14 +35,14 @@ function collectFiles(root, matcher, maxDepth = 3, fileAdapter = io_1.defaultFil
             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)) {
@@ -96,15 +96,15 @@ function getAllowedImageEntries(tree) {
  * @param entryPath Symbol identifier (e.g., "SYM:12345")
  * @returns Image data buffer or null if not found
  */
-function openImage(dbOrFile, entryPath, fileAdapter = io_1.defaultFileAdapter) {
+async function openImage(dbOrFile, entryPath, fileAdapter = io_1.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') {
@@ -139,9 +139,9 @@ function openImage(dbOrFile, entryPath, fileAdapter = io_1.defaultFileAdapter) {
         }
         if (cleanupNeeded && dbPath) {
             try {
-                removePath(dbPath);
+                await removePath(dbPath);
                 const dir = dirname(dbPath);
-                removePath(dir);
+                await removePath(dir);
             }
             catch (e) {
                 // Ignore cleanup errors
@@ -155,7 +155,7 @@ function openImage(dbOrFile, entryPath, fileAdapter = io_1.defaultFileAdapter) {
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Array of Snap package path information
  */
-function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.defaultFileAdapter) {
+async function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.defaultFileAdapter) {
     const { join, listDir, isDirectory, pathExists } = fileAdapter;
     const results = [];
     // Only works on Windows
@@ -169,13 +169,13 @@ function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = io_
         }
         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
@@ -198,8 +198,8 @@ function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = io_
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Path to the first matching Snap package, or null if not found
  */
-function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
-    const packages = findSnapPackages(packageNamePattern, fileAdapter);
+async function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const packages = await findSnapPackages(packageNamePattern, fileAdapter);
     return packages.length > 0 ? packages[0].packagePath : null;
 }
 /**
@@ -209,28 +209,28 @@ function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */
-function findSnapUsers(packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.defaultFileAdapter) {
+async function findSnapUsers(packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.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 = (0, io_1.extname)(full).toLowerCase();
             return ext === '.sps' || ext === '.spb';
         }, 2, fileAdapter);
@@ -248,8 +248,9 @@ function findSnapUsers(packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.d
  * @param packageNamePattern Optional package filter
  * @returns Array of vocab file paths
  */
-function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox', fileAdapter) {
-    const users = findSnapUsers(packageNamePattern, fileAdapter).filter((u) => !userId || u.userId === userId);
+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);
 }
 /**
@@ -259,12 +260,13 @@ function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox', f
  * @param packageNamePattern Optional package filter
  * @returns Array of history file paths (may be empty if not found)
  */
-function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.defaultFileAdapter) {
+async function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.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)
@@ -277,9 +279,9 @@ function isSnapInstalled(packageNamePattern = 'TobiiDynavox') {
 /**
  * Read Snap usage history from a pageset file (.sps/.spb)
  */
-function readSnapUsage(pagesetPath, fileAdapter = io_1.defaultFileAdapter) {
+async function readSnapUsage(pagesetPath, fileAdapter = io_1.defaultFileAdapter) {
     const { pathExists } = fileAdapter;
-    if (!pathExists(pagesetPath))
+    if (!(await pathExists(pagesetPath)))
         return [];
     const Database = (0, sqlite_1.requireBetterSqlite3)();
     const db = new Database(pagesetPath, { readonly: true });
@@ -336,8 +338,10 @@ function readSnapUsage(pagesetPath, fileAdapter = io_1.defaultFileAdapter) {
 /**
  * Read Snap usage history for a user (all pagesets)
  */
-function readSnapUsageForUser(userId, packageNamePattern = 'TobiiDynavox') {
-    const users = findSnapUsers(packageNamePattern).filter((u) => !userId || u.userId === userId);
+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();
 }

package/dist/processors/snapProcessor.d.ts

@@ -54,9 +54,9 @@ declare class SnapProcessor extends BaseProcessor {
      * Get available PageLayouts for a Snap file
      * Useful for UI components that want to let users select layout size
      * @param filePath - Path to the Snap file
-     * @returns Array of available PageLayouts with their dimensions
+     * @returns Promise resolving to available PageLayouts with their dimensions
      */
-    getAvailablePageLayouts(filePath: string): PageLayoutInfo[];
+    getAvailablePageLayouts(filePath: string): Promise<PageLayoutInfo[]>;
 }
 /**
  * Interface for PageLayout information returned by getAvailablePageLayouts

package/dist/processors/snapProcessor.js

@@ -68,7 +68,6 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { writeBinaryToPath, removePath, mkTempDir, basename, join } = this.options.fileAdapter;
-        await Promise.resolve();
         const tree = new treeStructure_1.AACTree();
         let dbResult = null;
         let cleanupTempZip = null;
@@ -79,22 +78,22 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                 const fileName = basename(filePathOrBuffer).toLowerCase();
                 if (fileName.endsWith('.sub.zip') || filePathOrBuffer.endsWith('.sub')) {
                     // Extract .sub.zip to find the embedded .sps file
-                    const tempDir = mkTempDir('snap-sub-');
+                    const tempDir = await mkTempDir('snap-sub-');
                     const zip = await this.options.zipAdapter(filePathOrBuffer);
                     // Find the .sps file in the archive
                     const files = zip.listFiles();
                     const spsFile = files.find((f) => f.endsWith('.sps'));
                     if (!spsFile) {
-                        removePath(tempDir, { recursive: true, force: true });
+                        await removePath(tempDir, { recursive: true, force: true });
                         throw new Error('No .sps file found in .sub.zip archive');
                     }
                     // Extract the .sps file
                     const spsData = await zip.readFile(spsFile);
                     const extractedSpsPath = join(tempDir, basename(spsFile));
-                    writeBinaryToPath(extractedSpsPath, Buffer.from(spsData));
+                    await writeBinaryToPath(extractedSpsPath, Buffer.from(spsData));
                     inputFile = extractedSpsPath;
-                    cleanupTempZip = () => {
-                        removePath(tempDir, { recursive: true, force: true });
+                    cleanupTempZip = async () => {
+                        await removePath(tempDir, { recursive: true, force: true });
                     };
                 }
             }
@@ -686,7 +685,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
         }
         finally {
             if (dbResult?.cleanup) {
-                dbResult.cleanup();
+                await dbResult.cleanup();
             }
             else if (dbResult?.db) {
                 dbResult.db.close();
@@ -694,7 +693,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             // Clean up temporary extracted .sps file from .sub.zip
             if (cleanupTempZip) {
                 try {
-                    cleanupTempZip();
+                    await cleanupTempZip();
                 }
                 catch (e) {
                     console.warn('[SnapProcessor] Failed to clean up temporary .sps file:', e);
@@ -710,13 +709,14 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
         if (typeof filePathOrBuffer === 'string') {
             const inputPath = filePathOrBuffer;
             const outputDir = dirname(outputPath);
-            if (!pathExists(outputDir)) {
-                mkDir(outputDir, { recursive: true });
+            const dirExists = await pathExists(outputDir);
+            if (!dirExists) {
+                await mkDir(outputDir, { recursive: true });
             }
-            if (pathExists(outputPath)) {
-                removePath(outputPath);
+            if (await pathExists(outputPath)) {
+                await removePath(outputPath);
             }
-            writeBinaryToPath(outputPath, readBinaryFromInput(inputPath));
+            await writeBinaryToPath(outputPath, await readBinaryFromInput(inputPath));
             const Database = (0, sqlite_1.requireBetterSqlite3)();
             const db = new Database(outputPath, { readonly: false });
             try {
@@ -778,7 +778,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             finally {
                 db.close();
             }
-            return readBinaryFromInput(outputPath);
+            return await readBinaryFromInput(outputPath);
         }
         // Fallback for buffer inputs: rebuild from tree (may drop Snap assets)
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -805,20 +805,20 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
         const { pathExists, mkDir, removePath, dirname } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('saveFromTree is only supported in Node.js environments for Snap files.');
         }
-        await Promise.resolve();
         const outputDir = dirname(outputPath);
-        if (!pathExists(outputDir)) {
-            mkDir(outputDir, { recursive: true });
+        const dirExists = await pathExists(outputDir);
+        if (!dirExists) {
+            await mkDir(outputDir, { recursive: true });
         }
-        if (pathExists(outputPath)) {
-            removePath(outputPath);
+        if (await pathExists(outputPath)) {
+            await removePath(outputPath);
         }
         // Create a new SQLite database for Snap format
         const Database = (0, sqlite_1.requireBetterSqlite3)();
@@ -1053,7 +1053,6 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
      * Add audio recording to a button in the database
      */
     async addAudioToButton(dbPath, buttonId, audioData, metadata) {
-        await Promise.resolve();
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('addAudioToButton is only supported in Node.js environments.');
         }
@@ -1091,7 +1090,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             const updateButton = db.prepare('UPDATE Button SET MessageRecordingId = ?, UseMessageRecording = 1, SerializedMessageSoundMetadata = ? WHERE Id = ?');
             const metadataJson = metadata ? JSON.stringify({ FileName: metadata }) : null;
             updateButton.run(audioId, metadataJson, buttonId);
-            return audioId;
+            return Promise.resolve(audioId);
         }
         finally {
             db.close();
@@ -1106,7 +1105,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             throw new Error('createAudioEnhancedPageset is only supported in Node.js environments.');
         }
         // Copy the source database to target
-        writeBinaryToPath(targetDbPath, readBinaryFromInput(sourceDbPath));
+        await writeBinaryToPath(targetDbPath, await readBinaryFromInput(sourceDbPath));
         // Add audio recordings to the copy
         for (const [buttonId, audioInfo] of audioMappings.entries()) {
             await this.addAudioToButton(targetDbPath, buttonId, audioInfo.audioData, audioInfo.metadata);
@@ -1174,16 +1173,16 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
      * Get available PageLayouts for a Snap file
      * Useful for UI components that want to let users select layout size
      * @param filePath - Path to the Snap file
-     * @returns Array of available PageLayouts with their dimensions
+     * @returns Promise resolving to available PageLayouts with their dimensions
      */
-    getAvailablePageLayouts(filePath) {
+    async getAvailablePageLayouts(filePath) {
         const { writeBinaryToPath, removePath, pathExists, join } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('getAvailablePageLayouts is only supported in Node.js environments.');
         }
         const dbPath = typeof filePath === 'string' ? filePath : join(process.cwd(), 'temp.spb');
         if (Buffer.isBuffer(filePath)) {
-            writeBinaryToPath(dbPath, filePath);
+            await writeBinaryToPath(dbPath, filePath);
         }
         let db = null;
         try {
@@ -1234,9 +1233,10 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                 db.close();
             }
             // Clean up temporary file if created from buffer
-            if (Buffer.isBuffer(filePath) && pathExists(dbPath)) {
+            const exists = await pathExists(dbPath);
+            if (Buffer.isBuffer(filePath) && exists) {
                 try {
-                    removePath(dbPath);
+                    await removePath(dbPath);
                 }
                 catch (e) {
                     console.warn('Failed to clean up temporary file:', e);

package/dist/processors/touchchatProcessor.d.ts

@@ -39,7 +39,7 @@ declare class TouchChatProcessor extends BaseProcessor {
      * This method uses shared translation utilities that work across all AAC formats.
      *
      * @param filePathOrBuffer - Path to TouchChat .ce 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[]>;
     /**
@@ -52,7 +52,7 @@ declare class TouchChatProcessor extends BaseProcessor {
      * @param llmTranslations - Array of LLM translations with symbol info
      * @param outputPath - Where to save the translated TouchChat file
      * @param options - Translation options (e.g., allowPartial for testing)
-     * @returns Buffer of the translated TouchChat file
+     * @returns Promise resolving to a buffer of the translated TouchChat file
      */
     processLLMTranslations(filePathOrBuffer: string | Uint8Array, llmTranslations: LLMLTranslationResult[], outputPath: string, options?: {
         allowPartial?: boolean;

package/dist/processors/touchchatProcessor.js

@@ -59,7 +59,6 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { readBinaryFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
         // Unzip .ce file, extract the .c4v SQLite DB, and parse pages/buttons
         let db = null;
         let cleanup;
@@ -67,7 +66,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             // Store source file path or buffer
             this.sourceFile = filePathOrBuffer;
             // Step 1: Unzip
-            const zipInput = readBinaryFromInput(filePathOrBuffer);
+            const zipInput = await readBinaryFromInput(filePathOrBuffer);
             const zip = await this.options.zipAdapter(zipInput);
             const vocabEntry = zip.listFiles().find((name) => name.endsWith('.c4v'));
             if (!vocabEntry) {
@@ -472,7 +471,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         finally {
             // Clean up
             if (cleanup) {
-                cleanup();
+                await cleanup();
             }
             else if (db) {
                 db.close();
@@ -495,11 +494,12 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         if (typeof filePathOrBuffer === 'string') {
             const inputPath = filePathOrBuffer;
             const outputDir = dirname(outputPath);
-            if (!pathExists(outputDir)) {
-                mkDir(outputDir, { recursive: true });
+            const dirExists = await pathExists(outputDir);
+            if (!dirExists) {
+                await mkDir(outputDir, { recursive: true });
             }
-            if (pathExists(outputPath)) {
-                removePath(outputPath);
+            if (await pathExists(outputPath)) {
+                await removePath(outputPath);
             }
             const zip = await this.options.zipAdapter(inputPath);
             const entries = (0, gridset_1.getZipEntriesFromAdapter)(zip);
@@ -507,10 +507,10 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             if (!vocabEntry) {
                 throw new Error('No .c4v vocab DB found in TouchChat export');
             }
-            const tempDir = mkTempDir('touchchat-translate-');
+            const tempDir = await mkTempDir('touchchat-translate-');
             const dbPath = join(tempDir, 'vocab.c4v');
             try {
-                writeBinaryToPath(dbPath, await vocabEntry.getData());
+                await writeBinaryToPath(dbPath, await vocabEntry.getData());
                 const Database = (0, sqlite_1.requireBetterSqlite3)();
                 const db = new Database(dbPath, { readonly: false });
                 try {
@@ -577,20 +577,20 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                 }
                 files.push({
                     name: vocabEntry.entryName,
-                    data: readBinaryFromInput(dbPath),
+                    data: await readBinaryFromInput(dbPath),
                 });
                 const zipData = await outputZip.writeFiles(files);
-                writeBinaryToPath(outputPath, zipData);
+                await writeBinaryToPath(outputPath, zipData);
             }
             finally {
                 try {
-                    removePath(tempDir, { recursive: true, force: true });
+                    await removePath(tempDir, { recursive: true, force: true });
                 }
                 catch {
                     // Best-effort cleanup
                 }
             }
-            return readBinaryFromInput(outputPath);
+            return await readBinaryFromInput(outputPath);
         }
         // Fallback for buffer inputs: rebuild from tree (may drop TouchChat metadata)
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -617,16 +617,15 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
         const { writeBinaryToPath, mkTempDir, readBinaryFromInput, pathExists, removePath, join } = this.options.fileAdapter;
-        await Promise.resolve();
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('saveFromTree is only supported in Node.js environments for TouchChat files.');
         }
         // Create a TouchChat database that matches the expected schema for loading
-        const tmpDir = mkTempDir('touchchat-export-');
+        const tmpDir = await mkTempDir('touchchat-export-');
         const dbPath = join(tmpDir, 'vocab.c4v');
         try {
             const Database = (0, sqlite_1.requireBetterSqlite3)();
@@ -921,19 +920,19 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             db.close();
             // Create zip file with the database
             const zip = await this.options.zipAdapter();
-            const data = readBinaryFromInput(dbPath);
+            const data = await readBinaryFromInput(dbPath);
             const zipData = await zip.writeFiles([
                 {
                     name: 'vocab.c4v',
                     data,
                 },
             ]);
-            writeBinaryToPath(outputPath, zipData);
+            await writeBinaryToPath(outputPath, zipData);
         }
         finally {
             // Clean up
-            if (pathExists(tmpDir)) {
-                removePath(tmpDir, { recursive: true, force: true });
+            if (await pathExists(tmpDir)) {
+                await removePath(tmpDir, { recursive: true, force: true });
             }
         }
     }
@@ -1016,7 +1015,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             const outputPath = filePath.replace(/\.ce$/, '_translated.ce');
             // Use existing processTexts method
             await this.processTexts(filePath, translations, outputPath);
-            return Promise.resolve(outputPath);
+            return outputPath;
         }
         catch (error) {
             return Promise.reject(new Error(`Failed to generate translated download: ${error instanceof Error ? error.message : 'Unknown error'}`));
@@ -1028,7 +1027,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return touchChatValidator_1.TouchChatValidator.validateFile(filePath, this.options.fileAdapter);
+        return await touchChatValidator_1.TouchChatValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Extract symbol information from a TouchChat file for LLM-based translation.
@@ -1037,7 +1036,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * This method uses shared translation utilities that work across all AAC formats.
      *
      * @param filePathOrBuffer - Path to TouchChat .ce 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);
@@ -1067,7 +1066,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * @param llmTranslations - Array of LLM translations with symbol info
      * @param outputPath - Where to save the translated TouchChat file
      * @param options - Translation options (e.g., allowPartial for testing)
-     * @returns Buffer of the translated TouchChat file
+     * @returns Promise resolving to a buffer of the translated TouchChat file
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
         const { readBinaryFromInput } = this.options.fileAdapter;
@@ -1112,7 +1111,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return readBinaryFromInput(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
 }
 exports.TouchChatProcessor = TouchChatProcessor;

package/dist/types/aac.d.ts

@@ -203,6 +203,6 @@ export interface AACTree {
     getPage(id: string): AACPage | undefined;
 }
 export interface AACProcessor {
-    extractTexts(filePath: string | Buffer): string[];
-    loadIntoTree(filePath: string | Buffer): AACTree;
+    extractTexts(filePath: string | Buffer): Promise<string[]>;
+    loadIntoTree(filePath: string | Buffer): Promise<AACTree>;
 }

package/dist/utilities/analytics/history.d.ts

@@ -64,30 +64,30 @@ export declare function exportHistoryToBaton(entries: HistoryEntry[], options?:
 /**
  * Read Grid 3 phrase history from a history.sqlite database and tag entries with their source.
  */
-export declare function readGrid3History(historyDbPath: string): HistoryEntry[];
+export declare function readGrid3History(historyDbPath: string): Promise<HistoryEntry[]>;
 /**
  * Read Grid 3 history for a specific user/language combination.
  */
-export declare function readGrid3HistoryForUser(userName: string, langCode?: string): HistoryEntry[];
+export declare function readGrid3HistoryForUser(userName: string, langCode?: string): Promise<HistoryEntry[]>;
 /**
  * Read every available Grid 3 history database on the machine.
  */
-export declare function readAllGrid3History(): HistoryEntry[];
+export declare function readAllGrid3History(): Promise<HistoryEntry[]>;
 /**
  * Read Snap button usage from a pageset database and tag entries with source.
  */
-export declare function readSnapUsage(pagesetPath: string): HistoryEntry[];
+export declare function readSnapUsage(pagesetPath: string): Promise<HistoryEntry[]>;
 /**
  * Read Snap usage for a specific user across all discovered pagesets.
  */
-export declare function readSnapUsageForUser(userId?: string, packageNamePattern?: string): HistoryEntry[];
-export declare function listSnapUsers(): SnapUserInfo[];
+export declare function readSnapUsageForUser(userId?: string, packageNamePattern?: string): Promise<HistoryEntry[]>;
+export declare function listSnapUsers(): Promise<SnapUserInfo[]>;
 /**
  * List Grid 3 users on the current machine.
  */
-export declare function listGrid3Users(): Grid3UserPath[];
+export declare function listGrid3Users(): Promise<Grid3UserPath[]>;
 /**
  * Convenience helper to gather all available history across Grid 3 and Snap.
  * Returns an empty array if no history files are present.
  */
-export declare function collectUnifiedHistory(): HistoryEntry[];
+export declare function collectUnifiedHistory(): Promise<HistoryEntry[]>;