@salesforce/mcp 0.26.11-qa.0 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -262,28 +262,32 @@ For complete documentation, see [Use DX MCP Tools for LWC](https://developer.sal
262
262
  - `guide_lwc_best_practices` (GA) - Offers LWC development best practices and coding standards guidance.
263
263
  - `guide_lwc_development` (GA) - Provides LWC development workflow and implementation guidelines.
264
264
  - `guide_lwc_rtl_support` (GA) - Provides Right-to-Left (RTL) internationalization support and RTL development guidance.
265
- - `guide_lwc_slds2_uplift_linter_fixes` (NON-GA) - Analyzes the given LWC code along with the slds-linter output to fix issues using Salesforce Lightning Design System 2 (SLDS 2) guidelines.
265
+ - `guide_slds_blueprints` (GA) - Retrieves comprehensive SLDS blueprints guidance, reference documentation, and a complete index of all 85 available blueprints by category.
266
+ - `explore_slds_blueprints` (GA) - Search and explore SLDS Blueprints by name, category, lightning component, SLDS class, or styling hook, returning full blueprint specs.
266
267
  - `guide_lwc_security` (GA) - Provides security analysis in accordance with product security guidelines and Lightning Web Security guidelines.
267
268
  - `guide_design_general` (GA) - Provides SLDS guidelines and best practices for Lightning Web Components with accessibility, responsive design, and component usage patterns.
268
269
  - `guide_utam_generation` (NON-GA) - Provides UI Test Automation Model (UTAM) Page Object generation guidelines and best practices.
270
+ - `reference_lwc_compilation_error` (GA) - References LWC compilation errors by looking up error codes against a knowledge base of documented error patterns, causes, and fixes.
269
271
 
270
272
  #### Lightning Data Service (LDS) Tools
271
273
 
272
274
  - `create_lds_graphql_mutation_query` (GA) - Provides guidance for creating GraphQL mutation queries.
273
275
  - `create_lds_graphql_read_query` (GA) - Create GraphQL read queries for LDS.
274
- - `explore_lds_graphql_schema` (GA) - Explore GraphQL schema structure for LDS.
276
+ - `fetch_lds_graphql_schema` (GA) - Fetch GraphQL schema structure for LDS.
275
277
  - `explore_lds_uiapi` (GA) - Explores and documents Lightning Design System UI API capabilities.
276
278
  - `guide_lds_data_consistency` (GA) - Provides data consistency patterns and best practices for LDS components.
277
279
  - `guide_lds_development` (GA) - Provides LDS development guidelines and component integration.
278
280
  - `guide_lds_graphql` (GA) - Provides LDS GraphQL usage patterns and guidelines.
279
281
  - `guide_lds_referential_integrity` (GA) - Provides referential integrity patterns for LDS data management.
280
282
  - `orchestrate_lds_data_requirements` (GA) - Provides step-by-step guidance for analyzing and clarifying LDS data requirements to produce PRD-ready specifications.
283
+ - `test_lds_graphql_query` (GA) - Tests a GraphQL query against a connected Salesforce org and returns the result (sub-tool of query creation workflows).
281
284
 
282
285
  #### Migration & Integration Tools
283
286
 
284
287
  - `guide_figma_to_lwc_conversion` (GA) - Converts Figma designs to LWC component specifications.
285
288
  - `run_lwc_accessibility_jest_tests` (GA) - Provides accessibility testing utilities and Jest integration for LWC components.
286
289
  - `verify_aura_migration_completeness` (GA) - Provides Aura to LWC migration completeness checklist and validation.
290
+ - `guide_lo_migration` (GA) - Migration recipe: converts a Lightning Out (beta) host page into a Lightning Out 2.0 page
287
291
 
288
292
  #### Workflow Tools
289
293
 
@@ -97,6 +97,11 @@ export class SfMcpServer extends McpServer {
97
97
  // https://modelcontextprotocol.io/specification/2025-06-18/schema#calltoolresult
98
98
  isError: result.isError ?? false,
99
99
  });
100
+ this.telemetry?.sendPdpEvent({
101
+ eventName: 'salesforceMcp.executed',
102
+ productFeatureId: 'aJCEE0000007Uiv4AE', // DX MCP Server
103
+ componentId: name, // MCP tool name
104
+ });
100
105
  return result;
101
106
  };
102
107
  const tool = super.registerTool(name, config, wrappedCb);
@@ -1,4 +1,4 @@
1
- import { Attributes } from '@salesforce/telemetry';
1
+ import { Attributes, PdpEvent } from '@salesforce/telemetry';
2
2
  import { Config } from '@oclif/core';
3
3
  import { TelemetryService } from '@salesforce/mcp-provider-api/src/index.js';
4
4
  export declare class Telemetry implements TelemetryService {
@@ -18,6 +18,7 @@ export declare class Telemetry implements TelemetryService {
18
18
  constructor(config: Config, attributes?: Attributes);
19
19
  addAttributes(attributes: Attributes): void;
20
20
  sendEvent(eventName: string, attributes?: Attributes): void;
21
+ sendPdpEvent(event: PdpEvent): void;
21
22
  start(): Promise<void>;
22
23
  stop(): void;
23
24
  }
package/lib/telemetry.js CHANGED
@@ -126,7 +126,15 @@ export class Telemetry {
126
126
  });
127
127
  }
128
128
  catch {
129
- /* empty */
129
+ /* intentionally empty */
130
+ }
131
+ }
132
+ sendPdpEvent(event) {
133
+ try {
134
+ this.reporter?.sendPdpEvent(event);
135
+ }
136
+ catch {
137
+ /* intentionally empty */
130
138
  }
131
139
  }
132
140
  async start() {