@willwade/aac-processors 0.1.19 → 0.1.21

package/dist/processors/obfProcessor.js

@@ -1,27 +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;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObfProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
@@ -146,13 +123,9 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 return 'image/png';
         }
     }
-    async processBoard(boardData, _boardPath) {
+    async processBoard(boardData, _boardPath, isZipEntry) {
         const sourceButtons = boardData.buttons || [];
         // Calculate page ID first (used to make button IDs unique)
-        const isZipEntry = _boardPath &&
-            _boardPath.endsWith('.obf') &&
-            !_boardPath.includes('/') &&
-            !_boardPath.includes('\\');
         const pageId = isZipEntry
             ? _boardPath // Zip entry - use filename to match navigation paths
             : boardData?.id
@@ -313,10 +286,11 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         // Detailed logging for debugging input
         const bufferLength = typeof filePathOrBuffer === 'string'
             ? null
-            : (0, io_1.readBinaryFromInput)(filePathOrBuffer).byteLength;
+            : readBinaryFromInput(filePathOrBuffer).byteLength;
         console.log('[OBF] loadIntoTree called with:', {
             type: typeof filePathOrBuffer,
             isBuffer: typeof Buffer !== 'undefined' && Buffer.isBuffer(filePathOrBuffer),
@@ -328,7 +302,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         // Helper: try to parse JSON OBF
         function tryParseObfJson(data) {
             try {
-                const str = typeof data === 'string' ? data : (0, io_1.readTextFromInput)(data);
+                const str = typeof data === 'string' ? data : readTextFromInput(data);
                 // Check for empty or whitespace-only content
                 if (!str.trim()) {
                     return null;
@@ -350,11 +324,11 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         // If input is a string path and ends with .obf, treat as JSON
         if (typeof filePathOrBuffer === 'string' && filePathOrBuffer.toLowerCase().endsWith('.obf')) {
             try {
-                const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+                const content = readTextFromInput(filePathOrBuffer);
                 const boardData = tryParseObfJson(content);
                 if (boardData) {
                     console.log('[OBF] Detected .obf file, parsed as JSON');
-                    const page = await this.processBoard(boardData, filePathOrBuffer);
+                    const page = await this.processBoard(boardData, filePathOrBuffer, false);
                     tree.addPage(page);
                     // Set metadata from root board
                     tree.metadata.format = 'obf';
@@ -384,7 +358,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 const lowered = input.toLowerCase();
                 return lowered.endsWith('.zip') || lowered.endsWith('.obz');
             }
-            const bytes = (0, io_1.readBinaryFromInput)(input);
+            const bytes = readBinaryFromInput(input);
             return bytes.length >= 2 && bytes[0] === 0x50 && bytes[1] === 0x4b;
         }
         // Check if input is a buffer or string that parses as OBF JSON; throw if neither JSON nor ZIP
@@ -393,7 +367,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             if (!asJson)
                 throw new Error('Invalid OBF content: not JSON and not ZIP');
             console.log('[OBF] Detected buffer/string as OBF JSON');
-            const page = await this.processBoard(asJson, '[bufferOrString]');
+            const page = await this.processBoard(asJson, '[bufferOrString]', false);
             tree.addPage(page);
             // Set metadata from root board
             tree.metadata.format = 'obf';
@@ -410,10 +384,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             return tree;
         }
         try {
-            const zipResult = this.options.zipAdapter
-                ? await this.options.zipAdapter(filePathOrBuffer)
-                : await (0, zip_1.openZipFromInput)(filePathOrBuffer);
-            this.zipFile = zipResult.zip;
+            this.zipFile = await this.options.zipAdapter(filePathOrBuffer);
         }
         catch (err) {
             console.error('[OBF] Error loading ZIP:', err);
@@ -422,17 +393,42 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         // Store the ZIP file reference for image extraction
         this.imageCache.clear(); // Clear cache for new file
         console.log('[OBF] Detected zip archive, extracting .obf files');
-        // Collect all .obf entries
-        const obfEntries = this.zipFile
-            .listFiles()
-            .filter((name) => name.toLowerCase().endsWith('.obf'));
+        // List manifest and OBF files
+        const filesInZip = this.zipFile.listFiles();
+        const manifestFile = filesInZip.filter((name) => name.toLowerCase() === 'manifest.json');
+        let obfEntries = filesInZip.filter((name) => name.toLowerCase().endsWith('.obf'));
+        // Attempt to read manifest
+        if (manifestFile && manifestFile.length === 1) {
+            try {
+                const content = await this.zipFile.readFile(manifestFile[0]);
+                const data = (0, io_1.decodeText)(content);
+                const str = typeof data === 'string' ? data : readTextFromInput(data);
+                if (!str.trim())
+                    throw new Error('Manifest object missing');
+                const manifestObject = JSON.parse(str);
+                if (!manifestObject)
+                    throw new Error('Manifest object is empty');
+                // Replace OBF file list
+                if (manifestObject.paths && manifestObject.paths.boards) {
+                    obfEntries = Object.values(manifestObject.paths.boards);
+                }
+                // Move root board to top of list
+                if (manifestObject.root) {
+                    obfEntries = obfEntries.filter((item) => item !== manifestObject.root);
+                    obfEntries.unshift(manifestObject.root);
+                }
+            }
+            catch (err) {
+                console.warn('[OBF] Error processing mainfest', err);
+            }
+        }
         // Process each .obf entry
         for (const entryName of obfEntries) {
             try {
                 const content = await this.zipFile.readFile(entryName);
                 const boardData = tryParseObfJson((0, io_1.decodeText)(content));
                 if (boardData) {
-                    const page = await this.processBoard(boardData, entryName);
+                    const page = await this.processBoard(boardData, entryName, true);
                     tree.addPage(page);
                     // Set metadata if not already set (use first board as reference)
                     if (!tree.metadata.format) {
@@ -544,6 +540,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         };
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         // Load the tree, apply translations, and save to new file
         const tree = await this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
@@ -573,9 +570,10 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save the translated tree and return its content
         await this.saveFromTree(tree, outputPath);
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        return readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
+        const { writeTextToPath, writeBinaryToPath } = this.options.fileAdapter;
         if (outputPath.endsWith('.obf')) {
             // Save as single OBF JSON file
             const rootPage = tree.rootId ? tree.getPage(tree.rootId) : Object.values(tree.pages)[0];
@@ -583,35 +581,21 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 throw new Error('No pages to save');
             }
             const obfBoard = this.createObfBoardFromPage(rootPage, 'Exported Board', tree.metadata);
-            (0, io_1.writeTextToPath)(outputPath, JSON.stringify(obfBoard, null, 2));
+            writeTextToPath(outputPath, JSON.stringify(obfBoard, null, 2));
         }
         else {
-            // Save as OBZ (zip with multiple OBF files)
-            if ((0, io_1.isNodeRuntime)()) {
-                const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
-                const zip = new AdmZip();
-                Object.values(tree.pages).forEach((page) => {
-                    const obfBoard = this.createObfBoardFromPage(page, 'Board', tree.metadata);
-                    const obfContent = JSON.stringify(obfBoard, null, 2);
-                    zip.addFile(`${page.id}.obf`, Buffer.from(obfContent, 'utf8'));
-                });
-                const zipBuffer = zip.toBuffer();
-                const { writeBinaryToPath } = await Promise.resolve().then(() => __importStar(require('../utils/io')));
-                writeBinaryToPath(outputPath, zipBuffer);
-            }
-            else {
-                const module = await Promise.resolve().then(() => __importStar(require('jszip')));
-                const JSZip = module.default || module;
-                const zip = new JSZip();
-                Object.values(tree.pages).forEach((page) => {
-                    const obfBoard = this.createObfBoardFromPage(page, 'Board', tree.metadata);
-                    const obfContent = JSON.stringify(obfBoard, null, 2);
-                    zip.file(`${page.id}.obf`, obfContent);
-                });
-                const zipBuffer = await zip.generateAsync({ type: 'uint8array' });
-                const { writeBinaryToPath } = await Promise.resolve().then(() => __importStar(require('../utils/io')));
-                writeBinaryToPath(outputPath, zipBuffer);
-            }
+            const files = Object.values(tree.pages).map((page) => {
+                const obfBoard = this.createObfBoardFromPage(page, 'Board', tree.metadata);
+                const obfContent = JSON.stringify(obfBoard, null, 2);
+                const name = page.id.endsWith('.obf') ? page.id : `${page.id}.obf`;
+                return {
+                    name,
+                    data: new TextEncoder().encode(obfContent),
+                };
+            });
+            const zip = await (0, zip_1.getZipAdapter)(undefined, this.options.fileAdapter);
+            const zipData = await zip.writeFiles(files);
+            writeBinaryToPath(outputPath, zipData);
         }
     }
     /**
@@ -635,7 +619,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      */
     async validate(filePath) {
         const ObfValidator = this.getObfValidator();
-        return ObfValidator.validateFile(filePath);
+        return ObfValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Extract symbol information from an OBF/OBZ file for LLM-based translation.
@@ -677,6 +661,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Buffer of the translated OBF/OBZ file
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         const tree = await this.loadIntoTree(filePathOrBuffer);
         // Validate translations using shared utility
         const buttonIds = Object.values(tree.pages).flatMap((page) => page.buttons.map((b) => b.id));
@@ -715,7 +700,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        return readBinaryFromInput(outputPath);
     }
     getObfValidator() {
         try {

package/dist/processors/obfsetProcessor.js

@@ -8,7 +8,6 @@ exports.ObfsetProcessor = void 0;
 const treeStructure_1 = require("../core/treeStructure");
 const treeStructure_2 = require("../core/treeStructure");
 const baseProcessor_1 = require("../core/baseProcessor");
-const io_1 = require("../utils/io");
 class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options = {}) {
         super(options);
@@ -33,10 +32,11 @@ class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
      * Load an .obfset file (JSON array of boards)
      */
     async loadIntoTree(filePathOrBuffer) {
+        const { readTextFromInput } = this.options.fileAdapter;
         await Promise.resolve();
         const tree = new treeStructure_1.AACTree();
         tree.metadata.format = 'obfset';
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const content = readTextFromInput(filePathOrBuffer);
         const boards = JSON.parse(content);
         // Track board ID mappings
         const boardMap = new Map();

package/dist/processors/opmlProcessor.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpmlProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
-// Removed unused import: FileProcessor
 const fast_xml_parser_1 = require("fast-xml-parser");
 const validationTypes_1 = require("../validation/validationTypes");
 const io_1 = require("../utils/io");
@@ -53,8 +52,9 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
         return { page, childPages };
     }
     async extractTexts(filePathOrBuffer) {
+        const { readTextFromInput } = this.options.fileAdapter;
         await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const content = readTextFromInput(filePathOrBuffer);
         const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
         const data = parser.parse(content);
         const texts = [];
@@ -85,10 +85,11 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         await Promise.resolve();
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.opml';
-        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
-        const content = (0, io_1.readTextFromInput)(buffer);
+        const buffer = readBinaryFromInput(filePathOrBuffer);
+        const content = readTextFromInput(buffer);
         try {
             if (!content || !content.trim()) {
                 const validationResult = (0, validationTypes_1.buildValidationResultFromMessage)({
@@ -171,8 +172,9 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { writeBinaryToPath, readTextFromInput } = this.options.fileAdapter;
         await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const content = readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         // Apply translations to text attributes in OPML outline elements
         translations.forEach((translation, originalText) => {
@@ -183,10 +185,11 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             }
         });
         const resultBuffer = (0, io_1.encodeText)(translatedContent);
-        (0, io_1.writeBinaryToPath)(outputPath, resultBuffer);
+        writeBinaryToPath(outputPath, resultBuffer);
         return resultBuffer;
     }
     async saveFromTree(tree, outputPath) {
+        const { writeTextToPath } = this.options.fileAdapter;
         await Promise.resolve();
         // Helper to recursively build outline nodes with cycle detection
         function buildOutline(page, visited = new Set()) {
@@ -257,7 +260,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             attributeNamePrefix: '@_',
         });
         const xml = '<?xml version="1.0" encoding="UTF-8"?>\n' + builder.build(opmlObj);
-        (0, io_1.writeTextToPath)(outputPath, xml);
+        writeTextToPath(outputPath, xml);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

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

@@ -1,5 +1,5 @@
 import { AACTree, AACSemanticCategory, AACSemanticIntent } from '../../core/treeStructure';
-import { ProcessorInput } from '../../utils/io';
+import { FileAdapter, ProcessorInput } from '../../utils/io';
 /**
  * Build a map of button IDs to resolved image entries for a specific page.
  * Mirrors the Grid helper for consumers that expect image reference data.
@@ -16,7 +16,7 @@ export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
  * @param entryPath Symbol identifier (e.g., "SYM:12345")
  * @returns Image data buffer or null if not found
  */
-export declare function openImage(dbOrFile: ProcessorInput, entryPath: string): Buffer | null;
+export declare function openImage(dbOrFile: ProcessorInput, entryPath: string, fileAdapter?: FileAdapter): Buffer | null;
 /**
  * Snap package path information
  */
@@ -53,14 +53,14 @@ export interface SnapUsageEntry {
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Array of Snap package path information
  */
-export declare function findSnapPackages(packageNamePattern?: string): SnapPackagePath[];
+export declare function findSnapPackages(packageNamePattern?: string, fileAdapter?: FileAdapter): SnapPackagePath[];
 /**
  * Find the first Snap package path matching the pattern
  * Convenience method for when you expect only one Snap installation
  * @param packageNamePattern Optional pattern to filter package names (default: 'TobiiDynavox')
  * @returns Path to the first matching Snap package, or null if not found
  */
-export declare function findSnapPackagePath(packageNamePattern?: string): string | null;
+export declare function findSnapPackagePath(packageNamePattern?: string, fileAdapter?: FileAdapter): string | null;
 /**
  * Find Snap user directories and their vocab files (.sps/.spb)
  * Typical path:
@@ -68,14 +68,14 @@ export declare function findSnapPackagePath(packageNamePattern?: string): string
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */
-export declare function findSnapUsers(packageNamePattern?: string): SnapUserInfo[];
+export declare function findSnapUsers(packageNamePattern?: string, fileAdapter?: FileAdapter): SnapUserInfo[];
 /**
  * Find vocab files for a specific Snap user (or all users)
  * @param userId Optional user identifier filter (case-sensitive directory name)
  * @param packageNamePattern Optional package filter
  * @returns Array of vocab file paths
  */
-export declare function findSnapUserVocabularies(userId?: string, packageNamePattern?: string): string[];
+export declare function findSnapUserVocabularies(userId?: string, packageNamePattern?: string, fileAdapter?: FileAdapter): string[];
 /**
  * Attempt to find history/analytics files for a Snap user by name
  * Currently searches for files containing "history" under the user directory
@@ -83,7 +83,7 @@ export declare function findSnapUserVocabularies(userId?: string, packageNamePat
  * @param packageNamePattern Optional package filter
  * @returns Array of history file paths (may be empty if not found)
  */
-export declare function findSnapUserHistory(userId: string, packageNamePattern?: string): string[];
+export declare function findSnapUserHistory(userId: string, packageNamePattern?: string, fileAdapter?: FileAdapter): string[];
 /**
  * Check whether TD Snap appears to be installed (Windows only)
  */
@@ -91,7 +91,7 @@ export declare function isSnapInstalled(packageNamePattern?: string): boolean;
 /**
  * Read Snap usage history from a pageset file (.sps/.spb)
  */
-export declare function readSnapUsage(pagesetPath: string): SnapUsageEntry[];
+export declare function readSnapUsage(pagesetPath: string, fileAdapter?: FileAdapter): SnapUsageEntry[];
 /**
  * Read Snap usage history for a user (all pagesets)
  */

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) {
+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 = 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)) {
@@ -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) {
+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 = mkTempDir(join(process.cwd(), 'snap-'));
+        dbPath = join(tempDir, 'temp.sps');
+        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);
+                removePath(dbPath);
+                const dir = dirname(dbPath);
+                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') {
+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 (!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),
                 });
             }
         }
@@ -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);
+function findSnapPackagePath(packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const packages = 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') {
+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 = 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 = (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,8 @@ 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);
+function findSnapUserVocabularies(userId, packageNamePattern = 'TobiiDynavox', fileAdapter) {
+    const users = findSnapUsers(packageNamePattern, fileAdapter).filter((u) => !userId || u.userId === userId);
     return users.flatMap((u) => u.vocabPaths);
 }
 /**
@@ -284,11 +259,12 @@ 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);
+function findSnapUserHistory(userId, packageNamePattern = 'TobiiDynavox', fileAdapter = io_1.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)
@@ -301,10 +277,12 @@ function isSnapInstalled(packageNamePattern = 'TobiiDynavox') {
 /**
  * Read Snap usage history from a pageset file (.sps/.spb)
  */
-function readSnapUsage(pagesetPath) {
-    if (!fs.existsSync(pagesetPath))
+function readSnapUsage(pagesetPath, fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists } = fileAdapter;
+    if (!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();