react-native-nitro-tracing 0.6.0

package/src/types/SpanEvent.ts

@@ -0,0 +1,13 @@
+import type { SpanOutcome } from './SpanOutcome'
+import type { EventContext } from './EventContext'
+/** Completed span from Recording.readEvents. */
+export interface SpanEvent extends EventContext {
+  /** Unique native span identity. */
+  spanId: string
+  /** Parent identity; empty for root spans. */
+  parentSpanId: string
+  /** Monotonic elapsed time in milliseconds. */
+  durationMs: number
+  /** Terminal result. */
+  outcome: SpanOutcome
+}

package/src/types/SpanOptions.ts

@@ -0,0 +1,6 @@
+import type { TraceContext } from './TraceContext'
+/** Input to Recording.startSpan. */
+export interface SpanOptions extends TraceContext {
+  /** Parent from the same recording; omit for a root span. */
+  parentSpanId?: string
+}

package/src/types/SpanOutcome.ts

@@ -0,0 +1,2 @@
+/** Terminal result of a {@link TraceSpan}. */
+export type SpanOutcome = 'success' | 'error' | 'cancelled' | 'interrupted'

package/src/types/TraceAttribute.ts

@@ -0,0 +1,7 @@
+/** Attributes retained in a recording. Values should be sanitized at the producer. */
+export interface TraceAttribute {
+  /** Attribute name. */
+  key: string
+  /** Sanitized scalar representation. */
+  value: string
+}

package/src/types/TraceAttributes.ts

@@ -0,0 +1,4 @@
+import type { TraceAttribute } from './TraceAttribute'
+import type { TraceContext } from './TraceContext'
+/** Attributes accepted by TraceContext. */
+export type TraceAttributes = TraceAttribute[]

package/src/types/TraceContext.ts

@@ -0,0 +1,10 @@
+import type { TraceAttributes } from './TraceAttributes'
+/** Context shared by marks and spans in a Recording. */
+export interface TraceContext {
+  /** Stable operation name, capped to 256 bytes. */
+  name: string
+  /** Application operation identity; empty for uncorrelated events. */
+  correlationId: string
+  /** Bounded scalar attributes, at most 32 entries. */
+  attributes: TraceAttributes
+}

package/src/types/TracePage.ts

@@ -0,0 +1,18 @@
+import type { SpanEvent } from './SpanEvent'
+import type { MarkEvent } from './MarkEvent'
+import type { MetricEvent } from './MetricEvent'
+/** Immutable event page. Arrays share a global sequence; merge by sequence if needed. */
+export interface TracePage {
+  /** Completed durations. */
+  spans: SpanEvent[]
+  /** Point events. */
+  marks: MarkEvent[]
+  /** Numeric samples. */
+  metrics: MetricEvent[]
+  /** Last returned sequence; pass to the next query. */
+  nextSequence: number
+  /** First retained sequence, or next assignable sequence when empty. */
+  earliestSequence: number
+  /** Number dropped since creation. */
+  droppedEvents: number
+}

package/src/types.ts

@@ -0,0 +1,17 @@
+export type { TraceAttribute } from './types/TraceAttribute'
+export type { TraceAttributes } from './types/TraceAttributes'
+export type { SpanOutcome } from './types/SpanOutcome'
+export type { RecordingOptions } from './types/RecordingOptions'
+export type { TraceContext } from './types/TraceContext'
+export type { SpanOptions } from './types/SpanOptions'
+export type { MetricOptions } from './types/MetricOptions'
+export type { EventContext } from './types/EventContext'
+export type { SpanEvent } from './types/SpanEvent'
+export type { MarkEvent } from './types/MarkEvent'
+export type { MetricEvent } from './types/MetricEvent'
+export type { ReadOptions } from './types/ReadOptions'
+export type { RecordingStats } from './types/RecordingStats'
+export type { TracePage } from './types/TracePage'
+export type { CompletedSpanOptions } from './types/CompletedSpanOptions'
+export type { MarkOptions } from './types/MarkOptions'
+export type { NativeSamplingOptions } from './types/NativeSamplingOptions'