Class MetadataProcessor

src/core/metadata/MetadataProcessor.ts:5–89

import {MetadataEntry, Metadata} from './Metadata.js';

export class MetadataProcessor {
    /**
     * Converts a raw metadata string to a structured entry
     */
    static parseMetadataEntry(entry: string): MetadataEntry {
        const colonIndex = entry.indexOf(':');
        if (colonIndex === -1) {
            throw new Error(`Invalid metadata format: ${entry}`);
        }

        return {
            key: entry.substring(0, colonIndex).trim(),
            value: entry.substring(colonIndex + 1).trim()
        };
    }

    /**
     * Formats a metadata entry into a string
     */
    static formatMetadataEntry(key: string, value: string | string[] | unknown): string {
        if (Array.isArray(value)) {
            return `${key}: ${value.join(', ')}`;
        }
        return `${key}: ${String(value)}`;
    }

    /**
     * Processes and validates metadata entries
     */
    static validateMetadata(metadata: Metadata): boolean {
        try {
            metadata.forEach(entry => this.parseMetadataEntry(entry));
            return true;
        } catch (error) {
            return false;
        }
    }

    /**
     * Merges multiple metadata arrays, removing duplicates
     */
    static mergeMetadata(...metadataArrays: Metadata[]): Metadata {
        const uniqueEntries = new Set<string>();

        metadataArrays.forEach(metadata => {
            metadata.forEach(entry => uniqueEntries.add(entry));
        });

        return Array.from(uniqueEntries);
    }

    /**
     * Filters metadata entries by key
     */
    static filterByKey(metadata: Metadata, key: string): Metadata {
        return metadata.filter(entry => {
            const parsed = this.parseMetadataEntry(entry);
            return parsed.key === key;