@willwade/aac-processors 0.1.19 → 0.1.21

package/dist/processors/snapProcessor.js

@@ -38,15 +38,15 @@ function mapSnapVisibility(visible) {
     return visible === 0 ? 'Hidden' : 'Visible';
 }
 class SnapProcessor extends baseProcessor_1.BaseProcessor {
-    constructor(symbolResolver = null, options = {}) {
+    constructor(symbolResolver = null, options) {
         super(options);
         this.symbolResolver = null;
         this.loadAudio = false;
         this.pageLayoutPreference = 'scanning'; // Default to scanning for metrics
         this.symbolResolver = symbolResolver;
-        this.loadAudio = options.loadAudio !== undefined ? options.loadAudio : true;
+        this.loadAudio = options?.loadAudio !== undefined ? options.loadAudio : true;
         this.pageLayoutPreference =
-            options.pageLayoutPreference !== undefined ? options.pageLayoutPreference : 'scanning'; // Default to scanning
+            options?.pageLayoutPreference !== undefined ? options.pageLayoutPreference : 'scanning'; // Default to scanning
     }
     async extractTexts(filePathOrBuffer) {
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -67,11 +67,41 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     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;
         try {
-            dbResult = await (0, sqlite_1.openSqliteDatabase)(filePathOrBuffer, { readonly: true });
+            // Handle .sub.zip files (Snap pageset backups containing .sps files)
+            let inputFile = filePathOrBuffer;
+            if (typeof filePathOrBuffer === 'string') {
+                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 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 });
+                        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));
+                    inputFile = extractedSpsPath;
+                    cleanupTempZip = () => {
+                        removePath(tempDir, { recursive: true, force: true });
+                    };
+                }
+            }
+            dbResult = await (0, sqlite_1.openSqliteDatabase)(inputFile, {
+                readonly: true,
+                fileAdapter: this.options.fileAdapter,
+            });
             const db = dbResult.db;
             const getTableColumns = (tableName) => {
                 try {
@@ -661,24 +691,32 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             else if (dbResult?.db) {
                 dbResult.db.close();
             }
+            // Clean up temporary extracted .sps file from .sub.zip
+            if (cleanupTempZip) {
+                try {
+                    cleanupTempZip();
+                }
+                catch (e) {
+                    console.warn('[SnapProcessor] Failed to clean up temporary .sps file:', e);
+                }
+            }
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { pathExists, mkDir, writeBinaryToPath, readBinaryFromInput, removePath, dirname } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('processTexts is only supported in Node.js environments for Snap files.');
         }
-        const fs = (0, io_1.getFs)();
-        const path = (0, io_1.getPath)();
         if (typeof filePathOrBuffer === 'string') {
             const inputPath = filePathOrBuffer;
-            const outputDir = path.dirname(outputPath);
-            if (!fs.existsSync(outputDir)) {
-                fs.mkdirSync(outputDir, { recursive: true });
+            const outputDir = dirname(outputPath);
+            if (!pathExists(outputDir)) {
+                mkDir(outputDir, { recursive: true });
             }
-            if (fs.existsSync(outputPath)) {
-                fs.unlinkSync(outputPath);
+            if (pathExists(outputPath)) {
+                removePath(outputPath);
             }
-            fs.copyFileSync(inputPath, outputPath);
+            writeBinaryToPath(outputPath, readBinaryFromInput(inputPath));
             const Database = (0, sqlite_1.requireBetterSqlite3)();
             const db = new Database(outputPath, { readonly: false });
             try {
@@ -740,7 +778,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             finally {
                 db.close();
             }
-            return fs.readFileSync(outputPath);
+            return readBinaryFromInput(outputPath);
         }
         // Fallback for buffer inputs: rebuild from tree (may drop Snap assets)
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -767,21 +805,20 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         await this.saveFromTree(tree, outputPath);
-        return fs.readFileSync(outputPath);
+        return 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 fs = (0, io_1.getFs)();
-        const path = (0, io_1.getPath)();
-        const outputDir = path.dirname(outputPath);
-        if (!fs.existsSync(outputDir)) {
-            fs.mkdirSync(outputDir, { recursive: true });
+        const outputDir = dirname(outputPath);
+        if (!pathExists(outputDir)) {
+            mkDir(outputDir, { recursive: true });
         }
-        if (fs.existsSync(outputPath)) {
-            fs.unlinkSync(outputPath);
+        if (pathExists(outputPath)) {
+            removePath(outputPath);
         }
         // Create a new SQLite database for Snap format
         const Database = (0, sqlite_1.requireBetterSqlite3)();
@@ -1064,12 +1101,12 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
      * Create a copy of the pageset with audio recordings added
      */
     async createAudioEnhancedPageset(sourceDbPath, targetDbPath, audioMappings) {
+        const { writeBinaryToPath, readBinaryFromInput } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('createAudioEnhancedPageset is only supported in Node.js environments.');
         }
-        const fs = (0, io_1.getFs)();
         // Copy the source database to target
-        fs.copyFileSync(sourceDbPath, targetDbPath);
+        writeBinaryToPath(targetDbPath, readBinaryFromInput(sourceDbPath));
         // Add audio recordings to the copy
         for (const [buttonId, audioInfo] of audioMappings.entries()) {
             await this.addAudioToButton(targetDbPath, buttonId, audioInfo.audioData, audioInfo.metadata);
@@ -1131,7 +1168,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return snapValidator_1.SnapValidator.validateFile(filePath);
+        return snapValidator_1.SnapValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Get available PageLayouts for a Snap file
@@ -1140,14 +1177,13 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Array of available PageLayouts with their dimensions
      */
     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 fs = (0, io_1.getFs)();
-        const path = (0, io_1.getPath)();
-        const dbPath = typeof filePath === 'string' ? filePath : path.join(process.cwd(), 'temp.spb');
+        const dbPath = typeof filePath === 'string' ? filePath : join(process.cwd(), 'temp.spb');
         if (Buffer.isBuffer(filePath)) {
-            fs.writeFileSync(dbPath, filePath);
+            writeBinaryToPath(dbPath, filePath);
         }
         let db = null;
         try {
@@ -1198,9 +1234,9 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                 db.close();
             }
             // Clean up temporary file if created from buffer
-            if (Buffer.isBuffer(filePath) && fs.existsSync(dbPath)) {
+            if (Buffer.isBuffer(filePath) && pathExists(dbPath)) {
                 try {
-                    fs.unlinkSync(dbPath);
+                    removePath(dbPath);
                 }
                 catch (e) {
                     console.warn('Failed to clean up temporary file:', e);

package/dist/processors/touchchatProcessor.js

@@ -9,7 +9,7 @@ const touchChatValidator_1 = require("../validation/touchChatValidator");
 const io_1 = require("../utils/io");
 const translationProcessor_1 = require("../utilities/translation/translationProcessor");
 const sqlite_1 = require("../utils/sqlite");
-const zip_1 = require("../utils/zip");
+const gridset_1 = require("./gridset");
 const toNumberOrUndefined = (value) => typeof value === 'number' ? value : undefined;
 const toStringOrUndefined = (value) => typeof value === 'string' && value.length > 0 ? value : undefined;
 const toBooleanOrUndefined = (value) => typeof value === 'number' ? value !== 0 : undefined;
@@ -58,6 +58,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     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;
@@ -66,16 +67,17 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             // Store source file path or buffer
             this.sourceFile = filePathOrBuffer;
             // Step 1: Unzip
-            const zipInput = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
-            const { zip } = this.options.zipAdapter
-                ? await this.options.zipAdapter(zipInput)
-                : await (0, zip_1.openZipFromInput)(zipInput);
+            const zipInput = readBinaryFromInput(filePathOrBuffer);
+            const zip = await this.options.zipAdapter(zipInput);
             const vocabEntry = zip.listFiles().find((name) => name.endsWith('.c4v'));
             if (!vocabEntry) {
                 throw new Error('No .c4v vocab DB found in TouchChat export');
             }
             const dbBuffer = await zip.readFile(vocabEntry);
-            const dbResult = await (0, sqlite_1.openSqliteDatabase)(dbBuffer, { readonly: true });
+            const dbResult = await (0, sqlite_1.openSqliteDatabase)(dbBuffer, {
+                readonly: true,
+                fileAdapter: this.options.fileAdapter,
+            });
             db = dbResult.db;
             cleanup = dbResult.cleanup;
             // Step 3: Create tree and load pages
@@ -478,6 +480,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { pathExists, mkDir, removePath, mkTempDir, writeBinaryToPath, readBinaryFromInput, dirname, join, } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('processTexts is only supported in Node.js environments for TouchChat files.');
         }
@@ -490,28 +493,24 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
          * within the embedded SQLite database, ensuring assets and metadata remain intact.
          */
         if (typeof filePathOrBuffer === 'string') {
-            const fs = (0, io_1.getFs)();
-            const path = (0, io_1.getPath)();
-            const os = (0, io_1.getOs)();
-            const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
             const inputPath = filePathOrBuffer;
-            const outputDir = path.dirname(outputPath);
-            if (!fs.existsSync(outputDir)) {
-                fs.mkdirSync(outputDir, { recursive: true });
+            const outputDir = dirname(outputPath);
+            if (!pathExists(outputDir)) {
+                mkDir(outputDir, { recursive: true });
             }
-            if (fs.existsSync(outputPath)) {
-                fs.unlinkSync(outputPath);
+            if (pathExists(outputPath)) {
+                removePath(outputPath);
             }
-            const zip = new AdmZip(inputPath);
-            const entries = zip.getEntries();
+            const zip = await this.options.zipAdapter(inputPath);
+            const entries = (0, gridset_1.getZipEntriesFromAdapter)(zip);
             const vocabEntry = entries.find((entry) => entry.entryName.endsWith('.c4v'));
             if (!vocabEntry) {
                 throw new Error('No .c4v vocab DB found in TouchChat export');
             }
-            const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'touchchat-translate-'));
-            const dbPath = path.join(tempDir, 'vocab.c4v');
+            const tempDir = mkTempDir('touchchat-translate-');
+            const dbPath = join(tempDir, 'vocab.c4v');
             try {
-                fs.writeFileSync(dbPath, vocabEntry.getData());
+                writeBinaryToPath(dbPath, await vocabEntry.getData());
                 const Database = (0, sqlite_1.requireBetterSqlite3)();
                 const db = new Database(dbPath, { readonly: false });
                 try {
@@ -564,26 +563,34 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                 finally {
                     db.close();
                 }
-                const outputZip = new AdmZip();
-                entries.forEach((entry) => {
+                const outputZip = await this.options.zipAdapter();
+                const files = [];
+                for (const entry of entries) {
                     if (entry.entryName === vocabEntry.entryName) {
-                        return;
+                        continue;
                     }
-                    const data = entry.isDirectory ? Buffer.alloc(0) : entry.getData();
-                    outputZip.addFile(entry.entryName, data, entry.comment || '');
+                    const data = await entry.getData();
+                    files.push({
+                        name: entry.entryName,
+                        data,
+                    });
+                }
+                files.push({
+                    name: vocabEntry.entryName,
+                    data: readBinaryFromInput(dbPath),
                 });
-                outputZip.addFile(vocabEntry.entryName, fs.readFileSync(dbPath));
-                outputZip.writeZip(outputPath);
+                const zipData = await outputZip.writeFiles(files);
+                writeBinaryToPath(outputPath, zipData);
             }
             finally {
                 try {
-                    fs.rmSync(tempDir, { recursive: true, force: true });
+                    removePath(tempDir, { recursive: true, force: true });
                 }
                 catch {
                     // Best-effort cleanup
                 }
             }
-            return fs.readFileSync(outputPath);
+            return readBinaryFromInput(outputPath);
         }
         // Fallback for buffer inputs: rebuild from tree (may drop TouchChat metadata)
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -610,20 +617,17 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         await this.saveFromTree(tree, outputPath);
-        const fs = (0, io_1.getFs)();
-        return fs.readFileSync(outputPath);
+        return 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.');
         }
-        const fs = (0, io_1.getFs)();
-        const path = (0, io_1.getPath)();
-        const os = (0, io_1.getOs)();
         // Create a TouchChat database that matches the expected schema for loading
-        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'touchchat-export-'));
-        const dbPath = path.join(tmpDir, 'vocab.c4v');
+        const tmpDir = mkTempDir('touchchat-export-');
+        const dbPath = join(tmpDir, 'vocab.c4v');
         try {
             const Database = (0, sqlite_1.requireBetterSqlite3)();
             const db = new Database(dbPath);
@@ -916,15 +920,20 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             }
             db.close();
             // Create zip file with the database
-            const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
-            const zip = new AdmZip();
-            zip.addLocalFile(dbPath, '', 'vocab.c4v');
-            zip.writeZip(outputPath);
+            const zip = await this.options.zipAdapter();
+            const data = readBinaryFromInput(dbPath);
+            const zipData = await zip.writeFiles([
+                {
+                    name: 'vocab.c4v',
+                    data,
+                },
+            ]);
+            writeBinaryToPath(outputPath, zipData);
         }
         finally {
             // Clean up
-            if (fs.existsSync(tmpDir)) {
-                fs.rmSync(tmpDir, { recursive: true, force: true });
+            if (pathExists(tmpDir)) {
+                removePath(tmpDir, { recursive: true, force: true });
             }
         }
     }
@@ -1019,7 +1028,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return touchChatValidator_1.TouchChatValidator.validateFile(filePath);
+        return touchChatValidator_1.TouchChatValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Extract symbol information from a TouchChat file for LLM-based translation.
@@ -1061,6 +1070,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Buffer of the translated TouchChat file
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('processLLMTranslations is only supported in Node.js environments for TouchChat files.');
         }
@@ -1102,8 +1112,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        const fs = (0, io_1.getFs)();
-        return fs.readFileSync(outputPath);
+        return readBinaryFromInput(outputPath);
     }
 }
 exports.TouchChatProcessor = TouchChatProcessor;

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

@@ -9,6 +9,7 @@
  *
  * @module
  */
+import { FileAdapter } from '../../utils/io';
 export * from './metrics/types';
 export * from './metrics/effort';
 export * from './utils/idGenerator';
@@ -23,8 +24,8 @@ export { ReferenceLoader } from './reference';
 /**
  * Get the default reference data path
  */
-export declare function getReferenceDataPath(): string;
+export declare function getReferenceDataPath(fileAdapter: FileAdapter): string;
 /**
  * Check if reference data files exist
  */
-export declare function hasReferenceData(): boolean;
+export declare function hasReferenceData(fileAdapter?: FileAdapter): boolean;

package/dist/utilities/analytics/index.js

@@ -24,15 +24,11 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReferenceLoader = exports.ComparisonAnalyzer = exports.SentenceAnalyzer = exports.VocabularyAnalyzer = exports.MetricsCalculator = exports.OblAnonymizer = exports.OblUtil = void 0;
 exports.getReferenceDataPath = getReferenceDataPath;
 exports.hasReferenceData = hasReferenceData;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
+const io_1 = require("../../utils/io");
 // Always-available exports
 __exportStar(require("./metrics/types"), exports);
 __exportStar(require("./metrics/effort"), exports);
@@ -59,14 +55,16 @@ Object.defineProperty(exports, "ReferenceLoader", { enumerable: true, get: funct
 /**
  * Get the default reference data path
  */
-function getReferenceDataPath() {
-    return path_1.default.join(__dirname, 'reference', 'data');
+function getReferenceDataPath(fileAdapter) {
+    const { join } = fileAdapter;
+    return join(__dirname, 'reference', 'data');
 }
 /**
  * Check if reference data files exist
  */
-function hasReferenceData() {
-    const dataPath = getReferenceDataPath();
+function hasReferenceData(fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists, join } = fileAdapter;
+    const dataPath = getReferenceDataPath(fileAdapter);
     const requiredFiles = [
         'core_lists.en.json',
         'common_words.en.json',
@@ -74,5 +72,5 @@ function hasReferenceData() {
         'synonyms.en.json',
         'fringe.en.json',
     ];
-    return requiredFiles.every((file) => fs_1.default.existsSync(path_1.default.join(dataPath, file)));
+    return requiredFiles.every((file) => pathExists(join(dataPath, file)));
 }

package/dist/utilities/analytics/reference/index.d.ts

@@ -5,6 +5,7 @@
  * for AAC metrics analysis.
  */
 import { CoreList, CommonWordsData, SynonymsData } from '../metrics/types';
+import { FileAdapter } from '../../../utils/io';
 export interface ReferenceDataProvider {
     loadCoreLists(): CoreList[];
     loadCommonWords(): CommonWordsData;
@@ -29,7 +30,8 @@ export interface ReferenceDataProvider {
 export declare class ReferenceLoader {
     private dataDir;
     private locale;
-    constructor(dataDir?: string, locale?: string);
+    private fileAdapter;
+    constructor(dataDir?: string, locale?: string, fileAdapter?: FileAdapter);
     /**
      * Load core vocabulary lists
      */
@@ -79,8 +81,8 @@ export declare class ReferenceLoader {
 /**
  * Get the default reference data path
  */
-export declare function getReferenceDataPath(): string;
+export declare function getReferenceDataPath(fileAdapter?: FileAdapter): string;
 /**
  * Check if reference data files exist
  */
-export declare function hasReferenceData(): boolean;
+export declare function hasReferenceData(fileAdapter?: FileAdapter): boolean;

package/dist/utilities/analytics/reference/index.js

@@ -11,55 +11,61 @@ exports.getReferenceDataPath = getReferenceDataPath;
 exports.hasReferenceData = hasReferenceData;
 const io_1 = require("../../../utils/io");
 class ReferenceLoader {
-    constructor(dataDir, locale = 'en') {
+    constructor(dataDir, locale = 'en', fileAdapter = io_1.defaultFileAdapter) {
         this.locale = locale;
+        this.fileAdapter = fileAdapter;
         if (dataDir) {
             this.dataDir = dataDir;
         }
         else {
             // Resolve the data directory relative to this file's location
             // Use __dirname which works correctly after compilation
-            this.dataDir = (0, io_1.getPath)().join(__dirname, 'data');
+            this.dataDir = this.fileAdapter.join(__dirname, 'data');
         }
     }
     /**
      * Load core vocabulary lists
      */
     loadCoreLists() {
-        const filePath = (0, io_1.getPath)().join(this.dataDir, `core_lists.${this.locale}.json`);
-        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        const { readTextFromInput } = this.fileAdapter;
+        const filePath = this.fileAdapter.join(this.dataDir, `core_lists.${this.locale}.json`);
+        const content = readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load common words with baseline effort scores
      */
     loadCommonWords() {
-        const filePath = (0, io_1.getPath)().join(this.dataDir, `common_words.${this.locale}.json`);
-        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        const { readTextFromInput, join } = this.fileAdapter;
+        const filePath = join(this.dataDir, `common_words.${this.locale}.json`);
+        const content = readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load synonym mappings
      */
     loadSynonyms() {
-        const filePath = (0, io_1.getPath)().join(this.dataDir, `synonyms.${this.locale}.json`);
-        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        const { readTextFromInput, join } = this.fileAdapter;
+        const filePath = join(this.dataDir, `synonyms.${this.locale}.json`);
+        const content = readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load test sentences
      */
     loadSentences() {
-        const filePath = (0, io_1.getPath)().join(this.dataDir, `sentences.${this.locale}.json`);
-        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        const { readTextFromInput, join } = this.fileAdapter;
+        const filePath = join(this.dataDir, `sentences.${this.locale}.json`);
+        const content = readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load fringe vocabulary
      */
     loadFringe() {
-        const filePath = (0, io_1.getPath)().join(this.dataDir, `fringe.${this.locale}.json`);
-        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        const { readTextFromInput, join } = this.fileAdapter;
+        const filePath = join(this.dataDir, `fringe.${this.locale}.json`);
+        const content = readTextFromInput(filePath);
         const data = JSON.parse(String(content));
         // Flatten nested category words if needed
         if (Array.isArray(data) && data.length > 0 && data[0].categories) {
@@ -77,8 +83,9 @@ class ReferenceLoader {
      * Load base words hash map
      */
     loadBaseWords() {
-        const filePath = (0, io_1.getPath)().join(this.dataDir, `base_words.${this.locale}.json`);
-        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        const { readTextFromInput, join } = this.fileAdapter;
+        const filePath = join(this.dataDir, `base_words.${this.locale}.json`);
+        const content = readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
@@ -116,13 +123,14 @@ exports.ReferenceLoader = ReferenceLoader;
 /**
  * Get the default reference data path
  */
-function getReferenceDataPath() {
-    return String((0, io_1.getPath)().join(__dirname, 'data'));
+function getReferenceDataPath(fileAdapter = io_1.defaultFileAdapter) {
+    return String(fileAdapter.join(__dirname, 'data'));
 }
 /**
  * Check if reference data files exist
  */
-function hasReferenceData() {
+function hasReferenceData(fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists, join } = fileAdapter;
     const dataPath = getReferenceDataPath();
     const requiredFiles = [
         'core_lists.en.json',
@@ -131,5 +139,5 @@ function hasReferenceData() {
         'synonyms.en.json',
         'fringe.en.json',
     ];
-    return requiredFiles.every((file) => (0, io_1.getFs)().existsSync((0, io_1.getPath)().join(dataPath, file)));
+    return requiredFiles.every((file) => pathExists(join(dataPath, file)));
 }

package/dist/utilities/symbolTools.d.ts

@@ -1,10 +1,12 @@
+import { FileAdapter } from '../utils/io';
 export declare abstract class SymbolExtractor {
     abstract getSymbolReferences(filePath: string): string[];
 }
 export declare abstract class SymbolResolver {
     protected symbolPath: string;
     protected dbPath: string;
-    constructor(symbolPath: string, dbPath: string);
+    protected fileAdapter: FileAdapter;
+    constructor(symbolPath: string, dbPath: string, fileAdapter?: FileAdapter);
     abstract resolveSymbol(symbolRef: string): string | null;
 }
 export declare class SnapSymbolExtractor extends SymbolExtractor {
@@ -25,4 +27,4 @@ export declare class TouchChatSymbolExtractor extends SymbolExtractor {
 export declare class TouchChatSymbolResolver extends SymbolResolver {
     resolveSymbol(symbolRef: string): string | null;
 }
-export declare function resolveSymbol(label: string, symbolDir: string): string | null;
+export declare function resolveSymbol(label: string, symbolDir: string, fileAdapter?: FileAdapter): string | null;