@salesforce/metadata-enrichment 0.0.6 → 0.0.7

package/lib/files/fileProcessor.js

@@ -13,36 +13,70 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { readFile } from 'node:fs/promises';
+import { readFile, writeFile } from 'node:fs/promises';
+import { SfError } from '@salesforce/core';
+import { Messages } from '@salesforce/core/messages';
+import { XMLParser, XMLBuilder } from 'fast-xml-parser';
+import { EnrichmentStatus, SUPPORTED_COMPONENT_TYPES, METADATA_TYPE_CONFIGS } from '../enrichment/constants/api.js';
+import { DEFAULT_XML_METADATA_SCHEMA } from '../schemas/index.js';
 import { getMimeTypeFromExtension } from '../enrichment/enrichmentHandler.js';
-import { LWC_METADATA_TYPE_NAME, SUPPORTED_COMPONENT_TYPES } from '../enrichment/constants/component.js';
-import { LwcProcessor } from './lwcProcessor.js';
+Messages.importMessagesDirectory(import.meta.dirname);
+const messages = Messages.loadMessages('@salesforce/metadata-enrichment', 'errors');
 /**
- * Maps each supported component type to its corresponding processor.
- * Add new entries here when introducing support for additional component types.
- */
-const COMPONENT_TYPE_PROCESSOR_MAP = new Map([
-    [LWC_METADATA_TYPE_NAME, new LwcProcessor()],
-]);
-/**
- * A main entryway for processing file operations for metadata files.
- * This includes reading and writing component files.
- * Supported component types are defined in SUPPORTED_COMPONENT_TYPES and each maps
- * to a dedicated processor in COMPONENT_TYPE_PROCESSOR_MAP.
+ * A main entryway for processing metadata file operations
+ * with support for reading from and writing to component files.
+ * All supported component types write enrichment results to their xml metadata file (component.xml).
  */
 export class FileProcessor {
     static async updateMetadata(componentsToProcess, enrichmentRecords) {
-        const componentsByType = FileProcessor.groupComponentsByType(componentsToProcess);
-        for (const [componentType, components] of componentsByType) {
-            if (!SUPPORTED_COMPONENT_TYPES.has(componentType)) {
+        for (const component of componentsToProcess) {
+            // Skip if unsupported component type
+            if (!SUPPORTED_COMPONENT_TYPES.has(component.type?.name ?? '')) {
+                continue;
+            }
+            // Skip if source component is missing name or metadata file location
+            const componentName = component.fullName ?? component.name;
+            if (!componentName || !component.xml) {
+                continue;
+            }
+            // Find the enrichment record matching the source component
+            let enrichmentRecord;
+            for (const record of enrichmentRecords) {
+                if (record.componentName === componentName) {
+                    enrichmentRecord = record;
+                    break;
+                }
+            }
+            // Skip if for some reason the enrichment record is missing a response
+            if (!enrichmentRecord?.response) {
                 continue;
             }
-            const processor = COMPONENT_TYPE_PROCESSOR_MAP.get(componentType);
-            if (!processor) {
+            const enrichmentResult = enrichmentRecord.response.results[0];
+            if (!enrichmentResult) {
                 continue;
             }
             // eslint-disable-next-line no-await-in-loop
-            enrichmentRecords = await processor.updateMetadata(components, enrichmentRecords);
+            const fileResult = await FileProcessor.readComponentFile(componentName, component.xml);
+            if (!fileResult) {
+                continue;
+            }
+            const componentTypeName = component.type?.name ?? '';
+            // Skip processing if <skipUplift> tag is set to true
+            if (FileProcessor.isSkipUpliftEnabled(fileResult.fileContents, componentTypeName)) {
+                enrichmentRecord.message = 'skipUplift is set to true';
+                enrichmentRecord.status = EnrichmentStatus.SKIPPED;
+                continue;
+            }
+            // Write to component's metadata XML file
+            try {
+                const updatedXml = FileProcessor.updateMetaXml(fileResult.fileContents, enrichmentResult, componentTypeName);
+                // eslint-disable-next-line no-await-in-loop
+                await writeFile(component.xml, updatedXml, 'utf-8');
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                enrichmentRecord.message = errorMessage;
+            }
         }
         return enrichmentRecords;
     }
@@ -66,20 +100,66 @@ export class FileProcessor {
         if (!componentName) {
             return [];
         }
-        const filePaths = Array.from(component.walkContent());
+        let filePaths = Array.from(component.walkContent());
+        // Some component types (e.g. FlexiPage) have no separate content files —
+        // their definition lives entirely in the XML metadata file.
+        if (filePaths.length === 0 && component.xml) {
+            filePaths = [component.xml];
+        }
         const fileReadPromises = filePaths.map((filePath) => FileProcessor.readComponentFile(componentName, filePath));
         const fileResults = await Promise.all(fileReadPromises);
         return fileResults.filter((result) => result !== null);
     }
-    static groupComponentsByType(components) {
-        const componentsByType = new Map();
-        for (const component of components) {
-            const componentTypeName = component.type?.name ?? 'Unknown';
-            const existing = componentsByType.get(componentTypeName) ?? [];
-            existing.push(component);
-            componentsByType.set(componentTypeName, existing);
+    static updateMetaXml(xmlContent, result, componentTypeName) {
+        const parser = new XMLParser({
+            htmlEntities: true,
+            ignoreAttributes: false,
+            processEntities: false,
+            trimValues: true,
+        });
+        const builder = new XMLBuilder({
+            format: true,
+            ignoreAttributes: false,
+            processEntities: false,
+        });
+        try {
+            const xmlObj = parser.parse(xmlContent);
+            const rootKey = Object.keys(xmlObj).find((k) => k !== '?xml');
+            if (!rootKey) {
+                throw new SfError(messages.getMessage('errors.parsing.xml', [result.resourceName]));
+            }
+            if (!xmlObj[rootKey]) {
+                xmlObj[rootKey] = {};
+            }
+            const schema = (componentTypeName ? METADATA_TYPE_CONFIGS[componentTypeName]?.xmlSchema : undefined) ?? DEFAULT_XML_METADATA_SCHEMA;
+            schema.applyEnrichment(xmlObj[rootKey], result);
+            const builtXml = builder.build(xmlObj);
+            return builtXml.trim().replace(/\n{3,}/g, '\n\n');
+        }
+        catch (error) {
+            throw new SfError(messages.getMessage('errors.parsing.xml', [error instanceof Error ? error.message : String(error)]));
+        }
+    }
+    /**
+     * Checks if the component has opted out of enrichment.
+     * Delegates to the per-type XML schema's isSkipUpliftEnabled implementation.
+     */
+    static isSkipUpliftEnabled(xmlContent, componentTypeName) {
+        try {
+            const parser = new XMLParser({ ignoreAttributes: false, preserveOrder: false, trimValues: true });
+            const xmlObj = parser.parse(xmlContent);
+            const rootKey = Object.keys(xmlObj).find((k) => k !== '?xml');
+            if (!rootKey)
+                return false;
+            const xmlRoot = xmlObj[rootKey];
+            if (!xmlRoot)
+                return false;
+            const schema = (componentTypeName ? METADATA_TYPE_CONFIGS[componentTypeName]?.xmlSchema : undefined) ?? DEFAULT_XML_METADATA_SCHEMA;
+            return schema.isSkipUpliftEnabled(xmlRoot);
+        }
+        catch {
+            return false;
         }
-        return componentsByType;
     }
 }
 //# sourceMappingURL=fileProcessor.js.map

package/lib/files/fileProcessor.js.map

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

package/lib/files/sourceComponentProcessor.d.ts

@@ -1,5 +1,5 @@
 import { type SourceComponent } from '@salesforce/source-deploy-retrieve';
-import type { MetadataTypeAndName } from '../common/types.js';
+import type { EnrichmentRequestRecord } from '../enrichment/constants/api.js';
 export declare class SourceComponentProcessor {
     /**
      *
@@ -14,7 +14,7 @@ export declare class SourceComponentProcessor {
      * @param projectDir
      * @returns
      */
-    static getComponentsToSkip(sourceComponents: SourceComponent[], metadataEntries: string[], projectDir?: string): Set<MetadataTypeAndName>;
+    static getComponentsToSkip(sourceComponents: SourceComponent[], metadataEntries: string[], projectDir?: string): Set<EnrichmentRequestRecord>;
     private static filterComponents;
     private static diffRequestedComponents;
     private static parseRequestedComponents;

package/lib/files/sourceComponentProcessor.js

@@ -14,7 +14,11 @@
  * limitations under the License.
  */
 import { RegistryAccess } from '@salesforce/source-deploy-retrieve';
-import { COMPONENT_TYPE_VALIDATORS, SUPPORTED_COMPONENT_TYPES } from '../enrichment/constants/component.js';
+import { Messages } from '@salesforce/core/messages';
+import { EnrichmentStatus } from '../enrichment/constants/api.js';
+import { SUPPORTED_COMPONENT_TYPES } from '../enrichment/constants/api.js';
+Messages.importMessagesDirectory(import.meta.dirname);
+const messages = Messages.loadMessages('@salesforce/metadata-enrichment', 'errors');
 export class SourceComponentProcessor {
     /**
      *
@@ -48,17 +52,24 @@ export class SourceComponentProcessor {
             // Filter out unsupported component types
             if (!SUPPORTED_COMPONENT_TYPES.has(typeName)) {
                 filteredComponents.add({
-                    typeName: sourceComponent.type.name,
                     componentName: requestedComponent.componentName,
+                    componentType: sourceComponent.type,
+                    requestBody: null,
+                    response: null,
+                    message: messages.getMessage('errors.unsupported.type', [typeName]),
+                    status: EnrichmentStatus.SKIPPED,
                 });
                 continue;
             }
-            // Run type-specific validation
-            const validator = COMPONENT_TYPE_VALIDATORS.get(typeName);
-            if (validator && !validator(sourceComponent)) {
+            // Filter out supported components missing their metadata file
+            if (sourceComponent.xml === undefined) {
                 filteredComponents.add({
-                    typeName: sourceComponent.type.name,
                     componentName: requestedComponent.componentName,
+                    componentType: sourceComponent.type,
+                    requestBody: null,
+                    response: null,
+                    message: messages.getMessage('errors.component.configuration.not.found'),
+                    status: EnrichmentStatus.SKIPPED,
                 });
             }
         }
@@ -69,7 +80,14 @@ export class SourceComponentProcessor {
         const missingComponents = new Set();
         for (const requestedComponent of requestedComponents) {
             if (requestedComponent.componentName && !existingSourceComponentNames.has(requestedComponent.componentName)) {
-                missingComponents.add(requestedComponent);
+                missingComponents.add({
+                    componentName: requestedComponent.componentName,
+                    componentType: { name: requestedComponent.typeName },
+                    requestBody: null,
+                    response: null,
+                    message: messages.getMessage('errors.component.not.found'),
+                    status: EnrichmentStatus.SKIPPED,
+                });
             }
         }
         return missingComponents;

package/lib/files/sourceComponentProcessor.js.map

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

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 export { SourceComponentProcessor, FileProcessor } from './files/index.js';
 export type { FileReadResult } from './files/index.js';
-export { getMimeTypeFromExtension, API_ENDPOINT_ENRICHMENT, SUPPORTED_MIME_TYPES, EnrichmentHandler, EnrichmentMetrics, EnrichmentRecords, EnrichmentStatus, LwcComponentValidator, } from './enrichment/index.js';
+export { getMimeTypeFromExtension, API_ENDPOINT_ENRICHMENT, SUPPORTED_MIME_TYPES, EnrichmentHandler, EnrichmentMetrics, EnrichmentRecords, EnrichmentStatus, } from './enrichment/index.js';
 export type { ContentBundleFile, ContentBundle, EnrichmentRequestBody, EnrichmentMetadata, EnrichmentResult, EnrichMetadataResponse, EnrichmentRequestRecord, } from './enrichment/index.js';
 export type { ComponentEnrichmentStatus, MetadataTypeAndName } from './common/index.js';

package/lib/index.js

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 export { SourceComponentProcessor, FileProcessor } from './files/index.js';
-export { getMimeTypeFromExtension, API_ENDPOINT_ENRICHMENT, SUPPORTED_MIME_TYPES, EnrichmentHandler, EnrichmentMetrics, EnrichmentRecords, EnrichmentStatus, LwcComponentValidator, } from './enrichment/index.js';
+export { getMimeTypeFromExtension, API_ENDPOINT_ENRICHMENT, SUPPORTED_MIME_TYPES, EnrichmentHandler, EnrichmentMetrics, EnrichmentRecords, EnrichmentStatus, } from './enrichment/index.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/lib/schemas/index.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_XML_METADATA_SCHEMA, SALESFORCE_OBJECT_XML_METADATA_SCHEMA } from './schemas.js';
+export type { MetadataTypeXmlSchema, MetadataTypeConfig } from './schemas.js';

package/lib/{enrichment/validators → schemas}/index.js

@@ -13,5 +13,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export { LwcComponentValidator } from './lwcComponentValidator.js';
+export { DEFAULT_XML_METADATA_SCHEMA, SALESFORCE_OBJECT_XML_METADATA_SCHEMA } from './schemas.js';
 //# sourceMappingURL=index.js.map

package/lib/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,2BAA2B,EAAE,qCAAqC,EAAE,MAAM,cAAc,CAAC"}

package/lib/schemas/schemas.d.ts

@@ -0,0 +1,47 @@
+import type { EnrichmentResult } from '../enrichment/types/index.js';
+export type MetadataTypeXmlSchema = {
+    /**
+     * Define how to apply enrichment result data into the XML metadata.
+     * Called after the metadata file has been parsed and mutates xmlRoot in place.
+     */
+    applyEnrichment: (xmlRoot: Record<string, unknown>, result: EnrichmentResult) => void;
+    /**
+     * Define how to check if the user has opted out of enrichment based on the set <skipUplift> tag.
+     * If you want to ignore this capability, always return false.
+     */
+    isSkipUpliftEnabled: (xmlRoot: Record<string, unknown>) => boolean;
+};
+export type MetadataTypeConfig = {
+    apiType: string;
+    xmlSchema: MetadataTypeXmlSchema;
+};
+/**
+ * Default XML metadata schema where enrichment is written within <ai> block at metadata's root level.
+ *
+ * Example output structure:
+ * ```
+ * <LightningComponentBundle>
+ *   <ai>
+ *     <skipUplift>false</skipUplift>
+ *     <description>...</description>
+ *     <score>0.95</score>
+ *   </ai>
+ * </LightningComponentBundle>
+ * ```
+ */
+export declare const DEFAULT_XML_METADATA_SCHEMA: MetadataTypeXmlSchema;
+/**
+ * XML metadata schema for SalesforceObject where enrichment is written within <aiDescriptor> block.
+ *
+ * Example output structure:
+ * ```
+ * <CustomObject>
+ *   <aiDescriptor>
+ *     <skipUplift>false</skipUplift>
+ *     <enrichedDescription>...</enrichedDescription>
+ *     <score>0.95</score>
+ *   </aiDescriptor>
+ * </CustomObject>
+ * ```
+ */
+export declare const SALESFORCE_OBJECT_XML_METADATA_SCHEMA: MetadataTypeXmlSchema;

package/lib/schemas/schemas.js

@@ -0,0 +1,113 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { XMLParser } from 'fast-xml-parser';
+/**
+ * Parses the description field from an EnrichmentResult into an object suitable
+ * for embedding in the <ai> XML block.
+ *
+ * The description may be plain text, or HTML-entity-encoded XML containing a
+ * description tag and optionally one or more property tags.
+ */
+function parseDescriptionContent(description) {
+    const decodedDescription = description
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'");
+    // Plain text — no encoded XML tags present
+    // Wrap it in <description> tag and return it
+    if (!description.includes('&lt;description&gt;')) {
+        return { description: decodedDescription };
+    }
+    // Description contains encoded XML — parse the decoded fragment to extract child elements
+    // And return this XML content back within <ai> tags
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        processEntities: false,
+        trimValues: true,
+        isArray: (tagName) => tagName === 'property',
+    });
+    try {
+        // Use a temporary <root> element to wrap the XML content for serialization purposes only
+        const parsed = parser.parse(`<root>${decodedDescription}</root>`);
+        return parsed.root ?? { description: decodedDescription };
+    }
+    catch {
+        return { description: decodedDescription };
+    }
+}
+/**
+ * Default XML metadata schema where enrichment is written within <ai> block at metadata's root level.
+ *
+ * Example output structure:
+ * ```
+ * <LightningComponentBundle>
+ *   <ai>
+ *     <skipUplift>false</skipUplift>
+ *     <description>...</description>
+ *     <score>0.95</score>
+ *   </ai>
+ * </LightningComponentBundle>
+ * ```
+ */
+export const DEFAULT_XML_METADATA_SCHEMA = {
+    applyEnrichment(xmlRoot, result) {
+        Object.assign(xmlRoot, {
+            ai: {
+                skipUplift: 'false',
+                ...parseDescriptionContent(result.description),
+                score: String(result.descriptionScore),
+            },
+        });
+    },
+    isSkipUpliftEnabled(xmlRoot) {
+        const root = xmlRoot;
+        const skipUplift = root.ai?.skipUplift;
+        return skipUplift === true || String(skipUplift).toLowerCase() === 'true';
+    },
+};
+/**
+ * XML metadata schema for SalesforceObject where enrichment is written within <aiDescriptor> block.
+ *
+ * Example output structure:
+ * ```
+ * <CustomObject>
+ *   <aiDescriptor>
+ *     <skipUplift>false</skipUplift>
+ *     <enrichedDescription>...</enrichedDescription>
+ *     <score>0.95</score>
+ *   </aiDescriptor>
+ * </CustomObject>
+ * ```
+ */
+export const SALESFORCE_OBJECT_XML_METADATA_SCHEMA = {
+    applyEnrichment(xmlRoot, result) {
+        Object.assign(xmlRoot, {
+            aiDescriptor: {
+                skipUplift: 'false',
+                enrichedDescription: result.description,
+                score: String(result.descriptionScore),
+            },
+        });
+    },
+    isSkipUpliftEnabled(xmlRoot) {
+        const root = xmlRoot;
+        const skipUplift = root.aiDescriptor?.skipUplift;
+        return skipUplift === true || String(skipUplift).toLowerCase() === 'true';
+    },
+};
+//# sourceMappingURL=schemas.js.map

package/lib/schemas/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/schemas/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwB5C;;;;;;GAMG;AACH,SAAS,uBAAuB,CAAC,WAAmB;IAClD,MAAM,kBAAkB,GAAG,WAAW;SACnC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAE3B,2CAA2C;IAC3C,6CAA6C;IAC7C,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAC7C,CAAC;IAED,0FAA0F;IAC1F,oDAAoD;IACpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,UAAU;KAC7C,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,yFAAyF;QACzF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,kBAAkB,SAAS,CAAuC,CAAC;QACxG,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA0B;IAChE,eAAe,CAAC,OAAO,EAAE,MAAM;QAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;YACrB,EAAE,EAAE;gBACF,UAAU,EAAE,OAAO;gBACnB,GAAG,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC;gBAC9C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;aACvC;SACF,CAAC,CAAC;IACL,CAAC;IACD,mBAAmB,CAAC,OAAO;QACzB,MAAM,IAAI,GAAG,OAAqD,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC;QACvC,OAAO,UAAU,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;IAC5E,CAAC;CACF,CAAC;AAGF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAA0B;IAC1E,eAAe,CAAC,OAAO,EAAE,MAAM;QAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;YACrB,YAAY,EAAE;gBACZ,UAAU,EAAE,OAAO;gBACnB,mBAAmB,EAAE,MAAM,CAAC,WAAW;gBACvC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;aACvC;SACF,CAAC,CAAC;IACL,CAAC;IACD,mBAAmB,CAAC,OAAO;QACzB,MAAM,IAAI,GAAG,OAA+D,CAAC;QAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC;QACjD,OAAO,UAAU,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;IAC5E,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/metadata-enrichment",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "A library for handling metadata enrichment",
   "author": "Salesforce",
   "main": "lib/index",
@@ -51,11 +51,11 @@
     "string-width": "^4.2.3"
   },
   "dependencies": {
-    "@salesforce/core": "^8.24.0",
+    "@salesforce/core": "^8.26.3",
     "@salesforce/kit": "^3.2.4",
-    "@salesforce/source-deploy-retrieve": "^12.0.1",
+    "@salesforce/source-deploy-retrieve": "^12.31.14",
     "@salesforce/ts-types": "^2.0.11",
-    "fast-xml-parser": "^5.3.4"
+    "fast-xml-parser": "^5.4.1"
   },
   "devDependencies": {
     "@salesforce/cli-plugins-testkit": "^5.3.41",
@@ -63,7 +63,7 @@
     "eslint-plugin-sf-plugin": "^1.20.33",
     "ts-node": "^10.9.2",
     "ts-patch": "^3.1.2",
-    "typescript": "^5.5.4"
+    "typescript": "^5.9.2"
   },
   "publishConfig": {
     "access": "public"

package/lib/enrichment/validators/index.d.ts

@@ -1 +0,0 @@
-export { LwcComponentValidator } from './lwcComponentValidator.js';

package/lib/enrichment/validators/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/enrichment/validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/lib/enrichment/validators/lwcComponentValidator.d.ts

@@ -1,8 +0,0 @@
-import type { SourceComponent } from '@salesforce/source-deploy-retrieve';
-/**
- * Validator for LWC - "LightningComponentBundle" source components processing
- * Validates that a corresponding metadata XML file exists
- */
-export declare class LwcComponentValidator {
-    static validate(this: void, component: SourceComponent): boolean;
-}

package/lib/enrichment/validators/lwcComponentValidator.js

@@ -1,26 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * Validator for LWC - "LightningComponentBundle" source components processing
- * Validates that a corresponding metadata XML file exists
- */
-export class LwcComponentValidator {
-    static validate(component) {
-        const hasMetadataFile = (component.xml !== undefined);
-        return hasMetadataFile;
-    }
-}
-//# sourceMappingURL=lwcComponentValidator.js.map

package/lib/enrichment/validators/lwcComponentValidator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lwcComponentValidator.js","sourceRoot":"","sources":["../../../src/enrichment/validators/lwcComponentValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACzB,MAAM,CAAC,QAAQ,CAAa,SAA0B;QAC3D,MAAM,eAAe,GAAG,CAAC,SAAS,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;QACtD,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}

package/lib/files/lwcProcessor.d.ts

@@ -1,14 +0,0 @@
-import type { SourceComponent } from '@salesforce/source-deploy-retrieve';
-import type { EnrichmentRequestRecord } from '../enrichment/enrichmentHandler.js';
-import type { EnrichmentResult } from '../enrichment/types/index.js';
-import type { ComponentTypeProcessor, FileReadResult } from './fileProcessor.js';
-/**
- * A LWC specific processor for reading and updating LWC metadata files.
- */
-export declare class LwcProcessor implements ComponentTypeProcessor {
-    updateMetadata(lightningComponentBundles: SourceComponent[], enrichmentRecords: Set<EnrichmentRequestRecord>): Promise<Set<EnrichmentRequestRecord>>;
-    readComponentFiles(sourceComponents: SourceComponent[]): Promise<FileReadResult[]>;
-    updateMetaXml(xmlContent: string, result: EnrichmentResult): string;
-    isMetaXmlFile(filePath: string): boolean;
-    private isSkipUpliftEnabled;
-}