feat(sdk): expose span.cancel method

Customer code can already call span.end() (for example, after calling
span.disableAutoEnd() earlier), but so far could not cancel the span in
progress. We should expose for consistency and completeness sake.

packages/core/src/tracing/cls.js

@@ -79,6 +79,7 @@ function init(config, _processIdentityProvider) {
  * @property {Function} [freezePathTemplate]
  * @property {Function} [disableAutoEnd]
  * @property {Function} [transmitManual]
+ * @property {Function} [cancel]
  */
 
 class InstanaSpan {

packages/core/src/tracing/spanHandle.js

@@ -165,7 +165,7 @@ SpanHandle.prototype.disableAutoEnd = function disableAutoEnd() {
 };
 
 /**
- * Finishes as span that has been switched to manual-end-mode before.
+ * Finishes a span that has been switched to manual-end-mode before.
  * @param {boolean | number} errorCount
  */
 SpanHandle.prototype.end = function end(errorCount) {
@@ -181,6 +181,13 @@ SpanHandle.prototype.end = function end(errorCount) {
   this.span.transmitManual();
 };
 
+/**
+ * Cancels as span that has been switched to manual-end-mode before.
+ */
+SpanHandle.prototype.cancel = function cancel() {
+  this.span.cancel();
+};
+
 /**
  * TODO: make it as a class
  * Provides noop operation for the SpanHandle API when automatic tracing is not enabled or no span is currently active.
@@ -249,6 +256,10 @@ NoopSpanHandle.prototype.end = function end() {
   // provide dummy operation when automatic tracing is not enabled
 };
 
+NoopSpanHandle.prototype.cancel = function cancel() {
+  // provide dummy operation when automatic tracing is not enabled
+};
+
 /**
  * @param {import ('./cls')} cls
  * @returns {SpanHandle | NoopSpanHandle}