@isoftdata/utility-dashboard-backend 2.0.1 → 2.1.0

package/README.md

@@ -17,16 +17,16 @@ This function returns data in the format expected for the `loadReportMetadata` f
 #### Function signature
 
 ```js
-async formatReportMetadata(mysqlConnection, { report, chartsInReport })
+async formatReportMetadata(mysqlConnection, { report, chartsInReport, session })
 ```
 
 #### Example Usage (From Pro Web `server/chart-loader.js`)
 
 ```js
-async function loadReportMetadata({ dashboardReportId, chartId }) {
+async function loadReportMetadata({ dashboardReportId, chartId, session }) {
 	const report = await db.dashboardReport.loadById({ dashboardReportId }) // gets a report by its id
 	const chartsInReport = await db.dashboardChart.loadByReport({ dashboardReportId, chartId }) // gets all charts for a specified report, or if `chartId` is specified, only gets that chart for that report.
-	return await formatReportMetadata(db.pool, { report, chartsInReport })
+	return await formatReportMetadata(db.pool, { report, chartsInReport, session })
 }
 ```
 
@@ -93,6 +93,16 @@ Example:
 ]
 ```
 
+#### session
+Session object from the Auth Module
+
+#### site (optional)
+The 'type' of site for the product this is used in. Determines the MySQL table to query for site selection parameters, and used to calculate `siteIdColumn` if that is not specified.
+#### siteIdColumn (optional)
+The name of the column that stores the site id in the site table. Defaults to `${site}id`.
+#### siteNameColumn (optional)
+The store name column.
+
 ### formatChartDataForReport
 
 This function returns data in the format expected for the `loadChartDataForReport` function on the dashboard client component, including applying any report-specific chart options overrides and running the chart's query.
@@ -100,18 +110,18 @@ This function returns data in the format expected for the `loadChartDataForRepor
 #### Function signature
 
 ```js
-async formatChartDataForReport(mysqlConnection, { reportParameters, chart, reportChart, parameterSelectionList })
+async formatChartDataForReport(mysqlConnection, { reportParameters, chart, reportChart, parameterSelectionList, session })
 ```
 
 #### Example usage: (from Pro Web `server/chart-loader.js`)
 
 ```js
-async function loadChartDataForReport ({ dashboardReportId, chartId, parameterSelectionList }) {
+async function loadChartDataForReport ({ dashboardReportId, chartId, parameterSelectionList, session }) {
 	const report = await db.dashboardReport.loadById({ dashboardReportId }) // get the report object
 	const chart = await db.dashboardChart.loadById({ chartId }) // get the chart object
 	const reportChart = await db.dashboardReportChart.loadByReportAndChartId({ chartId, dashboardReportId }) // get the report chart for the rank/overrides
 	try {
-		const chartData = await formatChartDataForReport(db.pool, { reportParameters: report.parameters, chart, reportChart, parameterSelectionList })
+		const chartData = await formatChartDataForReport(db.pool, { reportParameters: report.parameters, chart, reportChart, parameterSelectionList, session })
 		return chartData
 	} catch (err) {
 		console.error(err)
@@ -132,6 +142,9 @@ The id of a chart row in `wa_dashboard_chart`.
 #### parameterSelectionList
 The array of selected parameters sent from the client dashboard.
 
+#### session
+Session object from the Auth Module
+
 ### loadOutputParameterValues
 
 This function outputs the report's parameter values in the format expected by the dashboard client and backend. When sending to the client, including `forClient: true` will not include the properties only needed by the backend.

package/dist/chart-helper.d.ts

@@ -0,0 +1,32 @@
+import { Connection, OkPacket, ResultSetHeader, RowDataPacket } from "mysql";
+import { Formatting, GoogleDataTable, MultiSeriesOptions, ProcessedFormatting, Table } from "./types/chart";
+export type QueryFieldsObject = Record<string, string>;
+declare function queryWithFields(connection: Connection, query: {
+    sql: string;
+    values: unknown[];
+}): Promise<{
+    results: RowDataPacket[] | RowDataPacket[][] | OkPacket | OkPacket[] | ResultSetHeader;
+    fields: QueryFieldsObject;
+}>;
+interface getMultiSeriesDataInput {
+    data: RowDataPacket[];
+    seriesOptions: MultiSeriesOptions;
+    formatting?: Formatting;
+    fields: QueryFieldsObject;
+}
+declare function getMultiSeriesData({ data: queryResult, seriesOptions, formatting, fields }: getMultiSeriesDataInput): {
+    data: RowDataPacket[];
+    formatting: Formatting;
+    fields: Record<string, string>;
+};
+declare function makeNegativeNumbericValuesZero(resultSet: RowDataPacket[]): RowDataPacket[];
+declare function coerceNullColumn(columnProp: string, data: RowDataPacket[], destinationType?: unknown): RowDataPacket[];
+declare function handleFormattingTemplates(formatting?: Formatting): ProcessedFormatting;
+declare function getDataTableFormat(data: RowDataPacket[], fields: {
+    [key: string]: string;
+}, multiSeries?: MultiSeriesOptions): GoogleDataTable;
+declare function makeDataCumulative(dataTable: GoogleDataTable, cumulative?: boolean): GoogleDataTable;
+declare function getRactiveTableDataFormat(rows: RowDataPacket[], fields: {
+    [key: string]: string;
+}, formatting: ProcessedFormatting, styleTemplates?: {}): Table;
+export { queryWithFields, getMultiSeriesData, makeNegativeNumbericValuesZero, makeNegativeNumbericValuesZero as makeNegativeNumericValuesZero, coerceNullColumn, handleFormattingTemplates, getDataTableFormat, makeDataCumulative, getRactiveTableDataFormat, };

package/dist/chart-helper.js

@@ -0,0 +1,240 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRactiveTableDataFormat = exports.makeDataCumulative = exports.getDataTableFormat = exports.handleFormattingTemplates = exports.coerceNullColumn = exports.makeNegativeNumericValuesZero = exports.makeNegativeNumbericValuesZero = exports.getMultiSeriesData = exports.queryWithFields = void 0;
+const formatting_templates_1 = __importDefault(require("./formatting-templates"));
+const toSnakeCase = require('to-snake-case');
+const mysqlDataTypes = require('mysql/lib/protocol/constants/types');
+const style_templates_1 = __importDefault(require("./style-templates"));
+function mysqlToGoogleChartsDataTypeMap(mysqlDataType) {
+    switch (mysqlDataType) {
+        case 'VAR_STRING':
+        case 'STRING':
+        case 'ENUM':
+        case 'VARCHAR':
+            return 'string';
+        case 'DECIMAL':
+        case 'NEWDECIMAL':
+        case 'BIT':
+        case 'TINY':
+        case 'SHORT':
+        case 'LONG':
+        case 'FLOAT':
+        case 'DOUBLE':
+        case 'LONGLONG':
+        case 'INT24':
+        case 'YEAR':
+            return 'number';
+        case 'TIMESTAMP':
+        case 'DATETIME':
+        case 'TIMESTAMP2':
+        case 'DATETIME2':
+            return 'datetime';
+        case 'DATE':
+        case 'NEWDATE':
+            return 'date';
+        case 'TIME':
+        case 'TIME2':
+            return 'timeofday';
+        default:
+            return 'string';
+    }
+}
+function makeDataTableCol(key, fields, role = null) {
+    return {
+        id: toSnakeCase(key).toLowerCase(),
+        label: key,
+        type: mysqlToGoogleChartsDataTypeMap(fields[key]),
+        role,
+    };
+}
+function queryWithFields(connection, query) {
+    return new Promise((resolve, reject) => {
+        connection.query(query, (err, results, fields) => {
+            if (err) {
+                console.error('Error running query for dashboard chart', err);
+                reject(err);
+            }
+            else {
+                resolve({
+                    results,
+                    fields: fields?.reduce((sum, field) => {
+                        return {
+                            ...sum,
+                            [field.name]: mysqlDataTypes[field.type] || field.type,
+                        };
+                    }, {}) ?? {},
+                });
+            }
+        });
+    });
+}
+exports.queryWithFields = queryWithFields;
+function getMultiSeriesData({ data: queryResult, seriesOptions, formatting, fields }) {
+    const { groupXAxisBy, series, value, tooltip } = seriesOptions;
+    const allOfTheKeysInTheSeries = new Set(queryResult.map(row => row[series]));
+    const objectOfAllKeysWithNullValues = {};
+    for (const key of allOfTheKeysInTheSeries) {
+        objectOfAllKeysWithNullValues[key] = null;
+        if (tooltip) {
+            objectOfAllKeysWithNullValues[`${tooltip} ${key}`] = null;
+        }
+    }
+    const grouped = {};
+    for (const row of queryResult) {
+        if (!grouped[row[groupXAxisBy]]) {
+            grouped[row[groupXAxisBy]] = { ...objectOfAllKeysWithNullValues };
+        }
+        grouped[row[groupXAxisBy]][row[series]] = row[value];
+        if (tooltip) {
+            grouped[row[groupXAxisBy]][`${tooltip} ${row[series]}`] = row[tooltip];
+        }
+    }
+    const seriesFields = { [groupXAxisBy]: fields[groupXAxisBy] };
+    const seriesFormatting = {};
+    for (const key of allOfTheKeysInTheSeries) {
+        seriesFields[key] = fields[value];
+        if (tooltip) {
+            seriesFields[`${tooltip} ${key}`] = fields[tooltip];
+        }
+        if (formatting && value in formatting) {
+            seriesFormatting[key] = formatting[value];
+        }
+    }
+    const multiSeriesData = [];
+    for (const key in grouped) {
+        multiSeriesData.push({
+            [groupXAxisBy]: key,
+            ...grouped[key],
+        });
+    }
+    return {
+        data: multiSeriesData,
+        formatting: {
+            ...formatting,
+            ...seriesFormatting,
+        },
+        fields: seriesFields,
+    };
+}
+exports.getMultiSeriesData = getMultiSeriesData;
+function makeNegativeNumbericValuesZero(resultSet) {
+    const numberCols = Object.keys(resultSet[0]).filter(key => typeof resultSet[0][key] === 'number');
+    return resultSet.map(row => {
+        numberCols.forEach(col => {
+            if (row[col] < 0) {
+                row[col] = 0;
+            }
+        });
+        return row;
+    });
+}
+exports.makeNegativeNumbericValuesZero = makeNegativeNumbericValuesZero;
+exports.makeNegativeNumericValuesZero = makeNegativeNumbericValuesZero;
+function coerceNullColumn(columnProp, data, destinationType) {
+    const hasNullValue = data.find(row => row[columnProp] === null);
+    if (hasNullValue) {
+        const rowWithValidValue = data.find(row => row[columnProp] !== null);
+        let nullReplacement = '';
+        if ((destinationType && destinationType === 'number') || (rowWithValidValue && typeof rowWithValidValue[columnProp] === 'number')) {
+            nullReplacement = 0;
+        }
+        return data.map(row => {
+            return {
+                ...row,
+                [columnProp]: row[columnProp] ?? nullReplacement,
+            };
+        });
+    }
+    else {
+        return data;
+    }
+}
+exports.coerceNullColumn = coerceNullColumn;
+function handleFormattingTemplates(formatting) {
+    const formattingOutput = {};
+    if (formatting && typeof formatting === 'object') {
+        for (const key in formatting) {
+            formattingOutput[key] = { type: formatting[key].type, format: null };
+            if (typeof formatting[key].format === 'string') {
+                if (formatting[key].format in formatting_templates_1.default) {
+                    formattingOutput[key].format = formatting_templates_1.default[formatting[key].format];
+                }
+            }
+        }
+    }
+    return formattingOutput;
+}
+exports.handleFormattingTemplates = handleFormattingTemplates;
+function getDataTableFormat(data, fields, multiSeries) {
+    let cols = [];
+    if (multiSeries) {
+        cols = [makeDataTableCol(multiSeries.groupXAxisBy, fields)];
+    }
+    for (const key in fields) {
+        if (!multiSeries || key !== multiSeries.groupXAxisBy) {
+            if (multiSeries?.tooltip && key.includes(multiSeries.tooltip)) {
+                cols.push(makeDataTableCol(key, fields, 'tooltip'));
+            }
+            else {
+                cols.push(makeDataTableCol(key, fields));
+            }
+        }
+    }
+    const rows = data.map(row => {
+        const items = [];
+        for (const column in row) {
+            items.push({ v: row[column] });
+        }
+        return {
+            c: items,
+        };
+    });
+    return { cols, rows };
+}
+exports.getDataTableFormat = getDataTableFormat;
+function makeDataCumulative(dataTable, cumulative = true) {
+    dataTable.rows.forEach((row, rowIndex) => {
+        if (rowIndex > 0) {
+            row.c.forEach((col, colIndex) => {
+                if (colIndex > 0 && col.v == null) {
+                    col.v = Number(dataTable.rows[rowIndex - 1].c[colIndex].v);
+                }
+                else if (cumulative && colIndex > 0) {
+                    col.v = Number(col.v) + Number(dataTable.rows[rowIndex - 1].c[colIndex].v);
+                }
+            });
+        }
+    });
+    return dataTable;
+}
+exports.makeDataCumulative = makeDataCumulative;
+function getRactiveTableDataFormat(rows, fields, formatting, styleTemplates = {}) {
+    const columns = Object.keys(fields).map(field => {
+        if (formatting?.[field]?.type === 'NumberFormat' && formatting?.[field]?.format?.prefix === '$') {
+            return {
+                property: `${field}[value]`,
+                name: field,
+                class: 'text-right border-top-0',
+            };
+        }
+        return {
+            property: `${field}[value]`,
+            name: field,
+            class: 'border-top-0',
+        };
+    });
+    if (styleTemplates) {
+        rows = rows.map(row => {
+            return (0, style_templates_1.default)(row, styleTemplates);
+        });
+    }
+    return {
+        columns,
+        rows,
+    };
+}
+exports.getRactiveTableDataFormat = getRactiveTableDataFormat;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhcnQtaGVscGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NoYXJ0LWhlbHBlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFJQSxrRkFBdUQ7QUFDdkQsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFBO0FBQzVDLE1BQU0sY0FBYyxHQUFHLE9BQU8sQ0FBQyxvQ0FBb0MsQ0FBQyxDQUFBO0FBRXBFLHdFQUE2QztBQUc3QyxTQUFTLDhCQUE4QixDQUFDLGFBQXFCO0lBQzVELFFBQVEsYUFBYSxFQUFFO1FBQ3RCLEtBQUssWUFBWSxDQUFDO1FBQ2xCLEtBQUssUUFBUSxDQUFDO1FBQ2QsS0FBSyxNQUFNLENBQUM7UUFDWixLQUFLLFNBQVM7WUFDYixPQUFPLFFBQVEsQ0FBQTtRQUNoQixLQUFLLFNBQVMsQ0FBQztRQUNmLEtBQUssWUFBWSxDQUFDO1FBQ2xCLEtBQUssS0FBSyxDQUFDO1FBQ1gsS0FBSyxNQUFNLENBQUM7UUFDWixLQUFLLE9BQU8sQ0FBQztRQUNiLEtBQUssTUFBTSxDQUFDO1FBQ1osS0FBSyxPQUFPLENBQUM7UUFDYixLQUFLLFFBQVEsQ0FBQztRQUNkLEtBQUssVUFBVSxDQUFDO1FBQ2hCLEtBQUssT0FBTyxDQUFDO1FBQ2IsS0FBSyxNQUFNO1lBQ1YsT0FBTyxRQUFRLENBQUE7UUFDaEIsS0FBSyxXQUFXLENBQUM7UUFDakIsS0FBSyxVQUFVLENBQUM7UUFDaEIsS0FBSyxZQUFZLENBQUM7UUFDbEIsS0FBSyxXQUFXO1lBQ2YsT0FBTyxVQUFVLENBQUE7UUFDbEIsS0FBSyxNQUFNLENBQUM7UUFDWixLQUFLLFNBQVM7WUFDYixPQUFPLE1BQU0sQ0FBQTtRQUNkLEtBQUssTUFBTSxDQUFDO1FBQ1osS0FBSyxPQUFPO1lBQ1gsT0FBTyxXQUFXLENBQUE7UUFDbkI7WUFDQyxPQUFPLFFBQVEsQ0FBQTtLQUNoQjtBQUNGLENBQUM7QUFFRCxTQUFTLGdCQUFnQixDQUFDLEdB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

package/dist/formatting-templates.d.ts

@@ -0,0 +1,3 @@
+import { FormattingTemplates } from "./types/chart";
+declare const formattingTemplates: FormattingTemplates;
+export default formattingTemplates;

package/dist/formatting-templates.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const formattingTemplates = {
+    "CURRENCY": {
+        "prefix": "$",
+        "fractionDigits": 2,
+        "groupingSymbol": ",",
+    },
+    "MEDIUMDATE": {
+        "format": "medium",
+    },
+    "LONGDATE": {
+        "format": "long",
+    },
+};
+exports.default = formattingTemplates;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZm9ybWF0dGluZy10ZW1wbGF0ZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZm9ybWF0dGluZy10ZW1wbGF0ZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFFQSxNQUFNLG1CQUFtQixHQUF3QjtJQUNoRCxVQUFVLEVBQUU7UUFDWCxRQUFRLEVBQUUsR0FBRztRQUNiLGdCQUFnQixFQUFFLENBQUM7UUFDbkIsZ0JBQWdCLEVBQUUsR0FBRztLQUNyQjtJQUNELFlBQVksRUFBRTtRQUNiLFFBQVEsRUFBRSxRQUFRO0tBQ2xCO0lBQ0QsVUFBVSxFQUFFO1FBQ1gsUUFBUSxFQUFFLE1BQU07S0FDaEI7Q0FDRCxDQUFBO0FBQ0Qsa0JBQWUsbUJBQW1CLENBQUEifQ==

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { handleFormattingTemplates } from './chart-helper.js';
+import * as formatterTemplates from './formatting-templates';
+import { DashboardReportParameter } from './types/parameter';
+import { Session, SiteType } from './types/session';
+import { MultiSeriesOptions, Formatting, Chart, Table, GoogleDataTable, ProcessedFormatting } from './types/chart';
+import { Connection } from 'mysql';
+import { Report, ReportInput } from './types/report';
+type LoadDataTableAndProcessedFormattingOptions = {
+    query: {
+        sql: string;
+        values: unknown[];
+    };
+    multiSeries?: MultiSeriesOptions;
+    formatting?: Formatting;
+    chartType: string;
+    cumulative?: boolean;
+    table?: Table;
+};
+declare function loadDataTableAndProcessedFormatting(mysqlConnection: Connection, { query: queryObject, multiSeries, formatting, chartType, cumulative, table }: LoadDataTableAndProcessedFormattingOptions): Promise<{
+    dataTable: GoogleDataTable | Table;
+    processedFormatting: ProcessedFormatting;
+}>;
+type loadDataTableOptions = {
+    query: {
+        sql: string;
+        values: unknown[];
+    };
+    multiSeries: MultiSeriesOptions;
+    formatting: Formatting;
+    chartType: string;
+};
+declare function loadDataTable(mysqlConnection: Connection, { query: queryObject, multiSeries, formatting, chartType }: loadDataTableOptions): Promise<GoogleDataTable>;
+type loadOutputParameterValuesOptions = {
+    definitionList: DashboardReportParameter[];
+    selectionList?: Array<Partial<DashboardReportParameter> & Pick<DashboardReportParameter, 'name'>>;
+    forClient?: boolean;
+    session: Session;
+    site?: SiteType;
+    siteIdColumn?: string;
+    siteNameColumn?: string;
+};
+declare function loadOutputParameterValues(mysqlConnection: Connection, { definitionList, selectionList, forClient, session, site, siteIdColumn, siteNameColumn }: loadOutputParameterValuesOptions): Promise<DashboardReportParameter[]>;
+declare const parameterizeQuery: (queryString: string, parameterValues: DashboardReportParameter[]) => {
+    sql: string;
+    values: unknown[];
+};
+type FormatReportMetadataOptions = {
+    report: ReportInput;
+    chartsInReport: Chart[];
+    session: Session;
+    site: SiteType;
+    siteIdColumn?: string;
+    siteNameColumn?: string;
+};
+declare function formatReportMetadata(mysqlConnection: Connection, { report, chartsInReport, session, site, siteIdColumn, siteNameColumn }: FormatReportMetadataOptions): Promise<Report>;
+type FormatChartDataForReportOptions = {
+    reportParameters: DashboardReportParameter[];
+    chart: Chart;
+    reportChart: {
+        chartId: number;
+        dashboardReportId: number;
+        jsonOverride: Partial<Chart>;
+        rank: number;
+        reportChartId: number;
+    };
+    parameterSelectionList: DashboardReportParameter[];
+    session: Session;
+    site: SiteType;
+    siteIdColumn?: string;
+    siteNameColumn?: string;
+};
+declare function formatChartDataForReport(mysqlConnection: Connection, { reportParameters, chart, reportChart, parameterSelectionList, session, site, siteIdColumn, siteNameColumn }: FormatChartDataForReportOptions): Promise<Omit<Chart, 'query'>>;
+export { formatReportMetadata, formatChartDataForReport, loadOutputParameterValues, loadDataTable, loadDataTableAndProcessedFormatting, parameterizeQuery, handleFormattingTemplates, formatterTemplates, };