@willwade/aac-processors 0.1.20 → 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,8 +578,9 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         });
         return texts;
     }
-    extractRawTexts(filePathOrBuffer) {
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+    async extractRawTexts(filePathOrBuffer) {
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -659,12 +660,12 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         const tree = new treeStructure_1.AACTree();
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.grd';
-        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         try {
-            let content = (0, io_1.readTextFromInput)(buffer);
+            let content = await readTextFromInput(buffer);
             // Remove BOM if present
             if (content.charCodeAt(0) === 0xfeff) {
                 content = content.slice(1);
@@ -1057,8 +1058,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         });
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
-        await Promise.resolve();
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { readTextFromInput, readBinaryFromInput, writeTextToPath } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1067,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
-        (0, io_1.writeTextToPath)(outputPath, JSON.stringify(grdFile, null, 2));
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        await writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        return await readBinaryFromInput(outputPath);
     }
     applyTranslationsToGridFile(grdFile, translations) {
         grdFile.grids.forEach((grid) => {
@@ -1180,7 +1181,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async saveFromTree(tree, outputPath) {
-        await Promise.resolve();
+        const { writeTextToPath } = this.options.fileAdapter;
         // 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 = {
@@ -1383,13 +1384,14 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 },
             },
         };
-        (0, io_1.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) {
-        let content = (0, io_1.readTextFromInput)(filePath);
+    async addAudioToElement(filePath, elementId, audioData, metadata) {
+        const { readTextFromInput, writeTextToPath } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePath);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1432,31 +1434,33 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             throw new Error(`Element with ID ${elementId} not found`);
         }
         // Write back to file
-        (0, io_1.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
-        const fs = (0, io_1.getFs)();
-        fs.copyFileSync(sourceFilePath, targetFilePath);
+        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) {
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+    async getElementIds(filePathOrBuffer) {
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1478,8 +1482,9 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
     /**
      * Check if an element has audio recording
      */
-    hasAudioRecording(filePathOrBuffer, elementId) {
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+    async hasAudioRecording(filePathOrBuffer, elementId) {
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);

package/dist/processors/dotProcessor.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DotProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
-// Removed unused import: FileProcessor
 const validationTypes_1 = require("../validation/validationTypes");
 const io_1 = require("../utils/io");
 class DotProcessor extends baseProcessor_1.BaseProcessor {
@@ -52,8 +51,8 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         return { nodes: Array.from(nodes.values()), edges };
     }
     async extractTexts(filePathOrBuffer) {
-        await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { readTextFromInput } = this.options.fileAdapter;
+        const content = await readTextFromInput(filePathOrBuffer);
         const { nodes, edges } = this.parseDotFile(content);
         const texts = [];
         // Collect node labels
@@ -69,12 +68,12 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.dot';
-        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         const filesize = buffer.byteLength;
         try {
-            const content = (0, io_1.readTextFromInput)(buffer);
+            const content = await readTextFromInput(buffer);
             if (!content || content.trim().length === 0) {
                 const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
@@ -158,8 +157,8 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
-        await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { readTextFromInput, writeBinaryToPath } = this.options.fileAdapter;
+        const content = await readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         translations.forEach((translation, text) => {
             if (typeof text === 'string' && typeof translation === 'string') {
@@ -170,11 +169,11 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             }
         });
         const resultBuffer = (0, io_1.encodeText)(translatedContent || '');
-        (0, io_1.writeBinaryToPath)(outputPath, resultBuffer);
+        await writeBinaryToPath(outputPath, resultBuffer);
         return resultBuffer;
     }
     async saveFromTree(tree, _outputPath) {
-        await Promise.resolve();
+        const { writeTextToPath } = this.options.fileAdapter;
         let dotContent = `digraph "${tree.metadata?.name || 'AACBoard'}" {\n`;
         // Helper to escape DOT string
         const escapeDotString = (str) => {
@@ -204,7 +203,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             });
         }
         dotContent += '}\n';
-        (0, io_1.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

@@ -22,13 +22,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExcelProcessor = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
 const ExcelJS = __importStar(require("exceljs"));
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
@@ -41,38 +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) {
-        await Promise.resolve();
+        const { dirname, pathExists, mkDir } = this.options.fileAdapter;
         console.warn('ExcelProcessor.processTexts is not implemented yet.');
-        const outputDir = path_1.default.dirname(outputPath);
-        if (!fs_1.default.existsSync(outputDir)) {
-            fs_1.default.mkdirSync(outputDir, { recursive: true });
+        const outputDir = dirname(outputPath);
+        if (!(await pathExists(outputDir))) {
+            await mkDir(outputDir, { recursive: true });
         }
         return Buffer.alloc(0);
     }
@@ -468,8 +461,9 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * Note: This method is async but maintains the sync interface for compatibility
      */
     async saveFromTree(tree, outputPath) {
-        const outputDir = path_1.default.dirname(outputPath);
-        fs_1.default.mkdirSync(outputDir, { recursive: true });
+        const { mkDir, dirname, writeTextToPath } = this.options.fileAdapter;
+        const outputDir = dirname(outputPath);
+        await mkDir(outputDir, { recursive: true });
         try {
             await this.saveFromTreeAsync(tree, outputPath);
         }
@@ -478,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');
-                fs_1.default.mkdirSync(path_1.default.dirname(fallbackPath), { recursive: true });
-                fs_1.default.writeFileSync(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

@@ -1,6 +1,6 @@
 import { AACTree, AACSemanticCategory, AACSemanticIntent } from '../../core/treeStructure';
-import { type ZipAdapter } from '../../utils/zip';
-import type { ProcessorInput } from '../../utils/io';
+import { FileAdapter, ProcessorInput } from '../../utils/io';
+import { ZipAdapter } from '../../utils/zip';
 /**
  * Build a map of button IDs to resolved image entry paths for a specific page.
  * Helpful when rewriting zip entry names or validating images referenced in a grid.
@@ -17,9 +17,7 @@ export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-export declare function openImage(gridsetBuffer: Uint8Array, entryPath: string, password?: string | undefined, zipAdapter?: (input: ProcessorInput) => Promise<{
-    zip: ZipAdapter;
-}>): Promise<Uint8Array | null>;
+export declare function openImage(gridsetBuffer: Uint8Array, entryPath: string, password?: string | undefined, fileAdapter?: FileAdapter, zipAdapter?: (input?: ProcessorInput) => Promise<ZipAdapter>): Promise<Uint8Array | null>;
 /**
  * Generate a random GUID for Grid3 elements
  * Grid3 uses GUIDs for grid identification
@@ -90,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(): 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(): 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): 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): 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(): 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): 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[]>;