Move SpanContext isValid to the API

packages/opentelemetry-api/src/index.ts

@@ -42,6 +42,7 @@ export * from './trace/NoopTracer';
 export * from './trace/NoopTracerProvider';
 export * from './trace/Sampler';
 export * from './trace/SamplingResult';
+export * from './trace/spancontext-utils';
 export * from './trace/span_context';
 export * from './trace/span_kind';
 export * from './trace/span';

packages/opentelemetry-api/src/trace/NoopSpan.ts

@@ -20,15 +20,7 @@ import { Attributes } from './attributes';
 import { Span } from './span';
 import { SpanContext } from './span_context';
 import { Status } from './status';
-import { TraceFlags } from './trace_flags';
-
-export const INVALID_TRACE_ID = '0';
-export const INVALID_SPAN_ID = '0';
-const INVALID_SPAN_CONTEXT: SpanContext = {
-  traceId: INVALID_TRACE_ID,
-  spanId: INVALID_SPAN_ID,
-  traceFlags: TraceFlags.NONE,
-};
+import { INVALID_SPAN_CONTEXT } from './spancontext-utils';
 
 /**
  * The NoopSpan is the default {@link Span} that is used when no Span

packages/opentelemetry-core/src/trace/spancontext-utils.ts → packages/opentelemetry-api/src/trace/spancontext-utils.ts

@@ -13,24 +13,33 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { SpanContext } from './span_context';
+import { TraceFlags } from './trace_flags';
 
-import { SpanContext, TraceFlags } from '@opentelemetry/api';
-
-export const INVALID_SPANID = '0';
-export const INVALID_TRACEID = '0';
+const VALID_TRACEID_REGEX = /^([0-9a-f]{32})$/i;
+const VALID_SPANID_REGEX = /^[0-9a-f]{16}$/i;
+export const INVALID_SPANID = '0000000000000000';
+export const INVALID_TRACEID = '00000000000000000000000000000000';
 export const INVALID_SPAN_CONTEXT: SpanContext = {
   traceId: INVALID_TRACEID,
   spanId: INVALID_SPANID,
   traceFlags: TraceFlags.NONE,
 };
 
+export function isValidTraceId(traceId: string): boolean {
+  return VALID_TRACEID_REGEX.test(traceId) && traceId !== INVALID_TRACEID;
+}
+
+export function isValidSpanId(spanId: string): boolean {
+  return VALID_SPANID_REGEX.test(spanId) && spanId !== INVALID_SPANID;
+}
+
 /**
  * Returns true if this {@link SpanContext} is valid.
  * @return true if this {@link SpanContext} is valid.
  */
-export function isValid(spanContext: SpanContext): boolean {
+export function isSpanContextValid(spanContext: SpanContext): boolean {
   return (
-    spanContext.traceId !== INVALID_TRACEID &&
-    spanContext.spanId !== INVALID_SPANID
+    isValidTraceId(spanContext.traceId) && isValidSpanId(spanContext.spanId)
   );
 }

packages/opentelemetry-api/test/noop-implementations/noop-span.test.ts

@@ -17,8 +17,8 @@
 import * as assert from 'assert';
 import {
   CanonicalCode,
-  INVALID_SPAN_ID,
-  INVALID_TRACE_ID,
+  INVALID_SPANID,
+  INVALID_TRACEID,
   NoopSpan,
   TraceFlags,
 } from '../../src';
@@ -45,8 +45,8 @@ describe('NoopSpan', () => {
 
     assert.ok(!span.isRecording());
     assert.deepStrictEqual(span.context(), {
-      traceId: INVALID_TRACE_ID,
-      spanId: INVALID_SPAN_ID,
+      traceId: INVALID_TRACEID,
+      spanId: INVALID_SPANID,
       traceFlags: TraceFlags.NONE,
     });
     span.end();

packages/opentelemetry-core/test/trace/spancontext-utils.test.ts → packages/opentelemetry-api/test/trace/spancontext-utils.test.ts

@@ -16,7 +16,7 @@
 
 import * as assert from 'assert';
 import * as context from '../../src/trace/spancontext-utils';
-import { TraceFlags } from '@opentelemetry/api';
+import { TraceFlags } from '../../src';
 
 describe('spancontext-utils', () => {
   it('should return true for valid spancontext', () => {
@@ -25,7 +25,7 @@ describe('spancontext-utils', () => {
       spanId: '6e0c63257de34c92',
       traceFlags: TraceFlags.NONE,
     };
-    assert.ok(context.isValid(spanContext));
+    assert.ok(context.isSpanContextValid(spanContext));
   });
 
   it('should return false when traceId is invalid', () => {
@@ -34,7 +34,7 @@ describe('spancontext-utils', () => {
       spanId: '6e0c63257de34c92',
       traceFlags: TraceFlags.NONE,
     };
-    assert.ok(!context.isValid(spanContext));
+    assert.ok(!context.isSpanContextValid(spanContext));
   });
 
   it('should return false when spanId is invalid', () => {
@@ -43,7 +43,7 @@ describe('spancontext-utils', () => {
       spanId: context.INVALID_SPANID,
       traceFlags: TraceFlags.NONE,
     };
-    assert.ok(!context.isValid(spanContext));
+    assert.ok(!context.isSpanContextValid(spanContext));
   });
 
   it('should return false when traceId & spanId is invalid', () => {
@@ -52,6 +52,6 @@ describe('spancontext-utils', () => {
       spanId: context.INVALID_SPANID,
       traceFlags: TraceFlags.NONE,
     };
-    assert.ok(!context.isValid(spanContext));
+    assert.ok(!context.isSpanContextValid(spanContext));
   });
 });

packages/opentelemetry-core/src/context/propagation/B3Propagator.ts

@@ -17,6 +17,8 @@
 import {
   Context,
   GetterFunction,
+  isValidSpanId,
+  isValidTraceId,
   TextMapPropagator,
   SetterFunction,
   TraceFlags,
@@ -34,20 +36,9 @@ export const PARENT_SPAN_ID_KEY = Context.createKey(
 export const DEBUG_FLAG_KEY = Context.createKey(
   'OpenTelemetry Context Key B3 Debug Flag'
 );
-const VALID_TRACEID_REGEX = /^([0-9a-f]{16}){1,2}$/i;
-const VALID_SPANID_REGEX = /^[0-9a-f]{16}$/i;
-const INVALID_ID_REGEX = /^0+$/i;
 const VALID_SAMPLED_VALUES = new Set([true, 'true', 'True', '1', 1]);
 const VALID_UNSAMPLED_VALUES = new Set([false, 'false', 'False', '0', 0]);
 
-function isValidTraceId(traceId: string): boolean {
-  return VALID_TRACEID_REGEX.test(traceId) && !INVALID_ID_REGEX.test(traceId);
-}
-
-function isValidSpanId(spanId: string): boolean {
-  return VALID_SPANID_REGEX.test(spanId) && !INVALID_ID_REGEX.test(spanId);
-}
-
 function isValidParentSpanID(spanId: string | undefined): boolean {
   return spanId === undefined || isValidSpanId(spanId);
 }

packages/opentelemetry-core/src/index.ts

@@ -33,7 +33,6 @@ export * from './trace/sampler/AlwaysOffSampler';
 export * from './trace/sampler/AlwaysOnSampler';
 export * from './trace/sampler/ParentOrElseSampler';
 export * from './trace/sampler/ProbabilitySampler';
-export * from './trace/spancontext-utils';
 export * from './trace/TraceState';
 export * from './trace/IdGenerator';
 export * from './utils/url';

packages/opentelemetry-core/src/trace/NoRecordingSpan.ts

@@ -14,8 +14,11 @@
  * limitations under the License.
  */
 
-import { SpanContext, NoopSpan } from '@opentelemetry/api';
-import { INVALID_SPAN_CONTEXT } from '../trace/spancontext-utils';
+import {
+  SpanContext,
+  NoopSpan,
+  INVALID_SPAN_CONTEXT,
+} from '@opentelemetry/api';
 
 /**
  * The NoRecordingSpan extends the {@link NoopSpan}, making all operations no-op

packages/opentelemetry-shim-opentracing/test/Shim.test.ts

@@ -19,13 +19,12 @@ import * as opentracing from 'opentracing';
 import { BasicTracerProvider, Span } from '@opentelemetry/tracing';
 import { TracerShim, SpanShim, SpanContextShim } from '../src/shim';
 import {
-  INVALID_SPAN_CONTEXT,
   timeInputToHrTime,
   HttpTraceContext,
   CompositePropagator,
   HttpCorrelationContext,
 } from '@opentelemetry/core';
-import { propagation } from '@opentelemetry/api';
+import { INVALID_SPAN_CONTEXT, propagation } from '@opentelemetry/api';
 import { performance } from 'perf_hooks';
 
 describe('OpenTracing Shim', () => {

packages/opentelemetry-tracing/src/Tracer.ts

@@ -20,7 +20,6 @@ import {
   getActiveSpan,
   getParentSpanContext,
   InstrumentationLibrary,
-  isValid,
   NoRecordingSpan,
   IdGenerator,
   RandomIdGenerator,
@@ -79,7 +78,7 @@ export class Tracer implements api.Tracer {
     const spanId = this._idGenerator.generateSpanId();
     let traceId;
     let traceState;
-    if (!parentContext || !isValid(parentContext)) {
+    if (!parentContext || !api.isSpanContextValid(parentContext)) {
       // New root span.
       traceId = this._idGenerator.generateTraceId();
     } else {