@willwade/aac-processors 0.0.8 → 0.0.9

package/README.md

@@ -58,6 +58,37 @@ npm run build
 
 ---
 
+## Using with Electron
+
+`better-sqlite3` is a native module and must be rebuilt against Electron's Node.js runtime. If you see a `NODE_MODULE_VERSION` mismatch error, rebuild after installing dependencies:
+
+```bash
+npm install
+npx electron-rebuild
+```
+
+Or add a postinstall hook so the rebuild happens automatically:
+
+```json
+{
+  "scripts": {
+    "postinstall": "electron-builder install-app-deps"
+  }
+}
+```
+
+This step is only required for Electron apps; regular Node.js consumers do not need it.
+
+---
+
+## Windows Data Paths
+
+- **Grid 3 history**: `C:\Users\Public\Documents\Smartbox\Grid 3\Users\{username}\{langCode}\Phrases\history.sqlite`
+- **Grid 3 vocabularies**: `C:\Users\Public\Documents\Smartbox\Grid 3\Users\{username}\Grid Sets\`
+- **Snap vocabularies**: `C:\Users\{username}\AppData\Roaming\Tobii Dynavox\Snap Scene\Users\{userId}\` (`.sps`/`.spb`)
+
+---
+
 ## 🔧 Quick Start
 
 ### Basic Usage (TypeScript/ES6)

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

@@ -79,6 +79,8 @@ export declare function getCommonDocumentsPath(): string;
  * Find all Grid3 user data paths
  * Searches for users and language codes in the Grid3 directory structure
  * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\{langCode}\Phrases\history.sqlite
+ * Grid set/vocabulary archives live alongside users at:
+ * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\Grid Sets\
  * @returns Array of Grid3 user path information
  */
 export declare function findGrid3UserPaths(): Grid3UserPath[];

package/dist/processors/gridset/helpers.js

@@ -197,6 +197,8 @@ function getCommonDocumentsPath() {
  * Find all Grid3 user data paths
  * Searches for users and language codes in the Grid3 directory structure
  * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\{langCode}\Phrases\history.sqlite
+ * Grid set/vocabulary archives live alongside users at:
+ * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\Grid Sets\
  * @returns Array of Grid3 user path information
  */
 function findGrid3UserPaths() {
@@ -307,6 +309,8 @@ function findGrid3Vocabularies(userName) {
  * @returns Path to history.sqlite or null if not found
  */
 function findGrid3UserHistory(userName, langCode) {
+    if (!userName)
+        return null;
     const normalizedUser = userName.toLowerCase();
     const normalizedLang = langCode?.toLowerCase();
     const match = findGrid3UserPaths().find((u) => u.userName.toLowerCase() === normalizedUser &&
@@ -363,13 +367,26 @@ function readGrid3History(historyDbPath) {
     const events = new Map();
     for (const row of rows) {
         const phraseId = row.PhraseId;
-        const contentText = parseGrid3ContentXml(String(row.ContentXml ?? row.TextValue ?? ''));
+        const rawContentSource = [row.ContentXml, row.TextValue].find((candidate) => {
+            if (candidate === null || candidate === undefined)
+                return false;
+            const asString = String(candidate);
+            return asString.trim().length > 0;
+        });
+        if (rawContentSource === undefined) {
+            continue; // Skip history rows with no usable text content
+        }
+        const rawContentText = String(rawContentSource);
+        const contentText = parseGrid3ContentXml(rawContentText);
+        const rawXml = typeof row.ContentXml === 'string' && row.ContentXml.trim().length > 0
+            ? row.ContentXml
+            : undefined;
         const entry = events.get(phraseId) ??
             {
                 id: `grid:${phraseId}`,
                 content: contentText,
                 occurrences: [],
-                rawXml: row.ContentXml,
+                rawXml,
             };
         entry.occurrences.push({
             timestamp: (0, dotnetTicks_1.dotNetTicksToDate)(BigInt(row.TickValue ?? 0)),

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

@@ -56,6 +56,8 @@ export declare function findSnapPackages(packageNamePattern?: string): SnapPacka
 export declare function findSnapPackagePath(packageNamePattern?: string): string | null;
 /**
  * Find Snap user directories and their vocab files (.sps/.spb)
+ * Typical path:
+ * C:\Users\{username}\AppData\Roaming\Tobii Dynavox\Snap Scene\Users\{userId}\
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */

package/dist/processors/snap/helpers.js

@@ -155,6 +155,8 @@ function findSnapPackagePath(packageNamePattern = 'TobiiDynavox') {
 }
 /**
  * Find Snap user directories and their vocab files (.sps/.spb)
+ * Typical path:
+ * C:\Users\{username}\AppData\Roaming\Tobii Dynavox\Snap Scene\Users\{userId}\
  * @param packageNamePattern Optional package filter (default TobiiDynavox)
  * @returns Array of user info with vocab paths
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "A comprehensive TypeScript library for processing AAC (Augmentative and Alternative Communication) file formats with translation support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",