@safaricom-mxl/web-sdk 0.0.16 → 0.0.18

package/DATA_EXPORT.md

@@ -3,7 +3,7 @@
 ## When is data sent?
 
 Telemetry data for Spans and Logs are exported from the SDK independently. Spans are sent as a batch whenever a session
-ends, this is managed by the [MXLSessionBatchedSpanProcessor](./src/processors/MXLSessionBatchedSpanProcessor/MXLSessionBatchedSpanProcessor.ts).
+ends, this is managed by the [MXLSessionPartBatchedSpanProcessor](./src/processors/MXLSessionPartBatchedSpanProcessor/MXLSessionPartBatchedSpanProcessor.ts).
 Logs are also batched but can be sent throughout a session, this is managed by a [BatchLogRecordProcessor](https://github.com/open-telemetry/opentelemetry-js/blob/experimental/v0.57.0/experimental/packages/sdk-logs/src/platform/browser/export/BatchLogRecordProcessor.ts).
 
 ## How is data sent?
@@ -13,7 +13,7 @@ Data from the SDK is sent to MXL using a CORS HTTP POST request. The data is gzi
 [keepalive property](https://developer.mozilla.org/en-US/docs/Web/API/Request/keepalive) of the browser's Fetch API to
 help ensure the transmission of data even if the page has been closed. If possible we will attempt to retry request
 failures following an exponential backoff. See [FetchTransport](./src/transport/FetchTransport/FetchTransport.ts) and
-[RetryingTransport](./src/transport/RetryingTransport/RetryingTransport.ts) for more details. 
+[RetryingTransport](./src/transport/RetryingTransport/RetryingTransport.ts) for more details.
 
 > [!NOTE]
 > The Fetch API's `keepalive` property is supported by all modern browsers, however it was a relatively recent addition
@@ -26,4 +26,3 @@ If you [provide your own custom exporter](./README.md#custom-exporters) then bat
 [BatchLogRecordProcessor](https://github.com/open-telemetry/opentelemetry-js/blob/experimental/v0.57.0/experimental/packages/sdk-logs/src/platform/browser/export/BatchLogRecordProcessor.ts)
 and [BatchSpanProcessor](https://github.com/open-telemetry/opentelemetry-js/blob/v1.30.0/packages/opentelemetry-sdk-trace-base/src/platform/browser/export/BatchSpanProcessor.ts)
 respectively.
-

package/REACT.md

@@ -1,25 +1,39 @@
 # Instrumenting a React app with the MXL Web SDK
 
-You can use any of the MXL Web SDK features in your React application. However, we provide some additional automatic 
+You can use any of the MXL Web SDK features in your React application. However, we provide some additional automatic
 instrumentation to make it easier to instrument some common React libraries and patterns.
 
 > [!TIP]
 > Make sure you call `initSDK` before your React App is mounted, this will ensure that the SDK is ready to capture traces and logs from the start of your app's lifecycle.
 
+## Recommended imports
+
+Prefer granular subpath imports so bundlers only load the React helpers you use. This is especially important for SSR
+frameworks such as TanStack Start and Vinxi.
+
+| Use case | Import path |
+| --- | --- |
+| Error boundary | `@safaricom-mxl/web-sdk/react-instrumentation/error-boundary` |
+| React Router navigation init | `@safaricom-mxl/web-sdk/react-instrumentation/navigation` |
+| React Router v4/v5 HOC | `@safaricom-mxl/web-sdk/react-instrumentation/router-v5` |
+| React Router v6+ declarative HOC | `@safaricom-mxl/web-sdk/react-instrumentation/router-v6-declarative` |
+| React Router v6+ data router | `@safaricom-mxl/web-sdk/react-instrumentation/router-v6-data` |
+
+The legacy barrel `@safaricom-mxl/web-sdk/react-instrumentation` remains available for backward compatibility, but it
+re-exports all React helpers and can pull in unused router modules in strict ESM environments.
+
 ## React Router
 
 To instrument React Router, add the React Router navigation instrumentation when you init the MXL Web SDK.
 
 ```typescript
 import { initSDK } from '@safaricom-mxl/web-sdk';
-import { createReactRouterNavigationInstrumentation } from '@safaricom-mxl/web-sdk/react-instrumentation';
+import { createReactRouterNavigationInstrumentation } from '@safaricom-mxl/web-sdk/react-instrumentation/navigation';
 
 initSDK({
   // ...Other configs
-  instrumentations: [
-    createReactRouterNavigationInstrumentation(),
-  ],
-})
+  instrumentations: [createReactRouterNavigationInstrumentation()],
+});
 ```
 
 ### React Router V4/V5
@@ -27,7 +41,7 @@ initSDK({
 If you're using React Router V4 or V5, you can use the `withMXLRoutingLegacy` higher-order component (HOC) to wrap your `Route` components. This will automatically track route changes. `MXLRoute` needs to be surrounded by a `<Switch>` component to properly capture the current path.
 
 ```typescript jsx
-import { withMXLRoutingLegacy } from '@safaricom-mxl/web-sdk/react-instrumentation';
+import { withMXLRoutingLegacy } from '@safaricom-mxl/web-sdk/react-instrumentation/router-v5';
 import { Route, Router, Switch } from 'react-router-dom';
 
 const MXLRoute = withMXLRoutingLegacy(Route);
@@ -47,10 +61,10 @@ const App = () => {
 
 ### React Router V6+ in declarative mode
 
-If you're using React Router V6 or later, you can use the `withMXLRouting` higher-order component (HOC) to wrap your `Routes` components. This will automatically track route changes. 
+If you're using React Router V6 or later, you can use the `withMXLRouting` higher-order component (HOC) to wrap your `Routes` components. This will automatically track route changes.
 
 ```typescript jsx
-import { withMXLRouting } from '@safaricom-mxl/web-sdk/react-instrumentation';
+import { withMXLRouting } from '@safaricom-mxl/web-sdk/react-instrumentation/router-v6-declarative';
 import { Route, Routes, BrowserRouter } from 'react-router-dom';
 
 const MXLRoutes = withMXLRouting(Routes);
@@ -73,7 +87,7 @@ const App = () => {
 When using data mode in React Router, you can listen to browser changes using `listenToRouterChanges` to automatically track route changes.
 
 ```typescript jsx
-import { listenToRouterChanges } from '@safaricom-mxl/web-sdk/react-instrumentation';
+import { listenToRouterChanges } from '@safaricom-mxl/web-sdk/react-instrumentation/router-v6-data';
 import {
   createBrowserRouter,
   RouterProvider,
@@ -126,7 +140,7 @@ If set to `true`, the instrumentation will remove path options from the route na
 To capture rendering errors in your React components, you can use the `MXLErrorBoundary` component. This component will automatically capture errors that on any of its children components render and send them to MXL.
 
 ```typescript jsx
-import { MXLErrorBoundary } from '@safaricom-mxl/web-sdk/react-instrumentation';
+import { MXLErrorBoundary } from '@safaricom-mxl/web-sdk/react-instrumentation/error-boundary';
 
 const App = () => {
   return (
@@ -140,4 +154,4 @@ const App = () => {
     </MXLErrorBoundary>
   );
 }
-```
+```

package/README.md

@@ -49,14 +49,14 @@ capturing telemetry:
 import { initSDK } from '@safaricom-mxl/web-sdk';
 
 const result = initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
 });
 
 if (!!result) {
-  console.log("Successfully initialized the MXL SDK");
+  console.log('Successfully initialized the MXL SDK');
 } else {
-  console.log("Failed to initialize the MXL SDK");
+  console.log('Failed to initialize the MXL SDK');
 }
 ```
 
@@ -75,7 +75,7 @@ For the most basic usage simply start a span and end it after some operation com
 ```typescript
 import { trace } from '@safaricom-mxl/web-sdk';
 
-const span = trace.startSpan("span-name");
+const span = trace.startSpan('span-name');
 
 someAsyncOperation()
   .then(() => span.end())
@@ -97,7 +97,7 @@ You can add basic context to sessions by emitting a breadcrumb that will be visi
 ```typescript
 import { session } from '@safaricom-mxl/web-sdk';
 
-session.addBreadcrumb("something happened");
+session.addBreadcrumb('something happened');
 ```
 
 A full log message can also be emitted. Note that unlike emitting a breadcrumb a log is more heavy-weight and may
@@ -109,8 +109,8 @@ import { log } from '@safaricom-mxl/web-sdk';
 log.message('Loading not finished in time.', 'error', {
   attributes: {
     propertyA: 'valueA',
-    propertyB: 'valueB'
-  }
+    propertyB: 'valueB',
+  },
 });
 ```
 
@@ -130,8 +130,8 @@ try {
     handled: true,
     attributes: {
       propertyA: 'valueA',
-      propertyB: 'valueB'
-    }
+      propertyB: 'valueB',
+    },
   });
 }
 ```
@@ -147,14 +147,14 @@ You can add custom properties to be included as part of the current session:
 ```typescript
 import { session } from '@safaricom-mxl/web-sdk';
 
-session.addProperty("my-custom-property", "some value");
+session.addProperty('my-custom-property', 'some value');
 ```
 
 These properties will, by default, only be included in the current session.
 If you want to add permanent properties that are sent across all sessions, you can configure the lifespan option:
 
 ```typescript
-session.addProperty("my-custom-property", "some value", {
+session.addProperty('my-custom-property', 'some value', {
   lifespan: 'permanent',
 });
 ```
@@ -167,10 +167,10 @@ you use your `package.json` to track versions of your app then a way to keep thi
 value when initializing the SDK (assuming that your bundler provides a method for importing json files):
 
 ```typescript
-import * as packageInfo from "../<some-path>/package.json";
+import * as packageInfo from '../<some-path>/package.json';
 
 initSDK({
-  appID: "YOUR_MXL_APP_ID",
+  appID: 'YOUR_MXL_APP_ID',
   appVersion: packageInfo.version,
 });
 ```
@@ -211,7 +211,6 @@ npx mxl-web-cli upload -a "YOUR_MXL_APP_ID" -t "YOUR_MXL_UPLOAD_API_TOKEN" -p "J
 > The CLI injects a comment and a short function to the end of bundle files to enable symbolication, so it needs to
 > happen before packaging.
 
-
 Additionally, if your app version is only known at build-time you can include it in the same command to have it injected
 into the bundle. If you follow this method do not also include appVersion when calling `initSDK` as that value will take
 precedence:
@@ -234,8 +233,8 @@ ones altogether) you can pass a `defaultInstrumentationConfig` object when initi
 import { initSDK } from '@safaricom-mxl/web-sdk';
 
 initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   defaultInstrumentationConfig: {
     omit: new Set(['@opentelemetry/instrumentation-fetch']),
   },
@@ -251,8 +250,8 @@ For more advanced customization you can also include additional instrumentations
 import { initSDK } from '@safaricom-mxl/web-sdk';
 
 initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   instrumentations: [myCustomInstrumentation],
 });
 ```
@@ -269,27 +268,30 @@ import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
 import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
 
 initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   spanExporters: [
     new OTLPTraceExporter({
       url: 'https://example.com/endpoint/for/traces',
       headers: {
-        'Authorization': 'Basic TOKEN'
-      }
+        Authorization: 'Basic TOKEN',
+      },
     }),
   ],
   logExporters: [
     new OTLPLogExporter({
       url: 'https://example.com/endpoint/for/logs',
       headers: {
-        'Authorization': 'Basic TOKEN'
-      }
+        Authorization: 'Basic TOKEN',
+      },
     }),
   ],
   defaultInstrumentationConfig: {
     network: {
-      ignoreUrls: ['https://example.com/endpoint/for/traces', 'https://example.com/endpoint/for/logs'],
+      ignoreUrls: [
+        'https://example.com/endpoint/for/traces',
+        'https://example.com/endpoint/for/logs',
+      ],
     },
   },
 });
@@ -309,13 +311,19 @@ We recommend you include our SDK as a regular npm dependency (see [Quick Start](
 the SDK as a code snippet from CDN, you can do so by adding the following script tag to your generated HTML file:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/-mxl/web-sdk" crossorigin="anonymous"></script>
+<script
+  src="https://cdn.jsdelivr.net/npm/-mxl/web-sdk"
+  crossorigin="anonymous"
+></script>
 ```
 
 Note: we recommend you pin specific versions to avoid breaking changes. Like:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/-mxl/web-sdk@X.X.X" crossorigin="anonymous"></script>
+<script
+  src="https://cdn.jsdelivr.net/npm/-mxl/web-sdk@X.X.X"
+  crossorigin="anonymous"
+></script>
 ```
 
 Replacing `X.X.X` with the version of the SDK you wish to include. Check available versions
@@ -328,14 +336,14 @@ that makes use of the sdk.
 The rest of this README assumes using the SDK from an NPM installation, here are some required changes to keep in mind
 as you refer to that documentation:
 
-1) Importing the sdk from node modules is no longer valid. Instead, reference it from the global `window` object:
+1. Importing the sdk from node modules is no longer valid. Instead, reference it from the global `window` object:
 
    ```diff
    - import { initSDK, log, page, session, trace, user } from '@safaricom-mxl/web-sdk';
    + const { initSDK, log, page, session, trace, user } = window.MXLWebSdk;
    ```
 
-2) Our CLI tool does not support injecting an app version when loading from CDN since in that case our SDK is not
+2. Our CLI tool does not support injecting an app version when loading from CDN since in that case our SDK is not
    bundled with your code, instead you will need to make sure to pass in your app version when initializing the sdk as
    in the following example:
 
@@ -353,7 +361,27 @@ following snippet to your HTML file. Remmxler to replace `X.X.X` with the versio
 
 ```html
 <script>
-   !function(){window.MXLWebSdkOnReady=window.MXLWebSdkOnReady||{q:[],onReady:function(e){window.MXLWebSdkOnReady.q.push(e)}};let e=document.createElement("script");e.async=!0,e.crossOrigin="anonymous",e.src="https://cdn.jsdelivr.net/npm/-mxl/web-sdk@X.X.X",e.onload=function(){window.MXLWebSdkOnReady.q.forEach(e=>e()),window.MXLWebSdkOnReady.q=[],window.MXLWebSdkOnReady.onReady=function(e){e()}};let n=document.getElementsByTagName("script")[0];n.parentNode.insertBefore(e,n)}();
+  !(function () {
+    window.MXLWebSdkOnReady = window.MXLWebSdkOnReady || {
+      q: [],
+      onReady: function (e) {
+        window.MXLWebSdkOnReady.q.push(e);
+      },
+    };
+    let e = document.createElement('script');
+    ((e.async = !0),
+      (e.crossOrigin = 'anonymous'),
+      (e.src = 'https://cdn.jsdelivr.net/npm/-mxl/web-sdk@X.X.X'),
+      (e.onload = function () {
+        (window.MXLWebSdkOnReady.q.forEach((e) => e()),
+          (window.MXLWebSdkOnReady.q = []),
+          (window.MXLWebSdkOnReady.onReady = function (e) {
+            e();
+          }));
+      }));
+    let n = document.getElementsByTagName('script')[0];
+    n.parentNode.insertBefore(e, n);
+  })();
 </script>
 ```
 
@@ -365,7 +393,7 @@ window.MXLWebSdkOnReady.onReady(() => {
     appVersion: '0.0.1',
     /*...*/
   });
-})
+});
 ```
 
 This is necessary to ensure that the SDK is fully loaded before you start using it.
@@ -383,8 +411,8 @@ initializing the SDK.
 import { initSDK } from '@safaricom-mxl/web-sdk';
 
 const mxlSDK = initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   registerGlobally: false, // Prevents the SDK from registering itself globally
 });
 ```
@@ -396,8 +424,8 @@ and properties.
 import { initSDK } from '@safaricom-mxl/web-sdk';
 
 const mxlSDK = initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   registerGlobally: false, // Prevents the SDK from registering itself globally
 });
 
@@ -412,10 +440,10 @@ log.message('This is a log message', 'info');
 
 Some instrumentation is still being registered globally and we're actively working on making it local for each instance:
 
-* Fetch and XHR instrumentations patch global functions (`globalThis.fetch` and `XMLHttpRequest.prototype`). When
+- Fetch and XHR instrumentations patch global functions (`globalThis.fetch` and `XMLHttpRequest.prototype`). When
   multiple SDK instances run on the same page each one installs its own wrapper and every instance produces spans for
   every network request.
-* Global error handler listens to all unhandled errors and rejections, all SDKs are going to report all the errors that
+- Global error handler listens to all unhandled errors and rejections, all SDKs are going to report all the errors that
   are not caught.
 
 ## Network span forwarding
@@ -440,19 +468,19 @@ the additional header by configuring the fetch or XHR instrumentations with an a
 import { sdk } from '@safaricom-mxl/web-sdk';
 
 sdk.initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   defaultInstrumentationConfig: {
     '@opentelemetry/instrumentation-fetch': {
       propagateTraceHeaderCorsUrls: [
         /example\.com/, // propagates for any CORS requests with URLs that match the regex
-        "https://www.example.com/foo", // propagates for CORS requests to URLs that exactly match the string
+        'https://www.example.com/foo', // propagates for CORS requests to URLs that exactly match the string
       ],
     },
     '@opentelemetry/instrumentation-xml-http-request': {
       propagateTraceHeaderCorsUrls: [
         /example\.com/, // propagates for any CORS requests with URLs that match the regex
-        "https://www.example.com/foo", // propagates for CORS requests to URLs that exactly match the string
+        'https://www.example.com/foo', // propagates for CORS requests to URLs that exactly match the string
       ],
     },
   },
@@ -468,8 +496,8 @@ turned off if set:
 import { sdk } from '@safaricom-mxl/web-sdk';
 
 sdk.initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
 
   // The following are not supported alongside Network Span Forwarding and will cause that feature to turn off:
   // 1. Setting registerGlobally to false
@@ -477,7 +505,10 @@ sdk.initSDK({
   // 2. Providing a custom propagator
   propagator: myCustomPropagator,
   // 3. Omitting both network instrumentations
-  omit: new Set(['@opentelemetry/instrumentation-fetch', '@opentelemetry/instrumentation-xml-http-request']),
+  omit: new Set([
+    '@opentelemetry/instrumentation-fetch',
+    '@opentelemetry/instrumentation-xml-http-request',
+  ]),
 });
 ```
 
@@ -490,8 +521,8 @@ of what has been configured server-side:
 import { sdk } from '@safaricom-mxl/web-sdk';
 
 sdk.initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
 
   blockNetworkSpanForwarding: true,
 });
@@ -528,9 +559,9 @@ If you wish to customize the SDK behavior by configuring custom resources, expor
 you must ensure that you are using versions of the OTel packages that are compatible with our SDK:
 
 | MXL Web SDK | Open Telemetry APIs | Core   | Instrumentations & Contrib |
-|-----------------|---------------------|--------|----------------------------|
-| ^2.0.0          | ^1.9.0              | ^2.0.3 | >=0.203.0 <0.300.0         |
-| 1.8.2           | ^1.9.0              | 1.30.1 | 0.57.2                     |
+| ----------- | ------------------- | ------ | -------------------------- |
+| ^2.0.0      | ^1.9.0              | ^2.0.3 | >=0.203.0 <0.300.0         |
+| 1.8.2       | ^1.9.0              | 1.30.1 | 0.57.2                     |
 
 For a full list of dependencies used by the SDK, please refer to [package.json](./package.json).
 
@@ -543,8 +574,8 @@ initializing as follows:
 import { initSDK, DiagLogLevel } from '@safaricom-mxl/web-sdk';
 
 initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   logLevel: DiagLogLevel.ALL,
 });
 ```
@@ -556,12 +587,18 @@ emitted:
 
 ```typescript
 import { initSDK, DiagLogLevel } from '@safaricom-mxl/web-sdk';
-import { ConsoleLogRecordExporter, SimpleLogRecordProcessor } from '@opentelemetry/sdk-logs';
-import { ConsoleSpanExporter, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-web'
+import {
+  ConsoleLogRecordExporter,
+  SimpleLogRecordProcessor,
+} from '@opentelemetry/sdk-logs';
+import {
+  ConsoleSpanExporter,
+  SimpleSpanProcessor,
+} from '@opentelemetry/sdk-trace-web';
 
 initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   logLevel: DiagLogLevel.INFO,
 
   // setup as exporters to output with the same batching as when exporting to a collector endpoint
@@ -588,7 +625,7 @@ module.exports = {
     alias: {
       '@opentelemetry/semantic-conventions/incubating': path.resolve(
         __dirname,
-        './node_modules/@opentelemetry/semantic-conventions/build/src/index-incubating.js'
+        './node_modules/@opentelemetry/semantic-conventions/build/src/index-incubating.js',
       ),
     },
   },

package/UPGRADING.md

@@ -15,12 +15,14 @@ If your app has direct dependencies on OTel JS packages ensure they are updated
 import { sdk } from '@safaricom-mxl/web-sdk';
 
 sdk.initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   logLevel: sdk.DiagLogLevel.INFO,
 });
 
-const myMethod = (span: sdk.Span) => { /* ... */ };
+const myMethod = (span: sdk.Span) => {
+  /* ... */
+};
 ```
 
 2.x version:
@@ -29,12 +31,14 @@ const myMethod = (span: sdk.Span) => { /* ... */ };
 import { initSDK, DiagLogLevel, Span } from '@safaricom-mxl/web-sdk';
 
 initSDK({
-  appID: "YOUR_MXL_APP_ID",
-  appVersion: "YOUR_APP_VERSION",
+  appID: 'YOUR_MXL_APP_ID',
+  appVersion: 'YOUR_APP_VERSION',
   logLevel: DiagLogLevel.INFO,
 });
 
-const myMethod = (span: Span) => { /* ... */ };
+const myMethod = (span: Span) => {
+  /* ... */
+};
 ```
 
 ### CLI now operates on a build folder rather than individual files
@@ -56,8 +60,9 @@ npx mxl-web-cli upload --app-version "APP_VERSION" -a "YOUR_MXL_APP_ID" -t "YOUR
 See the breaking changes outlined in the [1.0.0 Release notes](https://github.com/mxl-io/mxl-web-sdk/releases/tag/1.0.0).
 
 In order to upgrade you will need to:
-* Update MXL trace API calls from `startPerformanceSpan` to `startSpan`
-* Update any optional arguments being passed to `log.message` or `log.logException`
+
+- Update MXL trace API calls from `startPerformanceSpan` to `startSpan`
+- Update any optional arguments being passed to `log.message` or `log.logException`
 
 ### Update start span calls
 
@@ -66,7 +71,7 @@ In order to upgrade you will need to:
 ```typescript
 import { trace } from '@safaricom-mxl/web-sdk';
 
-const span = trace.startPerformanceSpan("span-name");
+const span = trace.startPerformanceSpan('span-name');
 ```
 
 1.x version:
@@ -74,7 +79,7 @@ const span = trace.startPerformanceSpan("span-name");
 ```typescript
 import { trace } from '@safaricom-mxl/web-sdk';
 
-const span = trace.startSpan("span-name");
+const span = trace.startSpan('span-name');
 ```
 
 ### Update logging arguments
@@ -84,12 +89,17 @@ const span = trace.startSpan("span-name");
 ```typescript
 import { log } from '@safaricom-mxl/web-sdk';
 
-log.message('Loading not finished in time.', 'error', {
-  keyA: 'valueA',
-  keYB: 'valueB'
-}, true);
+log.message(
+  'Loading not finished in time.',
+  'error',
+  {
+    keyA: 'valueA',
+    keYB: 'valueB',
+  },
+  true,
+);
 
-// ... 
+// ...
 
 log.logException(err, true, { keyA: 'valueA' }, ts);
 ```
@@ -102,16 +112,16 @@ import { log } from '@safaricom-mxl/web-sdk';
 log.message('Loading not finished in time.', 'error', {
   attributes: {
     keyA: 'valueA',
-    keYB: 'valueB'
+    keYB: 'valueB',
   },
-  includeStacktrace: true
+  includeStacktrace: true,
 });
 
-// ... 
+// ...
 
 log.logException(err, {
   handled: true,
   attributes: { keyA: 'valueA' },
   timestamp: ts,
 });
-```
+```

package/dist/_virtual/_rolldown/runtime.cjs

@@ -5,6 +5,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
@@ -20,4 +21,5 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
+exports.__commonJSMin = __commonJSMin;
 exports.__toESM = __toESM;

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,24 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+export { __commonJSMin, __toESM };

package/dist/api-logs/api/LogAPI/LogAPI.cjs

@@ -14,11 +14,11 @@ var LogAPI = class LogAPI {
 			const proxyManager = new require_api_logs_manager_ProxyLogManager_ProxyLogManager.ProxyLogManager();
 			const safeManager = require_utils_createSafeProxy_createSafeProxy.createSafeProxy(proxyManager, NOOP_LOG_MANAGER, _opentelemetry_api.diag.createComponentLogger({ namespace: "LogAPI" }), INTERNAL_METHODS);
 			LogAPI._instance = Object.assign(safeManager, {
-				setGlobalLogManager(logManager) {
-					proxyManager.setDelegate(logManager);
-				},
 				getLogManager() {
 					return proxyManager;
+				},
+				setGlobalLogManager(logManager) {
+					proxyManager.setDelegate(logManager);
 				}
 			});
 		}

package/dist/api-logs/api/LogAPI/LogAPI.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"LogAPI.cjs","names":["NoOpLogManager","ProxyLogManager","createSafeProxy","diag"],"sources":["../../../../src/api-logs/api/LogAPI/LogAPI.ts"],"sourcesContent":["import { diag } from '@opentelemetry/api';\nimport { createSafeProxy } from '../../../utils';\nimport type { LogManager } from '../../manager';\nimport { NoOpLogManager, ProxyLogManager } from '../../manager';\n\n/**\n * Public interface for LogAPI including SDK-internal methods.\n */\nexport interface LogAPIInstance extends LogManager {\n  /** @internal SDK use only */\n  setGlobalLogManager(logManager: LogManager): void;\n  /** @internal SDK use only */\n  getLogManager(): LogManager;\n}\n\nconst NOOP_LOG_MANAGER = new NoOpLogManager();\nconst INTERNAL_METHODS = new Set(['setDelegate', 'getDelegate']);\n\nexport class LogAPI {\n  private static _instance?: LogAPIInstance;\n\n  public static getInstance(): LogAPIInstance {\n    if (!LogAPI._instance) {\n      const proxyManager = new ProxyLogManager();\n\n      const safeManager = createSafeProxy(\n        proxyManager,\n        NOOP_LOG_MANAGER,\n        diag.createComponentLogger({ namespace: 'LogAPI' }),\n        INTERNAL_METHODS,\n      );\n\n      LogAPI._instance = Object.assign(safeManager, {\n        setGlobalLogManager(logManager: LogManager): void {\n          proxyManager.setDelegate(logManager);\n        },\n        getLogManager(): LogManager {\n          return proxyManager;\n        },\n      }) as LogAPIInstance;\n    }\n\n    return LogAPI._instance;\n  }\n\n  public static resetInstance(): void {\n    LogAPI._instance = undefined;\n  }\n}\n"],"mappings":";;;;;;;AAeA,MAAM,mBAAmB,IAAIA,uDAAAA,gBAAgB;AAC7C,MAAM,mBAAmB,IAAI,IAAI,CAAC,eAAe,cAAc,CAAC;AAEhE,IAAa,SAAb,MAAa,OAAO;CAClB,OAAe;CAEf,OAAc,cAA8B;AAC1C,MAAI,CAAC,OAAO,WAAW;GACrB,MAAM,eAAe,IAAIC,yDAAAA,iBAAiB;GAE1C,MAAM,cAAcC,8CAAAA,gBAClB,cACA,kBACAC,mBAAAA,KAAK,sBAAsB,EAAE,WAAW,UAAU,CAAC,EACnD,iBACD;AAED,UAAO,YAAY,OAAO,OAAO,aAAa;IAC5C,oBAAoB,YAA8B;AAChD,kBAAa,YAAY,WAAW;;IAEtC,gBAA4B;AAC1B,YAAO;;IAEV,CAAC;;AAGJ,SAAO,OAAO;;CAGhB,OAAc,gBAAsB;AAClC,SAAO,YAAY,KAAA"}
+{"version":3,"file":"LogAPI.cjs","names":["NoOpLogManager","ProxyLogManager","createSafeProxy","diag"],"sources":["../../../../src/api-logs/api/LogAPI/LogAPI.ts"],"sourcesContent":["import { diag } from '@opentelemetry/api';\nimport { createSafeProxy } from '../../../utils/createSafeProxy/createSafeProxy';\nimport type { LogManager } from '../../manager/types';\nimport { NoOpLogManager } from '../../manager/NoOpLogManager/NoOpLogManager';\nimport { ProxyLogManager } from '../../manager/ProxyLogManager/ProxyLogManager';\n/**\n * Public interface for LogAPI including SDK-internal methods.\n */\nexport interface LogAPIInstance extends LogManager {\n  /** @internal SDK use only */\n  setGlobalLogManager(logManager: LogManager): void;\n  /** @internal SDK use only */\n  getLogManager(): LogManager;\n}\n\nconst NOOP_LOG_MANAGER = new NoOpLogManager();\nconst INTERNAL_METHODS = new Set(['setDelegate', 'getDelegate']);\n\nexport class LogAPI {\n  private static _instance?: LogAPIInstance;\n\n  public static getInstance(): LogAPIInstance {\n    if (!LogAPI._instance) {\n      const proxyManager = new ProxyLogManager();\n\n      const safeManager = createSafeProxy(\n        proxyManager,\n        NOOP_LOG_MANAGER,\n        diag.createComponentLogger({ namespace: 'LogAPI' }),\n        INTERNAL_METHODS,\n      );\n\n      LogAPI._instance = Object.assign(safeManager, {\n        getLogManager(): LogManager {\n          return proxyManager;\n        },\n        setGlobalLogManager(logManager: LogManager): void {\n          proxyManager.setDelegate(logManager);\n        },\n      }) as LogAPIInstance;\n    }\n\n    return LogAPI._instance;\n  }\n\n  public static resetInstance(): void {\n    LogAPI._instance = undefined;\n  }\n}\n"],"mappings":";;;;;;;AAeA,MAAM,mBAAmB,IAAIA,uDAAAA,gBAAgB;AAC7C,MAAM,mBAAmB,IAAI,IAAI,CAAC,eAAe,cAAc,CAAC;AAEhE,IAAa,SAAb,MAAa,OAAO;CAClB,OAAe;CAEf,OAAc,cAA8B;AAC1C,MAAI,CAAC,OAAO,WAAW;GACrB,MAAM,eAAe,IAAIC,yDAAAA,iBAAiB;GAE1C,MAAM,cAAcC,8CAAAA,gBAClB,cACA,kBACAC,mBAAAA,KAAK,sBAAsB,EAAE,WAAW,UAAU,CAAC,EACnD,iBACD;AAED,UAAO,YAAY,OAAO,OAAO,aAAa;IAC5C,gBAA4B;AAC1B,YAAO;;IAET,oBAAoB,YAA8B;AAChD,kBAAa,YAAY,WAAW;;IAEvC,CAAC;;AAGJ,SAAO,OAAO;;CAGhB,OAAc,gBAAsB;AAClC,SAAO,YAAY,KAAA"}