@willwade/aac-processors 0.0.21 → 0.0.23

package/dist/validation/astericsValidator.js

@@ -0,0 +1,115 @@
+"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.AstericsGridValidator = void 0;
+/* eslint-disable @typescript-eslint/require-await */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const baseValidator_1 = require("./baseValidator");
+/**
+ * Validator for Asterics Grid (.grd) JSON files
+ */
+class AstericsGridValidator extends baseValidator_1.BaseValidator {
+    /**
+     * Validate from disk
+     */
+    static async validateFile(filePath) {
+        const validator = new AstericsGridValidator();
+        const content = fs.readFileSync(filePath);
+        const stats = fs.statSync(filePath);
+        return validator.validate(content, path.basename(filePath), stats.size);
+    }
+    /**
+     * Identify whether the content appears to be an Asterics .grd file
+     */
+    static async identifyFormat(content, filename) {
+        const name = filename.toLowerCase();
+        if (name.endsWith('.grd')) {
+            return true;
+        }
+        try {
+            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            const json = JSON.parse(str);
+            return Array.isArray(json?.grids);
+        }
+        catch {
+            return false;
+        }
+    }
+    async validate(content, filename, filesize) {
+        this.reset();
+        await this.add_check('filename', 'file extension', async () => {
+            if (!filename.toLowerCase().endsWith('.grd')) {
+                this.warn('filename should end with .grd');
+            }
+        });
+        let json = null;
+        await this.add_check('json_parse', 'valid JSON', async () => {
+            try {
+                let str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+                if (str.charCodeAt(0) === 0xfeff) {
+                    str = str.slice(1);
+                }
+                json = JSON.parse(str);
+            }
+            catch (e) {
+                this.err(`Failed to parse JSON: ${e.message}`, true);
+            }
+        });
+        if (!json) {
+            return this.buildResult(filename, filesize, 'asterics');
+        }
+        await this.add_check('grids', 'grids array', async () => {
+            if (!Array.isArray(json.grids) || json.grids.length === 0) {
+                this.err('missing grids array in file', true);
+            }
+        });
+        const grids = Array.isArray(json.grids) ? json.grids.slice(0, 5) : [];
+        grids.forEach((grid, idx) => {
+            const prefix = `grid[${idx}]`;
+            this.add_check_sync(`${prefix}_id`, `${prefix} id`, () => {
+                if (!grid?.id || typeof grid.id !== 'string') {
+                    this.err('grid is missing an id');
+                }
+            });
+            this.add_check_sync(`${prefix}_rows`, `${prefix} rowCount`, () => {
+                if (typeof grid?.rowCount !== 'number' || grid.rowCount <= 0) {
+                    this.err('rowCount must be a positive number');
+                }
+            });
+            this.add_check_sync(`${prefix}_elements`, `${prefix} elements`, () => {
+                if (!Array.isArray(grid?.gridElements)) {
+                    this.err('gridElements must be an array');
+                    return;
+                }
+                if (grid.gridElements.length === 0) {
+                    this.warn('grid has no elements');
+                }
+            });
+        });
+        return this.buildResult(filename, filesize, 'asterics');
+    }
+}
+exports.AstericsGridValidator = AstericsGridValidator;

package/dist/validation/dotValidator.d.ts

@@ -0,0 +1,10 @@
+import { BaseValidator } from './baseValidator';
+import { ValidationResult } from './validationTypes';
+/**
+ * Validator for Graphviz DOT files
+ */
+export declare class DotValidator extends BaseValidator {
+    static validateFile(filePath: string): Promise<ValidationResult>;
+    static identifyFormat(content: any, filename: string): Promise<boolean>;
+    validate(content: Buffer | Uint8Array, filename: string, filesize: number): Promise<ValidationResult>;
+}

package/dist/validation/dotValidator.js

@@ -0,0 +1,113 @@
+"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");
+/**
+ * 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);
+    }
+    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);
+            return str.includes('digraph') || str.includes('->');
+        }
+        catch {
+            return false;
+        }
+    }
+    async validate(content, filename, filesize) {
+        this.reset();
+        await this.add_check('filename', 'file extension', async () => {
+            if (!filename.toLowerCase().endsWith('.dot')) {
+                this.warn('filename should end with .dot');
+            }
+        });
+        let text = '';
+        await this.add_check('text', 'text content', async () => {
+            text = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (!text.trim()) {
+                this.err('DOT file is empty', true);
+            }
+            // Basic control character check
+            const head = text.substring(0, 200);
+            for (let i = 0; i < head.length; i++) {
+                const code = head.charCodeAt(i);
+                if (code === 0) {
+                    this.err('DOT appears to be binary data', true);
+                }
+            }
+        });
+        if (!text) {
+            return this.buildResult(filename, filesize, 'dot');
+        }
+        let nodes = [];
+        let edges = [];
+        await this.add_check('structure', 'graph structure', async () => {
+            const edgeRegex = /"?([^"\s]+)"?\s*->\s*"?([^"\s]+)"?(?:\s*\[label="([^"]+)"\])?/g;
+            let maskedContent = text;
+            let edgeMatch;
+            edges = [];
+            const nodeMap = new Map();
+            while ((edgeMatch = edgeRegex.exec(text)) !== null) {
+                const [fullMatch, from, to, label] = edgeMatch;
+                edges.push({ from, to, label });
+                nodeMap.set(from, { id: from, label: from });
+                nodeMap.set(to, { id: to, label: to });
+                maskedContent = maskedContent.replace(fullMatch, ' '.repeat(fullMatch.length));
+            }
+            const nodeRegex = /"?([^"\s]+)"?\s*\[label="((?:[^"\\]|\\.)*)"\]/g;
+            let nodeMatch;
+            while ((nodeMatch = nodeRegex.exec(maskedContent)) !== null) {
+                const [, id, rawLabel] = nodeMatch;
+                const label = rawLabel.replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+                nodeMap.set(id, { id, label });
+            }
+            nodes = Array.from(nodeMap.values());
+            if (nodes.length === 0 && edges.length === 0) {
+                this.err('no nodes or edges found in DOT content', true);
+            }
+        });
+        await this.add_check('connections', 'navigation edges', async () => {
+            if (edges.length === 0) {
+                this.warn('graph contains no edges; navigation buttons may be missing');
+            }
+        });
+        return this.buildResult(filename, filesize, 'dot');
+    }
+}
+exports.DotValidator = DotValidator;

package/dist/validation/excelValidator.d.ts

@@ -0,0 +1,10 @@
+import { BaseValidator } from './baseValidator';
+import { ValidationResult } from './validationTypes';
+/**
+ * Validator for Excel imports (.xlsx/.xls)
+ */
+export declare class ExcelValidator extends BaseValidator {
+    static validateFile(filePath: string): Promise<ValidationResult>;
+    static identifyFormat(_content: any, filename: string): Promise<boolean>;
+    validate(content: Buffer | Uint8Array, filename: string, filesize: number): Promise<ValidationResult>;
+}

package/dist/validation/excelValidator.js

@@ -0,0 +1,89 @@
+"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.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");
+/**
+ * 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);
+    }
+    static async identifyFormat(_content, filename) {
+        const name = filename.toLowerCase();
+        return name.endsWith('.xlsx') || name.endsWith('.xls');
+    }
+    async validate(content, filename, filesize) {
+        this.reset();
+        const ext = filename.toLowerCase().split('.').pop() || '';
+        await this.add_check('filename', 'file extension', async () => {
+            if (!['xlsx', 'xls'].includes(ext)) {
+                this.warn('filename should end with .xlsx or .xls');
+            }
+        });
+        if (ext === 'xls') {
+            // exceljs cannot parse legacy .xls files
+            await this.add_check('xls_support', 'legacy Excel format', async () => {
+                this.err('legacy .xls files are not supported; please provide .xlsx', true);
+            });
+            return this.buildResult(filename, filesize, 'excel');
+        }
+        const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
+        const workbook = new ExcelJS.Workbook();
+        await this.add_check('open', 'open workbook', async () => {
+            try {
+                await workbook.xlsx.load(buffer);
+            }
+            catch (e) {
+                this.err(`Failed to read Excel workbook: ${e.message}`, true);
+            }
+        });
+        await this.add_check('worksheets', 'worksheets exist', async () => {
+            if (workbook.worksheets.length === 0) {
+                this.err('Excel workbook has no worksheets', true);
+            }
+        });
+        const firstSheet = workbook.worksheets[0];
+        if (firstSheet) {
+            await this.add_check('content', 'worksheet has content', async () => {
+                const rows = firstSheet.actualRowCount || firstSheet.rowCount;
+                const cols = firstSheet.columnCount;
+                if (!rows || !cols) {
+                    this.err('first worksheet is empty', true);
+                }
+            });
+        }
+        return this.buildResult(filename, filesize, 'excel');
+    }
+}
+exports.ExcelValidator = ExcelValidator;

package/dist/validation/index.d.ts

@@ -2,12 +2,25 @@
  * Validation system for AAC processors
  * Provides consistent validation across all supported formats
  */
-export { ValidationError, ValidationCheck, ValidationResult, ValidationOptions, ValidationRule, } from './validationTypes';
+export { ValidationError, ValidationCheck, ValidationResult, ValidationOptions, ValidationRule, ValidationFailureError, buildValidationResultFromMessage, } from './validationTypes';
 export { BaseValidator } from './baseValidator';
 export { ObfValidator } from './obfValidator';
 export { GridsetValidator } from './gridsetValidator';
 export { SnapValidator } from './snapValidator';
 export { TouchChatValidator } from './touchChatValidator';
+export { AstericsGridValidator } from './astericsValidator';
+export { ExcelValidator } from './excelValidator';
+export { OpmlValidator } from './opmlValidator';
+export { DotValidator } from './dotValidator';
+export { ApplePanelsValidator } from './applePanelsValidator';
+export { ObfsetValidator } from './obfsetValidator';
 import { BaseValidator } from './baseValidator';
+import { ValidationResult } from './validationTypes';
 export declare function getValidatorForFormat(format: string): BaseValidator | null;
 export declare function getValidatorForFile(filename: string): BaseValidator | null;
+/**
+ * Convenience helper to validate either a file path or a Buffer/Uint8Array.
+ * 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>;

package/dist/validation/index.js

@@ -3,12 +3,38 @@
  * 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.TouchChatValidator = exports.SnapValidator = exports.GridsetValidator = exports.ObfValidator = exports.BaseValidator = exports.ValidationError = void 0;
+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;
 exports.getValidatorForFile = getValidatorForFile;
+exports.validateFileOrBuffer = validateFileOrBuffer;
 var validationTypes_1 = require("./validationTypes");
 Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return validationTypes_1.ValidationError; } });
+Object.defineProperty(exports, "ValidationFailureError", { enumerable: true, get: function () { return validationTypes_1.ValidationFailureError; } });
+Object.defineProperty(exports, "buildValidationResultFromMessage", { enumerable: true, get: function () { return validationTypes_1.buildValidationResultFromMessage; } });
 var baseValidator_1 = require("./baseValidator");
 Object.defineProperty(exports, "BaseValidator", { enumerable: true, get: function () { return baseValidator_1.BaseValidator; } });
 // Individual format validators
@@ -20,6 +46,18 @@ var snapValidator_1 = require("./snapValidator");
 Object.defineProperty(exports, "SnapValidator", { enumerable: true, get: function () { return snapValidator_1.SnapValidator; } });
 var touchChatValidator_1 = require("./touchChatValidator");
 Object.defineProperty(exports, "TouchChatValidator", { enumerable: true, get: function () { return touchChatValidator_1.TouchChatValidator; } });
+var astericsValidator_1 = require("./astericsValidator");
+Object.defineProperty(exports, "AstericsGridValidator", { enumerable: true, get: function () { return astericsValidator_1.AstericsGridValidator; } });
+var excelValidator_1 = require("./excelValidator");
+Object.defineProperty(exports, "ExcelValidator", { enumerable: true, get: function () { return excelValidator_1.ExcelValidator; } });
+var opmlValidator_1 = require("./opmlValidator");
+Object.defineProperty(exports, "OpmlValidator", { enumerable: true, get: function () { return opmlValidator_1.OpmlValidator; } });
+var dotValidator_1 = require("./dotValidator");
+Object.defineProperty(exports, "DotValidator", { enumerable: true, get: function () { return dotValidator_1.DotValidator; } });
+var applePanelsValidator_1 = require("./applePanelsValidator");
+Object.defineProperty(exports, "ApplePanelsValidator", { enumerable: true, get: function () { return applePanelsValidator_1.ApplePanelsValidator; } });
+var obfsetValidator_1 = require("./obfsetValidator");
+Object.defineProperty(exports, "ObfsetValidator", { enumerable: true, get: function () { return obfsetValidator_1.ObfsetValidator; } });
 /**
  * Main validator factory
  * Returns the appropriate validator for a given format
@@ -28,6 +66,14 @@ const obfValidator_2 = require("./obfValidator");
 const gridsetValidator_2 = require("./gridsetValidator");
 const snapValidator_2 = require("./snapValidator");
 const touchChatValidator_2 = require("./touchChatValidator");
+const astericsValidator_2 = require("./astericsValidator");
+const excelValidator_2 = require("./excelValidator");
+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"));
 function getValidatorForFormat(format) {
     switch (format.toLowerCase()) {
         case 'obf':
@@ -43,6 +89,23 @@ function getValidatorForFormat(format) {
         case 'touchchat':
         case 'ce':
             return new touchChatValidator_2.TouchChatValidator();
+        case 'asterics':
+        case 'grd':
+            return new astericsValidator_2.AstericsGridValidator();
+        case 'excel':
+        case 'xlsx':
+        case 'xls':
+            return new excelValidator_2.ExcelValidator();
+        case 'opml':
+            return new opmlValidator_2.OpmlValidator();
+        case 'dot':
+            return new dotValidator_2.DotValidator();
+        case 'applepanels':
+        case 'plist':
+        case 'ascconfig':
+            return new applePanelsValidator_2.ApplePanelsValidator();
+        case 'obfset':
+            return new obfsetValidator_2.ObfsetValidator();
         default:
             return null;
     }
@@ -63,7 +126,47 @@ function getValidatorForFile(filename) {
             return new snapValidator_2.SnapValidator();
         case 'ce':
             return new touchChatValidator_2.TouchChatValidator();
+        case 'grd':
+            return new astericsValidator_2.AstericsGridValidator();
+        case 'xlsx':
+        case 'xls':
+            return new excelValidator_2.ExcelValidator();
+        case 'opml':
+            return new opmlValidator_2.OpmlValidator();
+        case 'dot':
+            return new dotValidator_2.DotValidator();
+        case 'plist':
+        case 'ascconfig':
+            return new applePanelsValidator_2.ApplePanelsValidator();
+        case 'obfset':
+            return new obfsetValidator_2.ObfsetValidator();
         default:
             return null;
     }
 }
+/**
+ * Convenience helper to validate either a file path or a Buffer/Uint8Array.
+ * When a file path is provided, any validator-specific validateFile() helper
+ * will be used if available to access nested resources.
+ */
+async function validateFileOrBuffer(filePathOrBuffer, filenameHint) {
+    const isPath = typeof filePathOrBuffer === 'string';
+    const name = filenameHint || (isPath ? path.basename(filePathOrBuffer) : 'upload');
+    const validator = getValidatorForFile(name) || getValidatorForFormat(name);
+    if (!validator) {
+        throw new Error(`No validator registered for ${name}`);
+    }
+    if (isPath) {
+        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 buffer = Buffer.isBuffer(filePathOrBuffer)
+        ? filePathOrBuffer
+        : Buffer.from(filePathOrBuffer);
+    return validator.validate(buffer, name, buffer.byteLength);
+}

package/dist/validation/obfsetValidator.d.ts

@@ -0,0 +1,10 @@
+import { BaseValidator } from './baseValidator';
+import { ValidationResult } from './validationTypes';
+/**
+ * Validator for OBF set bundles (.obfset) - JSON arrays of boards
+ */
+export declare class ObfsetValidator extends BaseValidator {
+    static validateFile(filePath: string): Promise<ValidationResult>;
+    static identifyFormat(content: any, filename: string): Promise<boolean>;
+    validate(content: Buffer | Uint8Array, filename: string, filesize: number): Promise<ValidationResult>;
+}

package/dist/validation/obfsetValidator.js

@@ -0,0 +1,103 @@
+"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");
+/**
+ * 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);
+    }
+    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);
+            const parsed = JSON.parse(str);
+            return Array.isArray(parsed);
+        }
+        catch {
+            return false;
+        }
+    }
+    async validate(content, filename, filesize) {
+        this.reset();
+        await this.add_check('filename', 'file extension', async () => {
+            if (!filename.toLowerCase().endsWith('.obfset')) {
+                this.warn('filename should end with .obfset');
+            }
+        });
+        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 parsed = JSON.parse(str);
+                if (!Array.isArray(parsed)) {
+                    this.err('root must be a JSON array of boards', true);
+                }
+                else {
+                    boards = parsed;
+                }
+            }
+            catch (e) {
+                this.err(`Failed to parse JSON: ${e.message}`, true);
+            }
+        });
+        if (!boards) {
+            return this.buildResult(filename, filesize, 'obfset');
+        }
+        const safeBoards = boards;
+        safeBoards.slice(0, 5).forEach((board, idx) => {
+            const prefix = `board[${idx}]`;
+            this.add_check_sync(`${prefix}_id`, `${prefix} id`, () => {
+                if (!board?.id) {
+                    this.err('board is missing id');
+                }
+            });
+            this.add_check_sync(`${prefix}_buttons`, `${prefix} buttons`, () => {
+                if (!Array.isArray(board?.buttons)) {
+                    this.warn('board has no buttons array');
+                }
+            });
+            this.add_check_sync(`${prefix}_grid`, `${prefix} grid definition`, () => {
+                const grid = board?.grid;
+                if (!grid || typeof grid.rows !== 'number' || typeof grid.columns !== 'number') {
+                    this.warn('grid rows/columns missing; layout may be invalid');
+                }
+            });
+        });
+        return this.buildResult(filename, filesize, 'obfset');
+    }
+}
+exports.ObfsetValidator = ObfsetValidator;

package/dist/validation/opmlValidator.d.ts

@@ -0,0 +1,10 @@
+import { BaseValidator } from './baseValidator';
+import { ValidationResult } from './validationTypes';
+/**
+ * Validator for OPML files
+ */
+export declare class OpmlValidator extends BaseValidator {
+    static validateFile(filePath: string): Promise<ValidationResult>;
+    static identifyFormat(content: any, filename: string): Promise<boolean>;
+    validate(content: Buffer | Uint8Array, filename: string, filesize: number): Promise<ValidationResult>;
+}