@willwade/aac-processors 0.1.20 → 0.2.0

package/dist/processors/snap/helpers.js

@@ -1,30 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __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.getPageTokenImageMap = getPageTokenImageMap;
 exports.getAllowedImageEntries = getAllowedImageEntries;
@@ -38,10 +12,9 @@ exports.isSnapInstalled = isSnapInstalled;
 exports.readSnapUsage = readSnapUsage;
 exports.readSnapUsageForUser = readSnapUsageForUser;
 const treeStructure_1 = require("../../core/treeStructure");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const dotnetTicks_1 = require("../../utils/dotnetTicks");
+const io_1 = require("../../utils/io");
+const sqlite_1 = require("../../utils/sqlite");
 // Minimal Snap helpers (stubs) to align with processors/<engine>/helpers pattern
 // NOTE: Snap files can store different types of image data in PageSetData:
 // - PNG/JPEG binaries: Actual images that can be displayed
@@ -50,7 +23,8 @@ const dotnetTicks_1 = require("../../utils/dotnetTicks");
 // 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) {
+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 }];
     while (stack.length > 0) {
@@ -61,14 +35,14 @@ function collectFiles(root, matcher, maxDepth = 3) {
             continue;
         let entries;
         try {
-            entries = fs.readdirSync(current.dir, { withFileTypes: true });
+            entries = await listDir(current.dir);
         }
         catch (error) {
             continue;
         }
         for (const entry of entries) {
-            const fullPath = path.join(current.dir, entry.name);
-            if (entry.isDirectory()) {
+            const fullPath = join(current.dir, entry);
+            if (await isDirectory(entry)) {
                 stack.push({ dir: fullPath, depth: current.depth + 1 });
             }
             else if (matcher(fullPath)) {
@@ -122,17 +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) {
+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)) {
-        if (typeof fs.mkdtempSync !== 'function') {
-            return null; // Not in Node environment
-        }
-        const tempDir = fs.mkdtempSync(path.join(process.cwd(), 'snap-'));
-        dbPath = path.join(tempDir, 'temp.sps');
-        fs.writeFileSync(dbPath, dbOrFile);
+        const tempDir = await mkTempDir(join(process.cwd(), 'snap-'));
+        dbPath = join(tempDir, 'temp.sps');
+        await writeBinaryToPath(dbPath, dbOrFile);
         cleanupNeeded = true;
     }
     else if (typeof dbOrFile === 'string') {
@@ -141,9 +113,10 @@ function openImage(dbOrFile, entryPath) {
     else {
         return null;
     }
+    const better_sqlite3 = (0, io_1.getNodeRequire)()('better-sqlite3');
     let db = null;
     try {
-        db = new better_sqlite3_1.default(dbPath, { readonly: true });
+        db = new better_sqlite3.Database(dbPath, { readonly: true });
         // Query PageSetData for the symbol
         const row = db
             .prepare('SELECT Id, Identifier, Data FROM PageSetData WHERE Identifier = ?')
@@ -166,9 +139,9 @@ function openImage(dbOrFile, entryPath) {
         }
         if (cleanupNeeded && dbPath) {
             try {
-                fs.unlinkSync(dbPath);
-                const dir = path.dirname(dbPath);
-                fs.rmdirSync(dir);
+                await removePath(dbPath);
+                const dir = dirname(dbPath);
+                await removePath(dir);
             }
             catch (e) {
                 // Ignore cleanup errors
@@ -182,7 +155,8 @@ function openImage(dbOrFile, entryPath) {
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Array of Snap package path information
  */
-function findSnapPackages(packageNamePattern = 'TobiiDynavox') {
+async function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.defaultFileAdapter) {
+    const { join, listDir, isDirectory, pathExists } = fileAdapter;
     const results = [];
     // Only works on Windows
     if (process.platform !== 'win32') {
@@ -193,22 +167,22 @@ function findSnapPackages(packageNamePattern = 'TobiiDynavox') {
         if (!localAppData) {
             return results;
         }
-        const packagesPath = path.join(localAppData, 'Packages');
+        const packagesPath = join(localAppData, 'Packages');
         // Check if Packages directory exists
-        if (!fs.existsSync(packagesPath)) {
+        if (!(await pathExists(packagesPath))) {
             return results;
         }
         // Enumerate packages
-        const packages = fs.readdirSync(packagesPath, { withFileTypes: true });
+        const packages = await listDir(packagesPath);
         for (const packageDir of packages) {
-            if (!packageDir.isDirectory())
+            if (!(await isDirectory(packageDir)))
                 continue;
-            const packageName = packageDir.name;
+            const packageName = packageDir;
             // Filter by pattern
             if (packageName.includes(packageNamePattern)) {
                 results.push({
                     packageName,
-                    packagePath: path.join(packagesPath, packageName),
+                    packagePath: join(packagesPath, packageName),
                 });
             }
         }
@@ -224,8 +198,8 @@ function findSnapPackages(packageNamePattern = 'TobiiDynavox') {
  * @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') {
-    const packages = findSnapPackages(packageNamePattern);
+async function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const packages = await findSnapPackages(packageNamePattern, fileAdapter);
     return packages.length > 0 ? packages[0].packagePath : null;
 }
 /**
@@ -235,32 +209,33 @@ function findSnapPackagePath(packageNamePattern = 'TobiiDynavox') {
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */
-function findSnapUsers(packageNamePattern = 'TobiiDynavox') {
+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);
+    const packagePath = await findSnapPackagePath(packageNamePattern, fileAdapter);
     if (!packagePath) {
         return results;
     }
-    const usersRoot = path.join(packagePath, 'LocalState', 'Users');
-    if (!fs.existsSync(usersRoot)) {
+    const usersRoot = join(packagePath, 'LocalState', 'Users');
+    if (!(await pathExists(usersRoot))) {
         return results;
     }
-    const entries = fs.readdirSync(usersRoot, { withFileTypes: true });
+    const entries = await listDir(usersRoot);
     for (const entry of entries) {
-        if (!entry.isDirectory())
+        if (!(await isDirectory(entry)))
             continue;
-        if (entry.name.toLowerCase().startsWith('swiftkey'))
+        if (entry.toLowerCase().startsWith('swiftkey'))
             continue;
-        const userPath = path.join(usersRoot, entry.name);
-        const vocabPaths = collectFiles(userPath, (full) => {
-            const ext = path.extname(full).toLowerCase();
+        const userPath = join(usersRoot, entry);
+        const vocabPaths = await collectFiles(userPath, (full) => {
+            const ext = (0, io_1.extname)(full).toLowerCase();
             return ext === '.sps' || ext === '.spb';
-        }, 2);
+        }, 2, fileAdapter);
         results.push({
-            userId: entry.name,
+            userId: entry,
             userPath,
             vocabPaths,
         });
@@ -273,8 +248,9 @@ function findSnapUsers(packageNamePattern = 'TobiiDynavox') {
  * @param packageNamePattern Optional package filter
  * @returns Array of vocab file paths
  */
-function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox') {
-    const users = findSnapUsers(packageNamePattern).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);
 }
 /**
@@ -284,11 +260,13 @@ function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox') {
  * @param packageNamePattern Optional package filter
  * @returns Array of history file paths (may be empty if not found)
  */
-function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox') {
-    const user = findSnapUsers(packageNamePattern).find((u) => u.userId === userId);
+async function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.defaultFileAdapter) {
+    const { basename } = fileAdapter;
+    const allUsers = await findSnapUsers(packageNamePattern, fileAdapter);
+    const user = allUsers.find((u) => u.userId === userId);
     if (!user)
         return [];
-    return collectFiles(user.userPath, (full) => path.basename(full).toLowerCase().includes('history'), 2);
+    return await collectFiles(user.userPath, (full) => basename(full).toLowerCase().includes('history'), 2, fileAdapter);
 }
 /**
  * Check whether TD Snap appears to be installed (Windows only)
@@ -301,10 +279,12 @@ function isSnapInstalled(packageNamePattern = 'TobiiDynavox') {
 /**
  * Read Snap usage history from a pageset file (.sps/.spb)
  */
-function readSnapUsage(pagesetPath) {
-    if (!fs.existsSync(pagesetPath))
+async function readSnapUsage(pagesetPath, fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists } = fileAdapter;
+    if (!(await pathExists(pagesetPath)))
         return [];
-    const db = new better_sqlite3_1.default(pagesetPath, { readonly: true });
+    const Database = (0, sqlite_1.requireBetterSqlite3)();
+    const db = new Database(pagesetPath, { readonly: true });
     const tableCheck = db
         .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name IN ('ButtonUsage','Button')")
         .all();
@@ -358,8 +338,10 @@ function readSnapUsage(pagesetPath) {
 /**
  * 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

@@ -7,7 +7,6 @@ const idGenerator_1 = require("../utilities/analytics/utils/idGenerator");
 const snapValidator_1 = require("../validation/snapValidator");
 const io_1 = require("../utils/io");
 const sqlite_1 = require("../utils/sqlite");
-const zip_1 = require("../utils/zip");
 /**
  * Convert a Buffer or Uint8Array to base64 string (browser and Node compatible)
  * Node.js Buffers support toString('base64'), but Uint8Arrays in browser do not.
@@ -39,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);
@@ -68,7 +67,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { writeBinaryToPath, removePath, mkTempDir, basename, join } = this.options.fileAdapter;
         const tree = new treeStructure_1.AACTree();
         let dbResult = null;
         let cleanupTempZip = null;
@@ -76,32 +75,32 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             // Handle .sub.zip files (Snap pageset backups containing .sps files)
             let inputFile = filePathOrBuffer;
             if (typeof filePathOrBuffer === 'string') {
-                const fileName = (0, io_1.getPath)().basename(filePathOrBuffer).toLowerCase();
+                const fileName = basename(filePathOrBuffer).toLowerCase();
                 if (fileName.endsWith('.sub.zip') || filePathOrBuffer.endsWith('.sub')) {
-                    const fs = (0, io_1.getFs)();
-                    const path = (0, io_1.getPath)();
-                    const os = (0, io_1.getOs)();
                     // Extract .sub.zip to find the embedded .sps file
-                    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'snap-sub-'));
-                    const { zip } = await (0, zip_1.openZipFromInput)(filePathOrBuffer);
+                    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) {
-                        fs.rmSync(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 = path.join(tempDir, path.basename(spsFile));
-                    fs.writeFileSync(extractedSpsPath, Buffer.from(spsData));
+                    const extractedSpsPath = join(tempDir, basename(spsFile));
+                    await writeBinaryToPath(extractedSpsPath, Buffer.from(spsData));
                     inputFile = extractedSpsPath;
-                    cleanupTempZip = () => {
-                        fs.rmSync(tempDir, { recursive: true, force: true });
+                    cleanupTempZip = async () => {
+                        await removePath(tempDir, { recursive: true, force: true });
                     };
                 }
             }
-            dbResult = await (0, sqlite_1.openSqliteDatabase)(inputFile, { readonly: true });
+            dbResult = await (0, sqlite_1.openSqliteDatabase)(inputFile, {
+                readonly: true,
+                fileAdapter: this.options.fileAdapter,
+            });
             const db = dbResult.db;
             const getTableColumns = (tableName) => {
                 try {
@@ -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);
@@ -703,21 +702,21 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     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);
+            const dirExists = await pathExists(outputDir);
+            if (!dirExists) {
+                await mkDir(outputDir, { recursive: true });
             }
-            if (fs.existsSync(outputPath)) {
-                fs.unlinkSync(outputPath);
+            if (await pathExists(outputPath)) {
+                await removePath(outputPath);
             }
-            fs.copyFileSync(inputPath, outputPath);
+            await writeBinaryToPath(outputPath, await readBinaryFromInput(inputPath));
             const Database = (0, sqlite_1.requireBetterSqlite3)();
             const db = new Database(outputPath, { readonly: false });
             try {
@@ -779,7 +778,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             finally {
                 db.close();
             }
-            return fs.readFileSync(outputPath);
+            return await readBinaryFromInput(outputPath);
         }
         // Fallback for buffer inputs: rebuild from tree (may drop Snap assets)
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -806,21 +805,20 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         await this.saveFromTree(tree, outputPath);
-        return fs.readFileSync(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 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);
+        const dirExists = await pathExists(outputDir);
+        if (!dirExists) {
+            await mkDir(outputDir, { recursive: true });
         }
-        if (fs.existsSync(outputPath)) {
-            fs.unlinkSync(outputPath);
+        if (await pathExists(outputPath)) {
+            await removePath(outputPath);
         }
         // Create a new SQLite database for Snap format
         const Database = (0, sqlite_1.requireBetterSqlite3)();
@@ -1055,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.');
         }
@@ -1093,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();
@@ -1103,12 +1100,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);
+        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);
@@ -1170,23 +1167,22 @@ 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
      * 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 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);
+            await writeBinaryToPath(dbPath, filePath);
         }
         let db = null;
         try {
@@ -1237,9 +1233,10 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                 db.close();
             }
             // Clean up temporary file if created from buffer
-            if (Buffer.isBuffer(filePath) && fs.existsSync(dbPath)) {
+            const exists = await pathExists(dbPath);
+            if (Buffer.isBuffer(filePath) && exists) {
                 try {
-                    fs.unlinkSync(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;