@ibm/ibmi-mcp-server 0.1.0

package/dist/utils/formatting/tableFormatter.js

@@ -0,0 +1,550 @@
+/**
+ * @fileoverview Table formatter utility for creating tables in multiple formats.
+ * Supports markdown, ASCII, grid (Unicode), and compact table styles with configurable
+ * alignment, truncation, and formatting options.
+ * @module src/utils/formatting/tableFormatter
+ */
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { logger, requestContextService, } from "../index.js";
+/**
+ * Utility class for formatting tabular data into various table styles.
+ * Provides methods for rendering arrays of objects or raw 2D arrays as tables.
+ */
+export class TableFormatter {
+    /**
+     * Default formatting options.
+     * @private
+     */
+    defaultOptions = {
+        style: "markdown",
+        alignment: {},
+        maxWidth: 50,
+        truncate: true,
+        headerStyle: "none",
+        minWidth: 3,
+        padding: 1,
+        nullReplacement: "-",
+    };
+    /**
+     * Track NULL value counts per column during formatting.
+     * Reset before each formatting operation.
+     * @private
+     */
+    nullCounts = {};
+    /**
+     * Format an array of objects as a table.
+     * Automatically extracts headers from object keys.
+     *
+     * @template T - Type of objects in the array
+     * @param data - Array of objects to format
+     * @param options - Table formatting options
+     * @param context - Optional request context for logging
+     * @returns Formatted table string
+     * @throws {McpError} If data is invalid or formatting fails
+     *
+     * @example
+     * ```typescript
+     * const data = [
+     *   { name: 'Alice', age: 30, role: 'Engineer' },
+     *   { name: 'Bob', age: 25, role: 'Designer' }
+     * ];
+     * const table = tableFormatter.format(data, { style: 'grid' });
+     * ```
+     */
+    format(data, options, context) {
+        const logContext = context ||
+            requestContextService.createRequestContext({
+                operation: "TableFormatter.format",
+            });
+        if (!Array.isArray(data)) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, "Data must be an array", logContext);
+        }
+        if (data.length === 0) {
+            logger.debug(logContext, "Empty data array provided to table formatter");
+            return "";
+        }
+        // Extract headers from first object
+        const headers = Object.keys(data[0]);
+        // Merge options with defaults
+        const opts = {
+            ...this.defaultOptions,
+            ...options,
+            alignment: { ...this.defaultOptions.alignment, ...options?.alignment },
+        };
+        // Convert objects to 2D array (without NULL tracking for backward compatibility)
+        const rows = data.map((obj) => headers.map((header) => this.stringify(obj[header], opts.nullReplacement)));
+        logger.debug({
+            ...logContext,
+            rowCount: rows.length,
+            columnCount: headers.length,
+        }, "Formatting table from object array");
+        return this.formatRaw(headers, rows, options, context);
+    }
+    /**
+     * Format a raw 2D array with explicit headers.
+     * Provides full control over headers and cell values.
+     *
+     * @param headers - Array of column headers
+     * @param rows - 2D array of cell values
+     * @param options - Table formatting options
+     * @param context - Optional request context for logging
+     * @returns Formatted table string
+     * @throws {McpError} If headers/rows are invalid or formatting fails
+     *
+     * @example
+     * ```typescript
+     * const headers = ['Name', 'Age', 'Role'];
+     * const rows = [
+     *   ['Alice', '30', 'Engineer'],
+     *   ['Bob', '25', 'Designer']
+     * ];
+     * const table = tableFormatter.formatRaw(headers, rows, { style: 'ascii' });
+     * ```
+     */
+    formatRaw(headers, rows, options, context) {
+        const logContext = context ||
+            requestContextService.createRequestContext({
+                operation: "TableFormatter.formatRaw",
+            });
+        // Validate inputs
+        if (!Array.isArray(headers) || headers.length === 0) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, "Headers must be a non-empty array", logContext);
+        }
+        if (!Array.isArray(rows)) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, "Rows must be an array", logContext);
+        }
+        if (rows.length === 0) {
+            logger.debug(logContext, "Empty rows array provided to table formatter");
+            return "";
+        }
+        // Validate row lengths
+        const columnCount = headers.length;
+        for (let i = 0; i < rows.length; i++) {
+            if (rows[i].length !== columnCount) {
+                throw new McpError(JsonRpcErrorCode.ValidationError, `Row ${i} has ${rows[i].length} columns but expected ${columnCount}`, { ...logContext, rowIndex: i, expectedColumns: columnCount });
+            }
+        }
+        // Merge options with defaults
+        const opts = {
+            ...this.defaultOptions,
+            ...options,
+            alignment: { ...this.defaultOptions.alignment, ...options?.alignment },
+        };
+        // Apply header styling
+        const styledHeaders = this.applyHeaderStyle(headers, opts.headerStyle);
+        // Calculate column widths and metadata
+        const columns = this.calculateColumns(styledHeaders, rows, opts, logContext);
+        // Render table based on style
+        try {
+            const result = this.renderTable(columns, styledHeaders, rows, opts);
+            logger.debug({
+                ...logContext,
+                style: opts.style,
+                rows: rows.length,
+                columns: columns.length,
+            }, "Table formatted successfully");
+            return result;
+        }
+        catch (error) {
+            const err = error;
+            logger.error({
+                ...logContext,
+                error: err.message,
+            }, "Failed to render table");
+            throw new McpError(JsonRpcErrorCode.InternalError, `Failed to render table: ${err.message}`, { ...logContext, originalError: err.stack });
+        }
+    }
+    /**
+     * Format an array of objects as a table with NULL value tracking.
+     * Returns both the formatted table and metadata about NULL values.
+     *
+     * @template T - Type of objects in the array
+     * @param data - Array of objects to format
+     * @param options - Table formatting options
+     * @param context - Optional request context for logging
+     * @returns Object containing formatted table and metadata
+     * @throws {McpError} If data is invalid or formatting fails
+     *
+     * @example
+     * ```typescript
+     * const data = [
+     *   { name: 'Alice', age: 30, salary: null },
+     *   { name: 'Bob', age: 25, salary: 50000 }
+     * ];
+     * const result = tableFormatter.formatWithMetadata(data, { style: 'grid' });
+     * console.log(result.table);
+     * console.log(result.metadata.nullCounts); // { salary: 1 }
+     * ```
+     */
+    formatWithMetadata(data, options, context) {
+        const logContext = context ||
+            requestContextService.createRequestContext({
+                operation: "TableFormatter.formatWithMetadata",
+            });
+        if (!Array.isArray(data)) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, "Data must be an array", logContext);
+        }
+        if (data.length === 0) {
+            logger.debug(logContext, "Empty data array provided to table formatter");
+            return {
+                table: "",
+                metadata: { nullCounts: {} },
+            };
+        }
+        // Reset NULL tracking
+        this.nullCounts = {};
+        // Extract headers from first object
+        const headers = Object.keys(data[0]);
+        // Merge options with defaults
+        const opts = {
+            ...this.defaultOptions,
+            ...options,
+            alignment: { ...this.defaultOptions.alignment, ...options?.alignment },
+        };
+        // Convert objects to 2D array WITH NULL tracking
+        const rows = data.map((obj) => headers.map((header) => this.stringify(obj[header], opts.nullReplacement, header)));
+        logger.debug({
+            ...logContext,
+            rowCount: rows.length,
+            columnCount: headers.length,
+            nullCounts: this.nullCounts,
+        }, "Formatting table with metadata");
+        // Format the table
+        const table = this.formatRaw(headers, rows, options, context);
+        return {
+            table,
+            metadata: {
+                nullCounts: { ...this.nullCounts },
+            },
+        };
+    }
+    /**
+     * Format a raw 2D array with NULL value tracking.
+     * Returns both the formatted table and metadata about NULL values.
+     *
+     * Note: For raw arrays, NULL tracking uses column indices as keys.
+     *
+     * @param headers - Array of column headers
+     * @param rows - 2D array of cell values (may contain null/undefined)
+     * @param options - Table formatting options
+     * @param context - Optional request context for logging
+     * @returns Object containing formatted table and metadata
+     * @throws {McpError} If headers/rows are invalid or formatting fails
+     *
+     * @example
+     * ```typescript
+     * const headers = ['Name', 'Age', 'Salary'];
+     * const rows = [
+     *   ['Alice', 30, null],
+     *   ['Bob', 25, 50000]
+     * ];
+     * const result = tableFormatter.formatRawWithMetadata(headers, rows);
+     * console.log(result.metadata.nullCounts); // { '2': 1 } (column index 2)
+     * ```
+     */
+    formatRawWithMetadata(headers, rows, options, context) {
+        const logContext = context ||
+            requestContextService.createRequestContext({
+                operation: "TableFormatter.formatRawWithMetadata",
+            });
+        // Validate inputs
+        if (!Array.isArray(headers) || headers.length === 0) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, "Headers must be a non-empty array", logContext);
+        }
+        if (!Array.isArray(rows)) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, "Rows must be an array", logContext);
+        }
+        if (rows.length === 0) {
+            logger.debug(logContext, "Empty rows array provided to table formatter");
+            return {
+                table: "",
+                metadata: { nullCounts: {} },
+            };
+        }
+        // Reset NULL tracking
+        this.nullCounts = {};
+        // Merge options with defaults
+        const opts = {
+            ...this.defaultOptions,
+            ...options,
+            alignment: { ...this.defaultOptions.alignment, ...options?.alignment },
+        };
+        // Convert all cells to strings WITH NULL tracking
+        const stringRows = rows.map((row) => row.map((cell, colIndex) => this.stringify(cell, opts.nullReplacement, colIndex.toString())));
+        logger.debug({
+            ...logContext,
+            rowCount: stringRows.length,
+            columnCount: headers.length,
+            nullCounts: this.nullCounts,
+        }, "Formatting raw table with metadata");
+        // Format the table
+        const table = this.formatRaw(headers, stringRows, options, context);
+        return {
+            table,
+            metadata: {
+                nullCounts: { ...this.nullCounts },
+            },
+        };
+    }
+    /**
+     * Apply header styling transformations.
+     * @private
+     */
+    applyHeaderStyle(headers, style) {
+        switch (style) {
+            case "uppercase":
+                return headers.map((h) => h.toUpperCase());
+            case "bold":
+            case "none":
+            default:
+                return headers;
+        }
+    }
+    /**
+     * Calculate column widths and metadata.
+     * @private
+     */
+    calculateColumns(headers, rows, options, context) {
+        const columns = headers.map((header, index) => {
+            // Determine alignment (use configured or default to left)
+            const alignment = options.alignment[header] ||
+                options.alignment[index.toString()] ||
+                "left";
+            // Calculate max content width for this column
+            const headerWidth = header.length;
+            const maxContentWidth = Math.max(...rows.map((row) => (row[index] || "").length));
+            // Determine final width (respecting min/max constraints)
+            let width = Math.max(headerWidth, maxContentWidth);
+            width = Math.max(width, options.minWidth);
+            if (options.maxWidth && width > options.maxWidth) {
+                width = options.maxWidth;
+            }
+            return { name: header, width, alignment };
+        });
+        logger.debug({
+            ...context,
+            columns: columns.map((c) => ({ name: c.name, width: c.width })),
+        }, "Calculated column widths");
+        return columns;
+    }
+    /**
+     * Render table using the specified style.
+     * @private
+     */
+    renderTable(columns, headers, rows, options) {
+        switch (options.style) {
+            case "markdown":
+                return this.renderMarkdown(columns, headers, rows, options);
+            case "ascii":
+                return this.renderAscii(columns, headers, rows, options);
+            case "grid":
+                return this.renderGrid(columns, headers, rows, options);
+            case "compact":
+                return this.renderCompact(columns, headers, rows, options);
+            default:
+                throw new Error(`Unknown table style: ${String(options.style)}`);
+        }
+    }
+    /**
+     * Render markdown-style table.
+     * @private
+     */
+    renderMarkdown(columns, headers, rows, options) {
+        const lines = [];
+        const pad = " ".repeat(options.padding);
+        // Header row
+        const headerCells = headers.map((header, i) => this.formatCell(header, columns[i], options));
+        lines.push(`|${pad}${headerCells.join(`${pad}|${pad}`)}${pad}|`);
+        // Separator row
+        const separators = columns.map((col) => {
+            const dashes = "-".repeat(col.width);
+            return dashes;
+        });
+        lines.push(`|${pad}${separators.join(`${pad}|${pad}`)}${pad}|`);
+        // Data rows
+        for (const row of rows) {
+            const cells = row.map((cell, i) => this.formatCell(cell, columns[i], options));
+            lines.push(`|${pad}${cells.join(`${pad}|${pad}`)}${pad}|`);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Render ASCII box-drawing table.
+     * @private
+     */
+    renderAscii(columns, headers, rows, options) {
+        const lines = [];
+        const pad = " ".repeat(options.padding);
+        // Top border
+        const topBorder = columns
+            .map((col) => "-".repeat(col.width + options.padding * 2))
+            .join("+");
+        lines.push(`+${topBorder}+`);
+        // Header row
+        const headerCells = headers.map((header, i) => this.formatCell(header, columns[i], options));
+        lines.push(`|${pad}${headerCells.join(`${pad}|${pad}`)}${pad}|`);
+        // Header separator
+        const headerSep = columns
+            .map((col) => "-".repeat(col.width + options.padding * 2))
+            .join("+");
+        lines.push(`+${headerSep}+`);
+        // Data rows
+        for (const row of rows) {
+            const cells = row.map((cell, i) => this.formatCell(cell, columns[i], options));
+            lines.push(`|${pad}${cells.join(`${pad}|${pad}`)}${pad}|`);
+        }
+        // Bottom border
+        const bottomBorder = columns
+            .map((col) => "-".repeat(col.width + options.padding * 2))
+            .join("+");
+        lines.push(`+${bottomBorder}+`);
+        return lines.join("\n");
+    }
+    /**
+     * Render Unicode grid table.
+     * @private
+     */
+    renderGrid(columns, headers, rows, options) {
+        const lines = [];
+        const pad = " ".repeat(options.padding);
+        // Top border
+        const topBorder = columns
+            .map((col) => "─".repeat(col.width + options.padding * 2))
+            .join("┬");
+        lines.push(`┌${topBorder}┐`);
+        // Header row
+        const headerCells = headers.map((header, i) => this.formatCell(header, columns[i], options));
+        lines.push(`│${pad}${headerCells.join(`${pad}│${pad}`)}${pad}│`);
+        // Header separator
+        const headerSep = columns
+            .map((col) => "─".repeat(col.width + options.padding * 2))
+            .join("┼");
+        lines.push(`├${headerSep}┤`);
+        // Data rows
+        for (const row of rows) {
+            const cells = row.map((cell, i) => this.formatCell(cell, columns[i], options));
+            lines.push(`│${pad}${cells.join(`${pad}│${pad}`)}${pad}│`);
+        }
+        // Bottom border
+        const bottomBorder = columns
+            .map((col) => "─".repeat(col.width + options.padding * 2))
+            .join("┴");
+        lines.push(`└${bottomBorder}┘`);
+        return lines.join("\n");
+    }
+    /**
+     * Render compact space-separated table.
+     * @private
+     */
+    renderCompact(columns, headers, rows, options) {
+        const lines = [];
+        const pad = " ".repeat(options.padding * 2);
+        // Header row
+        const headerCells = headers.map((header, i) => this.formatCell(header, columns[i], options));
+        lines.push(headerCells.join(pad));
+        // Data rows
+        for (const row of rows) {
+            const cells = row.map((cell, i) => this.formatCell(cell, columns[i], options));
+            lines.push(cells.join(pad));
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Format a single cell with alignment and truncation.
+     * @private
+     */
+    formatCell(content, column, options) {
+        let text = content;
+        // Truncate if needed
+        if (options.truncate && text.length > column.width) {
+            text = text.substring(0, column.width - 3) + "...";
+        }
+        // Apply alignment padding
+        const padding = column.width - text.length;
+        if (padding <= 0) {
+            return text;
+        }
+        switch (column.alignment) {
+            case "left":
+                return text + " ".repeat(padding);
+            case "right":
+                return " ".repeat(padding) + text;
+            case "center": {
+                const leftPad = Math.floor(padding / 2);
+                const rightPad = padding - leftPad;
+                return " ".repeat(leftPad) + text + " ".repeat(rightPad);
+            }
+            default:
+                return text;
+        }
+    }
+    /**
+     * Convert any value to a string for display in table.
+     * Tracks NULL values per column when columnKey is provided.
+     * @private
+     */
+    stringify(value, nullReplacement = "-", columnKey) {
+        // Handle NULL/undefined values with tracking
+        if (value === null || value === undefined) {
+            if (columnKey) {
+                this.nullCounts[columnKey] = (this.nullCounts[columnKey] || 0) + 1;
+            }
+            return nullReplacement;
+        }
+        // Standard value conversion
+        if (typeof value === "string")
+            return value;
+        if (typeof value === "number")
+            return value.toString();
+        if (typeof value === "boolean")
+            return value.toString();
+        if (typeof value === "bigint")
+            return value.toString();
+        if (typeof value === "symbol")
+            return value.toString();
+        if (typeof value === "function")
+            return "[Function]";
+        if (Array.isArray(value))
+            return JSON.stringify(value);
+        if (typeof value === "object") {
+            try {
+                return JSON.stringify(value);
+            }
+            catch {
+                return "[Object]";
+            }
+        }
+        return "[Unknown]";
+    }
+}
+/**
+ * Singleton instance of TableFormatter.
+ * Use this instance to format tabular data into various table styles.
+ *
+ * @example
+ * ```typescript
+ * import { tableFormatter } from '../index.js';
+ *
+ * const data = [
+ *   { name: 'Alice', age: 30, role: 'Engineer' },
+ *   { name: 'Bob', age: 25, role: 'Designer' }
+ * ];
+ *
+ * // Markdown table (default)
+ * console.log(tableFormatter.format(data));
+ *
+ * // Grid table with right-aligned age
+ * console.log(tableFormatter.format(data, {
+ *   style: 'grid',
+ *   alignment: { age: 'right' }
+ * }));
+ *
+ * // Compact table with uppercase headers
+ * console.log(tableFormatter.format(data, {
+ *   style: 'compact',
+ *   headerStyle: 'uppercase'
+ * }));
+ * ```
+ */
+export const tableFormatter = new TableFormatter();
+//# sourceMappingURL=tableFormatter.js.map

package/dist/utils/formatting/tableFormatter.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Barrel file for the utils module.
+ * This file re-exports all utilities from their categorized subdirectories,
+ * providing a single entry point for accessing utility functions.
+ * @module src/utils
+ */
+export * from "./internal/index.js";
+export * from "./metrics/index.js";
+export * from "./parsing/index.js";
+export * from "./security/index.js";
+export * from "./network/index.js";
+export * from "./scheduling/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Barrel file for the utils module.
+ * This file re-exports all utilities from their categorized subdirectories,
+ * providing a single entry point for accessing utility functions.
+ * @module src/utils
+ */
+// Re-export all utilities from their categorized subdirectories
+export * from "./internal/index.js";
+export * from "./metrics/index.js";
+export * from "./parsing/index.js";
+export * from "./security/index.js";
+export * from "./network/index.js";
+export * from "./scheduling/index.js";
+// It's good practice to have index.ts files in each subdirectory
+// that export the contents of that directory.
+// Assuming those will be created or already exist.
+// If not, this might need adjustment to export specific files, e.g.:
+// export * from './internal/errorHandler.js';
+// export * from './internal/logger.js';
+// ... etc.
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gEAAgE;AAChE,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AAEtC,iEAAiE;AACjE,8CAA8C;AAC9C,mDAAmD;AACnD,qEAAqE;AACrE,8CAA8C;AAC9C,wCAAwC;AACxC,WAAW"}

package/dist/utils/internal/asyncContext.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Manages asynchronous context propagation using AsyncLocalStorage.
+ * This module provides a mechanism to store and retrieve a `RequestContext` across
+ * asynchronous operations, ensuring that critical metadata like `requestId` and trace
+ * information is available throughout the entire call stack without prop drilling.
+ * @module src/utils/internal/asyncContext
+ * @see {@link src/utils/internal/requestContext.ts} for the definition of RequestContext.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { RequestContext } from "./requestContext.js";
+/**
+ * The singleton `AsyncLocalStorage` instance for storing the `RequestContext`.
+ * This holds the context for the duration of a single asynchronous operation,
+ * such as an incoming tool call or a scheduled job.
+ */
+export declare const requestContextStore: AsyncLocalStorage<RequestContext>;
+/**
+ * Retrieves the current `RequestContext` from the async local storage.
+ * It is a synchronous call that depends on the execution context.
+ *
+ * @returns {RequestContext | undefined} The current `RequestContext` if it exists
+ * in the current async context, otherwise `undefined`.
+ */
+export declare function getRequestContext(): RequestContext | undefined;
+/**
+ * A higher-order function that runs a given function within a specified `RequestContext`.
+ * This is the primary mechanism for establishing an async context for an operation.
+ *
+ * @template T The return type of the function to be executed.
+ * @param {RequestContext} context - The `RequestContext` to set for the duration of the function's execution.
+ * @param {() => T} fn - The function to execute within the context.
+ * @returns {T} The result returned by the function `fn`.
+ */
+export declare function withRequestContext<T>(context: RequestContext, fn: () => T): T;
+//# sourceMappingURL=asyncContext.d.ts.map

package/dist/utils/internal/asyncContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncContext.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/asyncContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,mCAA0C,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7E"}