@interopio/otel 0.0.180 → 0.0.182

package/dist/builder.d.ts

@@ -1,6 +1,6 @@
 import { Container } from "./container";
 import { IOInsights } from "../insights";
-export declare class Builder {
+export declare class Builder implements IOInsights.APIBuilder {
     logger: IOInsights.Logger;
     settings?: Partial<IOInsights.Settings>;
     metricsBuilder?: IOInsights.MetricsManagerBuilder;

package/dist/index.d.ts

@@ -142,9 +142,3 @@ declare enum SpanStatusCode {
     ERROR = 2
 }
 export { SpanStatusCode };
-export interface SpanStatus {
-    /** The status code of this message. */
-    code: SpanStatusCode;
-    /** A developer-facing error message. */
-    message?: string;
-}

package/insights.d.ts

@@ -38,7 +38,6 @@ import {
 } from "@opentelemetry/sdk-logs";
 import { type MetricReader, type PeriodicExportingMetricReaderOptions, type PushMetricExporter } from "@opentelemetry/sdk-metrics";
 import { type OTLPMetricExporterOptions } from "@opentelemetry/exporter-metrics-otlp-http";
-import { SpanStatus } from "./src";
 
 /**
  * @docname Insights
@@ -64,6 +63,63 @@ export namespace IOInsights {
     logs: LogsManager;
   }
 
+  /**
+   * Builder interface for constructing the IO.Insights API.
+   */
+  export interface APIBuilder {
+    /**
+     * Logger instance used by the builder and child managers.
+     */
+    logger: Logger;
+    
+    /**
+     * Settings configuration for the API.
+     */
+    settings?: Partial<Settings>;
+    
+    /**
+     * Metrics manager builder instance.
+     */
+    metricsBuilder?: MetricsManagerBuilder;
+    
+    /**
+     * Traces manager builder instance.
+     */
+    tracesBuilder?: TracesManagerBuilder;
+
+    /**
+     * Sets the logger to be used by the observability system.
+     * @param logger - The logger implementation to use
+     * @returns The builder instance for method chaining
+     */
+    withLogger(logger: Logger): this;
+
+    /**
+     * Sets the configuration settings for the observability system.
+     * @param settings - The settings to apply
+     * @returns The builder instance for method chaining
+     */
+    withSettings(settings: Partial<Settings>): this;
+
+    /**
+     * Initializes the metrics manager builder.
+     * @returns The metrics manager builder for further configuration
+     */
+    withMetrics(): MetricsManagerBuilder;
+
+    /**
+     * Initializes the traces manager builder.
+     * @returns The traces manager builder for further configuration
+     */
+    withTraces(): TracesManagerBuilder;
+
+    /**
+     * Builds and returns the configured API container.
+     * @returns The fully configured API container
+     */
+    build(): API;
+  }
+
   /**
    * Metrics API.
    */
@@ -1682,4 +1738,27 @@ export namespace IOInsights {
     metrics?: MetricsSettings;
     logs?: LogsSettings;
   }
+
+  export enum SpanStatusCode {
+    /**
+     * The default status.
+     */
+    UNSET = 0,
+    /**
+     * The operation has been validated by an Application developer or
+     * Operator to have completed successfully.
+     */
+    OK = 1,
+    /**
+     * The operation contains an error.
+     */
+    ERROR = 2
+  }
+
+  export interface SpanStatus {
+    /** The status code of this message. */
+    code: SpanStatusCode;
+    /** A developer-facing error message. */
+    message?: string;
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interopio/otel",
-  "version": "0.0.180",
+  "version": "0.0.182",
   "description": "io.Insights observability library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",