@plyaz/core 1.2.0 → 1.2.1

package/dist/base/observability/BaseAdapter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Base Observability Adapter
+ *
+ * Abstract base class for all observability adapters.
+ * Provides common functionality and enforces the adapter interface.
+ *
+ * @module base/observability
+ */
+import { PackageLogger } from '@plyaz/logger';
+import type { ObservabilityAdapter, ObservabilityAdapterConfig, ObservabilityProvider, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent } from '@plyaz/types/observability';
+/**
+ * Abstract base class for observability adapters.
+ *
+ * Provides common functionality:
+ * - Initialization lifecycle
+ * - Default tag management
+ * - Error handling
+ * - Logging
+ *
+ * Subclasses must implement provider-specific methods.
+ */
+export declare abstract class BaseAdapter implements ObservabilityAdapter {
+    abstract readonly provider: ObservabilityProvider;
+    abstract readonly name: string;
+    protected _isInitialized: boolean;
+    protected _config: ObservabilityAdapterConfig | null;
+    protected readonly logger: PackageLogger;
+    constructor();
+    get isInitialized(): boolean;
+    get config(): ObservabilityAdapterConfig | null;
+    initialize(config: ObservabilityAdapterConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    protected abstract doInitialize(config: ObservabilityAdapterConfig): Promise<void>;
+    protected abstract doShutdown(): Promise<void>;
+    protected abstract doHealthCheck(): Promise<boolean>;
+    recordMetric(metric: Metric): Promise<void>;
+    incrementCounter(name: string, value?: number, tags?: Record<string, string>): Promise<void>;
+    setGauge(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    recordHistogram(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    protected abstract doRecordMetric(metric: Metric): Promise<void>;
+    startSpan(options: SpanOptions): Span;
+    getActiveSpan(): Span | null;
+    withSpan<T>(options: SpanOptions, fn: (span: Span) => Promise<T>): Promise<T>;
+    protected abstract doStartSpan(options: SpanOptions): Span;
+    protected abstract doGetActiveSpan(): Span | null;
+    log(entry: LogEntry): Promise<void>;
+    protected abstract doLog(entry: LogEntry): Promise<void>;
+    sendEvent(event: ObservabilityEvent): Promise<void>;
+    protected abstract doSendEvent(event: ObservabilityEvent): Promise<void>;
+    flush(): Promise<void>;
+    protected abstract doFlush(): Promise<void>;
+    /**
+     * Apply default tags to a metric
+     */
+    protected applyDefaultTags(metric: Metric): Metric;
+    /**
+     * Create a no-op span (for disabled/sampled-out traces)
+     */
+    protected createNoopSpan(_options: SpanOptions): Span;
+}
+/**
+ * No-op adapter that does nothing.
+ * Use when observability is disabled.
+ */
+export declare class NoopAdapter extends BaseAdapter {
+    readonly provider: "noop";
+    readonly name = "NoopAdapter";
+    protected doInitialize(): Promise<void>;
+    protected doShutdown(): Promise<void>;
+    protected doHealthCheck(): Promise<boolean>;
+    protected doRecordMetric(): Promise<void>;
+    protected doStartSpan(options: SpanOptions): Span;
+    protected doGetActiveSpan(): Span | null;
+    protected doLog(): Promise<void>;
+    protected doSendEvent(): Promise<void>;
+    protected doFlush(): Promise<void>;
+}
+//# sourceMappingURL=BaseAdapter.d.ts.map

package/dist/base/observability/BaseAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAdapter.d.ts","sourceRoot":"","sources":["../../../src/base/observability/BaseAdapter.ts"],"names":[],"mappings":"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"}

package/dist/base/observability/CompositeAdapter.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Composite Adapter
+ *
+ * Supports multiple observability providers running in parallel or priority (fallback) modes.
+ *
+ * - **Parallel mode**: Sends data to all adapters simultaneously
+ * - **Priority mode**: Tries first adapter, falls back to next on failure
+ *
+ * @module base/observability
+ */
+import type { ObservabilityAdapter, ObservabilityAdapterConfig, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent } from '@plyaz/types/observability';
+/**
+ * Composite adapter that delegates to multiple child adapters.
+ *
+ * @example Parallel mode (send to all - e.g., Datadog + Console)
+ * ```typescript
+ * const composite = new CompositeAdapter();
+ * await composite.initialize({
+ *   mode: 'parallel',
+ *   adapters: [datadogAdapter, loggerAdapter],
+ *   failOnAnyError: false,
+ * });
+ * ```
+ *
+ * @example Priority mode (fallback chain)
+ * ```typescript
+ * const composite = new CompositeAdapter();
+ * await composite.initialize({
+ *   mode: 'priority',
+ *   adapters: [datadogAdapter, grafanaAdapter, loggerAdapter],
+ *   adapterTimeout: 5000,
+ * });
+ * ```
+ */
+export declare class CompositeAdapter implements ObservabilityAdapter {
+    readonly provider: "custom";
+    readonly name = "CompositeAdapter";
+    private _isInitialized;
+    private _config;
+    private adapters;
+    private mode;
+    private adapterTimeout;
+    private failOnAnyError;
+    private fallbackOnErrors;
+    private readonly logger;
+    constructor();
+    get isInitialized(): boolean;
+    initialize(config: ObservabilityAdapterConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    recordMetric(metric: Metric): Promise<void>;
+    incrementCounter(name: string, value?: number, tags?: Record<string, string>): Promise<void>;
+    setGauge(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    recordHistogram(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    startSpan(options: SpanOptions): Span;
+    getActiveSpan(): Span | null;
+    withSpan<T>(options: SpanOptions, fn: (span: Span) => Promise<T>): Promise<T>;
+    log(entry: LogEntry): Promise<void>;
+    sendEvent(event: ObservabilityEvent): Promise<void>;
+    flush(): Promise<void>;
+    private executeOnAdapters;
+    private executeParallel;
+    private executePriority;
+    private withTimeout;
+    /**
+     * Check if we should fallback on this error type
+     */
+    private shouldFallbackOnError;
+    private createCompositeSpan;
+    private createNoopSpan;
+}
+//# sourceMappingURL=CompositeAdapter.d.ts.map

package/dist/base/observability/CompositeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeAdapter.d.ts","sourceRoot":"","sources":["../../../src/base/observability/CompositeAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,MAAM,EACN,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAInB,MAAM,4BAA4B,CAAC;AAUpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,gBAAiB,YAAW,oBAAoB;IAC3D,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;IACtC,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;;IASvC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAIK,UAAU,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C7D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAazB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB7B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAU,EACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAMV,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAInF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhG,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA2BrC,aAAa,IAAI,IAAI,GAAG,IAAI;IAUtB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB7E,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,iBAAiB;YAoBjB,eAAe;YAyBf,eAAe;YAgCf,WAAW;IAgBzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/base/observability/DatadogAdapter.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Datadog Adapter
+ *
+ * Adapter for sending metrics, traces, and logs to Datadog.
+ *
+ * Automatically uses:
+ * 1. **SDK** (dd-trace, hot-shots) when available
+ * 2. **API Client** (from @plyaz/api) as fallback
+ * 3. **Logger** for local debugging when neither is available
+ *
+ * @module base/observability
+ */
+import type { ObservabilityAdapterConfig, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent, DatadogAdapterConfig } from '@plyaz/types/observability';
+import { BaseAdapter } from './BaseAdapter';
+/**
+ * Interface for Datadog API client.
+ * Implemented in @plyaz/api package with proper endpoint definitions.
+ */
+export interface DatadogApiClient {
+    submitMetrics(metrics: DatadogMetricPayload[]): Promise<void>;
+    submitLogs(logs: DatadogLogPayload[]): Promise<void>;
+    submitEvent(event: DatadogEventPayload): Promise<void>;
+    isHealthy?(): Promise<boolean>;
+}
+export interface DatadogMetricPayload {
+    metric: string;
+    type: 'count' | 'gauge' | 'rate';
+    points: Array<[number, number]>;
+    tags?: string[];
+}
+export interface DatadogLogPayload {
+    ddsource?: string;
+    ddtags?: string;
+    service?: string;
+    message: string;
+    status: string;
+    [key: string]: unknown;
+}
+export interface DatadogEventPayload {
+    title: string;
+    text: string;
+    tags?: string[];
+    date_happened?: number;
+    priority?: 'normal' | 'low';
+    alert_type?: 'error' | 'warning' | 'info' | 'success';
+}
+/**
+ * Extended Datadog adapter configuration
+ */
+export interface DatadogAdapterConfigExtended extends DatadogAdapterConfig {
+    /**
+     * Datadog API client instance (from @plyaz/api).
+     * Used as fallback when SDK packages are not available.
+     */
+    apiClient?: DatadogApiClient;
+    /**
+     * DogStatsD host for metrics (when using SDK)
+     * @default 'localhost'
+     */
+    statsdHost?: string;
+    /**
+     * DogStatsD port for metrics (when using SDK)
+     * @default 8125
+     */
+    statsdPort?: number;
+}
+/**
+ * Datadog adapter for metrics, tracing, and logging.
+ *
+ * Automatically detects available integrations:
+ * - Uses dd-trace/hot-shots SDK when installed
+ * - Falls back to API client when SDK not available
+ * - Uses logger for debugging when neither is available
+ *
+ * @example Basic usage
+ * ```typescript
+ * const datadog = new DatadogAdapter();
+ * await datadog.initialize({
+ *   apiKey: process.env.DD_API_KEY,
+ *   site: 'datadoghq.com',
+ *   serviceName: 'my-service',
+ *   environment: 'production',
+ * });
+ * ```
+ *
+ * @example With API client fallback
+ * ```typescript
+ * import { createDatadogClient } from '@plyaz/api/datadog';
+ *
+ * const datadog = new DatadogAdapter();
+ * await datadog.initialize({
+ *   apiKey: process.env.DD_API_KEY,
+ *   apiClient: createDatadogClient({ ... }),
+ *   serviceName: 'my-service',
+ * });
+ * ```
+ */
+export declare class DatadogAdapter extends BaseAdapter {
+    readonly provider: "datadog";
+    readonly name = "DatadogAdapter";
+    private datadogConfig;
+    private apiClient?;
+    private metricsClient;
+    private tracer;
+    protected doInitialize(config: ObservabilityAdapterConfig): Promise<void>;
+    private initializeSdk;
+    protected doShutdown(): Promise<void>;
+    protected doHealthCheck(): Promise<boolean>;
+    protected doRecordMetric(metric: Metric): Promise<void>;
+    protected doStartSpan(options: SpanOptions): Span;
+    private createStubSpan;
+    protected doGetActiveSpan(): Span | null;
+    protected doLog(entry: LogEntry): Promise<void>;
+    protected doSendEvent(event: ObservabilityEvent): Promise<void>;
+    protected doFlush(): Promise<void>;
+}
+//# sourceMappingURL=DatadogAdapter.d.ts.map

package/dist/base/observability/DatadogAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatadogAdapter.d.ts","sourceRoot":"","sources":["../../../src/base/observability/DatadogAdapter.ts"],"names":[],"mappings":"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"}

package/dist/base/observability/LoggerAdapter.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Logger Adapter
+ *
+ * Uses @plyaz/logger for observability output.
+ * Can be used standalone OR alongside other adapters (Datadog, Grafana)
+ * to always have console/file logging regardless of external providers.
+ *
+ * @example Standalone usage
+ * ```typescript
+ * const logger = new LoggerAdapter();
+ * await logger.initialize({ serviceName: 'my-service' });
+ * ```
+ *
+ * @example As console fallback with Datadog
+ * ```typescript
+ * const observability = new ObservabilityService({
+ *   mode: 'parallel',
+ *   adapters: [datadogAdapter, loggerAdapter], // Both receive all events
+ * });
+ * ```
+ *
+ * @module base/observability
+ */
+import type { ObservabilityAdapterConfig, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent } from '@plyaz/types/observability';
+import { BaseAdapter } from './BaseAdapter';
+/**
+ * Logger adapter that uses @plyaz/logger for output.
+ *
+ * This adapter integrates observability with the existing logging infrastructure,
+ * providing structured logging for metrics, spans, and events through PackageLogger.
+ *
+ * Use this adapter:
+ * - As standalone for development/debugging
+ * - Alongside Datadog/Grafana to always have local console output
+ * - As a fallback in priority mode when external providers fail
+ */
+export declare class LoggerAdapter extends BaseAdapter {
+    readonly provider: "console";
+    readonly name = "LoggerAdapter";
+    private observabilityLogger;
+    private logMetrics;
+    private logSpans;
+    private logEvents;
+    protected doInitialize(config: ObservabilityAdapterConfig): Promise<void>;
+    protected doShutdown(): Promise<void>;
+    protected doHealthCheck(): Promise<boolean>;
+    protected doRecordMetric(metric: Metric): Promise<void>;
+    protected doStartSpan(options: SpanOptions): Span;
+    protected doGetActiveSpan(): Span | null;
+    protected doLog(entry: LogEntry): Promise<void>;
+    protected doSendEvent(event: ObservabilityEvent): Promise<void>;
+    protected doFlush(): Promise<void>;
+}
+//# sourceMappingURL=LoggerAdapter.d.ts.map

package/dist/base/observability/LoggerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerAdapter.d.ts","sourceRoot":"","sources":["../../../src/base/observability/LoggerAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAC1B,MAAM,EACN,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAMnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAU;IACvC,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAQ;cAET,YAAY,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;cAiB/D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAI3B,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;cAIjC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA6EjD,SAAS,CAAC,eAAe,IAAI,IAAI,GAAG,IAAI;cAIxB,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;cA4BrC,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;cAUrD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/dist/base/observability/ObservabilityService.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Observability Service
+ *
+ * Injectable service for observability (metrics, tracing, logging).
+ * Works like CacheManager, DatabaseService, and ApiClient - can be injected into domain services.
+ *
+ * Adapters are initialized separately with their own configs.
+ * This service only orchestrates - it doesn't know about adapter-specific configs.
+ *
+ * @module base/observability
+ */
+import type { ObservabilityAdapter, ObservabilityAdapterConfig, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent, OperationContext, MonitoringOperationResult, ObservabilityServiceConfig, ObservabilityServiceInterface } from '@plyaz/types/observability';
+/**
+ * ObservabilityService - Main observability service that implements ObservabilityAdapter.
+ *
+ * This service orchestrates multiple adapters and can be injected into domain services.
+ * Logger adapter is always included by default for console output.
+ *
+ * ```typescript
+ * // 1. Initialize adapters separately
+ * const datadogAdapter = new DatadogAdapter();
+ * await datadogAdapter.initialize({ apiKey: '...', serviceName: 'my-service' });
+ *
+ * // 2. Create service - logger is auto-added by default
+ * const observability = new ObservabilityService();
+ * await observability.initialize({
+ *   mode: 'parallel',
+ *   adapters: [datadogAdapter], // Logger added automatically
+ *   serviceName: 'my-service',
+ * });
+ *
+ * // 3. Use in domain services (implements ObservabilityAdapter)
+ * await observability.incrementCounter('api.requests', 1);
+ * ```
+ */
+export declare class ObservabilityService implements ObservabilityAdapter, ObservabilityServiceInterface {
+    readonly provider: "custom";
+    readonly name = "ObservabilityService";
+    private _isInitialized;
+    private _config;
+    private readonly logger;
+    private readonly adapterEntries;
+    private mode;
+    private readonly noopAdapter;
+    private loggerAdapter;
+    constructor();
+    get isInitialized(): boolean;
+    /**
+     * Check if service has at least one working adapter
+     */
+    get isReady(): boolean;
+    /**
+     * Get all adapters (for compatibility)
+     */
+    private get adapters();
+    /**
+     * Get initialized adapter entries
+     */
+    private get initializedEntries();
+    /**
+     * Get primary (non-failover) initialized adapters
+     */
+    private get primaryEntries();
+    /**
+     * Get failover initialized adapters
+     */
+    private get failoverEntries();
+    /**
+     * Check if input is an adapter with priority config
+     */
+    private isAdapterWithPriority;
+    /**
+     * Normalize adapter input to adapter with priority and failover config
+     */
+    private normalizeAdapter;
+    /**
+     * Initialize the observability service.
+     * Logger adapter is always added by default unless explicitly disabled.
+     * Adapters are sorted by priority (higher = first), with failover adapters after primary.
+     */
+    initialize(config: ObservabilityAdapterConfig & ObservabilityServiceConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    flush(): Promise<void>;
+    private get config();
+    private executeOnAdapters;
+    private executeSingle;
+    /**
+     * Execute on primary adapters in parallel.
+     * If all primary adapters fail, execute on failover adapters.
+     */
+    private executeParallelWithFailover;
+    private executeParallel;
+    /**
+     * Execute on primary adapters in priority order.
+     * If all primary adapters fail, try failover adapters.
+     */
+    private executePriorityWithFailover;
+    private withTimeout;
+    recordMetric(metric: Metric): Promise<void>;
+    incrementCounter(name: string, value?: number, tags?: Record<string, string>): Promise<void>;
+    setGauge(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    recordHistogram(name: string, value: number, tags?: Record<string, string>): Promise<void>;
+    startSpan(options: SpanOptions): Span;
+    withSpan<T>(options: SpanOptions, fn: (span: Span) => Promise<T>): Promise<T>;
+    getActiveSpan(): Span | null;
+    log(entry: LogEntry): Promise<void>;
+    sendEvent(event: ObservabilityEvent): Promise<void>;
+    /**
+     * Track a service operation with automatic metrics and tracing.
+     *
+     * @example
+     * ```typescript
+     * const { result, metrics } = await observability.trackOperation(
+     *   {
+     *     serviceName: 'UserService',
+     *     operation: 'create',
+     *     entityType: 'user',
+     *     startTime: Date.now(),
+     *   },
+     *   async () => {
+     *     return await this.repository.create(userData);
+     *   }
+     * );
+     * ```
+     */
+    trackOperation<T>(context: OperationContext, operation: () => Promise<T>): Promise<{
+        result: T;
+        metrics: MonitoringOperationResult;
+    }>;
+}
+/**
+ * Create an ObservabilityService with pre-initialized adapters.
+ *
+ * @example
+ * ```typescript
+ * // Initialize adapters first
+ * const datadogAdapter = new DatadogAdapter();
+ * await datadogAdapter.initialize({ apiKey: '...', serviceName: 'my-service' });
+ *
+ * // Create and initialize service (logger auto-added)
+ * const observability = await createObservabilityService({
+ *   mode: 'parallel',
+ *   adapters: [datadogAdapter],
+ *   serviceName: 'my-service',
+ * });
+ *
+ * // Priority mode (fallback chain)
+ * const observability = await createObservabilityService({
+ *   mode: 'priority',
+ *   adapters: [datadogAdapter, grafanaAdapter],
+ *   serviceName: 'my-service',
+ * });
+ * ```
+ */
+export declare function createObservabilityService(config?: ObservabilityServiceConfig & {
+    serviceName?: string;
+    environment?: string;
+}): Promise<ObservabilityService>;
+//# sourceMappingURL=ObservabilityService.d.ts.map

package/dist/base/observability/ObservabilityService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityService.d.ts","sourceRoot":"","sources":["../../../src/base/observability/ObservabilityService.ts"],"names":[],"mappings":"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"}

package/dist/base/observability/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Observability Module
+ *
+ * Adapter-based observability system supporting multiple providers
+ * (Datadog, Grafana, OpenTelemetry, etc.) with parallel and priority modes.
+ *
+ * @module base/observability
+ */
+export { BaseAdapter, NoopAdapter } from './BaseAdapter';
+export { LoggerAdapter } from './LoggerAdapter';
+export { CompositeAdapter } from './CompositeAdapter';
+export { DatadogAdapter } from './DatadogAdapter';
+export type { DatadogApiClient, DatadogMetricPayload, DatadogLogPayload, DatadogEventPayload, DatadogAdapterConfigExtended, } from './DatadogAdapter';
+export { ObservabilityService, createObservabilityService } from './ObservabilityService';
+export type { ObservabilityAdapter, ObservabilityAdapterConfig, ObservabilityProvider, Metric, SpanOptions, Span, LogEntry, ObservabilityEvent, SpanContext, SpanAttributes, SpanEvent, SpanStatus, DatadogAdapterConfig, OpenTelemetryAdapterConfig, GrafanaAdapterConfig, ConsoleAdapterConfig, CompositeMode, CompositeAdapterConfig, OperationContext, MonitoringOperationResult, AdapterWithPriority, AdapterEntry, ObservabilityServiceConfig, ObservabilityServiceInterface, } from '@plyaz/types/observability';
+export { OBSERVABILITY_METRICS, OBSERVABILITY_SPANS } from '@plyaz/types/observability';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAG1F,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,MAAM,EACN,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,EACZ,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}