Handle encrypted .gridsetx files in validator

Added support for detecting and handling encrypted .gridsetx files in GridsetValidator, issuing a warning and skipping content validation. Removed the requirement for a wordlists element in gridset files. Updated tests to cover encrypted file handling and the absence of wordlists.

Author: willwade

.envrc.example

@@ -1,4 +1,5 @@
 export AZURE_TRANSLATOR_KEY=""  # Replace with your Azure Translator key
 export AZURE_TRANSLATOR_REGION=""  # Replace with your Azure Translator region
 export GOOGLE_TRANSLATE_KEY=""
-export GEMINI_API_KEY=""
+export GEMINI_API_KEY=""
+export GRIDSET_PASSWORD=""  # Password for encrypted Grid3 archives (.gridsetx)

examples/.DS_Store

@@ -55,13 +55,24 @@ export class GridsetValidator extends BaseValidator {
   ): Promise<ValidationResult> {
     this.reset();
 
+    const isEncrypted = filename.toLowerCase().endsWith('.gridsetx');
+
     // eslint-disable-next-line @typescript-eslint/require-await
     await this.add_check('filename', 'file extension', async () => {
       if (!filename.match(/\.gridsetx?$/)) {
         this.warn('filename should end with .gridset or .gridsetx');
       }
     });
 
+    // For encrypted .gridsetx files, we can't validate the content
+    if (isEncrypted) {
+      // eslint-disable-next-line @typescript-eslint/require-await
+      await this.add_check('encrypted_format', 'encrypted gridsetx file', async () => {
+        this.warn('gridsetx files are encrypted and cannot be fully validated');
+      });
+      return this.buildResult(filename, filesize, 'gridset');
+    }
+
     let xmlObj: any = null;
     await this.add_check('xml_parse', 'valid XML', async () => {
       try {
@@ -97,7 +108,7 @@ export class GridsetValidator extends BaseValidator {
    */
   private async validateGridsetStructure(
     gridset: any,
-    filename: string,
+    _filename: string,
     _content: Buffer | Uint8Array
   ): Promise<void> {
     // Check for required elements
@@ -171,22 +182,6 @@ export class GridsetValidator extends BaseValidator {
         this.warn('gridset should have a styles element for consistent formatting');
       }
     });
-
-    // Check for wordlists
-    await this.add_check('wordlists', 'wordlists element', async () => {
-      const wordlists = gridset.wordlists || gridset.Wordlists;
-      if (!wordlists) {
-        this.warn('gridset should have a wordlists element for vocabulary support');
-      }
-    });
-
-    // Validate file references if it's a .gridsetx file (encrypted)
-    if (filename.endsWith('.gridsetx')) {
-      await this.add_check('encrypted_format', 'encrypted gridsetx', async () => {
-        // Gridsetx files are encrypted, so we can't validate much
-        this.warn('gridsetx files are encrypted and cannot be fully validated');
-      });
-    }
   }
 
   /**

src/validation/gridsetValidator.ts

@@ -183,6 +183,49 @@ describe('Validation System', () => {
 
       expect(result.valid).toBe(false);
     });
+
+    it('should handle encrypted .gridsetx files', async () => {
+      // .gridsetx files are encrypted, so we just validate the extension
+      const encryptedContent = Buffer.from('encrypted binary data');
+      const result = await new GridsetValidator().validate(
+        encryptedContent,
+        'test.gridsetx',
+        encryptedContent.length
+      );
+
+      expect(result).toBeDefined();
+      expect(result.format).toBe('gridset');
+      // Should have warning about encryption
+      const hasEncryptionWarning = result.results.some(
+        (r) => r.type === 'encrypted_format' && r.warnings && r.warnings.length > 0
+      );
+      expect(hasEncryptionWarning).toBe(true);
+    });
+
+    it('should not require wordlists element', async () => {
+      const gridsetWithoutWordlists = `<?xml version="1.0" encoding="utf-8"?>
+      <gridset id="test" name="Test Gridset">
+        <pages>
+          <page id="page1" name="Page 1">
+            <cells>
+              <cell id="cell1" label="Hello"/>
+            </cells>
+          </page>
+        </pages>
+        <fixedCellSize width="100" height="100"/>
+      </gridset>`;
+
+      const content = Buffer.from(gridsetWithoutWordlists);
+      const result = await new GridsetValidator().validate(content, 'test.gridset', content.length);
+
+      expect(result).toBeDefined();
+      expect(result.format).toBe('gridset');
+      // Should NOT have warning about missing wordlists
+      const hasWordlistsWarning = result.results.some(
+        (r) => r.type === 'wordlists' && r.warnings && r.warnings.length > 0
+      );
+      expect(hasWordlistsWarning).toBe(false);
+    });
   });
 
   describe('SnapValidator', () => {