@willwade/aac-processors 0.1.5 → 0.1.7

package/dist/validation/dotValidator.js

@@ -1,49 +1,30 @@
 "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.DotValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Graphviz DOT files
  */
 class DotValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new DotValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(content, filename) {
         const name = filename.toLowerCase();
         if (name.endsWith('.dot'))
             return true;
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             return str.includes('digraph') || str.includes('->');
         }
         catch {
@@ -59,7 +40,7 @@ class DotValidator extends baseValidator_1.BaseValidator {
         });
         let text = '';
         await this.add_check('text', 'text content', async () => {
-            text = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            text = (0, io_1.decodeText)(content);
             if (!text.trim()) {
                 this.err('DOT file is empty', true);
             }

package/dist/validation/excelValidator.js

@@ -25,19 +25,18 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExcelValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const ExcelJS = __importStar(require("exceljs"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Excel imports (.xlsx/.xls)
  */
 class ExcelValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new ExcelValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(_content, filename) {
         const name = filename.toLowerCase();
@@ -58,7 +57,7 @@ class ExcelValidator extends baseValidator_1.BaseValidator {
             });
             return this.buildResult(filename, filesize, 'excel');
         }
-        const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
+        const buffer = typeof Buffer !== 'undefined' && Buffer.isBuffer(content) ? content : (0, io_1.toArrayBuffer)(content);
         const workbook = new ExcelJS.Workbook();
         await this.add_check('open', 'open workbook', async () => {
             try {

package/dist/validation/gridsetValidator.js

@@ -1,4 +1,27 @@
 "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 };
 };
@@ -8,24 +31,9 @@ exports.GridsetValidator = void 0;
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
 const jszip_1 = __importDefault(require("jszip"));
+const xml2js = __importStar(require("xml2js"));
 const baseValidator_1 = require("./baseValidator");
 const io_1 = require("../utils/io");
-let cachedXml2js = null;
-function getXml2js() {
-    if (cachedXml2js)
-        return cachedXml2js;
-    try {
-        const nodeRequire = (0, io_1.getNodeRequire)();
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const module = nodeRequire('xml2js');
-        const resolved = module.default || module;
-        cachedXml2js = resolved;
-        return resolved;
-    }
-    catch {
-        throw new Error('Validator requires Xml2js in this environment.');
-    }
-}
 /**
  * Validator for Grid3/Smartbox Gridset files (.gridset, .gridsetx)
  */
@@ -39,10 +47,9 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new GridsetValidator();
         const fs = (0, io_1.getFs)();
-        const path = (0, io_1.getPath)();
         const content = fs.readFileSync(filePath);
         const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is Gridset format
@@ -54,8 +61,7 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as XML and check for gridset structure
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString('utf-8') : content;
-            const xml2js = getXml2js();
+            const contentStr = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const parser = new xml2js.Parser();
             const result = await parser.parseStringPromise(contentStr);
             return result && (result.gridset || result.Gridset);
@@ -108,9 +114,8 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
         let xmlObj = null;
         await this.add_check('xml_parse', 'valid XML', async () => {
             try {
-                const xml2js = getXml2js();
                 const parser = new xml2js.Parser();
-                const contentStr = content.toString('utf-8');
+                const contentStr = (0, io_1.decodeText)(content);
                 xmlObj = await parser.parseStringPromise(contentStr);
             }
             catch (e) {
@@ -135,7 +140,7 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
     async validateZipArchive(content, filename, _filesize) {
         let zip;
         try {
-            zip = await jszip_1.default.loadAsync(Buffer.from(content));
+            zip = await jszip_1.default.loadAsync((0, io_1.toUint8Array)(content));
         }
         catch (e) {
             this.err(`Failed to open ZIP archive: ${e.message}`, true);
@@ -151,7 +156,6 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
             else {
                 try {
                     const gridsetXml = await gridsetEntry.async('string');
-                    const xml2js = getXml2js();
                     const parser = new xml2js.Parser();
                     const xmlObj = await parser.parseStringPromise(gridsetXml);
                     const gridset = xmlObj.gridset || xmlObj.Gridset;
@@ -159,7 +163,7 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
                         this.err('Invalid gridset.xml structure', true);
                     }
                     else {
-                        await this.validateGridsetStructure(gridset, filename, Buffer.from(gridsetXml));
+                        await this.validateGridsetStructure(gridset, filename, new Uint8Array());
                     }
                 }
                 catch (e) {
@@ -176,7 +180,6 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
             else {
                 try {
                     const settingsXml = await settingsEntry.async('string');
-                    const xml2js = getXml2js();
                     const parser = new xml2js.Parser();
                     const xmlObj = await parser.parseStringPromise(settingsXml);
                     const settings = xmlObj.GridSetSettings || xmlObj.gridSetSettings || xmlObj.GridsetSettings;

package/dist/validation/index.d.ts

@@ -16,6 +16,7 @@ export { ApplePanelsValidator } from './applePanelsValidator';
 export { ObfsetValidator } from './obfsetValidator';
 import { BaseValidator } from './baseValidator';
 import { ValidationResult } from './validationTypes';
+import { type ProcessorInput } from '../utils/io';
 export declare function getValidatorForFormat(format: string): BaseValidator | null;
 export declare function getValidatorForFile(filename: string): BaseValidator | null;
 /**
@@ -23,4 +24,4 @@ export declare function getValidatorForFile(filename: string): BaseValidator | n
  * When a file path is provided, any validator-specific validateFile() helper
  * will be used if available to access nested resources.
  */
-export declare function validateFileOrBuffer(filePathOrBuffer: string | Buffer, filenameHint?: string): Promise<ValidationResult>;
+export declare function validateFileOrBuffer(filePathOrBuffer: ProcessorInput, filenameHint?: string): Promise<ValidationResult>;

package/dist/validation/index.js

@@ -3,29 +3,6 @@
  * Validation system for AAC processors
  * Provides consistent validation across all supported formats
  */
-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.ObfsetValidator = exports.ApplePanelsValidator = exports.DotValidator = exports.OpmlValidator = exports.ExcelValidator = exports.AstericsGridValidator = exports.TouchChatValidator = exports.SnapValidator = exports.GridsetValidator = exports.ObfValidator = exports.BaseValidator = exports.buildValidationResultFromMessage = exports.ValidationFailureError = exports.ValidationError = void 0;
 exports.getValidatorForFormat = getValidatorForFormat;
@@ -72,8 +49,7 @@ const opmlValidator_2 = require("./opmlValidator");
 const dotValidator_2 = require("./dotValidator");
 const applePanelsValidator_2 = require("./applePanelsValidator");
 const obfsetValidator_2 = require("./obfsetValidator");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+const io_1 = require("../utils/io");
 function getValidatorForFormat(format) {
     switch (format.toLowerCase()) {
         case 'obf':
@@ -151,22 +127,23 @@ function getValidatorForFile(filename) {
  */
 async function validateFileOrBuffer(filePathOrBuffer, filenameHint) {
     const isPath = typeof filePathOrBuffer === 'string';
-    const name = filenameHint || (isPath ? path.basename(filePathOrBuffer) : 'upload');
+    const name = filenameHint || (isPath ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload');
     const validator = getValidatorForFile(name) || getValidatorForFormat(name);
     if (!validator) {
         throw new Error(`No validator registered for ${name}`);
     }
     if (isPath) {
+        if (!(0, io_1.isNodeRuntime)()) {
+            throw new Error('File path validation is only supported in Node.js environments.');
+        }
         const ctor = validator.constructor;
         if (typeof ctor.validateFile === 'function') {
             return ctor.validateFile(filePathOrBuffer);
         }
-        const buf = fs.readFileSync(filePathOrBuffer);
-        const stats = fs.statSync(filePathOrBuffer);
-        return validator.validate(buf, path.basename(filePathOrBuffer), stats.size);
+        const buf = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+        const stats = (0, io_1.getFs)().statSync(filePathOrBuffer);
+        return validator.validate(buf, (0, io_1.getBasename)(filePathOrBuffer), stats.size);
     }
-    const buffer = Buffer.isBuffer(filePathOrBuffer)
-        ? filePathOrBuffer
-        : Buffer.from(filePathOrBuffer);
+    const buffer = (0, io_1.toUint8Array)(filePathOrBuffer);
     return validator.validate(buffer, name, buffer.byteLength);
 }

package/dist/validation/obfValidator.js

@@ -28,7 +28,7 @@ class ObfValidator extends baseValidator_1.BaseValidator {
         const validator = new ObfValidator();
         const content = (0, io_1.readBinaryFromInput)(filePath);
         const stats = (0, io_1.getFs)().statSync(filePath);
-        return validator.validate(content, (0, io_1.getPath)().basename(filePath), stats.size);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is OBF format
@@ -40,7 +40,12 @@ class ObfValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as JSON and check format
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString() : content;
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const contentStr = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const json = JSON.parse(contentStr);
             return json && json.format && json.format.startsWith('open-board-');
         }
@@ -74,7 +79,7 @@ class ObfValidator extends baseValidator_1.BaseValidator {
         let json = null;
         await this.add_check('valid_json', 'JSON file', async () => {
             try {
-                json = JSON.parse(content.toString());
+                json = JSON.parse((0, io_1.decodeText)(content));
             }
             catch {
                 this.err("Couldn't parse as JSON", true);

package/dist/validation/obfsetValidator.js

@@ -1,49 +1,30 @@
 "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.ObfsetValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for OBF set bundles (.obfset) - JSON arrays of boards
  */
 class ObfsetValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new ObfsetValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(content, filename) {
         const name = filename.toLowerCase();
         if (name.endsWith('.obfset'))
             return true;
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const parsed = JSON.parse(str);
             return Array.isArray(parsed);
         }
@@ -61,7 +42,7 @@ class ObfsetValidator extends baseValidator_1.BaseValidator {
         let boards = null;
         await this.add_check('json_parse', 'valid JSON array', async () => {
             try {
-                const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+                const str = (0, io_1.decodeText)(content);
                 const parsed = JSON.parse(str);
                 if (!Array.isArray(parsed)) {
                     this.err('root must be a JSON array of boards', true);

package/dist/validation/opmlValidator.js

@@ -1,43 +1,19 @@
 "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.OpmlValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const fast_xml_parser_1 = require("fast-xml-parser");
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for OPML files
  */
 class OpmlValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new OpmlValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(content, filename) {
         const name = filename.toLowerCase();
@@ -45,7 +21,12 @@ class OpmlValidator extends baseValidator_1.BaseValidator {
             return true;
         }
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const validation = fast_xml_parser_1.XMLValidator.validate(str);
             if (validation !== true) {
                 return false;
@@ -68,7 +49,7 @@ class OpmlValidator extends baseValidator_1.BaseValidator {
         });
         let text = '';
         await this.add_check('content', 'non-empty content', async () => {
-            text = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            text = (0, io_1.decodeText)(content);
             if (!text.trim()) {
                 this.err('OPML file is empty', true);
             }

package/dist/validation/snapValidator.js

@@ -29,11 +29,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SnapValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const xml2js = __importStar(require("xml2js"));
 const jszip_1 = __importDefault(require("jszip"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Snap files (.spb, .sps)
  * Snap files are zipped packages containing XML configuration
@@ -47,9 +46,9 @@ class SnapValidator extends baseValidator_1.BaseValidator {
      */
     static async validateFile(filePath) {
         const validator = new SnapValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is Snap format
@@ -62,8 +61,7 @@ class SnapValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as ZIP and check for Snap structure
         try {
-            const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-            const zip = await jszip_1.default.loadAsync(buffer);
+            const zip = await jszip_1.default.loadAsync((0, io_1.toUint8Array)(content));
             const entries = Object.values(zip.files).filter((entry) => !entry.dir);
             return entries.some((entry) => entry.name.includes('settings') || entry.name.includes('.xml'));
         }
@@ -85,8 +83,7 @@ class SnapValidator extends baseValidator_1.BaseValidator {
         let validZip = false;
         await this.add_check('zip', 'valid zip package', async () => {
             try {
-                const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-                zip = await jszip_1.default.loadAsync(buffer);
+                zip = await jszip_1.default.loadAsync((0, io_1.toUint8Array)(content));
                 const entries = Object.values(zip.files);
                 validZip = entries.length > 0;
             }

package/dist/validation/touchChatValidator.js

@@ -27,10 +27,9 @@ exports.TouchChatValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const xml2js = __importStar(require("xml2js"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for TouchChat files (.ce)
  * TouchChat files are XML-based
@@ -44,9 +43,9 @@ class TouchChatValidator extends baseValidator_1.BaseValidator {
      */
     static async validateFile(filePath) {
         const validator = new TouchChatValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is TouchChat format
@@ -58,7 +57,7 @@ class TouchChatValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as XML and check for TouchChat structure
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString('utf-8') : content;
+            const contentStr = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const parser = new xml2js.Parser();
             const result = await parser.parseStringPromise(contentStr);
             // TouchChat files typically have specific structure
@@ -82,7 +81,7 @@ class TouchChatValidator extends baseValidator_1.BaseValidator {
         await this.add_check('xml_parse', 'valid XML', async () => {
             try {
                 const parser = new xml2js.Parser();
-                const contentStr = content.toString('utf-8');
+                const contentStr = (0, io_1.decodeText)(content);
                 xmlObj = await parser.parseStringPromise(contentStr);
             }
             catch (e) {

package/docs/BROWSER_USAGE.md

@@ -565,14 +565,7 @@ async function safeLoadFile(file) {
 
 ## Testing
 
-See [Browser Test Page](../examples/browser-test.html) for interactive testing.
-
-To run the test server:
-```bash
-node examples/browser-test-server.js
-```
-
-Then open: http://localhost:8080/examples/browser-test.html
+Use the Vite demo in `examples/vitedemo` for interactive browser testing.
 
 ## Troubleshooting
 
@@ -614,5 +607,4 @@ await processor.loadIntoTree(uint8Array);
 
 - [API Documentation](./API.md)
 - [Examples](../examples/)
-- [Browser Test Page](../examples/browser-test.html)
-- [Test Server](../examples/browser-test-server.js)
+- [Vite Browser Demo](../examples/vitedemo)