@interopio/otel 0.0.181 → 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/insights.d.ts

@@ -63,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.
    */

package/package.json

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