@salesforce/platform-sdk 12.14.0 → 12.15.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
@@ -125,6 +125,39 @@ const analytics = await createAnalytics({
125
125
 
126
126
  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.
127
127
 
128
+ ### Pages whose CSP blocks `'unsafe-eval'`
129
+
130
+ `o11y` encodes telemetry with protobufjs, which generates code at runtime. On a page whose Content Security Policy omits `'unsafe-eval'` from `script-src`, that encode throws an `EvalError` and no envelope reaches the transport. Set `useEvalFreeEncoder: true` to let `o11y` fall back to an eval-free encoder:
131
+
132
+ ```ts
133
+ const analytics = await createAnalytics({
134
+ appId: "my-widget",
135
+ sdk,
136
+ transport,
137
+ useEvalFreeEncoder: true,
138
+ });
139
+ ```
140
+
141
+ The option is a fallback, not a switch. The first flush probes code generation once. If the page allows eval, `o11y` keeps the protobufjs encoder. If the page blocks eval, `o11y` uses the eval-free encoder for the rest of the session. Both paths produce identical bytes. The option applies only when `transport` is set, defaults to `false`, and requires `o11y` 266.26.0 or later.
142
+
143
+ On a page that blocks eval, the probe triggers one CSP violation report (a `securitypolicyviolation` event, plus a report to any `report-uri` or `report-to` endpoint) for each bundled copy of `o11y` on the page. This report is expected and does not indicate a failure.
144
+
145
+ ## Auto-instrumentation
146
+
147
+ `initializeAutoInstrumentation` from `@salesforce/platform-sdk/observability` maps its options to `o11y/orchestrator`'s `initialize()`, which starts the page monitors and uploads to `endpoint`. Repeated calls, including calls from other bundles on the same page, do nothing.
148
+
149
+ ```ts
150
+ import { initializeAutoInstrumentation } from "@salesforce/platform-sdk/observability";
151
+
152
+ initializeAutoInstrumentation({
153
+ endpoint: "https://telemetry.example.com/ingest",
154
+ environment: { appName: "my-app", appVersion: "1.0.0" },
155
+ useEvalFreeEncoder: true,
156
+ });
157
+ ```
158
+
159
+ `useEvalFreeEncoder` behaves as described in [Pages whose CSP blocks `'unsafe-eval'`](#pages-whose-csp-blocks-unsafe-eval). The orchestrator passes it to its uploader. It defaults to `false`, requires `o11y` 266.26.0 or later, and on a page that blocks eval triggers one CSP violation report for each bundled copy of `o11y`.
160
+
128
161
  ## Telemetry transport
129
162
 
130
163
  `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`.
@@ -20,6 +20,7 @@ class f {
20
20
  _uploadInterval;
21
21
  _clickUploadDelay;
22
22
  _clickTriggerCooldown;
23
+ _useEvalFreeEncoder;
23
24
  _boundClickListener = this._handleClick.bind(this);
24
25
  _boundVisibilityChangeListener = this._handleVisibilityChange.bind(this);
25
26
  _boundPageHideListener = this._handlePageHide.bind(this);
@@ -30,7 +31,7 @@ class f {
30
31
  _lastClickTriggeredAt = 0;
31
32
  _isDisposed = !1;
32
33
  constructor(e) {
33
- g(e?.onEnvelope, "options.onEnvelope"), s(e.uploadInterval, "options.uploadInterval"), s(e.messagesLimit, "options.messagesLimit"), s(e.metricsLimit, "options.metricsLimit"), s(e.maxUniqueSchemas, "options.maxUniqueSchemas"), s(e.clickUploadDelay, "options.clickUploadDelay"), s(e.clickTriggerCooldown, "options.clickTriggerCooldown"), this._onEnvelope = e.onEnvelope, this._onError = e.onError, this._messagesLimit = e.messagesLimit ?? d, this._metricsLimit = e.metricsLimit ?? u, this._uploadInterval = e.uploadInterval ?? c, this._clickUploadDelay = e.clickUploadDelay ?? _, this._clickTriggerCooldown = e.clickTriggerCooldown ?? m, this._enableClickTrigger = e.enableClickTrigger !== !1, this._enableVisibilityTrigger = e.enableVisibilityTrigger !== !1, this._collector = new h({
34
+ g(e?.onEnvelope, "options.onEnvelope"), s(e.uploadInterval, "options.uploadInterval"), s(e.messagesLimit, "options.messagesLimit"), s(e.metricsLimit, "options.metricsLimit"), s(e.maxUniqueSchemas, "options.maxUniqueSchemas"), s(e.clickUploadDelay, "options.clickUploadDelay"), s(e.clickTriggerCooldown, "options.clickTriggerCooldown"), this._onEnvelope = e.onEnvelope, this._onError = e.onError, this._messagesLimit = e.messagesLimit ?? d, this._metricsLimit = e.metricsLimit ?? u, this._uploadInterval = e.uploadInterval ?? c, this._clickUploadDelay = e.clickUploadDelay ?? _, this._clickTriggerCooldown = e.clickTriggerCooldown ?? m, this._enableClickTrigger = e.enableClickTrigger !== !1, this._enableVisibilityTrigger = e.enableVisibilityTrigger !== !1, this._useEvalFreeEncoder = e.useEvalFreeEncoder === !0, this._collector = new h({
34
35
  environment: e.environment,
35
36
  maxUniqueSchemas: e.maxUniqueSchemas
36
37
  }), this._restartInterval(), this._attachWindowListeners();
@@ -110,7 +111,7 @@ class f {
110
111
  metricsCount: this.metricsCount,
111
112
  estimatedByteSize: this.estimatedByteSize,
112
113
  triggeredAt: Date.now()
113
- }, r = this._collector.getRawContentsOfCoreEnvelope(), o = a(r);
114
+ }, r = this._collector.getRawContentsOfCoreEnvelope(), o = a(r, this._useEvalFreeEncoder);
114
115
  this._restartInterval();
115
116
  try {
116
117
  await this._onEnvelope(o, t);
@@ -1,4 +1,4 @@
1
- import { P as e, c as s, v as c } from "../analytics-TRyVm9Ub.js";
1
+ import { P as e, c as s, v as c } from "../analytics-DtUm3Bhb.js";
2
2
  export {
3
3
  e as PFT_META_KEY,
4
4
  s as createAnalytics,
@@ -91,6 +91,20 @@ export interface AnalyticsOptions {
91
91
  * is advisory. The SDK uses it only for usage-analytics dashboards.
92
92
  */
93
93
  pftId?: string;
94
+ /**
95
+ * Lets the telemetry uploader fall back to an eval-free encoder when the
96
+ * page's Content Security Policy blocks `'unsafe-eval'`.
97
+ *
98
+ * @remarks
99
+ * Applies only when `transport` is set. The option is a fallback, not a
100
+ * switch: the first flush probes code generation once and keeps the
101
+ * protobufjs encoder when the page allows it. On a page that blocks eval,
102
+ * the probe produces one CSP violation report. Requires o11y 266.26.0 or
103
+ * later.
104
+ *
105
+ * @default false
106
+ */
107
+ useEvalFreeEncoder?: boolean;
94
108
  }
95
109
  /**
96
110
  * The Analytics instance that `createAnalytics()` returns.
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"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"}
@@ -1,11 +1,11 @@
1
- import { registerInstrumentedApp as S } from "o11y/client";
2
- import { g as E, S as T } from "./surface-Cg3eyRpj.js";
3
- import { w as A } from "./sdk-promise-D0sy7OW1.js";
4
- import { getChatSDK as v } from "./chat/index.js";
5
- import { r as x } from "./TelemetryUploader-DKkdppe9.js";
6
- import { analyticsContextSchema as C, sessionSchema as k, pageViewSchema as _, errorContextSchema as D, interactionSchema as F, customEventSchema as L } from "o11y_schema/sf_mcpanalytics";
1
+ import { registerInstrumentedApp as P } from "o11y/client";
2
+ import { g as S, S as v } from "./surface-Cg3eyRpj.js";
3
+ import { w as T } from "./sdk-promise-D0sy7OW1.js";
4
+ import { getChatSDK as A } from "./chat/index.js";
5
+ import { r as x } from "./TelemetryUploader-mZWIhtRG.js";
6
+ import { analyticsContextSchema as C, sessionSchema as k, pageViewSchema as _, errorContextSchema as F, interactionSchema as D, customEventSchema as L } from "o11y_schema/sf_mcpanalytics";
7
7
  function N(e) {
8
- const n = (r, f, p, s, c) => {
8
+ const n = (r, f, g, o, c) => {
9
9
  e.error(c ?? r);
10
10
  }, a = (r) => {
11
11
  e.error(r.reason);
@@ -14,14 +14,14 @@ function N(e) {
14
14
  window.removeEventListener("error", n), window.removeEventListener("unhandledrejection", a);
15
15
  };
16
16
  }
17
- const J = "aJC", U = "sfdc.pftId", h = /* @__PURE__ */ new Set(), K = /^aJC[0-9A-Za-z]{12}(?:[0-9A-Za-z]{3})?$/;
18
- function I(e) {
19
- return typeof e != "string" || e.length === 0 ? !1 : e.length !== 15 && e.length !== 18 ? (P(e, "Expected a 15- or 18-character Salesforce ID"), !1) : K.test(e) ? !0 : (P(e, `Expected a Product Feature Id (prefix "${J}", base62).`), !1);
17
+ const J = "aJC", U = "sfdc.pftId", E = /* @__PURE__ */ new Set(), K = /^aJC[0-9A-Za-z]{12}(?:[0-9A-Za-z]{3})?$/;
18
+ function h(e) {
19
+ return typeof e != "string" || e.length === 0 ? !1 : e.length !== 15 && e.length !== 18 ? (I(e, "Expected a 15- or 18-character Salesforce ID"), !1) : K.test(e) ? !0 : (I(e, `Expected a Product Feature Id (prefix "${J}", base62).`), !1);
20
20
  }
21
- function P(e, n) {
22
- h.has(e) || (h.add(e), console.debug(`[platform-sdk:analytics] Ignoring invalid PFT Id "${e}". ${n}`));
21
+ function I(e, n) {
22
+ E.has(e) || (E.add(e), console.debug(`[platform-sdk:analytics] Ignoring invalid PFT Id "${e}". ${n}`));
23
23
  }
24
- function g(e) {
24
+ function p(e) {
25
25
  return {};
26
26
  }
27
27
  const O = {
@@ -31,15 +31,15 @@ const O = {
31
31
  },
32
32
  setWidgetState: {
33
33
  isAsync: !1,
34
- extractTags: g
34
+ extractTags: p
35
35
  },
36
36
  sendMessageToHost: {
37
37
  isAsync: !0,
38
- extractTags: g
38
+ extractTags: p
39
39
  },
40
40
  openLink: {
41
41
  isAsync: !0,
42
- extractTags: g
42
+ extractTags: p
43
43
  },
44
44
  readResource: {
45
45
  isAsync: !0,
@@ -55,37 +55,37 @@ const O = {
55
55
  };
56
56
  function $(e, n, a) {
57
57
  return new Proxy(e, {
58
- get(r, f, p) {
59
- const s = Reflect.get(r, f, p), c = O[f];
60
- return !c || typeof s != "function" ? s : (...u) => {
61
- const o = { ...a(), ...c.extractTags(u) }, d = `sdk.${String(f)}`;
58
+ get(r, f, g) {
59
+ const o = Reflect.get(r, f, g), c = O[f];
60
+ return !c || typeof o != "function" ? o : (...u) => {
61
+ const s = { ...a(), ...c.extractTags(u) }, d = `sdk.${String(f)}`;
62
62
  return c.isAsync ? n.activityAsync(d, async () => {
63
63
  try {
64
- const m = await s.apply(r, u);
65
- return n.incrementCounter(d, 1, !1, o), m;
64
+ const m = await o.apply(r, u);
65
+ return n.incrementCounter(d, 1, !1, s), m;
66
66
  } catch (m) {
67
- throw n.incrementCounter(d, 1, !0, o), m;
67
+ throw n.incrementCounter(d, 1, !0, s), m;
68
68
  }
69
- }) : (n.incrementCounter(d, 1, !1, o), s.apply(r, u));
69
+ }) : (n.incrementCounter(d, 1, !1, s), o.apply(r, u));
70
70
  };
71
71
  }
72
72
  });
73
73
  }
74
74
  function W(e) {
75
- return A(M(e), "createAnalytics");
75
+ return T(M(e), "createAnalytics");
76
76
  }
77
77
  async function M(e) {
78
78
  const { appId: n, clientSessionId: a } = e;
79
79
  let r;
80
80
  try {
81
- r = await E();
81
+ r = await S();
82
82
  } catch {
83
- r = T.WebApp;
83
+ r = v.WebApp;
84
84
  }
85
- const f = Date.now(), p = e.sdk ?? await v();
86
- let s = null;
87
- e.pftId !== void 0 && I(e.pftId) && (s = e.pftId);
88
- const c = () => s !== null ? { pftId: s } : {}, u = S("mcp-widget", {
85
+ const f = Date.now(), g = e.sdk ?? await A();
86
+ let o = null;
87
+ e.pftId !== void 0 && h(e.pftId) && (o = e.pftId);
88
+ const c = () => o !== null ? { pftId: o } : {}, u = P("mcp-widget", {
89
89
  appPayloadProvider: {
90
90
  getPayload: () => ({
91
91
  schema: C,
@@ -97,53 +97,54 @@ async function M(e) {
97
97
  })
98
98
  },
99
99
  clientSessionId: a
100
- }), o = u, d = $(p, o, () => ({
100
+ }), s = u, d = $(g, s, () => ({
101
101
  surface: r,
102
102
  ...c()
103
- })), m = N(o);
103
+ })), m = N(s);
104
104
  let y;
105
105
  e.transport && (y = x(u, {
106
106
  onEnvelope: (t) => {
107
107
  e.transport.enqueue(t);
108
- }
108
+ },
109
+ useEvalFreeEncoder: e.useEvalFreeEncoder
109
110
  }));
110
111
  let w, l = !1;
111
112
  return {
112
113
  instrumentedSDK: d,
113
114
  app: u,
114
115
  trackEvent(t, i) {
115
- l || o.log(L, {
116
+ l || s.log(L, {
116
117
  eventName: t,
117
118
  properties: i ? JSON.stringify(i) : ""
118
119
  });
119
120
  },
120
121
  trackInteraction(t, i) {
121
- l || o.log(F, {
122
+ l || s.log(D, {
122
123
  elementId: t,
123
124
  properties: i ? JSON.stringify(i) : ""
124
125
  });
125
126
  },
126
127
  trackError(t, i) {
127
- l || o.error(t, D, {
128
+ l || s.error(t, F, {
128
129
  properties: i ? JSON.stringify(i) : ""
129
130
  });
130
131
  },
131
132
  trackPageView(t) {
132
- l || t !== w && (w = t, o.log(_, { componentRef: t }));
133
+ l || t !== w && (w = t, s.log(_, { componentRef: t }));
133
134
  },
134
135
  setPftId(t) {
135
- l || I(t) && (s = t);
136
+ l || h(t) && (o = t);
136
137
  },
137
138
  dispose() {
138
139
  if (l) return;
139
140
  l = !0, m();
140
141
  const t = Date.now() - f;
141
- o.log(k, { durationMs: t }), y?.dispose();
142
+ s.log(k, { durationMs: t }), y?.dispose();
142
143
  }
143
144
  };
144
145
  }
145
146
  export {
146
147
  U as P,
147
148
  W as c,
148
- I as v
149
+ h as v
149
150
  };
@@ -386,7 +386,7 @@ function Ne(t) {
386
386
  const Pe = (t) => {
387
387
  const [e, r] = t, n = e instanceof Request && !r?.headers ? e.headers.has(b) : new Headers(r?.headers).has(b), s = W(n);
388
388
  return s ? d(w(b, s, t)) : d(t);
389
- }, Te = "X-SFDC-Client-Name", $e = "X-SFDC-Client-Version", _e = "@salesforce/platform-sdk", Re = "12.14.0", Le = (t) => {
389
+ }, Te = "X-SFDC-Client-Name", $e = "X-SFDC-Client-Version", _e = "@salesforce/platform-sdk", Re = "12.15.0", Le = (t) => {
390
390
  let e = w(Te, _e, t);
391
391
  return e = w($e, Re, e), d(e);
392
392
  }, Ve = "X-CSRF-Token";
package/dist/index.js CHANGED
@@ -7,8 +7,8 @@ import { createDataSDK as M, defineDataExtension as P, gql as V } from "./data/i
7
7
  import { createLightningSDK as E } from "./lightning/index.js";
8
8
  import { WebAppCurrentApp as I, getCurrentApp as U } from "./app/index.js";
9
9
  import { c as q } from "./transport-D9QstWle.js";
10
- import { T as F, r as L } from "./TelemetryUploader-DKkdppe9.js";
11
- import { P as W, c as Y, v as j } from "./analytics-TRyVm9Ub.js";
10
+ import { T as F, r as L } from "./TelemetryUploader-mZWIhtRG.js";
11
+ import { P as W, c as Y, v as j } from "./analytics-DtUm3Bhb.js";
12
12
  export {
13
13
  n as MCPAppsChatSDK,
14
14
  d as MCPAppsViewSDK,
@@ -36,6 +36,14 @@ export interface AutoInstrumentationOptions {
36
36
  * @default false
37
37
  */
38
38
  useBase64Json?: boolean;
39
+ /**
40
+ * Let the uploader fall back to an eval-free encoder when the page's Content
41
+ * Security Policy blocks `'unsafe-eval'`. The first upload probes code generation
42
+ * once and keeps the protobufjs encoder when the page allows it. Forwarded to the
43
+ * orchestrator. Requires o11y 266.26.0 or later.
44
+ * @default false
45
+ */
46
+ useEvalFreeEncoder?: boolean;
39
47
  /**
40
48
  * Form data key for telemetry payload (when not using Base64 JSON).
41
49
  * @default 'telemetry'
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAc,aAAa,EAA2B,MAAM,mBAAmB,CAAC;AAEvF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE;QACZ,kCAAkC;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,0BAA0B;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,yDAAyD;QACzD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,wBAAwB;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;IAEzC;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAEnC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CA2CvF;AAED;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAc,aAAa,EAA2B,MAAM,mBAAmB,CAAC;AAEvF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE;QACZ,kCAAkC;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,0BAA0B;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,yDAAyD;QACzD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,wBAAwB;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;IAEzC;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAEnC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CA4CvF;AAED;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC"}
@@ -7,6 +7,7 @@ function c(e) {
7
7
  endpoint: e.endpoint,
8
8
  environment: e.environment,
9
9
  useBase64Json: e.useBase64Json,
10
+ useEvalFreeEncoder: e.useEvalFreeEncoder,
10
11
  formDataKey: e.formDataKey,
11
12
  maxUniqueSchemas: e.maxUniqueSchemas,
12
13
  periodicUploadIntervalMs: e.periodicUploadIntervalMs,
@@ -1,5 +1,5 @@
1
1
  import { c as t } from "../transport-D9QstWle.js";
2
- import { T as o, r as l } from "../TelemetryUploader-DKkdppe9.js";
2
+ import { T as o, r as l } from "../TelemetryUploader-mZWIhtRG.js";
3
3
  export {
4
4
  o as TelemetryUploader,
5
5
  t as createTelemetryTransport,
@@ -10,6 +10,7 @@ export declare class TelemetryUploader implements LogCollectorLike, MetricsColle
10
10
  private readonly _uploadInterval;
11
11
  private readonly _clickUploadDelay;
12
12
  private readonly _clickTriggerCooldown;
13
+ private readonly _useEvalFreeEncoder;
13
14
  private readonly _boundClickListener;
14
15
  private readonly _boundVisibilityChangeListener;
15
16
  private readonly _boundPageHideListener;
@@ -1 +1 @@
1
- {"version":3,"file":"TelemetryUploader.d.ts","sourceRoot":"","sources":["../../../src/telemetry/uploader/TelemetryUploader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAG3B,wBAAwB,EACxB,MAAM,cAAc,CAAC;AAuBtB,qBAAa,iBAAkB,YAAW,gBAAgB,EAAE,oBAAoB;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgC;IACpE,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAA2C;IAC1F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAmC;IAC1E,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAc;IAC1C,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,wBAAwB;IA4B7C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oBAAoB,IAAI,OAAO;IAI/B,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAe/D,wBAAwB,CAAC,UAAU,EAAE,2BAA2B,GAAG,IAAI;IAWjE,KAAK,CAAC,MAAM,GAAE,WAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpD,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,wBAAwB;YAIlB,cAAc;CA2B5B;AAED,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,mBAAmB,EACpC,OAAO,EAAE,wBAAwB,GAC/B,iBAAiB,CAcnB"}
1
+ {"version":3,"file":"TelemetryUploader.d.ts","sourceRoot":"","sources":["../../../src/telemetry/uploader/TelemetryUploader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAG3B,wBAAwB,EACxB,MAAM,cAAc,CAAC;AAuBtB,qBAAa,iBAAkB,YAAW,gBAAgB,EAAE,oBAAoB;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgC;IACpE,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAA2C;IAC1F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAmC;IAC1E,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAc;IAC1C,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,wBAAwB;IA6B7C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oBAAoB,IAAI,OAAO;IAI/B,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAe/D,wBAAwB,CAAC,UAAU,EAAE,2BAA2B,GAAG,IAAI;IAWjE,KAAK,CAAC,MAAM,GAAE,WAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpD,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,wBAAwB;YAIlB,cAAc;CA2B5B;AAED,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,mBAAmB,EACpC,OAAO,EAAE,wBAAwB,GAC/B,iBAAiB,CAcnB"}
@@ -35,6 +35,18 @@ export interface TelemetryUploaderOptions {
35
35
  clickUploadDelay?: number;
36
36
  clickTriggerCooldown?: number;
37
37
  onError?: (context: TelemetryUploaderErrorContext) => void;
38
+ /**
39
+ * Lets o11y fall back to an eval-free protobuf encoder when the page's
40
+ * Content Security Policy blocks code generation (no `'unsafe-eval'`).
41
+ *
42
+ * @remarks
43
+ * The first encode probes code generation once. Pages that allow it keep
44
+ * the protobufjs encoder. The encoded bytes are identical on both paths.
45
+ * Requires o11y 266.26.0 or later.
46
+ *
47
+ * @default false
48
+ */
49
+ useEvalFreeEncoder?: boolean;
38
50
  }
39
51
  export interface MetricsExtractorMethodsLike {
40
52
  getAllBucketHistograms(): unknown[];
@@ -1 +1 @@
1
- {"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/telemetry/uploader/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACtB,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,kBAAkB,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAChC,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE,sBAAsB,KAC3B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,6BAA8B,SAAQ,sBAAsB;IAC5E,KAAK,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,2BAA2B;IAC3C,sBAAsB,IAAI,OAAO,EAAE,CAAC;IACpC,gBAAgB,IAAI,OAAO,EAAE,CAAC;IAC9B,oBAAoB,IAAI,OAAO,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAChC,oBAAoB,CAAC,IAAI,OAAO,CAAC;IACjC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,oBAAoB;IACpC,wBAAwB,CAAC,UAAU,EAAE,2BAA2B,GAAG,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IACnC,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7F,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChE,oBAAoB,CAAC,IAAI,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}
1
+ {"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/telemetry/uploader/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACtB,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,kBAAkB,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAChC,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE,sBAAsB,KAC3B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,6BAA8B,SAAQ,sBAAsB;IAC5E,KAAK,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,IAAI,CAAC;IAC3D;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC3C,sBAAsB,IAAI,OAAO,EAAE,CAAC;IACpC,gBAAgB,IAAI,OAAO,EAAE,CAAC;IAC9B,oBAAoB,IAAI,OAAO,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAChC,oBAAoB,CAAC,IAAI,OAAO,CAAC;IACjC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,oBAAoB;IACpC,wBAAwB,CAAC,UAAU,EAAE,2BAA2B,GAAG,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IACnC,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7F,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChE,oBAAoB,CAAC,IAAI,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/platform-sdk",
3
- "version": "12.14.0",
3
+ "version": "12.15.0",
4
4
  "license": "SEE LICENSE IN LICENSE.txt",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -131,9 +131,10 @@
131
131
  "build": "vite build",
132
132
  "clean": "rm -rf dist",
133
133
  "dev": "vite build --watch",
134
- "test": "vitest run --typecheck && npm run test:examples && npm run test:docs",
134
+ "test": "vitest run --typecheck && npm run test:examples && npm run test:docs && npm run test:private-producer",
135
135
  "test:examples": "tsx scripts/check-examples.mts",
136
136
  "test:docs": "tsx scripts/check-docs-symbols.mts",
137
+ "test:private-producer": "tsx scripts/check-private-producer.mts",
137
138
  "test:watch": "vitest",
138
139
  "test:coverage": "vitest run --coverage --typecheck"
139
140
  },
@@ -147,11 +148,11 @@
147
148
  "@conduit-client/service-pubsub": "3.19.6",
148
149
  "@conduit-client/service-retry": "3.19.6",
149
150
  "@conduit-client/utils": "3.19.6",
150
- "@salesforce/jsonrpc": "^12.14.0",
151
+ "@salesforce/jsonrpc": "^12.15.0",
151
152
  "@salesforce/sf-embedding-bridge": "2.3.0-rc.3"
152
153
  },
153
154
  "peerDependencies": {
154
- "o11y": ">=266.13.0",
155
+ "o11y": ">=266.26.0",
155
156
  "o11y_schema": ">=264.109.0"
156
157
  },
157
158
  "devDependencies": {
@@ -1,17 +0,0 @@
1
- import { Instrumentation } from './verbs';
2
- /**
3
- * Public entry point. Returns a verb surface bound to `name` — the logger/app
4
- * identity the o11y-client drain dispatches on (getInstrumentation(name)).
5
- *
6
- * `name` is validated eagerly: o11y-client's `isValidQueueEvent` silently drops
7
- * events whose name is empty or longer than {@link MAX_NAME_LENGTH}, so an
8
- * invalid name would lose ALL telemetry from that logger with zero feedback.
9
- * We fail fast here instead of emitting silently-discarded events.
10
- *
11
- * @throws {TypeError} if `name` is not a non-empty string of at most
12
- * {@link MAX_NAME_LENGTH} characters.
13
- */
14
- export declare function getInstrumentation(name: string): Instrumentation;
15
- export type { Instrumentation } from './verbs';
16
- export type { QueueVerb, QueueEventV1 } from './protocol';
17
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/observability/vendor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAOhE;AAED,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
@@ -1,11 +0,0 @@
1
- /**
2
- * Copyright (c) 2026, Salesforce, Inc.,
3
- * All rights reserved.
4
- * For full license text, see the LICENSE.txt file
5
- */
6
- /**
7
- * PLACEHOLDER names (owned by Platform SDK, WI-16 §8). Single source of truth —
8
- * a later name freeze is a one-line change here.
9
- */
10
- export declare const QUEUE_KEY_1P: "__SF_O11Y_QUEUE_1P__";
11
- //# sourceMappingURL=names.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../src/observability/vendor/names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAG,sBAA+B,CAAC"}
@@ -1,25 +0,0 @@
1
- /**
2
- * Copyright (c) 2026, Salesforce, Inc.,
3
- * All rights reserved.
4
- * For full license text, see the LICENSE.txt file
5
- */
6
- /**
7
- * FROZEN vendored copy of the o11y-client queue protocol contract.
8
- * SOURCE OF TRUTH: instrumentation/o11y-client
9
- * packages/o11y/src/queue/types.ts (QueueEventV1, QueueVerb, MAX_* limits)
10
- * packages/o11y/src/queue/drain.ts (isValidQueueEvent, MAX_SUPPORTED_VERSION)
11
- * Kept in sync MANUALLY. Do not diverge without a matching change there.
12
- */
13
- /** The only verbs the o11y-client drain will replay. Anything else is dropped. */
14
- export type QueueVerb = "log" | "error" | "incrementCounter" | "trackValue" | "bucketValue";
15
- /** Wire event, version 1 — exactly these four fields. */
16
- export interface QueueEventV1 {
17
- version: 1;
18
- name: string;
19
- verb: QueueVerb;
20
- args: unknown[];
21
- }
22
- export declare const PROTOCOL_VERSION: 1;
23
- export declare const MAX_NAME_LENGTH = 256;
24
- export declare const MAX_ARGS_LENGTH = 10;
25
- //# sourceMappingURL=protocol.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/observability/vendor/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AAEH,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,kBAAkB,GAAG,YAAY,GAAG,aAAa,CAAC;AAE5F,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,OAAO,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAC3C,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,eAAe,KAAK,CAAC"}
@@ -1,16 +0,0 @@
1
- import { QueueVerb } from './protocol';
2
- /**
3
- * Max events buffered on the 1P global BEFORE o11y-client's orchestrator installs
4
- * its drain. If the drop-in never loads (not installed, or init throws), this cap
5
- * bounds memory: the oldest events are dropped first and tallied in `droppedCount`,
6
- * which o11y-client's drain reads (QueueBufferStub contract) to report the loss.
7
- */
8
- export declare const MAX_PENDING_EVENTS = 1000;
9
- /**
10
- * Enqueue one event onto the 1P queue global. Correct BOTH before drain (we
11
- * lazily create a bounded, drop-oldest buffer) and after drain (the global is
12
- * o11y-client's DirectDispatchProxy, which also exposes `.push`).
13
- * Fire-and-forget: browser-only, never throws, never emits console output.
14
- */
15
- export declare function emit(name: string, verb: QueueVerb, args: unknown[]): void;
16
- //# sourceMappingURL=queue.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/observability/vendor/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAoB,KAAK,SAAS,EAAqB,MAAM,YAAY,CAAC;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAoCvC;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAYzE"}
@@ -1,19 +0,0 @@
1
- /**
2
- * Copyright (c) 2026, Salesforce, Inc.,
3
- * All rights reserved.
4
- * For full license text, see the LICENSE.txt file
5
- */
6
- /**
7
- * The 1P producer verb surface — mirrors o11y-client's Instrumentation 1:1 for
8
- * the five queue-drainable verbs. Each call enqueues a positional-args event.
9
- */
10
- export interface Instrumentation {
11
- log(schemaOrText: unknown, data?: unknown, options?: unknown): void;
12
- error(error: unknown, schemaOrText?: unknown, data?: unknown, options?: unknown): void;
13
- incrementCounter(operation: string, increment?: number, hasError?: boolean, tags?: Record<string, unknown>): void;
14
- trackValue(operation: string, value: number, hasError?: boolean, tags?: Record<string, unknown>): void;
15
- bucketValue(operation: string, value: number, buckets?: number[], hasError?: boolean, tags?: Record<string, unknown>): void;
16
- }
17
- /** Build a verb surface bound to a logger `name`. Arg order matches o11y-client. */
18
- export declare function createInstrumentation(name: string): Instrumentation;
19
- //# sourceMappingURL=verbs.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"verbs.d.ts","sourceRoot":"","sources":["../../../src/observability/vendor/verbs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACvF,gBAAgB,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,OAAO,EAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAAC;IACR,UAAU,CACT,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,EAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAAC;IACR,WAAW,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,QAAQ,CAAC,EAAE,OAAO,EAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAAC;CACR;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAkBnE"}