@crypto512/jicon-mcp 1.2.0 → 2.0.0

package/dist/utils/buffer-pipeline/stages/format.js

@@ -0,0 +1,160 @@
+/**
+ * Format Stage
+ *
+ * Applies conditional formatting rules to items.
+ * Used by output generators to style cells/elements based on conditions.
+ */
+import { evaluateCondition } from "./filter.js";
+/**
+ * Evaluate format rules against an item and return applicable styles
+ */
+export function evaluateFormats(item, formats) {
+    const fieldStyles = new Map();
+    let rowStyle = {};
+    for (const format of formats) {
+        if (evaluateCondition(item, format.condition)) {
+            if (format.fields && format.fields.length > 0) {
+                // Apply to specific fields
+                for (const field of format.fields) {
+                    const existing = fieldStyles.get(field) || {};
+                    fieldStyles.set(field, mergeStyles(existing, format.style));
+                }
+            }
+            else {
+                // Apply to entire row
+                rowStyle = mergeStyles(rowStyle, format.style);
+            }
+        }
+    }
+    return { fieldStyles, rowStyle };
+}
+/**
+ * Merge two styles, with later style taking precedence
+ */
+export function mergeStyles(base, override) {
+    return {
+        ...base,
+        ...override,
+    };
+}
+/**
+ * Execute format stage - annotates items with formatting info
+ */
+export function executeFormat(items, formats) {
+    if (!formats || formats.length === 0) {
+        // No formatting - wrap items without styles
+        return items.map((data) => ({
+            data,
+            styles: new Map(),
+        }));
+    }
+    return items.map((data) => {
+        const { fieldStyles, rowStyle } = evaluateFormats(data, formats);
+        return {
+            data,
+            styles: fieldStyles,
+            rowStyle: Object.keys(rowStyle).length > 0 ? rowStyle : undefined,
+        };
+    });
+}
+/**
+ * Convert style to inline CSS string
+ */
+export function styleToInlineCss(style) {
+    const parts = [];
+    if (style.color) {
+        parts.push(`color: ${style.color}`);
+    }
+    if (style.backgroundColor) {
+        parts.push(`background-color: ${style.backgroundColor}`);
+    }
+    if (style.bold) {
+        parts.push("font-weight: bold");
+    }
+    if (style.italic) {
+        parts.push("font-style: italic");
+    }
+    return parts.join("; ");
+}
+/**
+ * Apply text decorations (prefix, suffix, icon) to a value
+ */
+export function applyTextDecorations(value, style) {
+    let result = value;
+    if (style.icon) {
+        result = `${style.icon} ${result}`;
+    }
+    if (style.prefix) {
+        result = `${style.prefix}${result}`;
+    }
+    if (style.suffix) {
+        result = `${result}${style.suffix}`;
+    }
+    return result;
+}
+/**
+ * Get the effective style for a field, merging row style and field-specific style
+ */
+export function getEffectiveStyle(item, field) {
+    const fieldStyle = item.styles.get(field);
+    const rowStyle = item.rowStyle;
+    if (!fieldStyle && !rowStyle) {
+        return {};
+    }
+    if (!fieldStyle) {
+        return rowStyle || {};
+    }
+    if (!rowStyle) {
+        return fieldStyle;
+    }
+    // Merge row style (base) with field style (override)
+    return mergeStyles(rowStyle, fieldStyle);
+}
+/**
+ * Format a cell value with styling for XHTML output
+ */
+export function formatCellXhtml(value, style) {
+    // Convert value to string
+    let strValue;
+    if (value === null || value === undefined) {
+        strValue = "";
+    }
+    else if (Array.isArray(value)) {
+        strValue = value.join(", ");
+    }
+    else if (typeof value === "object") {
+        strValue = JSON.stringify(value);
+    }
+    else {
+        strValue = String(value);
+    }
+    // Escape HTML entities
+    strValue = escapeXml(strValue);
+    // Apply text decorations
+    strValue = applyTextDecorations(strValue, style);
+    // Wrap in styled span if needed
+    const inlineCss = styleToInlineCss(style);
+    if (inlineCss || style.cssClass) {
+        const attrs = [];
+        if (style.cssClass) {
+            attrs.push(`class="${escapeXml(style.cssClass)}"`);
+        }
+        if (inlineCss) {
+            attrs.push(`style="${escapeXml(inlineCss)}"`);
+        }
+        return `<span ${attrs.join(" ")}>${strValue}</span>`;
+    }
+    return strValue;
+}
+/**
+ * Escape XML special characters
+ */
+export function escapeXml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/buffer-pipeline/stages/format.js.map

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

package/dist/utils/buffer-pipeline/stages/group-by.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Group By Stage
+ *
+ * Groups items by a field and computes aggregations.
+ * Similar to SQL GROUP BY with aggregate functions.
+ */
+import type { GroupByConfig } from "../types.js";
+/**
+ * Execute group by stage
+ * Returns aggregated results, one row per group
+ */
+export declare function executeGroupBy(items: Record<string, unknown>[], config: GroupByConfig): Record<string, unknown>[];
+/**
+ * Validate aggregation config
+ */
+export declare function validateGroupByConfig(items: unknown[], config: GroupByConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Format aggregation results for display
+ * Converts arrays to readable strings, rounds numbers
+ */
+export declare function formatAggregationValue(value: unknown): string;
+//# sourceMappingURL=group-by.d.ts.map

package/dist/utils/buffer-pipeline/stages/group-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by.d.ts","sourceRoot":"","sources":["../../../../src/utils/buffer-pipeline/stages/group-by.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,aAAa,CAAC;AA+FtE;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAkD3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,EAAE,aAAa,GACpB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA4CtC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiB7D"}

package/dist/utils/buffer-pipeline/stages/group-by.js

@@ -0,0 +1,190 @@
+/**
+ * Group By Stage
+ *
+ * Groups items by a field and computes aggregations.
+ * Similar to SQL GROUP BY with aggregate functions.
+ */
+import { getFieldValue } from "./select.js";
+/**
+ * Compute an aggregation over a list of values
+ */
+function computeAggregation(values, func) {
+    switch (func) {
+        case "count":
+            return values.length;
+        case "sum": {
+            let sum = 0;
+            for (const v of values) {
+                const num = typeof v === "number" ? v : parseFloat(String(v));
+                if (!isNaN(num)) {
+                    sum += num;
+                }
+            }
+            return sum;
+        }
+        case "avg": {
+            if (values.length === 0)
+                return 0;
+            let sum = 0;
+            let count = 0;
+            for (const v of values) {
+                const num = typeof v === "number" ? v : parseFloat(String(v));
+                if (!isNaN(num)) {
+                    sum += num;
+                    count++;
+                }
+            }
+            return count > 0 ? sum / count : 0;
+        }
+        case "min": {
+            let min;
+            for (const v of values) {
+                const num = typeof v === "number" ? v : parseFloat(String(v));
+                if (!isNaN(num)) {
+                    if (min === undefined || num < min) {
+                        min = num;
+                    }
+                }
+            }
+            return min ?? null;
+        }
+        case "max": {
+            let max;
+            for (const v of values) {
+                const num = typeof v === "number" ? v : parseFloat(String(v));
+                if (!isNaN(num)) {
+                    if (max === undefined || num > max) {
+                        max = num;
+                    }
+                }
+            }
+            return max ?? null;
+        }
+        case "first":
+            return values.length > 0 ? values[0] : null;
+        case "last":
+            return values.length > 0 ? values[values.length - 1] : null;
+        case "list":
+            return values;
+        case "unique":
+            return [...new Set(values.map((v) => (v === null || v === undefined ? "" : String(v))))];
+        default:
+            return null;
+    }
+}
+/**
+ * Get a stable string key for grouping
+ */
+function getGroupKey(value) {
+    if (value === null || value === undefined) {
+        return "__null__";
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Execute group by stage
+ * Returns aggregated results, one row per group
+ */
+export function executeGroupBy(items, config) {
+    // Group items by the specified field
+    const groups = new Map();
+    for (const item of items) {
+        const groupValue = getFieldValue(item, config.field);
+        const groupKey = getGroupKey(groupValue);
+        if (!groups.has(groupKey)) {
+            groups.set(groupKey, {
+                groupValue,
+                items: [],
+            });
+        }
+        groups.get(groupKey).items.push(item);
+    }
+    // Compute aggregations for each group
+    const results = [];
+    for (const { groupValue, items: groupItems } of groups.values()) {
+        const row = {};
+        // Add the group field
+        const groupFieldName = config.field.split(".").pop() || config.field;
+        row[groupFieldName] = groupValue;
+        // Compute each aggregation
+        for (const agg of config.aggregations) {
+            if (agg.function === "count" && !agg.field) {
+                // Count all items in group
+                row[agg.as] = groupItems.length;
+            }
+            else {
+                // Extract values for the specified field
+                const values = agg.field
+                    ? groupItems.map((item) => getFieldValue(item, agg.field))
+                    : groupItems;
+                row[agg.as] = computeAggregation(values, agg.function);
+            }
+        }
+        results.push(row);
+    }
+    return results;
+}
+/**
+ * Validate aggregation config
+ */
+export function validateGroupByConfig(items, config) {
+    const errors = [];
+    if (items.length === 0) {
+        return { valid: true, errors: [] };
+    }
+    const sampleItem = items[0];
+    // Check group field exists
+    const groupValue = getFieldValue(sampleItem, config.field);
+    if (groupValue === undefined) {
+        errors.push(`Group field '${config.field}' not found`);
+    }
+    // Check aggregation fields exist (for non-count operations)
+    for (const agg of config.aggregations) {
+        if (agg.field) {
+            const aggValue = getFieldValue(sampleItem, agg.field);
+            if (aggValue === undefined) {
+                errors.push(`Aggregation field '${agg.field}' not found`);
+            }
+            // Check numeric fields for numeric aggregations
+            if (["sum", "avg", "min", "max"].includes(agg.function)) {
+                if (aggValue !== undefined &&
+                    typeof aggValue !== "number" &&
+                    isNaN(parseFloat(String(aggValue)))) {
+                    errors.push(`Field '${agg.field}' is not numeric, but used with ${agg.function}()`);
+                }
+            }
+        }
+        else if (agg.function !== "count") {
+            errors.push(`Aggregation '${agg.as}' requires a field for ${agg.function}()`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Format aggregation results for display
+ * Converts arrays to readable strings, rounds numbers
+ */
+export function formatAggregationValue(value) {
+    if (value === null || value === undefined) {
+        return "-";
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "-";
+        if (value.length <= 3)
+            return value.join(", ");
+        return `${value.slice(0, 3).join(", ")} (+${value.length - 3} more)`;
+    }
+    if (typeof value === "number") {
+        // Round to 2 decimal places
+        return Number.isInteger(value) ? String(value) : value.toFixed(2);
+    }
+    return String(value);
+}
+//# sourceMappingURL=group-by.js.map

package/dist/utils/buffer-pipeline/stages/group-by.js.map

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

package/dist/utils/buffer-pipeline/stages/select.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Select Stage
+ *
+ * Extracts and transforms fields from input items.
+ * Supports dot-notation for nested fields, renaming, and value transformations.
+ */
+import type { FieldMapping, SelectConfig } from "../types.js";
+/**
+ * Get a value from an object using dot notation path
+ * Handles nested objects and arrays
+ *
+ * @example
+ * getFieldValue({ priority: { name: "High" } }, "priority.name") // "High"
+ * getFieldValue({ labels: ["bug", "ui"] }, "labels") // ["bug", "ui"]
+ * getFieldValue({ fields: { customfield_10001: "value" } }, "fields.customfield_10001") // "value"
+ */
+export declare function getFieldValue(item: unknown, path: string): unknown;
+/**
+ * Get the output field name from a field mapping
+ */
+export declare function getOutputFieldName(mapping: FieldMapping): string;
+/**
+ * Transform a value according to the specified transformation
+ */
+export declare function transformValue(value: unknown, transform: FieldMapping["transform"]): unknown;
+/**
+ * Apply select stage to a single item
+ * Returns a new object with only the selected fields
+ */
+export declare function selectItem(item: unknown, config: SelectConfig): Record<string, unknown>;
+/**
+ * Apply select stage to all items
+ * If no select config is provided, passes items through unchanged
+ */
+export declare function executeSelect(items: unknown[], config?: SelectConfig): Record<string, unknown>[];
+/**
+ * Extract all available field paths from an item (for error suggestions)
+ * Limited to first 2 levels to avoid overwhelming output
+ */
+export declare function extractFieldPaths(item: unknown, prefix?: string, depth?: number, maxDepth?: number): string[];
+/**
+ * Validate select config and return errors if any fields don't exist
+ */
+export declare function validateSelectConfig(items: unknown[], config: SelectConfig): {
+    valid: boolean;
+    errors: string[];
+    suggestions: Map<string, string[]>;
+};
+/**
+ * Get the field names that will be available after executing a select stage.
+ * If no select config, returns the original field names from the data.
+ */
+export declare function getPostSelectFieldNames(items: unknown[], config?: SelectConfig): string[];
+//# sourceMappingURL=select.d.ts.map

package/dist/utils/buffer-pipeline/stages/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../../src/utils/buffer-pipeline/stages/select.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA8BlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAOhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,GACnC,OAAO,CAmDT;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,YAAY,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAc3B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,MAAW,EACnB,KAAK,GAAE,MAAU,EACjB,QAAQ,GAAE,MAAU,GACnB,MAAM,EAAE,CAkCV;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,EAAE,YAAY,GACnB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAiC1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,EAAE,CAaV"}