feat: add span processor

packages/opentelemetry-basic-tracer/src/SpanProcessor.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright 2019, OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Span } from '@opentelemetry/types';
+
+/**
+ * SpanProcessor is the interface Tracer SDK uses to allow synchronous hooks
+ * for when a {@link Span} is started or when a {@link Span} is ended.
+ */
+export interface SpanProcessor {
+  /**
+   * Called when a {@link Span} is started, if the `span.isRecordingEvents()`
+   * returns true.
+   * @param span the Span that just started.
+   */
+  onStart(span: Span): void;
+
+  /**
+   * Called when a {@link Span} is ended, if the `span.isRecordingEvents()`
+   * returns true.
+   * @param span the Span that just ended.
+   */
+  onEnd(span: Span): void;
+}

packages/opentelemetry-basic-tracer/src/index.ts

@@ -15,3 +15,4 @@
  */
 
 export * from './types';
+export * from './SpanProcessor';