@salesforce/platform-sdk 11.45.2 → 11.45.4

package/README.md

@@ -83,6 +83,42 @@ analytics.dispose();
 
 `createAnalytics` is async because it constructs a `ChatSDK` if you don't supply one. To skip the transport (e.g., during local development), omit the `transport` option — events still flow through `o11y` but aren't uploaded.
 
+### Attributing events to a PFT Id
+
+Attribute analytics events to a Product Feature Taxonomy (PFT) Id so usage rolls up to the correct feature in Salesforce dashboards.
+
+**Server side.** The MCP server declares the customer PFT Id on the `telemetry_upload` tool's `_meta` under the reserved key `"sfdc.pftId"`:
+
+```jsonc
+// telemetry_upload tool definition
+{
+  "name": "telemetry_upload",
+  "_meta": {
+    "sfdc.pftId": "aJCEE000000FgYP4A0",
+  },
+}
+```
+
+See [`TdxAxlDemoMcpServer.java`](https://codesearch.data.sfdc.net/gitcore.soma.salesforce.com/core-2206/core-266-public@p4/266-main/-/blob/core/experience-model-services-core-impl/java/src/experiencemodel/typesystem/mcp/TdxAxlDemoMcpServer.java) for a working example.
+
+**Widget side.** Read the Id via `chatSdk.accessToolMetadata()` and pass it to `createAnalytics`. The SDK exports the same key as `PFT_META_KEY` so the two sides stay in sync:
+
+```ts
+import { createAnalytics, PFT_META_KEY } from "@salesforce/platform-sdk";
+
+const meta = chatSdk.accessToolMetadata?.<Record<string, unknown>>();
+const pftId = meta?.[PFT_META_KEY];
+
+const analytics = await createAnalytics({
+  appId: "my-widget",
+  sdk,
+  transport,
+  pftId,
+});
+```
+
+Only PF Ids (KeyPrefix `aJC`, 15 or 18 chars) are accepted; PFE Ids (`aJD`) and malformed values are ignored, and the analytics instance simply carries no PFT attribution. Use `validatePftId` if you want to gate the value yourself before passing it in.
+
 ## Telemetry transport
 
 `createTelemetryTransport` buffers `o11y` envelopes and uploads them via the `telemetry_upload` tool exposed by the host `ChatSDK`. Use it directly when you want batching independent of `createAnalytics`.

package/dist/data/index.js

@@ -245,7 +245,7 @@ const w = "Accept-Language", me = (r) => {
     return u(r);
   const [t, n] = r;
   return (t instanceof Request && !n?.headers ? t.headers.has(w) : new Headers(n?.headers).has(w)) ? u(r) : u(b(w, e, r));
-}, ye = "X-SFDC-Client-Name", be = "X-SFDC-Client-Version", ve = "@salesforce/platform-sdk", Se = "11.45.2", ge = (r) => {
+}, ye = "X-SFDC-Client-Name", be = "X-SFDC-Client-Version", ve = "@salesforce/platform-sdk", Se = "11.45.4", ge = (r) => {
   let e = b(ye, ve, r);
   return e = b(be, Se, e), u(e);
 }, we = "X-CSRF-Token";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/platform-sdk",
-  "version": "11.45.2",
+  "version": "11.45.4",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -123,7 +123,7 @@
     "@conduit-client/service-pubsub": "3.19.6",
     "@conduit-client/service-retry": "3.19.6",
     "@conduit-client/utils": "3.19.6",
-    "@salesforce/jsonrpc": "^11.45.2",
+    "@salesforce/jsonrpc": "^11.45.4",
     "@salesforce/sf-embedding-bridge": "2.2.5-rc.2"
   },
   "peerDependencies": {