@willwade/aac-processors 0.1.21 → 0.2.0

package/dist/processors/astericsGridProcessor.js

@@ -570,7 +570,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             });
         }
         // Also extract texts from the raw file for comprehensive coverage
-        const rawTexts = this.extractRawTexts(filePathOrBuffer);
+        const rawTexts = await this.extractRawTexts(filePathOrBuffer);
         rawTexts.forEach((text) => {
             if (text && !texts.includes(text)) {
                 texts.push(text);
@@ -578,9 +578,9 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         });
         return texts;
     }
-    extractRawTexts(filePathOrBuffer) {
+    async extractRawTexts(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -661,12 +661,11 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
         const tree = new treeStructure_1.AACTree();
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.grd';
-        const buffer = readBinaryFromInput(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         try {
-            let content = readTextFromInput(buffer);
+            let content = await readTextFromInput(buffer);
             // Remove BOM if present
             if (content.charCodeAt(0) === 0xfeff) {
                 content = content.slice(1);
@@ -1060,8 +1059,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
         const { readTextFromInput, readBinaryFromInput, writeTextToPath } = this.options.fileAdapter;
-        await Promise.resolve();
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1070,8 +1068,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         // Apply translations directly to the JSON structure for comprehensive coverage
         this.applyTranslationsToGridFile(grdFile, translations);
         // Write the translated file
-        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
-        return readBinaryFromInput(outputPath);
+        await writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        return await readBinaryFromInput(outputPath);
     }
     applyTranslationsToGridFile(grdFile, translations) {
         grdFile.grids.forEach((grid) => {
@@ -1184,7 +1182,6 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
     }
     async saveFromTree(tree, outputPath) {
         const { writeTextToPath } = this.options.fileAdapter;
-        await Promise.resolve();
         // Use default Asterics Grid styling instead of taking from first page
         // This prevents issues where the first page has unusual colors (like purple)
         const defaultPageStyle = {
@@ -1387,14 +1384,14 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 },
             },
         };
-        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        await writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Add audio recording to a specific grid element
      */
-    addAudioToElement(filePath, elementId, audioData, metadata) {
+    async addAudioToElement(filePath, elementId, audioData, metadata) {
         const { readTextFromInput, writeTextToPath } = this.options.fileAdapter;
-        let content = readTextFromInput(filePath);
+        let content = await readTextFromInput(filePath);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1437,32 +1434,33 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             throw new Error(`Element with ID ${elementId} not found`);
         }
         // Write back to file
-        writeTextToPath(filePath, JSON.stringify(grdFile, null, 2));
+        await writeTextToPath(filePath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Create a copy of the grid file with audio recordings added
      */
-    createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
+    async createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
         const { writeBinaryToPath, readBinaryFromInput } = this.options.fileAdapter;
         // Copy the source file to target
-        writeBinaryToPath(targetFilePath, readBinaryFromInput(sourceFilePath));
+        await writeBinaryToPath(targetFilePath, await readBinaryFromInput(sourceFilePath));
         // Add audio recordings to the copy
-        audioMappings.forEach((audioInfo, elementId) => {
+        await Promise.all(Object.entries(audioMappings).map(async (item) => {
+            const [elementId, audioInfo] = item;
             try {
-                this.addAudioToElement(targetFilePath, elementId, audioInfo.audioData, audioInfo.metadata);
+                await this.addAudioToElement(targetFilePath, elementId, audioInfo.audioData, audioInfo.metadata);
             }
             catch (error) {
                 // Failed to add audio to element - continue with others
                 console.warn(`Failed to add audio to element ${elementId}:`, error);
             }
-        });
+        }));
     }
     /**
      * Extract all element IDs from the grid file for audio mapping
      */
-    getElementIds(filePathOrBuffer) {
+    async getElementIds(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1484,9 +1482,9 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Check if an element has audio recording
      */
-    hasAudioRecording(filePathOrBuffer, elementId) {
+    async hasAudioRecording(filePathOrBuffer, elementId) {
         const { readTextFromInput } = this.options.fileAdapter;
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);

package/dist/processors/dotProcessor.js

@@ -52,8 +52,7 @@ class DotProcessor 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 { nodes, edges } = this.parseDotFile(content);
         const texts = [];
         // Collect node labels
@@ -70,12 +69,11 @@ class DotProcessor 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.dot';
-        const buffer = readBinaryFromInput(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         const filesize = buffer.byteLength;
         try {
-            const content = readTextFromInput(buffer);
+            const content = await readTextFromInput(buffer);
             if (!content || content.trim().length === 0) {
                 const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
@@ -160,8 +158,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
         const { readTextFromInput, writeBinaryToPath } = this.options.fileAdapter;
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         translations.forEach((translation, text) => {
             if (typeof text === 'string' && typeof translation === 'string') {
@@ -172,12 +169,11 @@ class DotProcessor 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();
         let dotContent = `digraph "${tree.metadata?.name || 'AACBoard'}" {\n`;
         // Helper to escape DOT string
         const escapeDotString = (str) => {
@@ -207,7 +203,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             });
         }
         dotContent += '}\n';
-        writeTextToPath(_outputPath, dotContent);
+        await writeTextToPath(_outputPath, dotContent);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

package/dist/processors/excelProcessor.d.ts

@@ -11,13 +11,13 @@ export declare class ExcelProcessor extends BaseProcessor {
     /**
      * Extract all text content from an Excel file
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
-     * @returns Array of all text content found in the Excel file
+     * @returns Promise resolving to all text content found in the Excel file
      */
     extractTexts(_filePathOrBuffer: ProcessorInput): Promise<string[]>;
     /**
      * Load Excel file into AACTree structure
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
-     * @returns AACTree representation of the Excel file
+     * @returns Promise resolving to an AACTree representation of the Excel file
      */
     loadIntoTree(_filePathOrBuffer: ProcessorInput): Promise<AACTree>;
     /**
@@ -25,7 +25,7 @@ export declare class ExcelProcessor extends BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @param translations - Map of original text to translated text
      * @param outputPath - Path where translated Excel file should be saved
-     * @returns Buffer containing the translated Excel file
+     * @returns Promise resolving to a buffer containing the translated Excel file
      */
     processTexts(_filePathOrBuffer: ProcessorInput, _translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
     /**

package/dist/processors/excelProcessor.js

@@ -36,39 +36,36 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Extract all text content from an Excel file
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
-     * @returns Array of all text content found in the Excel file
+     * @returns Promise resolving to all text content found in the Excel file
      */
     async extractTexts(_filePathOrBuffer) {
-        await Promise.resolve();
         console.warn('ExcelProcessor.extractTexts is not implemented yet.');
-        return [];
+        return Promise.resolve([]);
     }
     /**
      * Load Excel file into AACTree structure
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
-     * @returns AACTree representation of the Excel file
+     * @returns Promise resolving to an AACTree representation of the Excel file
      */
     async loadIntoTree(_filePathOrBuffer) {
-        await Promise.resolve();
         console.warn('ExcelProcessor.loadIntoTree is not implemented yet.');
         const tree = new treeStructure_1.AACTree();
         tree.metadata.format = 'excel';
-        return tree;
+        return Promise.resolve(tree);
     }
     /**
      * Process texts in Excel file (apply translations)
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @param translations - Map of original text to translated text
      * @param outputPath - Path where translated Excel file should be saved
-     * @returns Buffer containing the translated Excel file
+     * @returns Promise resolving to a buffer containing the translated Excel file
      */
     async processTexts(_filePathOrBuffer, _translations, outputPath) {
         const { dirname, pathExists, mkDir } = this.options.fileAdapter;
-        await Promise.resolve();
         console.warn('ExcelProcessor.processTexts is not implemented yet.');
         const outputDir = dirname(outputPath);
-        if (!pathExists(outputDir)) {
-            mkDir(outputDir, { recursive: true });
+        if (!(await pathExists(outputDir))) {
+            await mkDir(outputDir, { recursive: true });
         }
         return Buffer.alloc(0);
     }
@@ -466,7 +463,7 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
     async saveFromTree(tree, outputPath) {
         const { mkDir, dirname, writeTextToPath } = this.options.fileAdapter;
         const outputDir = dirname(outputPath);
-        mkDir(outputDir, { recursive: true });
+        await mkDir(outputDir, { recursive: true });
         try {
             await this.saveFromTreeAsync(tree, outputPath);
         }
@@ -475,8 +472,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
             console.error('Failed to save Excel file:', message);
             try {
                 const fallbackPath = outputPath.replace(/\.xlsx$/i, '_error.txt');
-                mkDir(dirname(fallbackPath), { recursive: true });
-                writeTextToPath(fallbackPath, `Error saving Excel file: ${message}`);
+                await mkDir(dirname(fallbackPath), { recursive: true });
+                await writeTextToPath(fallbackPath, `Error saving Excel file: ${message}`);
             }
             catch (writeError) {
                 console.error('Failed to write Excel error file:', writeError);

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

@@ -88,49 +88,49 @@ export declare function getCommonDocumentsPath(): string;
  * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\Grid Sets\
  * @returns Array of Grid3 user path information
  */
-export declare function findGrid3UserPaths(fileAdapter?: FileAdapter): Grid3UserPath[];
+export declare function findGrid3UserPaths(fileAdapter?: FileAdapter): Promise<Grid3UserPath[]>;
 /**
  * Find all Grid3 history database paths
  * Convenience method that returns just the database file paths
  * @returns Array of paths to history.sqlite files
  */
-export declare function findGrid3HistoryDatabases(fileAdapter?: FileAdapter): string[];
+export declare function findGrid3HistoryDatabases(fileAdapter?: FileAdapter): Promise<string[]>;
 /**
  * Get Grid 3 users (alias of findGrid3UserPaths for clarity)
  */
-export declare function findGrid3Users(): Grid3UserPath[];
+export declare function findGrid3Users(): Promise<Grid3UserPath[]>;
 /**
  * Find Grid 3 gridset/vocabulary files for each user
  * @param userName Optional user filter; matches case-insensitively
  * @returns Array of user/gridset path pairs
  */
-export declare function findGrid3Vocabularies(userName?: string, fileAdapter?: FileAdapter): Grid3VocabularyPath[];
+export declare function findGrid3Vocabularies(userName?: string, fileAdapter?: FileAdapter): Promise<Grid3VocabularyPath[]>;
 /**
  * Find a specific user's Grid 3 history database
  * @param userName User name to search for (case-insensitive)
  * @param langCode Optional language code filter (case-insensitive)
  * @returns Path to history.sqlite or null if not found
  */
-export declare function findGrid3UserHistory(userName: string, langCode?: string, fileAdapter?: FileAdapter): string | null;
+export declare function findGrid3UserHistory(userName: string, langCode?: string, fileAdapter?: FileAdapter): Promise<string | null>;
 /**
  * Check whether Grid 3 appears to be installed (Windows only)
  */
-export declare function isGrid3Installed(fileAdapter?: FileAdapter): boolean;
+export declare function isGrid3Installed(fileAdapter?: FileAdapter): Promise<boolean>;
 /**
  * Read history events from a Grid 3 history.sqlite database.
  * @param historyDbPath Absolute path to the history database
  * @returns Parsed history entries grouped by phrase
  */
-export declare function readGrid3History(historyDbPath: string, fileAdapter?: FileAdapter): Grid3HistoryEntry[];
+export declare function readGrid3History(historyDbPath: string, fileAdapter?: FileAdapter): Promise<Grid3HistoryEntry[]>;
 /**
  * Convenience wrapper to load history for a specific Grid 3 user/lang combination.
  * @param userName Grid 3 user name (case-insensitive)
  * @param langCode Optional language code to narrow selection (case-insensitive)
  * @returns History entries for that user/language, or empty array if none
  */
-export declare function readGrid3HistoryForUser(userName: string, langCode?: string): Grid3HistoryEntry[];
+export declare function readGrid3HistoryForUser(userName: string, langCode?: string): Promise<Grid3HistoryEntry[]>;
 /**
  * Load all available Grid 3 histories on the machine.
  * @returns Combined history entries from every discovered history.sqlite
  */
-export declare function readAllGrid3History(): Grid3HistoryEntry[];
+export declare function readAllGrid3History(): Promise<Grid3HistoryEntry[]>;

package/dist/processors/gridset/helpers.js

@@ -188,7 +188,7 @@ function getCommonDocumentsPath() {
  * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\Grid Sets\
  * @returns Array of Grid3 user path information
  */
-function findGrid3UserPaths(fileAdapter = io_1.defaultFileAdapter) {
+async function findGrid3UserPaths(fileAdapter = io_1.defaultFileAdapter) {
     const { pathExists, listDir, isDirectory } = fileAdapter;
     const results = [];
     // Only works on Windows
@@ -200,26 +200,26 @@ function findGrid3UserPaths(fileAdapter = io_1.defaultFileAdapter) {
         // Use Windows path joining so tests that mock a Windows platform stay consistent even on POSIX runners
         const grid3BasePath = (0, io_1.joinWin32)(commonDocs, 'Smartbox', 'Grid 3', 'Users');
         // Check if Grid3 Users directory exists
-        if (!pathExists(grid3BasePath)) {
+        if (!(await pathExists(grid3BasePath))) {
             return results;
         }
         // Enumerate users
-        const users = listDir(grid3BasePath);
+        const users = await listDir(grid3BasePath);
         for (const userDir of users) {
-            if (!isDirectory(userDir))
+            if (!(await isDirectory(userDir)))
                 continue;
             const userName = userDir;
             const userPath = (0, io_1.joinWin32)(grid3BasePath, userName);
             // Enumerate language codes
-            const langDirs = listDir(userPath);
+            const langDirs = await listDir(userPath);
             for (const langDir of langDirs) {
-                if (!isDirectory(langDir))
+                if (!(await isDirectory(langDir)))
                     continue;
                 const langCode = langDir;
                 const basePath = (0, io_1.joinWin32)(userPath, langCode);
                 const historyDbPath = (0, io_1.joinWin32)(basePath, 'Phrases', 'history.sqlite');
                 // Only include if history database exists
-                if (pathExists(historyDbPath)) {
+                if (await pathExists(historyDbPath)) {
                     results.push({
                         userName,
                         langCode,
@@ -240,21 +240,22 @@ function findGrid3UserPaths(fileAdapter = io_1.defaultFileAdapter) {
  * Convenience method that returns just the database file paths
  * @returns Array of paths to history.sqlite files
  */
-function findGrid3HistoryDatabases(fileAdapter) {
-    return findGrid3UserPaths(fileAdapter).map((userPath) => userPath.historyDbPath);
+async function findGrid3HistoryDatabases(fileAdapter) {
+    const userPaths = await findGrid3UserPaths(fileAdapter);
+    return userPaths.map((userPath) => userPath.historyDbPath);
 }
 /**
  * Get Grid 3 users (alias of findGrid3UserPaths for clarity)
  */
-function findGrid3Users() {
-    return findGrid3UserPaths();
+async function findGrid3Users() {
+    return await findGrid3UserPaths();
 }
 /**
  * Find Grid 3 gridset/vocabulary files for each user
  * @param userName Optional user filter; matches case-insensitively
  * @returns Array of user/gridset path pairs
  */
-function findGrid3Vocabularies(userName, fileAdapter = io_1.defaultFileAdapter) {
+async function findGrid3Vocabularies(userName, fileAdapter = io_1.defaultFileAdapter) {
     const { pathExists, listDir, isDirectory } = fileAdapter;
     const results = [];
     if (process.platform !== 'win32') {
@@ -262,23 +263,23 @@ function findGrid3Vocabularies(userName, fileAdapter = io_1.defaultFileAdapter)
     }
     const commonDocs = getCommonDocumentsPath();
     const grid3BasePath = (0, io_1.joinWin32)(commonDocs, 'Smartbox', 'Grid 3', 'Users');
-    if (!pathExists(grid3BasePath)) {
+    if (!(await pathExists(grid3BasePath))) {
         return results;
     }
     const normalizedUser = userName?.toLowerCase();
-    const users = listDir(grid3BasePath);
+    const users = await listDir(grid3BasePath);
     for (const userDir of users) {
-        if (!isDirectory(userDir))
+        if (!(await isDirectory(userDir)))
             continue;
         if (normalizedUser && userDir.toLowerCase() !== normalizedUser)
             continue;
         const userRoot = (0, io_1.joinWin32)(grid3BasePath, userDir);
         const gridSetsDir = (0, io_1.joinWin32)(userRoot, 'Grid Sets');
-        if (!pathExists(gridSetsDir))
+        if (!(await pathExists(gridSetsDir)))
             continue;
-        const entries = listDir(gridSetsDir);
+        const entries = await listDir(gridSetsDir);
         for (const entry of entries) {
-            if (!pathExists(entry) || isDirectory(entry))
+            if (!(await pathExists(entry)) || (await isDirectory(entry)))
                 continue;
             const ext = (0, io_1.extname)(entry).toLowerCase();
             if (ext === '.gridset' || ext === '.gridsetx' || ext === '.grd' || ext === '.grdl') {
@@ -297,19 +298,20 @@ function findGrid3Vocabularies(userName, fileAdapter = io_1.defaultFileAdapter)
  * @param langCode Optional language code filter (case-insensitive)
  * @returns Path to history.sqlite or null if not found
  */
-function findGrid3UserHistory(userName, langCode, fileAdapter) {
+async function findGrid3UserHistory(userName, langCode, fileAdapter) {
     if (!userName)
         return null;
     const normalizedUser = userName.toLowerCase();
     const normalizedLang = langCode?.toLowerCase();
-    const match = findGrid3UserPaths(fileAdapter).find((u) => u.userName.toLowerCase() === normalizedUser &&
+    const userPaths = await findGrid3UserPaths(fileAdapter);
+    const match = userPaths.find((u) => u.userName.toLowerCase() === normalizedUser &&
         (!normalizedLang || u.langCode.toLowerCase() === normalizedLang));
     return match?.historyDbPath ?? null;
 }
 /**
  * Check whether Grid 3 appears to be installed (Windows only)
  */
-function isGrid3Installed(fileAdapter = io_1.defaultFileAdapter) {
+async function isGrid3Installed(fileAdapter = io_1.defaultFileAdapter) {
     const { pathExists } = fileAdapter;
     if (process.platform !== 'win32')
         return false;
@@ -317,7 +319,7 @@ function isGrid3Installed(fileAdapter = io_1.defaultFileAdapter) {
     if (!commonDocs)
         return false;
     const grid3BasePath = (0, io_1.joinWin32)(commonDocs, 'Smartbox', 'Grid 3', 'Users');
-    return pathExists(grid3BasePath);
+    return await pathExists(grid3BasePath);
 }
 function parseGrid3ContentXml(xmlContent) {
     const regex = /<r>(?:<!\[CDATA\[)?(.*?)(?:\]\]>)?<\/r>/gis;
@@ -336,9 +338,9 @@ function parseGrid3ContentXml(xmlContent) {
  * @param historyDbPath Absolute path to the history database
  * @returns Parsed history entries grouped by phrase
  */
-function readGrid3History(historyDbPath, fileAdapter = io_1.defaultFileAdapter) {
+async function readGrid3History(historyDbPath, fileAdapter = io_1.defaultFileAdapter) {
     const { pathExists } = fileAdapter;
-    if (!pathExists(historyDbPath))
+    if (!(await pathExists(historyDbPath)))
         return [];
     const Database = (0, sqlite_1.requireBetterSqlite3)();
     const db = new Database(historyDbPath, { readonly: true });
@@ -398,17 +400,18 @@ function readGrid3History(historyDbPath, fileAdapter = io_1.defaultFileAdapter)
  * @param langCode Optional language code to narrow selection (case-insensitive)
  * @returns History entries for that user/language, or empty array if none
  */
-function readGrid3HistoryForUser(userName, langCode) {
-    const dbPath = findGrid3UserHistory(userName, langCode);
+async function readGrid3HistoryForUser(userName, langCode) {
+    const dbPath = await findGrid3UserHistory(userName, langCode);
     if (!dbPath)
         return [];
-    return readGrid3History(dbPath);
+    return await readGrid3History(dbPath);
 }
 /**
  * Load all available Grid 3 histories on the machine.
  * @returns Combined history entries from every discovered history.sqlite
  */
-function readAllGrid3History() {
-    const paths = findGrid3HistoryDatabases();
-    return paths.flatMap((p) => readGrid3History(p));
+async function readAllGrid3History() {
+    const paths = await findGrid3HistoryDatabases();
+    const history = await Promise.all(paths.map(async (p) => await readGrid3History(p)));
+    return history.flat();
 }

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

@@ -97,7 +97,7 @@ export declare function suggestExtractionStrategy(report: SymbolReport): string;
 /**
  * Export symbol references to CSV for manual extraction
  */
-export declare function exportSymbolReferencesToCsv(report: SymbolReport, outputPath: string, fileAdapter?: FileAdapter): void;
+export declare function exportSymbolReferencesToCsv(report: SymbolReport, outputPath: string, fileAdapter?: FileAdapter): Promise<void>;
 /**
  * Create a manifest file for missing symbols
  */

package/dist/processors/gridset/symbolExtractor.js

@@ -286,13 +286,13 @@ function parseSymbolReferenceSafe(reference) {
 /**
  * Export symbol references to CSV for manual extraction
  */
-function exportSymbolReferencesToCsv(report, outputPath, fileAdapter = io_1.defaultFileAdapter) {
+async function exportSymbolReferencesToCsv(report, outputPath, fileAdapter = io_1.defaultFileAdapter) {
     const { writeTextToPath } = fileAdapter;
     const lines = ['Reference,Library,Path,Attribution,License'];
     for (const symbol of report.missingSymbols) {
         lines.push(`"${symbol.reference}","${symbol.library}","${symbol.path}","${symbol.attribution || ''}","${symbol.license || ''}"`);
     }
-    writeTextToPath(outputPath, lines.join('\n'));
+    await writeTextToPath(outputPath, lines.join('\n'));
 }
 function createSymbolManifest(tree, gridsetName) {
     const manifest = {

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

@@ -42,20 +42,20 @@ export interface LibrarySearchIndex {
  * @param pixFilePath - Path to .pix file
  * @returns Search index
  */
-export declare function parsePixFile(pixFilePath: string, fileAdapter?: FileAdapter): LibrarySearchIndex;
+export declare function parsePixFile(pixFilePath: string, fileAdapter?: FileAdapter): Promise<LibrarySearchIndex>;
 /**
  * Load search indexes for all available libraries
  * @param options - Search options
  * @returns Map of library name to search index
  */
-export declare function loadSearchIndexes(options?: SymbolSearchOptions, fileAdapter?: FileAdapter): Map<string, LibrarySearchIndex>;
+export declare function loadSearchIndexes(options?: SymbolSearchOptions, fileAdapter?: FileAdapter): Promise<Map<string, LibrarySearchIndex>>;
 /**
  * Search for symbols by term
  * @param searchTerm - Term to search for
  * @param options - Search options
  * @returns Array of search results
  */
-export declare function searchSymbols(searchTerm: string, options?: SymbolSearchOptions): SymbolSearchResult[];
+export declare function searchSymbols(searchTerm: string, options?: SymbolSearchOptions): Promise<SymbolSearchResult[]>;
 /**
  * Get symbol filename for a specific search term
  * @param searchTerm - Search term to look up
@@ -63,7 +63,7 @@ export declare function searchSymbols(searchTerm: string, options?: SymbolSearch
  * @param options - Search options
  * @returns Symbol filename or undefined
  */
-export declare function getSymbolFilename(searchTerm: string, library: string, options?: SymbolSearchOptions): string | undefined;
+export declare function getSymbolFilename(searchTerm: string, library: string, options?: SymbolSearchOptions): Promise<string | undefined>;
 /**
  * Get display name for a symbol filename
  * @param symbolFilename - Symbol filename (e.g., "above bw.png")
@@ -71,34 +71,34 @@ export declare function getSymbolFilename(searchTerm: string, library: string, o
  * @param options - Search options
  * @returns Display name or undefined
  */
-export declare function getSymbolDisplayName(symbolFilename: string, library: string, options?: SymbolSearchOptions): string | undefined;
+export declare function getSymbolDisplayName(symbolFilename: string, library: string, options?: SymbolSearchOptions): Promise<string | undefined>;
 /**
  * Get all search terms for a library
  * @param library - Library name
  * @param options - Search options
  * @returns Array of search terms
  */
-export declare function getAllSearchTerms(library: string, options?: SymbolSearchOptions): string[];
+export declare function getAllSearchTerms(library: string, options?: SymbolSearchOptions): Promise<string[]>;
 /**
  * Search suggestions (autocomplete)
  * @param partialTerm - Partial search term
  * @param options - Search options
  * @returns Array of suggested terms
  */
-export declare function getSearchSuggestions(partialTerm: string, options?: SymbolSearchOptions): string[];
+export declare function getSearchSuggestions(partialTerm: string, options?: SymbolSearchOptions): Promise<string[]>;
 /**
  * Search for symbols and return results with library references
  * @param searchTerm - Term to search for
  * @param options - Search options
  * @returns Array of full symbol references
  */
-export declare function searchSymbolsWithReferences(searchTerm: string, options?: SymbolSearchOptions): string[];
+export declare function searchSymbolsWithReferences(searchTerm: string, options?: SymbolSearchOptions): Promise<string[]>;
 /**
  * Count symbols in each library
  * @param options - Search options
  * @returns Map of library name to symbol count
  */
-export declare function countLibrarySymbols(options?: SymbolSearchOptions): Map<string, number>;
+export declare function countLibrarySymbols(options?: SymbolSearchOptions): Promise<Map<string, number>>;
 /**
  * Get statistics about symbol libraries
  */
@@ -115,4 +115,4 @@ export interface SymbolSearchStats {
  * @param options - Search options
  * @returns Statistics about available symbols
  */
-export declare function getSymbolSearchStats(options?: SymbolSearchOptions): SymbolSearchStats;
+export declare function getSymbolSearchStats(options?: SymbolSearchOptions): Promise<SymbolSearchStats>;