@salesforce/metadata-enrichment 0.0.1

package/lib/enrichment/enrichmentMetrics.js

@@ -0,0 +1,85 @@
+/*
+ * 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 { EnrichmentStatus } from './enrichmentHandler.js';
+export class EnrichmentMetrics {
+    success;
+    fail;
+    skipped;
+    total;
+    constructor() {
+        this.success = {
+            count: 0,
+            components: [],
+        };
+        this.fail = {
+            count: 0,
+            components: [],
+        };
+        this.skipped = {
+            count: 0,
+            components: [],
+        };
+        this.total = 0;
+    }
+    static createEnrichmentMetrics(enrichmentResults) {
+        const metrics = new EnrichmentMetrics();
+        for (const record of enrichmentResults) {
+            const componentName = record.componentName;
+            let typeName = '';
+            if (record.componentType) {
+                typeName = record.componentType.name;
+            }
+            else if (record.response?.results && record.response.results.length > 0) {
+                typeName = record.response.results[0].metadataType;
+            }
+            // Skip records where we can't determine the metadata type
+            if (!typeName) {
+                continue;
+            }
+            const component = {
+                typeName,
+                componentName,
+                message: record.message ?? (record.status === EnrichmentStatus.SUCCESS ? '' : 'Enrichment request failed'),
+            };
+            if (record.status === EnrichmentStatus.SUCCESS) {
+                metrics.addSuccessComponent(component);
+            }
+            else if (record.status === EnrichmentStatus.SKIPPED) {
+                metrics.addSkippedComponent(component);
+            }
+            else {
+                metrics.addFailComponent(component);
+            }
+        }
+        return metrics;
+    }
+    addSuccessComponent(component) {
+        this.success.components.push(component);
+        this.success.count++;
+        this.total++;
+    }
+    addFailComponent(component) {
+        this.fail.components.push(component);
+        this.fail.count++;
+        this.total++;
+    }
+    addSkippedComponent(component) {
+        this.skipped.components.push(component);
+        this.skipped.count++;
+        this.total++;
+    }
+}
+//# sourceMappingURL=enrichmentMetrics.js.map

package/lib/enrichment/enrichmentMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichmentMetrics.js","sourceRoot":"","sources":["../../src/enrichment/enrichmentMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,OAAO,iBAAiB;IACrB,OAAO,CAGZ;IACK,IAAI,CAGT;IACK,OAAO,CAGZ;IACK,KAAK,CAAS;IAErB;QACE,IAAI,CAAC,OAAO,GAAG;YACb,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,EAAE;SACf,CAAC;QACF,IAAI,CAAC,IAAI,GAAG;YACV,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,EAAE;SACf,CAAC;QACF,IAAI,CAAC,OAAO,GAAG;YACb,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,EAAE;SACf,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,uBAAuB,CACnC,iBAA4C;QAE5C,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAExC,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACvC,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;YAE3C,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;YACvC,CAAC;iBAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1E,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;YACrD,CAAC;YAED,0DAA0D;YAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAA8B;gBAC3C,QAAQ;gBACR,aAAa;gBACb,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B,CAAC;aAC3G,CAAC;YAEF,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC/C,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBACtD,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,mBAAmB,CAAC,SAAoC;QAC7D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEM,gBAAgB,CAAC,SAAoC;QAC1D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEM,mBAAmB,CAAC,SAAoC;QAC7D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACF"}

package/lib/enrichment/index.d.ts

@@ -0,0 +1,5 @@
+export { getMimeTypeFromExtension, EnrichmentHandler, EnrichmentStatus } from './enrichmentHandler.js';
+export { API_ENDPOINT_ENRICHMENT, LWC_MIME_TYPES } from './constants/index.js';
+export { EnrichmentMetrics } from './enrichmentMetrics.js';
+export type { EnrichmentRequestRecord } from './enrichmentHandler.js';
+export type { ContentBundleFile, ContentBundle, EnrichmentRequestBody, EnrichmentMetadata, EnrichmentResult, EnrichMetadataResult, } from './types/index.js';

package/lib/enrichment/index.js

@@ -0,0 +1,19 @@
+/*
+ * 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.
+ */
+export { getMimeTypeFromExtension, EnrichmentHandler, EnrichmentStatus } from './enrichmentHandler.js';
+export { API_ENDPOINT_ENRICHMENT, LWC_MIME_TYPES } from './constants/index.js';
+export { EnrichmentMetrics } from './enrichmentMetrics.js';
+//# sourceMappingURL=index.js.map

package/lib/enrichment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,2 @@
+export type { ContentBundleFile, ContentBundle, EnrichmentRequestBody, } from './requestTypes.js';
+export type { EnrichmentMetadata, EnrichmentResult, EnrichMetadataResult, } from './responseTypes.js';

package/lib/enrichment/types/index.js

@@ -0,0 +1,17 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/enrichment/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/enrichment/types/requestTypes.d.ts

@@ -0,0 +1,15 @@
+export type ContentBundleFile = {
+    filename: string;
+    mimeType: string;
+    content: string;
+    encoding: 'PlainText';
+};
+export type ContentBundle = {
+    resourceName: string;
+    files: Record<string, ContentBundleFile>;
+};
+export type EnrichmentRequestBody = {
+    contentBundles: ContentBundle[];
+    metadataType: 'Generic';
+    maxTokens: number;
+};

package/lib/enrichment/types/requestTypes.js

@@ -0,0 +1,17 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=requestTypes.js.map

package/lib/enrichment/types/requestTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestTypes.js","sourceRoot":"","sources":["../../../src/enrichment/types/requestTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/enrichment/types/responseTypes.d.ts

@@ -0,0 +1,18 @@
+export type EnrichmentMetadata = {
+    durationMs: number;
+    failureCount: number;
+    successCount: number;
+    timestamp: string;
+};
+export type EnrichmentResult = {
+    resourceId: string;
+    resourceName: string;
+    metadataType: string;
+    modelUsed: string;
+    description: string;
+    descriptionScore: number;
+};
+export type EnrichMetadataResult = {
+    metadata: EnrichmentMetadata;
+    results: EnrichmentResult[];
+};

package/lib/enrichment/types/responseTypes.js

@@ -0,0 +1,17 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=responseTypes.js.map

package/lib/enrichment/types/responseTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseTypes.js","sourceRoot":"","sources":["../../../src/enrichment/types/responseTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/files/fileProcessor.d.ts

@@ -0,0 +1,14 @@
+import type { SourceComponent } from '@salesforce/source-deploy-retrieve';
+import type { EnrichmentRequestRecord } from '../enrichment/enrichmentHandler.js';
+export type FileReadResult = {
+    componentName: string;
+    filePath: string;
+    fileContents: string;
+    mimeType: string;
+};
+export declare class FileProcessor {
+    static updateMetadataFiles(componentsToProcess: SourceComponent[], enrichmentRecords: Set<EnrichmentRequestRecord>): Promise<Set<EnrichmentRequestRecord>>;
+    static readComponentFile(componentName: string, filePath: string): Promise<FileReadResult | null>;
+    static readComponentFiles(component: SourceComponent): Promise<FileReadResult[]>;
+    private static groupComponentsByType;
+}

package/lib/files/fileProcessor.js

@@ -0,0 +1,65 @@
+/*
+ * 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 { readFile } from 'node:fs/promises';
+import { getMimeTypeFromExtension } from '../enrichment/enrichmentHandler.js';
+import { LwcProcessor } from './lwcProcessor.js';
+export class FileProcessor {
+    static async updateMetadataFiles(componentsToProcess, enrichmentRecords) {
+        const componentsByType = FileProcessor.groupComponentsByType(componentsToProcess);
+        // Only LightningComponentBundle components are supported for now
+        const lightningComponentBundles = componentsByType.get('LightningComponentBundle') ?? [];
+        if (lightningComponentBundles.length === 0) {
+            return enrichmentRecords;
+        }
+        return LwcProcessor.updateMetadataFiles(lightningComponentBundles, enrichmentRecords);
+    }
+    static async readComponentFile(componentName, filePath) {
+        try {
+            const fileContents = await readFile(filePath, 'utf-8');
+            const mimeType = getMimeTypeFromExtension(filePath);
+            return {
+                componentName,
+                filePath,
+                fileContents,
+                mimeType,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    static async readComponentFiles(component) {
+        const componentName = component.fullName ?? component.name;
+        if (!componentName) {
+            return [];
+        }
+        const filePaths = Array.from(component.walkContent());
+        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);
+        }
+        return componentsByType;
+    }
+}
+//# sourceMappingURL=fileProcessor.js.map

package/lib/files/fileProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileProcessor.js","sourceRoot":"","sources":["../../src/files/fileProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,MAAM,OAAO,aAAa;IAEjB,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACrC,mBAAsC,EACtC,iBAA+C;QAE/C,MAAM,gBAAgB,GAAG,aAAa,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;QAElF,iEAAiE;QACjE,MAAM,yBAAyB,GAAG,gBAAgB,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC;QACzF,IAAI,yBAAyB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,OAAO,YAAY,CAAC,mBAAmB,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;IACxF,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,aAAqB,EAAE,QAAgB;QAC3E,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;YAEpD,OAAO;gBACL,aAAa;gBACb,QAAQ;gBACR,YAAY;gBACZ,QAAQ;aACT,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,SAA0B;QAC/D,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,MAAM,gBAAgB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,iBAAiB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;QAE/G,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACxD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,EAA4B,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IACnF,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAAC,UAA6B;QAChE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA6B,CAAC;QAC9D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,iBAAiB,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,CAAC;YAC5D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,gBAAgB,CAAC,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF"}

package/lib/files/index.d.ts

@@ -0,0 +1,2 @@
+export { FileProcessor } from './fileProcessor.js';
+export type { FileReadResult } from './fileProcessor.js';

package/lib/files/index.js

@@ -0,0 +1,17 @@
+/*
+ * 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.
+ */
+export { FileProcessor } from './fileProcessor.js';
+//# sourceMappingURL=index.js.map

package/lib/files/index.js.map

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

package/lib/files/lwcProcessor.d.ts

@@ -0,0 +1,11 @@
+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 { FileReadResult } from './fileProcessor.js';
+export declare class LwcProcessor {
+    static readComponentFiles(sourceComponents: SourceComponent[]): Promise<FileReadResult[]>;
+    static updateMetadataFiles(lightningComponentBundles: SourceComponent[], enrichmentRecords: Set<EnrichmentRequestRecord>): Promise<Set<EnrichmentRequestRecord>>;
+    static updateMetaXml(xmlContent: string, result: EnrichmentResult): string;
+    static isMetaXmlFile(filePath: string): boolean;
+    private static isSkipUpliftEnabled;
+}

package/lib/files/lwcProcessor.js

@@ -0,0 +1,121 @@
+/*
+ * 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 { basename } from 'node:path';
+import { 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 } from '../enrichment/enrichmentHandler.js';
+import { FileProcessor } from './fileProcessor.js';
+Messages.importMessagesDirectory(import.meta.dirname);
+const messages = Messages.loadMessages('@salesforce/metadata-enrichment', 'enrichment');
+export class LwcProcessor {
+    static async readComponentFiles(sourceComponents) {
+        const fileReadPromises = [];
+        for (const component of sourceComponents) {
+            const componentName = component.fullName ?? component.name;
+            if (!componentName || !component.xml) {
+                continue;
+            }
+            fileReadPromises.push(FileProcessor.readComponentFile(componentName, component.xml));
+        }
+        const fileResults = await Promise.all(fileReadPromises);
+        return fileResults.filter((result) => result !== null);
+    }
+    static async updateMetadataFiles(lightningComponentBundles, enrichmentRecords) {
+        const fileContents = await LwcProcessor.readComponentFiles(lightningComponentBundles);
+        for (const file of fileContents) {
+            if (!LwcProcessor.isMetaXmlFile(file.filePath)) {
+                continue;
+            }
+            let enrichmentRecord;
+            for (const record of enrichmentRecords) {
+                if (record.componentName === file.componentName) {
+                    enrichmentRecord = record;
+                    break;
+                }
+            }
+            if (!enrichmentRecord?.response) {
+                continue;
+            }
+            const enrichmentResult = enrichmentRecord.response.results[0];
+            if (!enrichmentResult) {
+                continue;
+            }
+            // Check if skipUplift is enabled before processing
+            if (LwcProcessor.isSkipUpliftEnabled(file.fileContents)) {
+                enrichmentRecord.message = 'skipUplift is set to true';
+                enrichmentRecord.status = EnrichmentStatus.SKIPPED;
+                continue;
+            }
+            try {
+                const updatedXml = LwcProcessor.updateMetaXml(file.fileContents, enrichmentResult);
+                // eslint-disable-next-line no-await-in-loop
+                await writeFile(file.filePath, updatedXml, 'utf-8');
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                enrichmentRecord.message = errorMessage;
+            }
+        }
+        return enrichmentRecords;
+    }
+    static updateMetaXml(xmlContent, result) {
+        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);
+            if (!xmlObj.LightningComponentBundle) {
+                xmlObj.LightningComponentBundle = {};
+            }
+            xmlObj.LightningComponentBundle.ai = {
+                skipUplift: 'false',
+                description: result.description,
+                score: String(result.descriptionScore),
+            };
+            const builtXml = builder.build(xmlObj);
+            return builtXml.trim().replace(/\n{3,}/g, '\n\n');
+        }
+        catch (error) {
+            throw new SfError(messages.getMessage('error.parsing.xml', [error instanceof Error ? error.message : String(error)]));
+        }
+    }
+    static isMetaXmlFile(filePath) {
+        const fileName = basename(filePath);
+        return fileName.endsWith('.js-meta.xml');
+    }
+    static isSkipUpliftEnabled(xmlContent) {
+        try {
+            const parser = new XMLParser({ ignoreAttributes: false, preserveOrder: false, trimValues: true });
+            const xmlObj = parser.parse(xmlContent);
+            const skipUplift = xmlObj.LightningComponentBundle?.ai?.skipUplift;
+            return skipUplift === true || String(skipUplift).toLowerCase() === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=lwcProcessor.js.map

package/lib/files/lwcProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lwcProcessor.js","sourceRoot":"","sources":["../../src/files/lwcProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,iCAAiC,EAAE,YAAY,CAAC,CAAC;AAExF,MAAM,OAAO,YAAY;IAChB,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,gBAAmC;QACxE,MAAM,gBAAgB,GAA0C,EAAE,CAAC;QAEnE,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACzC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;YAC3D,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACvF,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACxD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,EAA4B,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IACnF,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACrC,yBAA4C,EAC5C,iBAA+C;QAE/C,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;QAEtF,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/C,SAAS;YACX,CAAC;YAED,IAAI,gBAAqD,CAAC;YAC1D,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;gBACvC,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;oBAChD,gBAAgB,GAAG,MAAM,CAAC;oBAC1B,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC;gBAChC,SAAS;YACX,CAAC;YAED,MAAM,gBAAgB,GAAiC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC5F,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,SAAS;YACX,CAAC;YAED,mDAAmD;YACnD,IAAI,YAAY,CAAC,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBACxD,gBAAgB,CAAC,OAAO,GAAG,2BAA2B,CAAC;gBACvD,gBAAgB,CAAC,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;gBACnF,4CAA4C;gBAC5C,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,gBAAgB,CAAC,OAAO,GAAG,YAAY,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,UAAkB,EAAE,MAAwB;QACtE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,YAAY,EAAE,IAAI;YAClB,gBAAgB,EAAE,KAAK;YACvB,eAAe,EAAE,KAAK;YACtB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;YAC7B,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,KAAK;YACvB,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAQrC,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,wBAAwB,EAAE,CAAC;gBACrC,MAAM,CAAC,wBAAwB,GAAG,EAAE,CAAC;YACvC,CAAC;YAED,MAAM,CAAC,wBAAwB,CAAC,EAAE,GAAG;gBACnC,UAAU,EAAE,OAAO;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;aACvC,CAAC;YAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxH,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,QAAgB;QAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAAC,UAAkB;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAClG,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAErC,CAAC;YAEF,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,EAAE,EAAE,EAAE,UAAU,CAAC;YACnE,OAAO,UAAU,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/lib/index.d.ts

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

package/lib/index.js

@@ -0,0 +1,18 @@
+/*
+ * 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.
+ */
+export { FileProcessor } from './files/index.js';
+export { getMimeTypeFromExtension, EnrichmentHandler, EnrichmentStatus, API_ENDPOINT_ENRICHMENT, LWC_MIME_TYPES, EnrichmentMetrics, } from './enrichment/index.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

package/messages/enrichment.md

@@ -0,0 +1,15 @@
+# error.enrichment.request
+
+Error sending request for component %s %s
+
+# error.parsing.xml
+
+Failed to parse XML: %s
+
+# error.file.read.failed
+
+Failed to read file for component %s
+
+# error.enrich.lwc.only
+
+Enrichment only supports Lightning Web Components (LightningComponentBundle)