From cdd7ad020e165fe680703b6d3319b908b682fb7a Mon Sep 17 00:00:00 2001
From: Andrew Dolgov <fox@fakecake.org>
Date: Fri, 20 Oct 2023 17:12:29 +0300
Subject: jaeger-client -> opentelemetry

---
 .../api/Trace/SpanBuilderInterface.php             | 51 ++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 vendor/open-telemetry/api/Trace/SpanBuilderInterface.php

(limited to 'vendor/open-telemetry/api/Trace/SpanBuilderInterface.php')

diff --git a/vendor/open-telemetry/api/Trace/SpanBuilderInterface.php b/vendor/open-telemetry/api/Trace/SpanBuilderInterface.php
new file mode 100644
index 000000000..52070933a
--- /dev/null
+++ b/vendor/open-telemetry/api/Trace/SpanBuilderInterface.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenTelemetry\API\Trace;
+
+use OpenTelemetry\Context\ContextInterface;
+
+/**
+ * Obtained from a {@see TracerInterface} and used to construct a {@see SpanInterface}.
+ */
+interface SpanBuilderInterface
+{
+    /**
+     * Sets the parent `Context`.
+     *
+     * @param ContextInterface|false|null $context the parent context, null to use the
+     *        current context, false to set no parent
+     * @return SpanBuilderInterface this span builder
+     *
+     * @see https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/api.md#span-creation
+     */
+    public function setParent($context): SpanBuilderInterface;
+
+    public function addLink(SpanContextInterface $context, iterable $attributes = []): SpanBuilderInterface;
+    public function setAttribute(string $key, $value): SpanBuilderInterface;
+    public function setAttributes(iterable $attributes): SpanBuilderInterface;
+
+    /**
+     * Sets an explicit start timestamp for the newly created {@see SpanInterface}.
+     * The provided *$timestamp* is assumed to be in nanoseconds.
+     *
+     * Defaults to the timestamp when {@see SpanBuilderInterface::startSpan} was called if not explicitly set.
+     */
+    public function setStartTimestamp(int $timestampNanos): SpanBuilderInterface;
+
+    /**
+     * @psalm-param SpanKind::KIND_* $spanKind
+     */
+    public function setSpanKind(int $spanKind): SpanBuilderInterface;
+
+    /**
+     * Starts and returns a new {@see SpanInterface}.
+     *
+     * The user _MUST_ manually end the span by calling {@see SpanInterface::end}.
+     *
+     * This method does _NOT_ automatically install the span into the current context.
+     * The user is responsible for calling {@see SpanInterface::activate} when they wish to do so.
+     */
+    public function startSpan(): SpanInterface;
+}
-- 
cgit v1.2.3-54-g00ecf