@cyberismo/data-handler 0.0.21 → 0.0.22

package/dist/utils/handlebars-helpers.js

@@ -0,0 +1,78 @@
+import { escapeJsonString } from './json.js';
+import { escapeCsvField } from './csv.js';
+import { resourceName } from './resource-utils.js';
+/**
+ * Formats a value from a logic program for use in graphviz
+ * @param value - The value to format
+ * @returns The formatted value
+ */
+function formatAttributeValue(value) {
+    if (!value) {
+        return '';
+    }
+    // value is an html-like string
+    if (value.length > 1 && value.startsWith('<') && value.endsWith('>')) {
+        return value;
+    }
+    // value is a normal string and needs to be wrapped in quotes
+    return `"${value}"`;
+}
+/**
+ * Checks if a field is a custom field
+ * @param field - The field to check
+ * @returns True if the field is a custom field, false otherwise
+ */
+function isCustomField(field) {
+    try {
+        const { type } = resourceName(field, true);
+        return type === 'fieldTypes';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Formats a value for display in a report
+ * @param value - The value to format
+ * @returns The formatted value
+ */
+function formatValue(value) {
+    if (typeof value === 'object') {
+        if (Array.isArray(value)) {
+            return value.map((v) => formatValue(v)).join(', ');
+        }
+        if (value != null &&
+            'displayValue' in value &&
+            typeof value.displayValue === 'string') {
+            return value.displayValue;
+        }
+        if (value != null && 'value' in value && typeof value.value === 'string') {
+            return formatValue(value.value);
+        }
+        return JSON.stringify(value, null, 2);
+    }
+    if (typeof value === 'boolean') {
+        return value ? 'Yes' : 'No';
+    }
+    return value?.toString() ?? '';
+}
+/**
+ * Registers comparison helpers (eq and ne) with a Handlebars instance
+ * @param instance handlebars instance
+ */
+export function registerComparisonHelpers(instance) {
+    instance.registerHelper('eq', (a, b) => a === b);
+    instance.registerHelper('ne', (a, b) => a !== b);
+}
+/**
+ * Registers report-specific helpers with a Handlebars instance
+ * @param instance handlebars instance
+ */
+export function registerReportHelpers(instance) {
+    instance.registerHelper('formatAttributeValue', formatAttributeValue);
+    instance.registerHelper('isCustomField', isCustomField);
+    instance.registerHelper('formatValue', formatValue);
+    instance.registerHelper('jsonEscape', escapeJsonString);
+    instance.registerHelper('csvEscape', escapeCsvField);
+}
+//# sourceMappingURL=handlebars-helpers.js.map

package/dist/utils/handlebars-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlebars-helpers.js","sourceRoot":"","sources":["../../src/utils/handlebars-helpers.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,+BAA+B;IAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,6DAA6D;IAC7D,OAAO,IAAI,KAAK,GAAG,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3C,OAAO,IAAI,KAAK,YAAY,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,IACE,KAAK,IAAI,IAAI;YACb,cAAc,IAAI,KAAK;YACvB,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,EACtC,CAAC;YACD,OAAO,KAAK,CAAC,YAAY,CAAC;QAC5B,CAAC;QACD,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzE,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAA2B;IACnE,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA2B;IAC/D,QAAQ,CAAC,cAAc,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;IACtE,QAAQ,CAAC,cAAc,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IACxD,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IACxD,QAAQ,CAAC,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC"}

package/dist/utils/json.js

@@ -48,7 +48,9 @@ export function readJsonFileSync(file) {
     }
     catch (error) {
         if (error instanceof Error) {
-            throw new Error(`Invalid JSON in file '${file}': ${error.message}`);
+            throw new Error(`Invalid JSON in file '${file}': ${error.message}`, {
+                cause: error,
+            });
         }
     }
 }
@@ -65,7 +67,9 @@ export async function readJsonFile(file) {
     }
     catch (error) {
         if (error instanceof Error) {
-            throw new Error(`Invalid JSON in file '${file}': ${error.message}`);
+            throw new Error(`Invalid JSON in file '${file}': ${error.message}`, {
+                cause: error,
+            });
         }
     }
 }

package/dist/utils/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AAEF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAmB,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,aAAa,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA6B,EAC7B,IAAY,EACZ,OAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AAEF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAmB,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,aAAa,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA6B,EAC7B,IAAY,EACZ,OAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/log-utils.d.ts

@@ -9,8 +9,13 @@
     You should have received a copy of the GNU Affero General Public
     License along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
-import { type ChildLoggerOptions, type Logger } from 'pino';
-export declare function setLogger(logger: Logger): void;
+import { type Level, type ChildLoggerOptions, type Logger } from 'pino';
+/**
+ * Initialize the logger
+ * @param level Log level for stdout output.
+ * @param logPath Optional file path for full trace logging.
+ */
+export declare function initLogger(level: Level, logPath?: string): void;
 /**
  * Returns the logger instance.
  */

package/dist/utils/log-utils.js

@@ -10,11 +10,36 @@
     License along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 import pino from 'pino';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
 // This could be also a more generic interface, but since we use pino and this is an internal package, let's keep it simple
-// silent logger as default
+// Silent logger as default.
 let _logger = pino({ level: 'silent' });
-export function setLogger(logger) {
-    _logger = logger;
+let initialized = false;
+/**
+ * Initialize the logger
+ * @param level Log level for stdout output.
+ * @param logPath Optional file path for full trace logging.
+ */
+export function initLogger(level, logPath) {
+    if (initialized)
+        return;
+    initialized = true;
+    if (logPath) {
+        try {
+            mkdirSync(dirname(logPath), { recursive: true });
+        }
+        catch (error) {
+            throw new Error(`Failed to create log directory '${dirname(logPath)}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+        _logger = pino({ level: 'trace' }, pino.multistream([
+            { stream: pino.destination(logPath), level: 'trace' },
+            { stream: pino.destination(1), level },
+        ]));
+    }
+    else {
+        _logger = pino({ level }, pino.destination(1));
+    }
 }
 /**
  * Returns the logger instance.

package/dist/utils/log-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-utils.js","sourceRoot":"","sources":["../../src/utils/log-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,IAA8C,MAAM,MAAM,CAAC;AAElE,2HAA2H;AAC3H,2BAA2B;AAC3B,IAAI,OAAO,GAAW,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAEhD,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AACD;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AACD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAqD,EACrD,OAA4B;IAE5B,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"log-utils.js","sourceRoot":"","sources":["../../src/utils/log-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,IAA0D,MAAM,MAAM,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,2HAA2H;AAC3H,4BAA4B;AAC5B,IAAI,OAAO,GAAW,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,OAAgB;IACvD,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IACnB,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,mCAAmC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACjH,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,IAAI,CACZ,EAAE,KAAK,EAAE,OAAO,EAAE,EAClB,IAAI,CAAC,WAAW,CAAC;YACf,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;YACrD,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE;SACvC,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AACD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAqD,EACrD,OAA4B;IAE5B,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/report.d.ts

@@ -1,23 +1,5 @@
 import type { CalculationEngine } from '../containers/project/calculation-engine.js';
 import type { Context } from '../interfaces/project-interfaces.js';
-/**
- * Formats a value from a logic program for use to graphviz
- * @param value - The value to format
- * @returns The formatted value
- */
-export declare function formatAttributeValue(value?: string): string;
-/**
- * Checks if a field is a custom field
- * @param field - The field to check
- * @returns True if the field is a custom field, false otherwise
- */
-export declare function isCustomField(field: string): boolean;
-/**
- * Formats a value for display in a report
- * @param value - The value to format
- * @returns The formatted value
- */
-export declare function formatValue(value: unknown): string;
 /**
  * Parameters for the core generation function
  */
@@ -26,7 +8,6 @@ interface GenerateReportContentParams {
     contentTemplate: string;
     queryTemplate: string;
     options: Record<string, string | undefined | boolean>;
-    graph?: boolean;
     context: Context;
 }
 /**

package/dist/utils/report.js

@@ -11,64 +11,7 @@
 */
 import Handlebars from 'handlebars';
 import { registerEmptyMacros } from '../macros/index.js';
-import { resourceName } from './resource-utils.js';
-import { escapeJsonString } from './json.js';
-import { escapeCsvField } from './csv.js';
-/**
- * Formats a value from a logic program for use to graphviz
- * @param value - The value to format
- * @returns The formatted value
- */
-export function formatAttributeValue(value) {
-    if (!value) {
-        return '';
-    }
-    // value is an html-like string
-    if (value.length > 1 && value.startsWith('<') && value.endsWith('>')) {
-        return value;
-    }
-    // value is a normal string and needs to be wrapped in quotes
-    return `"${value}"`;
-}
-/**
- * Checks if a field is a custom field
- * @param field - The field to check
- * @returns True if the field is a custom field, false otherwise
- */
-export function isCustomField(field) {
-    try {
-        const { type } = resourceName(field, true);
-        return type === 'fieldTypes';
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Formats a value for display in a report
- * @param value - The value to format
- * @returns The formatted value
- */
-export function formatValue(value) {
-    if (typeof value === 'object') {
-        if (Array.isArray(value)) {
-            return value.map((v) => formatValue(v)).join(', ');
-        }
-        if (value != null &&
-            'displayValue' in value &&
-            typeof value.displayValue === 'string') {
-            return value.displayValue;
-        }
-        if (value != null && 'value' in value && typeof value.value === 'string') {
-            return formatValue(value.value);
-        }
-        return JSON.stringify(value, null, 2);
-    }
-    if (typeof value === 'boolean') {
-        return value ? 'Yes' : 'No';
-    }
-    return value?.toString() ?? '';
-}
+import { registerComparisonHelpers, registerReportHelpers, } from './handlebars-helpers.js';
 /**
  * Generates report content based on a report definition, project context, and options,
  * by utilizing the ReportRunner class.
@@ -78,9 +21,9 @@ export function formatValue(value) {
  * @throws Error if the report definition is invalid, schema validation fails, or logic program execution fails.
  */
 export async function generateReportContent(params) {
-    const { calculate, contentTemplate, queryTemplate, graph, options, // Destructure options
-    context, } = params;
+    const { calculate, contentTemplate, queryTemplate, options, context } = params;
     const handlebars = Handlebars.create();
+    registerComparisonHelpers(handlebars);
     // Compile and execute the query template
     const template = handlebars.compile(queryTemplate, {
         strict: true,
@@ -91,13 +34,7 @@ export async function generateReportContent(params) {
     }
     // register empty macros so that other macros aren't touched yet
     registerEmptyMacros(handlebars);
-    if (graph) {
-        handlebars.registerHelper('formatAttributeValue', formatAttributeValue);
-    }
-    handlebars.registerHelper('isCustomField', isCustomField);
-    handlebars.registerHelper('formatValue', formatValue);
-    handlebars.registerHelper('jsonEscape', escapeJsonString);
-    handlebars.registerHelper('csvEscape', escapeCsvField);
+    registerReportHelpers(handlebars);
     return handlebars.compile(contentTemplate)({
         ...options,
         ...result,

package/dist/utils/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/utils/report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/utils/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAajC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAmC;IAEnC,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,GACnE,MAAM,CAAC;IAET,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IACvC,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAEtC,yCAAyC;IACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE;QACjD,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAE3E,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,gEAAgE;IAChE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAChC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAElC,OAAO,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACzC,GAAG,OAAO;QACV,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/rw-lock.d.ts

@@ -0,0 +1,71 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2026
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation. This program is distributed in the hope that it
+  will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Affero General Public License for more details.
+  You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+/**
+ * Promise-based read-write lock with writer priority and reentrancy.
+ *
+ * - Multiple concurrent readers are allowed.
+ * - Writers get exclusive access.
+ * - Writer-priority: new readers block when a writer is waiting.
+ * - Reentrancy via AsyncLocalStorage: nested lock calls within the same
+ *   async context are no-ops.
+ * - After-write hooks fire after the outermost write completes successfully.
+ */
+export declare class RWLock {
+    private readonly name;
+    private readers;
+    private writer;
+    private readerQueue;
+    private writerQueue;
+    private context;
+    private afterWriteHooks;
+    private writeErrorHooks;
+    private readonly logger;
+    constructor(name?: string);
+    /**
+     * Register a callback that fires after the outermost write completes
+     * successfully. Hooks run while still holding the write lock.
+     */
+    onAfterWrite(hook: () => Promise<void>): void;
+    /**
+     * Register a callback that fires when the outermost write fails.
+     * Hooks run while still holding the write lock.
+     */
+    onWriteError(hook: (error: unknown) => Promise<void>): void;
+    /**
+     * Execute `fn` under a read lock. Concurrent readers are allowed.
+     * If already inside a read or write context, just runs fn directly.
+     */
+    read<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute `fn` under an exclusive write lock.
+     * If already inside a write context, just runs fn directly (no hooks).
+     */
+    write<T>(fn: () => Promise<T>): Promise<T>;
+    private acquireRead;
+    private releaseRead;
+    private acquireWrite;
+    private releaseWrite;
+}
+/**
+ * A Helper decorator built for commands that automatically handles using a read lock
+ */
+export declare function read<This extends object, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Promise<Return>): (this: This, ...args: Args) => Promise<Return>;
+/**
+ * A Helper decorator built for commands that automatically handles using a write lock.
+ *
+ * Two forms:
+ * - `@write()`: just acquires the write lock, no commit message (for wrapper methods)
+ * - `@write((param) => \`Do ${param}\`)`: acquires the write lock and sets a default commit message
+ */
+export declare function write<This extends object, Args extends unknown[], Return>(): (target: (this: This, ...args: Args) => Promise<Return>) => (this: This, ...args: Args) => Promise<Return>;
+export declare function write<This extends object, Args extends unknown[], Return>(message: (...args: any[]) => string): (target: (this: This, ...args: Args) => Promise<Return>) => (this: This, ...args: Args) => Promise<Return>;

package/dist/utils/rw-lock.js

@@ -0,0 +1,220 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2026
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation. This program is distributed in the hope that it
+  will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Affero General Public License for more details.
+  You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { runWithDefaultCommitMessage } from './commit-context.js';
+import { getChildLogger } from './log-utils.js';
+/**
+ * Promise-based read-write lock with writer priority and reentrancy.
+ *
+ * - Multiple concurrent readers are allowed.
+ * - Writers get exclusive access.
+ * - Writer-priority: new readers block when a writer is waiting.
+ * - Reentrancy via AsyncLocalStorage: nested lock calls within the same
+ *   async context are no-ops.
+ * - After-write hooks fire after the outermost write completes successfully.
+ */
+export class RWLock {
+    name;
+    readers = 0;
+    writer = false;
+    readerQueue = [];
+    writerQueue = [];
+    context = new AsyncLocalStorage();
+    afterWriteHooks = [];
+    writeErrorHooks = [];
+    logger;
+    constructor(name = 'RWLock') {
+        this.name = name;
+        this.logger = getChildLogger({ module: 'RWLock', name });
+    }
+    /**
+     * Register a callback that fires after the outermost write completes
+     * successfully. Hooks run while still holding the write lock.
+     */
+    onAfterWrite(hook) {
+        this.afterWriteHooks.push(hook);
+    }
+    /**
+     * Register a callback that fires when the outermost write fails.
+     * Hooks run while still holding the write lock.
+     */
+    onWriteError(hook) {
+        this.writeErrorHooks.push(hook);
+    }
+    /**
+     * Execute `fn` under a read lock. Concurrent readers are allowed.
+     * If already inside a read or write context, just runs fn directly.
+     */
+    async read(fn) {
+        const current = this.context.getStore();
+        if (current?.active) {
+            return fn();
+        }
+        await this.acquireRead();
+        const ctx = { mode: 'read', active: true };
+        try {
+            return await this.context.run(ctx, fn);
+        }
+        finally {
+            ctx.active = false;
+            this.releaseRead();
+        }
+    }
+    /**
+     * Execute `fn` under an exclusive write lock.
+     * If already inside a write context, just runs fn directly (no hooks).
+     */
+    async write(fn) {
+        const current = this.context.getStore();
+        if (current?.active && current.mode === 'write') {
+            return fn();
+        }
+        if (current?.active && current.mode === 'read') {
+            throw new Error('Cannot acquire write lock while holding read lock');
+        }
+        await this.acquireWrite();
+        const ctx = { mode: 'write', active: true };
+        try {
+            const result = await this.context.run(ctx, fn);
+            // Fire after-write hooks while still holding the lock
+            for (const hook of this.afterWriteHooks) {
+                await this.context.run(ctx, hook);
+            }
+            return result;
+        }
+        catch (error) {
+            // Run rollback hooks on error (outermost write only)
+            for (const hook of this.writeErrorHooks) {
+                await this.context.run(ctx, () => hook(error));
+            }
+            throw error;
+        }
+        finally {
+            ctx.active = false;
+            this.releaseWrite();
+        }
+    }
+    acquireRead() {
+        if (!this.writer && this.writerQueue.length === 0) {
+            this.readers++;
+            this.logger.trace({ readers: this.readers }, 'read lock acquired');
+            return Promise.resolve();
+        }
+        this.logger.debug({
+            readers: this.readers,
+            writer: this.writer,
+            writerQueueDepth: this.writerQueue.length,
+            readerQueueDepth: this.readerQueue.length,
+        }, 'read lock queued (writer active or pending)');
+        return new Promise((resolve) => {
+            this.readerQueue.push(() => {
+                this.readers++;
+                this.logger.debug({
+                    readers: this.readers,
+                    writerQueueDepth: this.writerQueue.length,
+                    readerQueueDepth: this.readerQueue.length,
+                }, 'read lock acquired after wait');
+                resolve();
+            });
+        });
+    }
+    releaseRead() {
+        this.readers--;
+        this.logger.trace({
+            readers: this.readers,
+            writerQueueDepth: this.writerQueue.length,
+            readerQueueDepth: this.readerQueue.length,
+        }, 'read lock released');
+        if (this.readers === 0 && this.writerQueue.length > 0) {
+            const next = this.writerQueue.shift();
+            next();
+        }
+    }
+    acquireWrite() {
+        if (!this.writer && this.readers === 0) {
+            this.writer = true;
+            this.logger.trace({
+                readers: this.readers,
+                writerQueueDepth: this.writerQueue.length,
+                readerQueueDepth: this.readerQueue.length,
+            }, 'write lock acquired');
+            return Promise.resolve();
+        }
+        this.logger.debug({
+            readers: this.readers,
+            writer: this.writer,
+            writerQueueDepth: this.writerQueue.length,
+            readerQueueDepth: this.readerQueue.length,
+        }, `write lock queued (readers: ${this.readers}, writer active: ${this.writer})`);
+        return new Promise((resolve) => {
+            this.writerQueue.push(() => {
+                this.writer = true;
+                this.logger.debug({
+                    readers: this.readers,
+                    writerQueueDepth: this.writerQueue.length,
+                    readerQueueDepth: this.readerQueue.length,
+                }, 'write lock acquired after wait');
+                resolve();
+            });
+        });
+    }
+    releaseWrite() {
+        this.writer = false;
+        this.logger.trace({
+            readers: this.readers,
+            writerQueueDepth: this.writerQueue.length,
+            readerQueueDepth: this.readerQueue.length,
+        }, 'write lock released');
+        if (this.writerQueue.length > 0) {
+            const next = this.writerQueue.shift();
+            next();
+        }
+        else {
+            // Wake ALL waiting readers
+            const readers = this.readerQueue.splice(0);
+            for (const wake of readers) {
+                wake();
+            }
+        }
+    }
+}
+// Helper to access the lock from a command instance via its `project` property.
+function getLock(instance) {
+    const lock = instance.project?.lock;
+    if (!lock) {
+        throw new Error('@read/@write decorator: instance.project.lock is not defined. ' +
+            'Ensure the class has a `project` property with `lock: RWLock`.');
+    }
+    return lock;
+}
+/**
+ * A Helper decorator built for commands that automatically handles using a read lock
+ */
+export function read(target) {
+    return function (...args) {
+        return getLock(this).read(() => target.call(this, ...args));
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function write(message) {
+    return function (target) {
+        return function (...args) {
+            if (!message) {
+                return getLock(this).write(() => target.call(this, ...args));
+            }
+            const label = message(...args);
+            return runWithDefaultCommitMessage(label, () => getLock(this).write(() => target.call(this, ...args)));
+        };
+    };
+}
+//# sourceMappingURL=rw-lock.js.map

package/dist/utils/rw-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rw-lock.js","sourceRoot":"","sources":["../../src/utils/rw-lock.ts"],"names":[],"mappings":"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"}

package/dist/utils/user-preferences.js

@@ -97,14 +97,14 @@ export class UserPreferences {
             if (hasCode(error)) {
                 // If file already exists (EEXIST), that's fine - we'll use the existing file
                 if (error.code !== 'EEXIST') {
-                    throw new Error(`Error creating preferences file '${this.prefsFilePath}': ${error}`);
+                    throw new Error(`Error creating preferences file '${this.prefsFilePath}': ${error}`, { cause: error });
                 }
                 else {
                     this.logger.warn('Preferences file already exists');
                 }
             }
             else {
-                throw new Error(`Error creating preferences file '${this.prefsFilePath}': ${error}`);
+                throw new Error(`Error creating preferences file '${this.prefsFilePath}': ${error}`, { cause: error });
             }
         }
     }
@@ -119,7 +119,7 @@ export class UserPreferences {
             return JSON.parse(readFileSync(this.prefsFilePath, 'utf8'));
         }
         catch (error) {
-            throw new Error(`Error reading preferences file '${this.prefsFilePath}': ${error}`);
+            throw new Error(`Error reading preferences file '${this.prefsFilePath}': ${error}`, { cause: error });
         }
     }
 }