sfdx-hardis 6.16.1-beta202512161830.0 → 6.17.1

package/lib/common/utils/dataCloudUtils.js

@@ -0,0 +1,279 @@
+import { SfError } from "@salesforce/core";
+import { uxLog } from "./index.js";
+import fs from "fs-extra";
+import path from "path";
+export const DATA_CLOUD_QUERIES_FOLDER_ROOT = path.join(process.cwd(), 'scripts', 'data-cloud-queries');
+const QUERY_CONNECT_PATH = "ssot/query-sql";
+const DEFAULT_DATASPACE = "default";
+const DEFAULT_WORKLOAD_NAME = "sfdx-hardis-cli";
+const DEFAULT_ROW_LIMIT = 2000;
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+const DEFAULT_POLL_TIMEOUT_MS = 120000;
+const DEFAULT_OMIT_SCHEMA = false;
+const SUCCESS_STATUSES = new Set(["finished", "resultsproduced"]);
+const RUNNING_STATUSES = new Set(["running", "queued"]);
+const FAILURE_STATUSES = new Set(["failed", "canceled", "cancelled", "error"]);
+export async function listAvailableDataCloudQueries() {
+    // List folders in DATA_CLOUD_QUERIES_FOLDER_ROOT
+    const queries = [];
+    if (fs.existsSync(DATA_CLOUD_QUERIES_FOLDER_ROOT)) {
+        const files = await fs.readdir(DATA_CLOUD_QUERIES_FOLDER_ROOT);
+        for (const file of files) {
+            const fullPath = path.join(DATA_CLOUD_QUERIES_FOLDER_ROOT, file);
+            const stat = await fs.stat(fullPath);
+            if (stat.isFile() && path.extname(file).toLowerCase() === '.sql') {
+                queries.push(path.basename(file, '.sql'));
+            }
+        }
+    }
+    return queries;
+}
+export async function loadDataCloudQueryFromFile(queryName) {
+    const filePath = path.join(DATA_CLOUD_QUERIES_FOLDER_ROOT, `${queryName}.sql`);
+    if (!fs.existsSync(filePath)) {
+        throw new SfError(`Data Cloud query file not found: ${filePath}`);
+    }
+    const queryContent = await fs.readFile(filePath, 'utf8');
+    return queryContent;
+}
+export async function saveDataCloudQueryToFile(queryName, queryContent) {
+    // Ensure the folder exists
+    await fs.ensureDir(DATA_CLOUD_QUERIES_FOLDER_ROOT);
+    const filePath = path.join(DATA_CLOUD_QUERIES_FOLDER_ROOT, `${queryName}.sql`);
+    await fs.writeFile(filePath, queryContent, 'utf8');
+    return filePath;
+}
+export async function dataCloudSqlQuery(query, conn, options) {
+    if (!query || !query.trim()) {
+        throw new SfError("[DataCloudSqlQuery] The Data Cloud SQL query must be a non-empty string.");
+    }
+    const settings = resolveOptions(options);
+    try {
+        const initialChunk = await submitInitialQuery(query.trim(), conn, settings);
+        if (!initialChunk.metadata.length) {
+            throw new SfError(`[DataCloudSqlQuery] Data Cloud SQL query did not return column metadata.\n${JSON.stringify(initialChunk)}`);
+        }
+        if (!initialChunk.status.queryId) {
+            throw new SfError(`[DataCloudSqlQuery] Data Cloud SQL query did not return a queryId needed for pagination.\n${JSON.stringify(initialChunk)}`);
+        }
+        let metadata = initialChunk.metadata;
+        const records = [...initialChunk.records];
+        const rawData = [...initialChunk.rawData];
+        let status = initialChunk.status;
+        status = await waitForQueryCompletion(conn, status, settings);
+        const pagination = await fetchRemainingRows(conn, status.queryId, metadata, records.length, status.rowCount, settings);
+        if (!metadata.length && pagination.metadata.length) {
+            metadata = pagination.metadata;
+        }
+        if (pagination.records.length) {
+            records.push(...pagination.records);
+            rawData.push(...pagination.rawData);
+        }
+        uxLog("log", this, `[DataCloudSqlQuery] Retrieved ${records.length} records.`);
+        return {
+            queryId: status.queryId,
+            metadata,
+            status: {
+                ...status,
+                rowCount: status.rowCount ?? records.length,
+            },
+            records,
+            rawData,
+            returnedRows: records.length,
+            hasMoreRows: false,
+        };
+    }
+    catch (error) {
+        throw wrapQueryError(error);
+    }
+}
+async function submitInitialQuery(query, conn, options) {
+    const endpoint = buildQueryConnectUrl(conn, options);
+    uxLog("log", this, `[DataCloudSqlQuery] Submitting initial query to ${endpoint}:\n${query}`);
+    const response = await conn.request({
+        method: "POST",
+        url: endpoint,
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ sql: query }),
+    });
+    return normalizeQueryResponse(response);
+}
+async function waitForQueryCompletion(conn, status, options) {
+    const deadline = Date.now() + options.pollTimeoutMs;
+    let currentStatus = status;
+    while (isRunningStatus(currentStatus.completionStatus)) {
+        if (Date.now() > deadline) {
+            throw new SfError(`Timed out after ${options.pollTimeoutMs}ms while waiting for Data Cloud query ${currentStatus.queryId} to finish.`);
+        }
+        const waitTimeMs = Math.min(options.waitTimeMs, Math.max(0, deadline - Date.now()));
+        currentStatus = await fetchQueryStatus(conn, currentStatus.queryId, options, waitTimeMs);
+        if (isFailureStatus(currentStatus.completionStatus)) {
+            throw new SfError(`Data Cloud SQL query ${currentStatus.queryId} failed with status ${currentStatus.completionStatus}.`);
+        }
+        if (isRunningStatus(currentStatus.completionStatus) && options.pollIntervalMs > 0) {
+            await delay(options.pollIntervalMs);
+        }
+    }
+    if (!isSuccessStatus(currentStatus.completionStatus)) {
+        throw new SfError(`Unexpected Data Cloud SQL query status: ${currentStatus.completionStatus || "Unknown"}.`);
+    }
+    return currentStatus;
+}
+async function fetchRemainingRows(conn, queryId, metadata, alreadyFetched, totalRows, options) {
+    const rowLimit = Math.max(1, options.rowLimit);
+    const records = [];
+    const rawData = [];
+    let offset = alreadyFetched;
+    let remaining = typeof totalRows === "number" ? Math.max(totalRows - alreadyFetched, 0) : undefined;
+    while (remaining === undefined || remaining > 0) {
+        const response = await fetchRowsPage(conn, queryId, options, offset, rowLimit);
+        const rows = response.data ?? [];
+        if (response.metadata && !metadata.length) {
+            metadata = response.metadata;
+        }
+        if (!rows.length) {
+            break;
+        }
+        rawData.push(...rows);
+        records.push(...rows.map((row) => mapRowToRecord(row, metadata)));
+        offset += rows.length;
+        if (remaining !== undefined) {
+            remaining -= rows.length;
+        }
+        if (rows.length < rowLimit) {
+            break;
+        }
+    }
+    return { records, rawData, metadata };
+}
+async function fetchQueryStatus(conn, queryId, options, waitTimeMs) {
+    const url = buildQueryConnectUrl(conn, options, [queryId], {
+        waitTimeMs: waitTimeMs > 0 ? waitTimeMs : undefined,
+    });
+    const response = await conn.request({
+        method: "GET",
+        url,
+    });
+    return normalizeStatusResponse(response, queryId);
+}
+async function fetchRowsPage(conn, queryId, options, offset, rowLimit) {
+    const url = buildQueryConnectUrl(conn, options, [queryId, "rows"], {
+        rowLimit,
+        offset,
+        omitSchema: options.omitSchema,
+    });
+    return conn.request({
+        method: "GET",
+        url,
+    });
+}
+function normalizeQueryResponse(response) {
+    if (typeof response !== "object" || response === null) {
+        throw new SfError("Invalid response format received from Data Cloud SQL query.\n" + JSON.stringify(response, null, 2));
+    }
+    const metadata = response.metadata ?? [];
+    const dataRows = response.data ?? [];
+    const records = metadata.length ? dataRows.map((row) => mapRowToRecord(row, metadata)) : [];
+    const status = normalizeStatusResponse(response.status ?? {}, "");
+    return {
+        queryId: status.queryId,
+        metadata,
+        status,
+        records,
+        rawData: dataRows,
+        returnedRows: response.returnedRows ?? records.length,
+        hasMoreRows: hasMoreRowsPending(status, records.length),
+    };
+}
+function normalizeStatusResponse(status, fallbackQueryId) {
+    return {
+        chunkCount: status.chunkCount ?? 0,
+        completionStatus: status.completionStatus ?? "Unknown",
+        queryId: status.queryId ?? fallbackQueryId,
+        rowCount: status.rowCount,
+        expirationTime: status.expirationTime,
+        progress: status.progress,
+    };
+}
+function mapRowToRecord(row, metadata) {
+    if (!metadata.length) {
+        throw new SfError("Cannot map Data Cloud rows without column metadata.");
+    }
+    return metadata.reduce((acc, column, index) => {
+        acc[column.name] = row[index] ?? null;
+        return acc;
+    }, {});
+}
+function hasMoreRowsPending(status, fetchedRows) {
+    if (typeof status.rowCount === "number") {
+        return status.rowCount > fetchedRows;
+    }
+    const state = status.completionStatus?.toLowerCase();
+    return state === "running" || state === "resultsproduced";
+}
+function buildQueryConnectUrl(conn, options, pathSegments = [], queryParams = {}) {
+    const base = conn.baseUrl().replace(/\/$/, "");
+    const baseSegments = QUERY_CONNECT_PATH.split("/");
+    const path = [...baseSegments, ...pathSegments]
+        .filter((segment) => segment && segment.length)
+        .map((segment) => encodeURIComponent(segment))
+        .join("/");
+    const params = {
+        dataspace: options.dataspace,
+        workloadName: options.workloadName,
+        ...queryParams,
+    };
+    const queryString = Object.entries(params)
+        .filter(([, value]) => value !== undefined && value !== null && value !== "")
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
+        .join("&");
+    return queryString ? `${base}/${path}?${queryString}` : `${base}/${path}`;
+}
+function resolveOptions(options) {
+    return {
+        dataspace: options?.dataspace || DEFAULT_DATASPACE,
+        workloadName: options?.workloadName || DEFAULT_WORKLOAD_NAME,
+        rowLimit: options?.rowLimit || DEFAULT_ROW_LIMIT,
+        pollIntervalMs: options?.pollIntervalMs || DEFAULT_POLL_INTERVAL_MS,
+        pollTimeoutMs: options?.pollTimeoutMs || DEFAULT_POLL_TIMEOUT_MS,
+        waitTimeMs: options?.waitTimeMs || DEFAULT_POLL_INTERVAL_MS,
+        omitSchema: options?.omitSchema ?? DEFAULT_OMIT_SCHEMA,
+    };
+}
+function isRunningStatus(status) {
+    return RUNNING_STATUSES.has(status?.toLowerCase());
+}
+function isSuccessStatus(status) {
+    return SUCCESS_STATUSES.has(status?.toLowerCase());
+}
+function isFailureStatus(status) {
+    return FAILURE_STATUSES.has(status?.toLowerCase());
+}
+function delay(ms) {
+    if (ms <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function wrapQueryError(error) {
+    if (isSfRequestError(error)) {
+        const details = [error.message];
+        const bodyMessage = error.body?.message;
+        const bodyDescription = error.body?.error_description;
+        if (bodyMessage) {
+            details.push(bodyMessage);
+        }
+        if (bodyDescription && bodyDescription !== bodyMessage) {
+            details.push(bodyDescription);
+        }
+        if (error.statusCode) {
+            details.push(`(status ${error.statusCode})`);
+        }
+        return new SfError(`[DataCloudSqlQuery] Data Cloud SQL query failed: ${details.filter(Boolean).join(" ")}`.trim());
+    }
+    return error instanceof SfError ? error : new SfError("[DataCloudSqlQuery] Unknown error while executing Data Cloud SQL query.");
+}
+function isSfRequestError(error) {
+    return Boolean(error && typeof error === "object" && "message" in error);
+}
+//# sourceMappingURL=dataCloudUtils.js.map

package/lib/common/utils/dataCloudUtils.js.map

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

package/lib/common/utils/filesUtils.d.ts

@@ -173,20 +173,19 @@ export declare function generateReportPath(fileNamePrefix: string, outputFile: s
  * @param {string} outputPath - The path where the CSV file will be written.
  * @returns {Promise<void>} - A Promise that resolves when the operation is complete.
  */
-export declare function generateCsvFile(data: any[], outputPath: string, options: {
-    fileTitle?: string;
-    csvFileTitle?: string;
-    xlsFileTitle?: string;
-    noExcel?: boolean;
-}): Promise<any>;
-export declare function createXlsxFromCsv(outputPath: string, options: {
+export interface ExcelColumnStyle {
+    wrap?: boolean;
+    width?: number;
+    hyperlinkFromValue?: boolean;
+    maxHeight?: number;
+}
+export interface ExcelExportOptions {
     fileTitle?: string;
     csvFileTitle?: string;
     xlsFileTitle?: string;
     noExcel?: boolean;
-}, result: any): Promise<void>;
-export declare function createXlsxFromCsvFiles(csvFilesPath: string[], outputPath: string, options: {
-    fileTitle?: string;
-    csvFileTitle?: string;
-    xlsFileTitle?: string;
-}): Promise<void>;
+    columnsCustomStyles?: Record<string, ExcelColumnStyle>;
+}
+export declare function generateCsvFile(data: any[], outputPath: string, options?: ExcelExportOptions): Promise<any>;
+export declare function createXlsxFromCsv(outputPath: string, options: ExcelExportOptions, result: any): Promise<void>;
+export declare function createXlsxFromCsvFiles(csvFilesPath: string[], outputPath: string, options?: ExcelExportOptions): Promise<void>;

package/lib/common/utils/filesUtils.js

@@ -1220,16 +1220,7 @@ export async function generateReportPath(fileNamePrefix, outputFile, options = {
         return outputFile;
     }
 }
-/**
- * @description This function generates a CSV file from the provided data and writes it to the specified output path.
- * If the operation is successful, it logs a message and requests to open the file.
- * If an error occurs during the operation, it logs the error message and stack trace.
- *
- * @param {any[]} data - The data to be written to the CSV file.
- * @param {string} outputPath - The path where the CSV file will be written.
- * @returns {Promise<void>} - A Promise that resolves when the operation is complete.
- */
-export async function generateCsvFile(data, outputPath, options) {
+export async function generateCsvFile(data, outputPath, options = {}) {
     const result = {};
     try {
         const csvContent = Papa.unparse(data);
@@ -1259,7 +1250,7 @@ export async function createXlsxFromCsv(outputPath, options, result) {
         const xslFileName = path.basename(outputPath).replace('.csv', '.xlsx');
         const xslxFile = path.join(xlsDirName, xslFileName);
         await fs.ensureDir(xlsDirName);
-        await csvToXls(outputPath, xslxFile);
+        await csvToXls(outputPath, xslxFile, options);
         uxLog("action", this, c.cyan(c.italic(`Please see detailed XLSX log in ${c.bold(xslxFile)}`)));
         const xlsFileTitle = options?.fileTitle ? `${options.fileTitle} (XLSX)` : options?.xlsFileTitle ?? "Report (XLSX)";
         WebSocketClient.sendReportFileMessage(xslxFile, xlsFileTitle, "report");
@@ -1278,28 +1269,19 @@ export async function createXlsxFromCsv(outputPath, options, result) {
         uxLog("warning", this, c.yellow('Error while generating XLSX log file:\n' + e2.message + '\n' + e2.stack));
     }
 }
-async function csvToXls(csvFile, xslxFile) {
+async function csvToXls(csvFile, xslxFile, options) {
     const workbook = new ExcelJS.Workbook();
     const worksheet = await workbook.csv.readFile(csvFile);
-    // Set filters
-    worksheet.autoFilter = 'A1:Z1';
-    // Adjust column size (only if the file is not too big, to avoid performances issues)
-    if (worksheet.rowCount < 5000) {
-        worksheet.columns.forEach((column) => {
-            const lengths = (column.values || []).map((v) => (v || '').toString().length);
-            const maxLength = Math.max(...lengths.filter((v) => typeof v === 'number'));
-            column.width = maxLength;
-        });
-    }
+    applyWorksheetFormatting(worksheet, options);
     await workbook.xlsx.writeFile(xslxFile);
 }
-export async function createXlsxFromCsvFiles(csvFilesPath, outputPath, options) {
+export async function createXlsxFromCsvFiles(csvFilesPath, outputPath, options = {}) {
     try {
         const xlsDirName = path.join(path.dirname(outputPath), 'xls');
         const xslFileName = path.basename(outputPath).replace('.csv', '.xlsx');
         const xslxFile = path.join(xlsDirName, xslFileName);
         await fs.ensureDir(xlsDirName);
-        await csvFilesToXls(csvFilesPath, xslxFile);
+        await csvFilesToXls(csvFilesPath, xslxFile, options);
         uxLog("action", this, c.cyan(c.italic(`Please see detailed XLSX log in ${c.bold(xslxFile)}`)));
         const xlsFileTitle = options?.fileTitle ? `${options.fileTitle} (XLSX)` : options?.xlsFileTitle ?? "Report (XLSX)";
         WebSocketClient.sendReportFileMessage(xslxFile, xlsFileTitle, "report");
@@ -1318,7 +1300,7 @@ export async function createXlsxFromCsvFiles(csvFilesPath, outputPath, options)
         uxLog("warning", this, c.yellow('Error while generating XLSX log file:\n' + e2.message + '\n' + e2.stack));
     }
 }
-async function csvFilesToXls(csvFiles, xslxFile) {
+async function csvFilesToXls(csvFiles, xslxFile, options) {
     const workbook = new ExcelJS.Workbook();
     let worksheet;
     for (const csvFile of csvFiles) {
@@ -1328,24 +1310,7 @@ async function csvFilesToXls(csvFiles, xslxFile) {
         }
         worksheet = await workbook.csv.readFile(csvFile);
         worksheet.name = path.basename(csvFile).replace('.csv', '').substring(0, 25);
-        // Set filters
-        worksheet.autoFilter = 'A1:Z1';
-        // Adjust column size (only if the file is not too big, to avoid performances issues)
-        if (worksheet.rowCount < 5000) {
-            if (!worksheet.columns) {
-                console.error(`[csvFilesToXls] worksheet.columns is null for file: ${csvFile}`);
-                continue;
-            }
-            worksheet.columns.forEach((column, idx) => {
-                if (!column) {
-                    console.error(`[csvFilesToXls] Null column at index ${idx} in file: ${csvFile}`);
-                    return;
-                }
-                const lengths = (column.values || []).map((v) => (v || '').toString().length);
-                const maxLength = Math.max(...lengths.filter((v) => typeof v === 'number'));
-                column.width = maxLength;
-            });
-        }
+        applyWorksheetFormatting(worksheet, options);
         // Scan only the first row and convert string formulas
         const firstRow = worksheet.getRow(1);
         firstRow.eachCell((cell) => {
@@ -1356,4 +1321,110 @@ async function csvFilesToXls(csvFiles, xslxFile) {
     }
     await workbook.xlsx.writeFile(xslxFile);
 }
+function applyWorksheetFormatting(worksheet, options) {
+    worksheet.autoFilter = 'A1:Z1';
+    if (!worksheet.columns) {
+        return;
+    }
+    const columnStylePreferences = new Map();
+    const columnMaxHeightConstraints = new Map();
+    Object.entries(options?.columnsCustomStyles ?? {}).forEach(([columnName, style]) => {
+        if (!columnName || !style) {
+            return;
+        }
+        const normalizedName = columnName.trim().toLowerCase();
+        const sanitizedStyle = {
+            wrap: style.wrap === true,
+            width: typeof style.width === 'number' && style.width > 0 ? style.width : undefined,
+            hyperlinkFromValue: style.hyperlinkFromValue === true,
+            maxHeight: typeof style.maxHeight === 'number' && style.maxHeight > 0 ? style.maxHeight : undefined,
+        };
+        columnStylePreferences.set(normalizedName, sanitizedStyle);
+    });
+    const headerRow = worksheet.getRow(1);
+    const headerByColumn = new Map();
+    headerRow.eachCell({ includeEmpty: true }, (cell, colNumber) => {
+        const headerValue = (cell?.text ?? (cell.value ?? '')).toString();
+        headerByColumn.set(colNumber, headerValue);
+    });
+    const shouldAutoFit = worksheet.rowCount < 5000;
+    worksheet.columns.forEach((column, idx) => {
+        if (!column) {
+            return;
+        }
+        const columnNumber = column.number ?? idx + 1;
+        const headerName = headerByColumn.get(columnNumber) ?? '';
+        const normalizedHeader = headerName.trim().toLowerCase();
+        const stylePreferences = columnStylePreferences.get(normalizedHeader);
+        const preferredWidth = stylePreferences?.width;
+        if (typeof preferredWidth === 'number') {
+            column.width = preferredWidth;
+        }
+        else if (shouldAutoFit) {
+            const lengths = (column.values || []).map((value) => (value ?? '').toString().length);
+            const filteredLengths = lengths.filter((len) => Number.isFinite(len));
+            const maxLength = filteredLengths.length > 0 ? Math.max(...filteredLengths) : 10;
+            column.width = maxLength;
+        }
+        if (stylePreferences?.wrap) {
+            const updatedAlignment = { ...(column.alignment || {}), wrapText: true };
+            column.alignment = updatedAlignment;
+            column.eachCell?.({ includeEmpty: true }, (cell) => {
+                cell.alignment = { ...(cell.alignment || {}), wrapText: true };
+            });
+        }
+        if (stylePreferences?.hyperlinkFromValue) {
+            column.eachCell?.({ includeEmpty: true }, (cell) => {
+                const hyperlinkTarget = extractHyperlinkTarget(cell);
+                if (!hyperlinkTarget) {
+                    return;
+                }
+                const textValue = cell.text?.trim() || hyperlinkTarget;
+                cell.value = { text: textValue, hyperlink: hyperlinkTarget };
+                cell.font = { ...(cell.font || {}), color: { argb: 'FF0563C1' }, underline: true };
+            });
+        }
+        if (stylePreferences?.maxHeight && columnNumber) {
+            columnMaxHeightConstraints.set(columnNumber, stylePreferences.maxHeight);
+        }
+    });
+    if (columnMaxHeightConstraints.size > 0) {
+        worksheet.eachRow({ includeEmpty: true }, (row, rowNumber) => {
+            if (rowNumber === 1 || !row) {
+                return;
+            }
+            let enforcedMaxHeight;
+            columnMaxHeightConstraints.forEach((maxHeight, columnNumber) => {
+                const cell = row.getCell(columnNumber);
+                if (!cell) {
+                    return;
+                }
+                const hasValue = cell.value !== null && cell.value !== undefined && cell.value !== '';
+                if (!hasValue) {
+                    return;
+                }
+                enforcedMaxHeight = typeof enforcedMaxHeight === 'number' ? Math.min(enforcedMaxHeight, maxHeight) : maxHeight;
+            });
+            if (typeof enforcedMaxHeight === 'number') {
+                if (!row.height || row.height > enforcedMaxHeight) {
+                    row.height = enforcedMaxHeight;
+                }
+            }
+        });
+    }
+}
+function extractHyperlinkTarget(cell) {
+    const rawValue = typeof cell.value === 'string' ? cell.value : cell.text;
+    if (!rawValue) {
+        return null;
+    }
+    const trimmed = rawValue.trim();
+    if (!trimmed) {
+        return null;
+    }
+    return isLikelyHyperlink(trimmed) ? trimmed : null;
+}
+function isLikelyHyperlink(value) {
+    return /^(https?:\/\/|mailto:)/i.test(value);
+}
 //# sourceMappingURL=filesUtils.js.map