@loonylabs/llm-middleware 2.0.0

package/dist/middleware/services/flat-formatter/flat-formatter.service.js

@@ -0,0 +1,333 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormatConfigurator = exports.FlatFormatter = void 0;
+/**
+ * FlatFormatter - Advanced utility class with computed fields support and array slicing
+ * Converts complex JSON objects into flat, readable text formats optimized for LLM consumption
+ */
+class FlatFormatter {
+    /**
+     * Converts a JSON object to a flat format with optional computed fields
+     */
+    static flatten(data, options) {
+        const { format = 'sections', itemPrefix = '### ITEM', itemSuffix = '###', indentLevel = 2, includeArrayIndices = true, separator = '===', keyValueSeparator = ': ', ignoreEmptyValues = true, ignoredKeys = [], customFormatters = {}, entryTitleKey, entryTitleAsPrefix = false, entryTitleDefault = 'ENTRY', computedFields = {}, computedFieldsFirst = true, indexOffset = 0, arraySliceStart, arraySliceEnd } = options;
+        // Function to format a single object
+        const formatObject = (obj, prefix = '') => {
+            let result = '';
+            for (const [key, value] of Object.entries(obj)) {
+                // Skip keys from the ignoredKeys list
+                if (ignoredKeys.includes(key))
+                    continue;
+                // Skip empty values if desired
+                if (ignoreEmptyValues && (value === '' || value === null || value === undefined ||
+                    (Array.isArray(value) && value.length === 0) ||
+                    (typeof value === 'object' && Object.keys(value).length === 0))) {
+                    continue;
+                }
+                // Use custom formatters if available
+                if (customFormatters[key]) {
+                    result += `${prefix}${key}${keyValueSeparator}${customFormatters[key](value)}\n`;
+                    continue;
+                }
+                if (Array.isArray(value)) {
+                    if (value.every(item => typeof item !== 'object')) {
+                        // Simple array of primitives
+                        result += `${prefix}${key}${keyValueSeparator}${value.join(', ')}\n`;
+                    }
+                    else {
+                        // Array of objects
+                        result += `${prefix}${key}${keyValueSeparator}\n`;
+                        value.forEach((item, index) => {
+                            if (typeof item === 'object' && item !== null) {
+                                result += includeArrayIndices ?
+                                    `${prefix}${' '.repeat(indentLevel)}[${index + indexOffset}] ` :
+                                    `${prefix}${' '.repeat(indentLevel)}`;
+                                result += formatObject(item, `${prefix}${' '.repeat(indentLevel * 2)}`);
+                                if (index < value.length - 1)
+                                    result += '\n';
+                            }
+                            else {
+                                result += `${prefix}${' '.repeat(indentLevel)}${includeArrayIndices ? `[${index + indexOffset}] ` : ''}${item}\n`;
+                            }
+                        });
+                    }
+                }
+                else if (typeof value === 'object' && value !== null) {
+                    // Nested object
+                    result += `${prefix}${key}${keyValueSeparator}\n`;
+                    result += formatObject(value, `${prefix}${' '.repeat(indentLevel)}`);
+                }
+                else {
+                    // Primitive value
+                    result += `${prefix}${key}${keyValueSeparator}${value}\n`;
+                }
+            }
+            return result;
+        };
+        // Main logic for formatting based on desired format
+        if (Array.isArray(data)) {
+            // Array slice logic
+            const originalArray = data;
+            let dataToProcess = data;
+            let actualStartIndex = 0;
+            // Calculate slice parameters
+            if (arraySliceStart !== undefined || arraySliceEnd !== undefined) {
+                const start = arraySliceStart ?? 0;
+                const end = arraySliceEnd ?? data.length;
+                dataToProcess = data.slice(start, end);
+                actualStartIndex = start;
+            }
+            // Preprocessing for computed fields considering slice
+            let processedData = dataToProcess;
+            if (Object.keys(computedFields).length > 0) {
+                processedData = dataToProcess.map((item, sliceIndex) => {
+                    const originalIndex = actualStartIndex + sliceIndex;
+                    const computedProps = {};
+                    // Calculate all computed fields for this item with original index and original array
+                    Object.entries(computedFields).forEach(([key, computeFn]) => {
+                        computedProps[key] = computeFn(item, originalIndex, originalArray);
+                    });
+                    // Combine computed and original fields
+                    if (computedFieldsFirst) {
+                        return { ...computedProps, ...item };
+                    }
+                    else {
+                        return { ...item, ...computedProps };
+                    }
+                });
+            }
+            let result = '';
+            processedData.forEach((item, sliceIndex) => {
+                const originalIndex = actualStartIndex + sliceIndex;
+                const itemNumber = originalIndex + indexOffset;
+                // Determine entry title based on configuration
+                let entryTitle = entryTitleDefault;
+                if (entryTitleKey && typeof item === 'object' && item !== null) {
+                    const titleValue = item[entryTitleKey];
+                    if (titleValue) {
+                        entryTitle = `"${titleValue}"`;
+                    }
+                }
+                switch (format) {
+                    case 'sections':
+                        if (entryTitleAsPrefix && entryTitleKey) {
+                            result += `${itemPrefix} ${itemNumber + 1} - ${entryTitle} ${itemSuffix}\n`;
+                        }
+                        else {
+                            result += `${itemPrefix} ${itemNumber + 1} ${itemSuffix}\n`;
+                        }
+                        result += formatObject(item);
+                        break;
+                    case 'numbered':
+                        result += `[${itemNumber + 1}] ${entryTitle}\n`;
+                        result += formatObject(item, '  - ');
+                        break;
+                    case 'table':
+                        result += `| ENTRY ${itemNumber + 1} - ${entryTitle} |\n`;
+                        result += formatObject(item);
+                        break;
+                    case 'separator':
+                        result += `${separator} ENTRY ${itemNumber + 1} - ${entryTitle} ${separator}\n`;
+                        result += formatObject(item);
+                        break;
+                }
+                if (sliceIndex < processedData.length - 1) {
+                    result += '\n';
+                }
+            });
+            return result;
+        }
+        else {
+            // Format single object - computed fields only if explicitly desired
+            if (Object.keys(computedFields).length > 0) {
+                const computedProps = {};
+                Object.entries(computedFields).forEach(([key, computeFn]) => {
+                    computedProps[key] = computeFn(data, 0, [data]);
+                });
+                if (computedFieldsFirst) {
+                    data = { ...computedProps, ...data };
+                }
+                else {
+                    data = { ...data, ...computedProps };
+                }
+            }
+            return formatObject(data);
+        }
+    }
+    /**
+     * Converts a JSON object to sections format with markdown headers
+     */
+    static toSections(data, options = {}) {
+        return this.flatten(data, { format: 'sections', ...options });
+    }
+    /**
+     * Converts a JSON object to numbered list format
+     */
+    static toNumberedList(data, options = {}) {
+        return this.flatten(data, { format: 'numbered', ...options });
+    }
+    /**
+     * Converts a JSON object to table-like format
+     */
+    static toTable(data, options = {}) {
+        return this.flatten(data, { format: 'table', ...options });
+    }
+    /**
+     * Converts a JSON object to separator format
+     */
+    static toSeparated(data, options = {}) {
+        return this.flatten(data, { format: 'separator', ...options });
+    }
+    /**
+     * Convenience method for commonly used computed fields
+     */
+    static withCommonComputedFields(data, options, includeIndex = true, includePosition = true, indexOffset = 0) {
+        const computedFields = {};
+        if (includeIndex) {
+            computedFields['Index'] = (item, index) => index + indexOffset;
+        }
+        if (includePosition) {
+            computedFields['Position'] = (item, index, allItems) => `${index + indexOffset + 1} of ${allItems.length}`;
+        }
+        return this.flatten(data, {
+            ...options,
+            computedFields,
+            indexOffset
+        });
+    }
+    /**
+     * Convenience method for array slicing
+     */
+    static sliceArray(data, start, end, options = {}) {
+        return this.flatten(data, {
+            ...options,
+            arraySliceStart: start,
+            arraySliceEnd: end
+        });
+    }
+}
+exports.FlatFormatter = FlatFormatter;
+/**
+ * FormatConfigurator - Enables creating custom formatting configurations
+ */
+class FormatConfigurator {
+    constructor(baseOptions = {}) {
+        this.formatOptions = {
+            format: 'sections',
+            itemPrefix: '###',
+            itemSuffix: '###',
+            indentLevel: 2,
+            includeArrayIndices: true,
+            separator: '===',
+            keyValueSeparator: ': ',
+            ignoreEmptyValues: true,
+            ignoredKeys: [],
+            customFormatters: {},
+            entryTitleKey: undefined,
+            entryTitleAsPrefix: false,
+            entryTitleDefault: 'ENTRY',
+            computedFields: {},
+            computedFieldsFirst: true,
+            indexOffset: 0,
+            arraySliceStart: undefined,
+            arraySliceEnd: undefined,
+            ...baseOptions
+        };
+    }
+    // Fluent API methods for configuration
+    withFormat(format) {
+        this.formatOptions.format = format;
+        return this;
+    }
+    withItemPrefix(prefix) {
+        this.formatOptions.itemPrefix = prefix;
+        return this;
+    }
+    withItemSuffix(suffix) {
+        this.formatOptions.itemSuffix = suffix;
+        return this;
+    }
+    withIndentLevel(level) {
+        this.formatOptions.indentLevel = level;
+        return this;
+    }
+    withSeparator(separator) {
+        this.formatOptions.separator = separator;
+        return this;
+    }
+    withKeyValueSeparator(separator) {
+        this.formatOptions.keyValueSeparator = separator;
+        return this;
+    }
+    ignoreEmptyValues(ignore) {
+        this.formatOptions.ignoreEmptyValues = ignore;
+        return this;
+    }
+    ignoreKeys(...keys) {
+        this.formatOptions.ignoredKeys = [...this.formatOptions.ignoredKeys, ...keys];
+        return this;
+    }
+    withCustomFormatter(key, formatter) {
+        this.formatOptions.customFormatters[key] = formatter;
+        return this;
+    }
+    // Methods for entry title configuration
+    withEntryTitleKey(key) {
+        this.formatOptions.entryTitleKey = key;
+        return this;
+    }
+    withEntryTitleAsPrefix(asPrefix = true) {
+        this.formatOptions.entryTitleAsPrefix = asPrefix;
+        return this;
+    }
+    withEntryTitleDefault(defaultTitle) {
+        this.formatOptions.entryTitleDefault = defaultTitle;
+        return this;
+    }
+    // Methods for computed fields
+    withComputedField(key, computeFn) {
+        this.formatOptions.computedFields[key] = computeFn;
+        return this;
+    }
+    withIndexField(key = 'No', offset = 1) {
+        this.formatOptions.computedFields[key] = (item, index) => index + offset;
+        return this;
+    }
+    withPositionField(key = 'Position', offset = 1) {
+        this.formatOptions.computedFields[key] = (item, index, allItems) => `${index + offset} of ${allItems.length}`;
+        return this;
+    }
+    computedFieldsFirst(first = true) {
+        this.formatOptions.computedFieldsFirst = first;
+        return this;
+    }
+    // Index offset method
+    withIndexOffset(offset) {
+        this.formatOptions.indexOffset = offset;
+        return this;
+    }
+    // Array slice methods
+    withArraySlice(start, end) {
+        this.formatOptions.arraySliceStart = start;
+        this.formatOptions.arraySliceEnd = end;
+        return this;
+    }
+    withArraySliceStart(start) {
+        this.formatOptions.arraySliceStart = start;
+        return this;
+    }
+    withArraySliceEnd(end) {
+        this.formatOptions.arraySliceEnd = end;
+        return this;
+    }
+    // Final method that returns the configured format
+    build() {
+        return this.formatOptions;
+    }
+    // Direct formatting with current settings
+    format(data) {
+        return FlatFormatter.flatten(data, this.formatOptions);
+    }
+}
+exports.FormatConfigurator = FormatConfigurator;
+//# sourceMappingURL=flat-formatter.service.js.map

package/dist/middleware/services/flat-formatter/flat-formatter.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat-formatter.service.js","sourceRoot":"","sources":["../../../../src/middleware/services/flat-formatter/flat-formatter.service.ts"],"names":[],"mappings":"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"}

package/dist/middleware/services/flat-formatter/index.d.ts

@@ -0,0 +1,4 @@
+export { FlatFormatter, FormatConfigurator, ComputedFieldOptions } from './flat-formatter.service';
+export * from './presets';
+export { BasePreset, BaseEntity, ProcessedEntity, FormatConfig, GenericEntity } from './presets';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/services/flat-formatter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/middleware/services/flat-formatter/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGnG,cAAc,WAAW,CAAC;AAG1B,OAAO,EAEL,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EAGZ,aAAa,EACd,MAAM,WAAW,CAAC"}

package/dist/middleware/services/flat-formatter/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePreset = exports.FormatConfigurator = exports.FlatFormatter = void 0;
+// Core FlatFormatter service
+var flat_formatter_service_1 = require("./flat-formatter.service");
+Object.defineProperty(exports, "FlatFormatter", { enumerable: true, get: function () { return flat_formatter_service_1.FlatFormatter; } });
+Object.defineProperty(exports, "FormatConfigurator", { enumerable: true, get: function () { return flat_formatter_service_1.FormatConfigurator; } });
+// Presets system
+__exportStar(require("./presets"), exports);
+// Re-export for convenience
+var presets_1 = require("./presets");
+// Base classes
+Object.defineProperty(exports, "BasePreset", { enumerable: true, get: function () { return presets_1.BasePreset; } });
+//# sourceMappingURL=index.js.map

package/dist/middleware/services/flat-formatter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/middleware/services/flat-formatter/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6BAA6B;AAC7B,mEAAmG;AAA1F,uHAAA,aAAa,OAAA;AAAE,4HAAA,kBAAkB,OAAA;AAE1C,iBAAiB;AACjB,4CAA0B;AAE1B,4BAA4B;AAC5B,qCASmB;AARjB,eAAe;AACf,qGAAA,UAAU,OAAA"}

package/dist/middleware/services/flat-formatter/presets/base-preset.d.ts

@@ -0,0 +1,68 @@
+import { FormatConfigurator } from '../flat-formatter.service';
+export interface BaseEntity {
+    [key: string]: any;
+}
+export interface ProcessedEntity {
+    [key: string]: string | number | boolean;
+}
+export type FormatConfig = {
+    format: 'sections' | 'numbered' | 'table' | 'separator';
+    itemPrefix?: string;
+    itemSuffix?: string;
+    indentLevel?: number;
+    includeArrayIndices?: boolean;
+    separator?: string;
+    keyValueSeparator?: string;
+    ignoreEmptyValues?: boolean;
+    ignoredKeys?: string[];
+    customFormatters?: Record<string, (value: any) => string>;
+    entryTitleKey?: string;
+    entryTitleAsPrefix?: boolean;
+    entryTitleDefault?: string;
+};
+/**
+ * Abstract base class for all presets
+ * Provides robust null-safe entity processing with automatic fallback mechanisms
+ */
+export declare abstract class BasePreset<TOriginal extends BaseEntity, TProcessed extends ProcessedEntity = ProcessedEntity> {
+    protected defaultFormat: FormatConfig;
+    protected entityTypeName: string;
+    constructor(entityTypeName: string, defaultFormat?: FormatConfig);
+    protected abstract preprocessEntity(entity: TOriginal): TProcessed;
+    protected createDefaultFormat(): FormatConfig;
+    /**
+     * Safe wrapper around concrete preprocessEntity implementation
+     * Catches all errors and handles null/undefined entities
+     */
+    private safePreprocessEntityWrapper;
+    /**
+     * Creates a minimal fallback entity on errors
+     * Uses generic approaches without specific property names
+     */
+    private createFallbackEntity;
+    /**
+     * Safe navigation through nested objects
+     */
+    private safeNestedAccess;
+    /**
+     * Preprocessing for arrays and single entities with transparent null-safety
+     * Existing presets don't notice the changes
+     */
+    protected preprocessEntities(entities: TOriginal | TOriginal[] | null | undefined): TProcessed[];
+    protected createSingleObjectFormat(baseFormat: FormatConfig): FormatConfig;
+    protected getSingleObjectFormat(): FormatConfig | null;
+    /**
+     * Robust formatForLLM with central null-safety
+     * Existing presets continue to work without changes
+     */
+    formatForLLM(entities?: TOriginal | TOriginal[] | null, header?: string, format?: FormatConfig): string;
+    getDefaultFormat(): FormatConfig;
+    createFormat(): FormatConfigurator;
+    formatSingleEntity(entity: TOriginal | null | undefined, header?: string, format?: FormatConfig): string;
+    formatMultipleEntities(entities: TOriginal[] | null | undefined, header?: string, format?: FormatConfig): string;
+    /**
+     * Debug helper function for entity structure
+     */
+    protected debugEntity(entity: any, entityName?: string): void;
+}
+//# sourceMappingURL=base-preset.d.ts.map

package/dist/middleware/services/flat-formatter/presets/base-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-preset.d.ts","sourceRoot":"","sources":["../../../../../src/middleware/services/flat-formatter/presets/base-preset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG9E,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC1C;AAGD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,8BAAsB,UAAU,CAAC,SAAS,SAAS,UAAU,EAAE,UAAU,SAAS,eAAe,GAAG,eAAe;IACjH,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IACtC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;gBAErB,cAAc,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,YAAY;IAMhE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU;IAGlE,SAAS,CAAC,mBAAmB,IAAI,YAAY;IAa7C;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA8BnC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA4C5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,EAAE;IAahG,SAAS,CAAC,wBAAwB,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY;IAsB1E,SAAS,CAAC,qBAAqB,IAAI,YAAY,GAAG,IAAI;IAQtD;;;OAGG;IACI,YAAY,CACjB,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,IAAI,EACzC,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM;IAgDF,gBAAgB,IAAI,YAAY;IAKhC,YAAY,IAAI,kBAAkB;IAKlC,kBAAkB,CACvB,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACpC,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM;IAMF,sBAAsB,CAC3B,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACxC,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM;IAOT;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,IAAI;CAUxE"}