@willwade/aac-processors 0.1.19 → 0.1.21

package/dist/browser/processors/snap/helpers.js

@@ -1,8 +1,7 @@
 import { AACSemanticCategory, AACSemanticIntent, } from '../../core/treeStructure';
-import * as fs from 'fs';
-import * as path from 'path';
-import Database from 'better-sqlite3';
 import { dotNetTicksToDate } from '../../utils/dotnetTicks';
+import { defaultFileAdapter, extname, getNodeRequire, } from '../../utils/io';
+import { requireBetterSqlite3 } from '../../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
@@ -11,7 +10,8 @@ import { dotNetTicksToDate } from '../../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) {
+function collectFiles(root, matcher, maxDepth = 3, fileAdapter = defaultFileAdapter) {
+    const { listDir, join, isDirectory } = fileAdapter;
     const results = new Set();
     const stack = [{ dir: root, depth: 0 }];
     while (stack.length > 0) {
@@ -22,14 +22,14 @@ function collectFiles(root, matcher, maxDepth = 3) {
             continue;
         let entries;
         try {
-            entries = fs.readdirSync(current.dir, { withFileTypes: true });
+            entries = 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 (isDirectory(entry)) {
                 stack.push({ dir: fullPath, depth: current.depth + 1 });
             }
             else if (matcher(fullPath)) {
@@ -83,17 +83,15 @@ export function getAllowedImageEntries(tree) {
  * @param entryPath Symbol identifier (e.g., "SYM:12345")
  * @returns Image data buffer or null if not found
  */
-export function openImage(dbOrFile, entryPath) {
+export function openImage(dbOrFile, entryPath, fileAdapter = 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 = mkTempDir(join(process.cwd(), 'snap-'));
+        dbPath = join(tempDir, 'temp.sps');
+        writeBinaryToPath(dbPath, dbOrFile);
         cleanupNeeded = true;
     }
     else if (typeof dbOrFile === 'string') {
@@ -102,9 +100,10 @@ export function openImage(dbOrFile, entryPath) {
     else {
         return null;
     }
+    const better_sqlite3 = getNodeRequire()('better-sqlite3');
     let db = null;
     try {
-        db = new Database(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 = ?')
@@ -127,9 +126,9 @@ export function openImage(dbOrFile, entryPath) {
         }
         if (cleanupNeeded && dbPath) {
             try {
-                fs.unlinkSync(dbPath);
-                const dir = path.dirname(dbPath);
-                fs.rmdirSync(dir);
+                removePath(dbPath);
+                const dir = dirname(dbPath);
+                removePath(dir);
             }
             catch (e) {
                 // Ignore cleanup errors
@@ -143,7 +142,8 @@ export function openImage(dbOrFile, entryPath) {
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Array of Snap package path information
  */
-export function findSnapPackages(packageNamePattern = 'TobiiDynavox') {
+export function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
+    const { join, listDir, isDirectory, pathExists } = fileAdapter;
     const results = [];
     // Only works on Windows
     if (process.platform !== 'win32') {
@@ -154,22 +154,22 @@ export 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 (!pathExists(packagesPath)) {
             return results;
         }
         // Enumerate packages
-        const packages = fs.readdirSync(packagesPath, { withFileTypes: true });
+        const packages = listDir(packagesPath);
         for (const packageDir of packages) {
-            if (!packageDir.isDirectory())
+            if (!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),
                 });
             }
         }
@@ -185,8 +185,8 @@ export 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
  */
-export function findSnapPackagePath(packageNamePattern = 'TobiiDynavox') {
-    const packages = findSnapPackages(packageNamePattern);
+export function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const packages = findSnapPackages(packageNamePattern, fileAdapter);
     return packages.length > 0 ? packages[0].packagePath : null;
 }
 /**
@@ -196,32 +196,33 @@ export function findSnapPackagePath(packageNamePattern = 'TobiiDynavox') {
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */
-export function findSnapUsers(packageNamePattern = 'TobiiDynavox') {
+export function findSnapUsers(packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
+    const { join, listDir, isDirectory, pathExists } = fileAdapter;
     const results = [];
     if (process.platform !== 'win32') {
         return results;
     }
-    const packagePath = findSnapPackagePath(packageNamePattern);
+    const packagePath = 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 (!pathExists(usersRoot)) {
         return results;
     }
-    const entries = fs.readdirSync(usersRoot, { withFileTypes: true });
+    const entries = listDir(usersRoot);
     for (const entry of entries) {
-        if (!entry.isDirectory())
+        if (!isDirectory(entry))
             continue;
-        if (entry.name.toLowerCase().startsWith('swiftkey'))
+        if (entry.toLowerCase().startsWith('swiftkey'))
             continue;
-        const userPath = path.join(usersRoot, entry.name);
+        const userPath = join(usersRoot, entry);
         const vocabPaths = collectFiles(userPath, (full) => {
-            const ext = path.extname(full).toLowerCase();
+            const ext = extname(full).toLowerCase();
             return ext === '.sps' || ext === '.spb';
-        }, 2);
+        }, 2, fileAdapter);
         results.push({
-            userId: entry.name,
+            userId: entry,
             userPath,
             vocabPaths,
         });
@@ -234,8 +235,8 @@ export function findSnapUsers(packageNamePattern = 'TobiiDynavox') {
  * @param packageNamePattern Optional package filter
  * @returns Array of vocab file paths
  */
-export function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox') {
-    const users = findSnapUsers(packageNamePattern).filter((u) => !userId || u.userId === userId);
+export function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const users = findSnapUsers(packageNamePattern, fileAdapter).filter((u) => !userId || u.userId === userId);
     return users.flatMap((u) => u.vocabPaths);
 }
 /**
@@ -245,11 +246,12 @@ export function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDyna
  * @param packageNamePattern Optional package filter
  * @returns Array of history file paths (may be empty if not found)
  */
-export function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox') {
-    const user = findSnapUsers(packageNamePattern).find((u) => u.userId === userId);
+export function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox', fileAdapter = defaultFileAdapter) {
+    const { basename } = fileAdapter;
+    const user = findSnapUsers(packageNamePattern, fileAdapter).find((u) => u.userId === userId);
     if (!user)
         return [];
-    return collectFiles(user.userPath, (full) => path.basename(full).toLowerCase().includes('history'), 2);
+    return collectFiles(user.userPath, (full) => basename(full).toLowerCase().includes('history'), 2, fileAdapter);
 }
 /**
  * Check whether TD Snap appears to be installed (Windows only)
@@ -262,9 +264,11 @@ export function isSnapInstalled(packageNamePattern = 'TobiiDynavox') {
 /**
  * Read Snap usage history from a pageset file (.sps/.spb)
  */
-export function readSnapUsage(pagesetPath) {
-    if (!fs.existsSync(pagesetPath))
+export function readSnapUsage(pagesetPath, fileAdapter = defaultFileAdapter) {
+    const { pathExists } = fileAdapter;
+    if (!pathExists(pagesetPath))
         return [];
+    const Database = 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')")

package/dist/browser/processors/snapProcessor.js

@@ -2,7 +2,7 @@ import { BaseProcessor, } from '../core/baseProcessor';
 import { AACTree, AACPage, AACButton, AACSemanticCategory, AACSemanticIntent, } from '../core/treeStructure';
 import { generateCloneId } from '../utilities/analytics/utils/idGenerator';
 import { SnapValidator } from '../validation/snapValidator';
-import { getFs, getNodeRequire, getPath, isNodeRuntime } from '../utils/io';
+import { getNodeRequire, isNodeRuntime } from '../utils/io';
 import { openSqliteDatabase, requireBetterSqlite3 } from '../utils/sqlite';
 /**
  * Convert a Buffer or Uint8Array to base64 string (browser and Node compatible)
@@ -35,15 +35,15 @@ function mapSnapVisibility(visible) {
     return visible === 0 ? 'Hidden' : 'Visible';
 }
 class SnapProcessor extends 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);
@@ -64,11 +64,41 @@ class SnapProcessor extends BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { writeBinaryToPath, removePath, mkTempDir, basename, join } = this.options.fileAdapter;
         await Promise.resolve();
         const tree = new AACTree();
         let dbResult = null;
+        let cleanupTempZip = null;
         try {
-            dbResult = await 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 openSqliteDatabase(inputFile, {
+                readonly: true,
+                fileAdapter: this.options.fileAdapter,
+            });
             const db = dbResult.db;
             const getTableColumns = (tableName) => {
                 try {
@@ -658,24 +688,32 @@ class SnapProcessor extends 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 (!isNodeRuntime()) {
             throw new Error('processTexts is only supported in Node.js environments for Snap files.');
         }
-        const fs = getFs();
-        const path = 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 = requireBetterSqlite3();
             const db = new Database(outputPath, { readonly: false });
             try {
@@ -737,7 +775,7 @@ class SnapProcessor extends 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);
@@ -764,21 +802,20 @@ class SnapProcessor extends 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 (!isNodeRuntime()) {
             throw new Error('saveFromTree is only supported in Node.js environments for Snap files.');
         }
         await Promise.resolve();
-        const fs = getFs();
-        const path = 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 = requireBetterSqlite3();
@@ -1061,12 +1098,12 @@ class SnapProcessor extends BaseProcessor {
      * Create a copy of the pageset with audio recordings added
      */
     async createAudioEnhancedPageset(sourceDbPath, targetDbPath, audioMappings) {
+        const { writeBinaryToPath, readBinaryFromInput } = this.options.fileAdapter;
         if (!isNodeRuntime()) {
             throw new Error('createAudioEnhancedPageset is only supported in Node.js environments.');
         }
-        const fs = 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);
@@ -1128,7 +1165,7 @@ class SnapProcessor extends BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return SnapValidator.validateFile(filePath);
+        return SnapValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Get available PageLayouts for a Snap file
@@ -1137,14 +1174,13 @@ class SnapProcessor extends BaseProcessor {
      * @returns Array of available PageLayouts with their dimensions
      */
     getAvailablePageLayouts(filePath) {
+        const { writeBinaryToPath, removePath, pathExists, join } = this.options.fileAdapter;
         if (!isNodeRuntime()) {
             throw new Error('getAvailablePageLayouts is only supported in Node.js environments.');
         }
-        const fs = getFs();
-        const path = 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 {
@@ -1195,9 +1231,9 @@ class SnapProcessor extends 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/browser/processors/touchchatProcessor.js

@@ -3,10 +3,10 @@ import { AACTree, AACPage, AACButton, AACSemanticCategory, AACSemanticIntent, }
 import { generateCloneId } from '../utilities/analytics/utils/idGenerator';
 import { detectCasing, isNumericOrEmpty } from '../core/stringCasing';
 import { TouchChatValidator } from '../validation/touchChatValidator';
-import { getFs, getNodeRequire, getOs, getPath, isNodeRuntime, readBinaryFromInput, } from '../utils/io';
+import { isNodeRuntime } from '../utils/io';
 import { extractAllButtonsForTranslation, validateTranslationResults, } from '../utilities/translation/translationProcessor';
 import { openSqliteDatabase, requireBetterSqlite3, } from '../utils/sqlite';
-import { openZipFromInput } from '../utils/zip';
+import { getZipEntriesFromAdapter } from './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;
@@ -55,6 +55,7 @@ class TouchChatProcessor extends 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;
@@ -64,15 +65,16 @@ class TouchChatProcessor extends BaseProcessor {
             this.sourceFile = filePathOrBuffer;
             // Step 1: Unzip
             const zipInput = readBinaryFromInput(filePathOrBuffer);
-            const { zip } = this.options.zipAdapter
-                ? await this.options.zipAdapter(zipInput)
-                : await openZipFromInput(zipInput);
+            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 openSqliteDatabase(dbBuffer, { readonly: true });
+            const dbResult = await openSqliteDatabase(dbBuffer, {
+                readonly: true,
+                fileAdapter: this.options.fileAdapter,
+            });
             db = dbResult.db;
             cleanup = dbResult.cleanup;
             // Step 3: Create tree and load pages
@@ -475,6 +477,7 @@ class TouchChatProcessor extends BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { pathExists, mkDir, removePath, mkTempDir, writeBinaryToPath, readBinaryFromInput, dirname, join, } = this.options.fileAdapter;
         if (!isNodeRuntime()) {
             throw new Error('processTexts is only supported in Node.js environments for TouchChat files.');
         }
@@ -487,28 +490,24 @@ class TouchChatProcessor extends BaseProcessor {
          * within the embedded SQLite database, ensuring assets and metadata remain intact.
          */
         if (typeof filePathOrBuffer === 'string') {
-            const fs = getFs();
-            const path = getPath();
-            const os = getOs();
-            const AdmZip = 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 = 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 = requireBetterSqlite3();
                 const db = new Database(dbPath, { readonly: false });
                 try {
@@ -561,26 +560,34 @@ class TouchChatProcessor extends 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);
@@ -607,20 +614,17 @@ class TouchChatProcessor extends BaseProcessor {
             });
         });
         await this.saveFromTree(tree, outputPath);
-        const fs = 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 (!isNodeRuntime()) {
             throw new Error('saveFromTree is only supported in Node.js environments for TouchChat files.');
         }
-        const fs = getFs();
-        const path = getPath();
-        const os = 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 = requireBetterSqlite3();
             const db = new Database(dbPath);
@@ -913,15 +917,20 @@ class TouchChatProcessor extends BaseProcessor {
             }
             db.close();
             // Create zip file with the database
-            const AdmZip = 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 });
             }
         }
     }
@@ -1016,7 +1025,7 @@ class TouchChatProcessor extends BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return TouchChatValidator.validateFile(filePath);
+        return TouchChatValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Extract symbol information from a TouchChat file for LLM-based translation.
@@ -1058,6 +1067,7 @@ class TouchChatProcessor extends BaseProcessor {
      * @returns Buffer of the translated TouchChat file
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         if (!isNodeRuntime()) {
             throw new Error('processLLMTranslations is only supported in Node.js environments for TouchChat files.');
         }
@@ -1099,8 +1109,7 @@ class TouchChatProcessor extends BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        const fs = getFs();
-        return fs.readFileSync(outputPath);
+        return readBinaryFromInput(outputPath);
     }
 }
 export { TouchChatProcessor };