@willwade/aac-processors 0.0.30 → 0.1.0

package/dist/processors/dotProcessor.js

@@ -1,15 +1,11 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DotProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
 // Removed unused import: FileProcessor
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const validation_1 = require("../validation");
+const validationTypes_1 = require("../validation/validationTypes");
+const io_1 = require("../utils/io");
 class DotProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
@@ -55,10 +51,9 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         }
         return { nodes: Array.from(nodes.values()), edges };
     }
-    extractTexts(filePathOrBuffer) {
-        const content = typeof filePathOrBuffer === 'string'
-            ? fs_1.default.readFileSync(filePathOrBuffer, 'utf8')
-            : filePathOrBuffer.toString('utf8');
+    async extractTexts(filePathOrBuffer) {
+        await Promise.resolve();
+        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         const { nodes, edges } = this.parseDotFile(content);
         const texts = [];
         // Collect node labels
@@ -73,16 +68,15 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         }
         return texts;
     }
-    loadIntoTree(filePathOrBuffer) {
-        const filename = typeof filePathOrBuffer === 'string' ? path_1.default.basename(filePathOrBuffer) : 'upload.dot';
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
+    async loadIntoTree(filePathOrBuffer) {
+        await Promise.resolve();
+        const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.dot';
+        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
         const filesize = buffer.byteLength;
         try {
-            const content = buffer.toString('utf8');
+            const content = (0, io_1.readTextFromInput)(buffer);
             if (!content || content.trim().length === 0) {
-                const validation = (0, validation_1.buildValidationResultFromMessage)({
+                const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
                     filesize,
                     format: 'dot',
@@ -90,14 +84,14 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                     type: 'content',
                     description: 'DOT file content',
                 });
-                throw new validation_1.ValidationFailureError('Empty DOT content', validation);
+                throw new validationTypes_1.ValidationFailureError('Empty DOT content', validation);
             }
             // Check for binary data (contains null bytes or non-printable characters)
             const head = content.substring(0, 100);
             for (let i = 0; i < head.length; i++) {
                 const code = head.charCodeAt(i);
                 if (code === 0 || (code >= 0 && code <= 8) || (code >= 14 && code <= 31)) {
-                    const validation = (0, validation_1.buildValidationResultFromMessage)({
+                    const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                         filename,
                         filesize,
                         format: 'dot',
@@ -105,7 +99,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                         type: 'content',
                         description: 'DOT file content',
                     });
-                    throw new validation_1.ValidationFailureError('Invalid DOT content', validation);
+                    throw new validationTypes_1.ValidationFailureError('Invalid DOT content', validation);
                 }
             }
             const { nodes, edges } = this.parseDotFile(content);
@@ -149,10 +143,10 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             return tree;
         }
         catch (error) {
-            if (error instanceof validation_1.ValidationFailureError) {
+            if (error instanceof validationTypes_1.ValidationFailureError) {
                 throw error;
             }
-            const validation = (0, validation_1.buildValidationResultFromMessage)({
+            const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                 filename,
                 filesize,
                 format: 'dot',
@@ -160,14 +154,12 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                 type: 'parse',
                 description: 'Parse DOT graph',
             });
-            throw new validation_1.ValidationFailureError('Failed to load DOT file', validation, error);
+            throw new validationTypes_1.ValidationFailureError('Failed to load DOT file', validation, error);
         }
     }
-    processTexts(filePathOrBuffer, translations, outputPath) {
-        const safeBuffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
-        const content = safeBuffer.toString('utf8');
+    async processTexts(filePathOrBuffer, translations, outputPath) {
+        await Promise.resolve();
+        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         let translatedContent = content;
         translations.forEach((translation, text) => {
             if (typeof text === 'string' && typeof translation === 'string') {
@@ -177,12 +169,12 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                 translatedContent = translatedContent.replace(new RegExp(`label="${escapedText}"`, 'g'), `label="${escapedTranslation}"`);
             }
         });
-        const resultBuffer = Buffer.from(translatedContent || '', 'utf8');
-        // Save to output path
-        fs_1.default.writeFileSync(outputPath, resultBuffer);
+        const resultBuffer = (0, io_1.encodeText)(translatedContent || '');
+        (0, io_1.writeBinaryToPath)(outputPath, resultBuffer);
         return resultBuffer;
     }
-    saveFromTree(tree, _outputPath) {
+    async saveFromTree(tree, _outputPath) {
+        await Promise.resolve();
         let dotContent = `digraph "${tree.metadata?.name || 'AACBoard'}" {\n`;
         // Helper to escape DOT string
         const escapeDotString = (str) => {
@@ -212,7 +204,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             });
         }
         dotContent += '}\n';
-        fs_1.default.writeFileSync(_outputPath, dotContent);
+        (0, io_1.writeTextToPath)(_outputPath, dotContent);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

package/dist/processors/excelProcessor.d.ts

@@ -1,3 +1,4 @@
+import { ProcessorInput } from '../utils/io';
 import { BaseProcessor, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
 /**
@@ -12,13 +13,13 @@ export declare class ExcelProcessor extends BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns Array of all text content found in the Excel file
      */
-    extractTexts(_filePathOrBuffer: string | Buffer): string[];
+    extractTexts(_filePathOrBuffer: ProcessorInput): Promise<string[]>;
     /**
      * Load Excel file into AACTree structure
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns AACTree representation of the Excel file
      */
-    loadIntoTree(_filePathOrBuffer: string | Buffer): AACTree;
+    loadIntoTree(_filePathOrBuffer: ProcessorInput): Promise<AACTree>;
     /**
      * Process texts in Excel file (apply translations)
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
@@ -26,7 +27,7 @@ export declare class ExcelProcessor extends BaseProcessor {
      * @param outputPath - Path where translated Excel file should be saved
      * @returns Buffer containing the translated Excel file
      */
-    processTexts(_filePathOrBuffer: string | Buffer, _translations: Map<string, string>, outputPath: string): Buffer;
+    processTexts(_filePathOrBuffer: ProcessorInput, _translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
     /**
      * Convert an AAC page to an Excel worksheet
      * @param workbook - Excel workbook to add worksheet to

package/dist/processors/excelProcessor.js

@@ -43,7 +43,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns Array of all text content found in the Excel file
      */
-    extractTexts(_filePathOrBuffer) {
+    async extractTexts(_filePathOrBuffer) {
+        await Promise.resolve();
         console.warn('ExcelProcessor.extractTexts is not implemented yet.');
         return [];
     }
@@ -52,7 +53,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns AACTree representation of the Excel file
      */
-    loadIntoTree(_filePathOrBuffer) {
+    async loadIntoTree(_filePathOrBuffer) {
+        await Promise.resolve();
         console.warn('ExcelProcessor.loadIntoTree is not implemented yet.');
         const tree = new treeStructure_1.AACTree();
         tree.metadata.format = 'excel';
@@ -65,7 +67,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * @param outputPath - Path where translated Excel file should be saved
      * @returns Buffer containing the translated Excel file
      */
-    processTexts(_filePathOrBuffer, _translations, outputPath) {
+    async processTexts(_filePathOrBuffer, _translations, outputPath) {
+        await Promise.resolve();
         console.warn('ExcelProcessor.processTexts is not implemented yet.');
         const outputDir = path_1.default.dirname(outputPath);
         if (!fs_1.default.existsSync(outputDir)) {

package/dist/processors/gridset/crypto.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Crypto utilities for Gridsetx (encrypted Grid3 files)
+ * This module is only needed for .gridsetx files and uses Node-only crypto/zlib
+ */
+/**
+ * Decrypt and inflate a Grid3 encrypted payload (DesktopContentEncrypter).
+ * Uses AES-256-CBC with key/IV derived from the password padded with spaces
+ * and then Deflate decompression.
+ *
+ * @param buffer - Encrypted buffer
+ * @param password - Password (defaults to 'Chocolate')
+ * @returns Decrypted and inflated buffer
+ */
+export declare function decryptGridsetEntry(buffer: Buffer, password?: string): Buffer;
+/**
+ * Check if crypto operations are available in the current environment
+ */
+export declare function isCryptoAvailable(): boolean;

package/dist/processors/gridset/crypto.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Crypto utilities for Gridsetx (encrypted Grid3 files)
+ * This module is only needed for .gridsetx files and uses Node-only crypto/zlib
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decryptGridsetEntry = decryptGridsetEntry;
+exports.isCryptoAvailable = isCryptoAvailable;
+/**
+ * Decrypt and inflate a Grid3 encrypted payload (DesktopContentEncrypter).
+ * Uses AES-256-CBC with key/IV derived from the password padded with spaces
+ * and then Deflate decompression.
+ *
+ * @param buffer - Encrypted buffer
+ * @param password - Password (defaults to 'Chocolate')
+ * @returns Decrypted and inflated buffer
+ */
+function decryptGridsetEntry(buffer, password) {
+    // Dynamic require to avoid breaking in browser environments
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-return
+    const crypto = require('crypto');
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-return
+    const zlib = require('zlib');
+    const pwd = (password || 'Chocolate').padEnd(32, ' ');
+    const key = Buffer.from(pwd.slice(0, 32), 'utf8');
+    const iv = Buffer.from(pwd.slice(0, 16), 'utf8');
+    try {
+        const decipher = crypto.createDecipheriv('aes-256-cbc', key, iv);
+        const decrypted = Buffer.concat([decipher.update(buffer), decipher.final()]);
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return zlib.inflateSync(decrypted);
+        }
+        catch {
+            // If data isn't deflated, return raw decrypted bytes
+            return decrypted;
+        }
+    }
+    catch {
+        return buffer;
+    }
+}
+/**
+ * Check if crypto operations are available in the current environment
+ */
+function isCryptoAvailable() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('crypto');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('zlib');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

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

@@ -15,7 +15,7 @@ export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-export declare function openImage(gridsetBuffer: Buffer, entryPath: string, password?: string | undefined): Buffer | null;
+export declare function openImage(gridsetBuffer: Uint8Array, entryPath: string, password?: string | undefined): Promise<Uint8Array | null>;
 /**
  * Generate a random GUID for Grid3 elements
  * Grid3 uses GUIDs for grid identification

package/dist/processors/gridset/helpers.js

@@ -42,7 +42,6 @@ exports.isGrid3Installed = isGrid3Installed;
 exports.readGrid3History = readGrid3History;
 exports.readGrid3HistoryForUser = readGrid3HistoryForUser;
 exports.readAllGrid3History = readAllGrid3History;
-const adm_zip_1 = __importDefault(require("adm-zip"));
 const fast_xml_parser_1 = require("fast-xml-parser");
 const treeStructure_1 = require("../../core/treeStructure");
 const fs = __importStar(require("fs"));
@@ -96,14 +95,25 @@ function getAllowedImageEntries(tree) {
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-function openImage(gridsetBuffer, entryPath, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
-    const zip = new adm_zip_1.default(gridsetBuffer);
-    const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
-    const want = normalizeZipPath(entryPath);
-    const entry = entries.find((e) => normalizeZipPath(e.entryName) === want);
-    if (!entry)
+async function openImage(gridsetBuffer, entryPath, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const JSZip = require('jszip');
+        const zip = await JSZip.loadAsync(gridsetBuffer);
+        const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
+        const want = normalizeZipPath(entryPath);
+        const entry = entries.find((e) => normalizeZipPath(e.entryName) === want);
+        if (!entry)
+            return null;
+        const data = await entry.getData();
+        if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {
+            return Buffer.from(data);
+        }
+        return data;
+    }
+    catch (error) {
         return null;
-    return entry.getData();
+    }
 }
 /**
  * Generate a random GUID for Grid3 elements

package/dist/processors/gridset/password.d.ts

@@ -1,11 +1,28 @@
+import type JSZip from 'jszip';
 import { ProcessorOptions } from '../../core/baseProcessor';
-import AdmZip from 'adm-zip';
+import { ProcessorInput } from '../../utils/io';
 /**
  * Resolve the password to use for Grid3 archives.
  * Preference order:
  * 1. Explicit processor option
  * 2. GRIDSET_PASSWORD env var
  */
-export declare function resolveGridsetPassword(options?: ProcessorOptions, source?: string | Buffer): string | undefined;
+export declare function resolveGridsetPassword(options?: ProcessorOptions, source?: ProcessorInput): string | undefined;
 export declare function resolveGridsetPasswordFromEnv(): string | undefined;
-export declare function getZipEntriesWithPassword(zip: AdmZip, password?: string): AdmZip.IZipEntry[];
+/**
+ * Get zip entries as an array from JSZip instance.
+ * JSZip doesn't have password protection at the entry level like AdmZip.
+ * Password protection for .gridsetx is handled at the archive level in crypto.ts.
+ *
+ * @param zip - JSZip instance
+ * @param password - Optional password (kept for API compatibility, not used with JSZip)
+ * @returns Array of entry objects with name and data
+ */
+type ZipEntry = {
+    name: string;
+    entryName: string;
+    dir: boolean;
+    getData: () => Promise<Uint8Array>;
+};
+export declare function getZipEntriesWithPassword(zip: JSZip, password?: string): ZipEntry[];
+export {};

package/dist/processors/gridset/password.js

@@ -28,10 +28,24 @@ function resolveGridsetPassword(options, source) {
 function resolveGridsetPasswordFromEnv() {
     return process.env.GRIDSET_PASSWORD;
 }
-// Wrapper to set the password before reading entries (typed getEntries lacks the optional arg)
 function getZipEntriesWithPassword(zip, password) {
+    const entries = [];
+    // Note: JSZip doesn't support zip-level password protection like AdmZip
+    // Password protection for .gridsetx files is handled at the encrypted archive level
+    // in crypto.ts before the zip is loaded
     if (password) {
-        return zip.getEntries(password);
+        console.warn('JSZip does not support zip-level password protection. For .gridsetx encrypted files, password is handled at the archive level.');
     }
-    return zip.getEntries();
+    zip.forEach((relativePath, file) => {
+        entries.push({
+            name: relativePath,
+            entryName: relativePath,
+            dir: file.dir || false,
+            getData: async () => {
+                // Use 'uint8array' which is supported everywhere
+                return await file.async('uint8array');
+            },
+        });
+    });
+    return entries;
 }

package/dist/processors/gridset/wordlistHelpers.d.ts

@@ -59,12 +59,12 @@ export declare function wordlistToXml(wordlist: WordList): string;
  * @returns Map of grid names to their wordlists (if they have any)
  *
  * @example
- * const wordlists = extractWordlists(gridsetBuffer);
+ * const wordlists = await extractWordlists(gridsetBuffer);
  * wordlists.forEach((wordlist, gridName) => {
  *   console.log(`Grid "${gridName}" has ${wordlist.items.length} items`);
  * });
  */
-export declare function extractWordlists(gridsetBuffer: Buffer, password?: string | undefined): Map<string, WordList>;
+export declare function extractWordlists(gridsetBuffer: Uint8Array, password?: string | undefined): Promise<Map<string, WordList>>;
 /**
  * Updates or adds a wordlist to a specific grid in a gridset
  *
@@ -79,4 +79,4 @@ export declare function extractWordlists(gridsetBuffer: Buffer, password?: strin
  * const updatedGridset = updateWordlist(gridsetBuffer, 'Greetings', newWordlist);
  * fs.writeFileSync('updated-gridset.gridset', updatedGridset);
  */
-export declare function updateWordlist(gridsetBuffer: Buffer, gridName: string, wordlist: WordList, password?: string | undefined): Buffer;
+export declare function updateWordlist(gridsetBuffer: Uint8Array, gridName: string, wordlist: WordList, password?: string | undefined): Promise<Uint8Array>;

package/dist/processors/gridset/wordlistHelpers.js

@@ -9,17 +9,14 @@
  * Note: Wordlists are only supported in Grid3 format. Other AAC formats
  * do not have equivalent wordlist functionality.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createWordlist = createWordlist;
 exports.wordlistToXml = wordlistToXml;
 exports.extractWordlists = extractWordlists;
 exports.updateWordlist = updateWordlist;
-const adm_zip_1 = __importDefault(require("adm-zip"));
 const fast_xml_parser_1 = require("fast-xml-parser");
 const password_1 = require("./password");
+const io_1 = require("../../utils/io");
 /**
  * Creates a WordList object from an array of words/phrases or a dictionary
  *
@@ -100,31 +97,33 @@ function wordlistToXml(wordlist) {
  * @returns Map of grid names to their wordlists (if they have any)
  *
  * @example
- * const wordlists = extractWordlists(gridsetBuffer);
+ * const wordlists = await extractWordlists(gridsetBuffer);
  * wordlists.forEach((wordlist, gridName) => {
  *   console.log(`Grid "${gridName}" has ${wordlist.items.length} items`);
  * });
  */
-function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
+async function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
     const wordlists = new Map();
     const parser = new fast_xml_parser_1.XMLParser();
     let zip;
     try {
-        zip = new adm_zip_1.default(gridsetBuffer);
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const JSZip = require('jszip');
+        zip = await JSZip.loadAsync(gridsetBuffer);
     }
     catch (error) {
         throw new Error(`Invalid gridset buffer: ${error.message}`);
     }
     const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
     // Process each grid file
-    entries.forEach((entry) => {
+    for (const entry of entries) {
         if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
             try {
-                const xmlContent = entry.getData().toString('utf8');
+                const xmlContent = (0, io_1.decodeText)(await entry.getData());
                 const data = parser.parse(xmlContent);
                 const grid = data.Grid || data.grid;
                 if (!grid || !grid.WordList) {
-                    return;
+                    continue;
                 }
                 // Extract grid name from path (e.g., "Grids/MyGrid/grid.xml" -> "MyGrid")
                 const match = entry.entryName.match(/^Grids\/([^/]+)\//);
@@ -133,7 +132,7 @@ function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridse
                 const wordlistData = grid.WordList;
                 const itemsContainer = wordlistData.Items || wordlistData.items;
                 if (!itemsContainer) {
-                    return;
+                    continue;
                 }
                 const itemArray = Array.isArray(itemsContainer.WordListItem)
                     ? itemsContainer.WordListItem
@@ -154,7 +153,7 @@ function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridse
                 console.warn(`Failed to extract wordlist from ${entry.entryName}:`, error);
             }
         }
-    });
+    }
     return wordlists;
 }
 /**
@@ -171,7 +170,7 @@ function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridse
  * const updatedGridset = updateWordlist(gridsetBuffer, 'Greetings', newWordlist);
  * fs.writeFileSync('updated-gridset.gridset', updatedGridset);
  */
-function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
+async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
     const parser = new fast_xml_parser_1.XMLParser();
     const builder = new fast_xml_parser_1.XMLBuilder({
         ignoreAttributes: false,
@@ -181,7 +180,9 @@ function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, passwo
     });
     let zip;
     try {
-        zip = new adm_zip_1.default(gridsetBuffer);
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const JSZip = require('jszip');
+        zip = await JSZip.loadAsync(gridsetBuffer);
     }
     catch (error) {
         throw new Error(`Invalid gridset buffer: ${error.message}`);
@@ -189,17 +190,17 @@ function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, passwo
     const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
     let found = false;
     // Find and update the grid
-    entries.forEach((entry) => {
+    for (const entry of entries) {
         if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
             const match = entry.entryName.match(/^Grids\/([^/]+)\//);
             const currentGridName = match ? match[1] : null;
             if (currentGridName === gridName) {
                 try {
-                    const xmlContent = entry.getData().toString('utf8');
+                    const xmlContent = (0, io_1.decodeText)(await entry.getData());
                     const data = parser.parse(xmlContent);
                     const grid = data.Grid || data.grid;
                     if (!grid) {
-                        return;
+                        continue;
                     }
                     // Build the new wordlist XML structure
                     const items = wordlist.items.map((item) => ({
@@ -221,7 +222,7 @@ function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, passwo
                     };
                     // Rebuild the XML
                     const updatedXml = builder.build(data);
-                    zip.updateFile(entry, Buffer.from(updatedXml, 'utf8'));
+                    zip.file(entry.entryName, updatedXml, { binary: false });
                     found = true;
                 }
                 catch (error) {
@@ -230,9 +231,9 @@ function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, passwo
                 }
             }
         }
-    });
+    }
     if (!found) {
         throw new Error(`Grid "${gridName}" not found in gridset`);
     }
-    return zip.toBuffer();
+    return await zip.generateAsync({ type: 'uint8array' });
 }

package/dist/processors/gridsetProcessor.d.ts

@@ -2,14 +2,9 @@ import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString
 import { AACTree } from '../core/treeStructure';
 import { type ButtonForTranslation, type LLMLTranslationResult } from '../utilities/translation/translationProcessor';
 import { ValidationResult } from '../validation/validationTypes';
+import { ProcessorInput } from '../utils/io';
 declare class GridsetProcessor extends BaseProcessor {
     constructor(options?: ProcessorOptions);
-    /**
-     * Decrypt and inflate a Grid3 encrypted payload (DesktopContentEncrypter).
-     * Uses AES-256-CBC with key/IV derived from the password padded with spaces
-     * and then Deflate decompression.
-     */
-    private decryptGridsetEntry;
     private getGridsetPassword;
     private ensureAlphaChannel;
     /**
@@ -25,9 +20,9 @@ declare class GridsetProcessor extends BaseProcessor {
     private convertGrid3StyleToAACStyle;
     private getStyleById;
     private textOf;
-    extractTexts(filePathOrBuffer: string | Buffer): string[];
-    loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
-    processTexts(filePathOrBuffer: string | Buffer, translations: Map<string, string>, outputPath: string): Buffer;
+    extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
+    loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;
+    processTexts(filePathOrBuffer: ProcessorInput, translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
     /**
      * Extract symbol information from a gridset for LLM-based translation.
      * Returns a structured format showing which buttons have symbols and their context.
@@ -37,7 +32,7 @@ declare class GridsetProcessor extends BaseProcessor {
      * @param filePathOrBuffer - Path to gridset file or buffer
      * @returns Array of symbol information for LLM processing
      */
-    extractSymbolsForLLM(filePathOrBuffer: string | Buffer): ButtonForTranslation[];
+    extractSymbolsForLLM(filePathOrBuffer: string | Buffer): Promise<ButtonForTranslation[]>;
     /**
      * Apply LLM translations with symbol information.
      * The LLM should provide translations with symbol attachments in the correct positions.
@@ -52,8 +47,8 @@ declare class GridsetProcessor extends BaseProcessor {
      */
     processLLMTranslations(filePathOrBuffer: string | Buffer, llmTranslations: LLMLTranslationResult[], outputPath: string, options?: {
         allowPartial?: boolean;
-    }): Buffer;
-    saveFromTree(tree: AACTree, outputPath: string): void;
+    }): Promise<Uint8Array>;
+    saveFromTree(tree: AACTree, outputPath: string): Promise<void>;
     private calculateColumnDefinitions;
     private calculateRowDefinitions;
     private findButtonPosition;