@glasstrace/sdk 1.7.0 → 1.8.0

package/dist/{capture-error-BmQz7xF6.d.cts → capture-error-C95zvSvF.d.cts}

@@ -190,7 +190,40 @@ declare class GlasstraceExporter implements SpanExporter {
     private pendingBatches;
     private pendingSpanCount;
     private overflowLogged;
+    /**
+     * Lazily-bound reference to the export-path circuit breaker
+     * (DISC-1568 / Wave 15C). Resolved on first export so this
+     * constructor stays side-effect-free. The breaker is a module-
+     * singleton — every `GlasstraceExporter` instance shares the same
+     * one so a rotation event observed in `init-client.ts` reaches
+     * every active exporter.
+     */
+    private circuitBreaker;
     constructor(options: GlasstraceExporterOptions);
+    /**
+     * Returns the export-path circuit breaker, lazily wiring it on
+     * first call. The breaker is a module-singleton so all exporter
+     * instances share state — a credential rotation observed once
+     * resets the breaker for every active exporter, and a single
+     * outage at the OTLP endpoint trips a single breaker rather than
+     * one per exporter copy.
+     *
+     * The wiring binds:
+     * - the lifecycle event sink to the SDK's lifecycle bus
+     *   (`emitLifecycleEvent`) so the `otel:circuit_*` events surface
+     *   to runtime-state, the CLI bridge, and any user-installed
+     *   subscribers.
+     * - the dropped-span counter to {@link recordSpansDropped} so OPEN-
+     *   state drops show up in the existing health surface.
+     * - the FSM hooks to {@link pushDegradationSource} /
+     *   {@link clearDegradationSource} keyed on `"export-circuit"`,
+     *   which routes the OPEN/CLOSED transitions through the
+     *   centralised `recomputeCoreFromDegradationSources()` helper.
+     *   That helper guards `ACTIVE ↔ ACTIVE_DEGRADED` so a circuit
+     *   recovery never clobbers an unrelated `OtelState.COEXISTENCE_FAILED`
+     *   degradation source.
+     */
+    private getCircuitBreaker;
     export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
     /**
      * Called when the API key transitions from "pending" to a resolved value.
@@ -234,6 +267,11 @@ declare class GlasstraceExporter implements SpanExporter {
      * Flushes all buffered spans through the delegate exporter.
      * Enriches spans at flush time (not buffer time) so that session IDs
      * are computed with the resolved API key instead of the "pending" sentinel.
+     *
+     * Honors the circuit breaker symmetrically with {@link export}: if the
+     * breaker is OPEN at flush time, every buffered batch is dropped via
+     * `recordSpansDropped` and its callback completed with `{ code: 0 }`,
+     * preserving the bounded-memory contract during outages.
      */
     private flushPending;
 }

package/dist/{capture-error-CTgSYxek.d.ts → capture-error-Dzz7_-v4.d.ts}

@@ -190,7 +190,40 @@ declare class GlasstraceExporter implements SpanExporter {
     private pendingBatches;
     private pendingSpanCount;
     private overflowLogged;
+    /**
+     * Lazily-bound reference to the export-path circuit breaker
+     * (DISC-1568 / Wave 15C). Resolved on first export so this
+     * constructor stays side-effect-free. The breaker is a module-
+     * singleton — every `GlasstraceExporter` instance shares the same
+     * one so a rotation event observed in `init-client.ts` reaches
+     * every active exporter.
+     */
+    private circuitBreaker;
     constructor(options: GlasstraceExporterOptions);
+    /**
+     * Returns the export-path circuit breaker, lazily wiring it on
+     * first call. The breaker is a module-singleton so all exporter
+     * instances share state — a credential rotation observed once
+     * resets the breaker for every active exporter, and a single
+     * outage at the OTLP endpoint trips a single breaker rather than
+     * one per exporter copy.
+     *
+     * The wiring binds:
+     * - the lifecycle event sink to the SDK's lifecycle bus
+     *   (`emitLifecycleEvent`) so the `otel:circuit_*` events surface
+     *   to runtime-state, the CLI bridge, and any user-installed
+     *   subscribers.
+     * - the dropped-span counter to {@link recordSpansDropped} so OPEN-
+     *   state drops show up in the existing health surface.
+     * - the FSM hooks to {@link pushDegradationSource} /
+     *   {@link clearDegradationSource} keyed on `"export-circuit"`,
+     *   which routes the OPEN/CLOSED transitions through the
+     *   centralised `recomputeCoreFromDegradationSources()` helper.
+     *   That helper guards `ACTIVE ↔ ACTIVE_DEGRADED` so a circuit
+     *   recovery never clobbers an unrelated `OtelState.COEXISTENCE_FAILED`
+     *   degradation source.
+     */
+    private getCircuitBreaker;
     export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
     /**
      * Called when the API key transitions from "pending" to a resolved value.
@@ -234,6 +267,11 @@ declare class GlasstraceExporter implements SpanExporter {
      * Flushes all buffered spans through the delegate exporter.
      * Enriches spans at flush time (not buffer time) so that session IDs
      * are computed with the resolved API key instead of the "pending" sentinel.
+     *
+     * Honors the circuit breaker symmetrically with {@link export}: if the
+     * breaker is OPEN at flush time, every buffered batch is dropped via
+     * `recordSpansDropped` and its callback completed with `{ code: 0 }`,
+     * preserving the bounded-memory contract during outages.
      */
     private flushPending;
 }