monora-ai 1.7.0 → 1.9.0

package/README.md

@@ -1,4 +1,4 @@
-# Monora SDK for Node.js
+# Monora SDK for Node.js v1.9.0
 
 Lightweight governance and trace SDK for AI systems.
 
@@ -12,6 +12,13 @@ Lightweight governance and trace SDK for AI systems.
 - **Multiple Sinks**: Output to stdout, file (JSON-lines), or HTTPS endpoints
 - **Event Enrichment**: Automatic metadata (timestamp, host, process, environment)
 
+### New in v1.9.0
+
+- **🔄 Circuit Breaker**: Fault tolerance for HTTPS sinks with automatic recovery
+- **📊 Telemetry/Analytics**: Prometheus and StatsD metrics export for observability
+- **📄 PDF Reports**: Generate compliance and EU AI Act PDF reports
+- **🌐 Next.js Middleware**: W3C Trace Context propagation for Next.js applications
+
 ## Installation
 
 ```bash
@@ -341,6 +348,133 @@ const httpsSink = new HttpSink(
 );
 ```
 
+## v1.9.0 Features
+
+### Circuit Breaker
+
+Prevent cascading failures with circuit breaker pattern for HTTPS sinks:
+
+```typescript
+import { HttpSink } from 'monora';
+
+const httpsSink = new HttpSink(
+  'https://api.example.com/events',
+  { 'Authorization': 'Bearer token' },
+  {
+    circuitBreaker: {
+      enabled: true,
+      failure_threshold: 5,
+      success_threshold: 2,
+      reset_timeout_sec: 60,
+    }
+  }
+);
+```
+
+### Telemetry/Analytics
+
+Export metrics to Prometheus or StatsD:
+
+```typescript
+import { init, initMetrics, recordEvent, recordViolation } from 'monora';
+
+// Configure telemetry
+init({
+  configPath: './monora.yml',
+  config: {
+    telemetry: {
+      enabled: true,
+      backend: 'prometheus', // or 'statsd'
+      prometheus: {
+        port: 9090,
+        start_server: true,
+      }
+    }
+  }
+});
+
+// Metrics are automatically recorded:
+// - monora_events_total (by event_type)
+// - monora_violations_total (by policy_type)
+// - monora_queue_depth
+// - monora_tokens_total
+```
+
+### PDF Report Generation
+
+Generate compliance PDF reports:
+
+```typescript
+import { generateCompliancePdf, generateAIActPdf } from 'monora';
+
+// Generate compliance PDF
+await generateCompliancePdf(complianceReport, 'compliance_report.pdf');
+
+// Generate EU AI Act transparency PDF
+await generateAIActPdf(aiActReport, 'ai_act_report.pdf');
+```
+
+Requires optional dependency: `npm install puppeteer`
+
+### Next.js Middleware
+
+Automatic W3C Trace Context propagation for Next.js:
+
+```typescript
+// middleware.ts
+import { withMonoraMiddleware } from 'monora';
+
+export default withMonoraMiddleware({
+  skipPatterns: [/^\/_next/, /^\/api\/health/],
+});
+
+export const config = {
+  matcher: '/(.*)',
+};
+```
+
+For API routes (Pages Router):
+
+```typescript
+// pages/api/users.ts
+import { withMonoraApi } from 'monora';
+
+export default withMonoraApi(async (req, res) => {
+  const users = await fetchUsers();
+  res.json(users);
+});
+```
+
+For route handlers (App Router):
+
+```typescript
+// app/api/users/route.ts
+import { withMonoraRoute } from 'monora';
+import { NextRequest, NextResponse } from 'next/server';
+
+export const GET = withMonoraRoute(async (req: NextRequest) => {
+  const users = await fetchUsers();
+  return NextResponse.json(users);
+});
+```
+
+For Server Actions:
+
+```typescript
+// app/actions.ts
+'use server';
+import { withMonoraAction } from 'monora';
+
+export const createUser = withMonoraAction(
+  async (formData: FormData) => {
+    const name = formData.get('name');
+    // Create user logic
+    return { success: true };
+  },
+  'createUser'
+);
+```
+
 ## License
 
 MIT

package/dist/alerts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiBrF;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QAC1C,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;KAC7C;IAaD,KAAK,IAAI,IAAI;IASb,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAWxC,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;YAQC,YAAY;YAqBZ,WAAW;IAmBzB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,aAAa;CAStB"}
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiBrF;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QAC1C,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;KAC7C;IAaD,KAAK,IAAI,IAAI;IASb,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAWxC,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;YAQC,YAAY;YAqBZ,WAAW;IAmBzB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,aAAa;CAStB"}

package/dist/alerts.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViolationWebhookDispatcher = exports.AlertError = void 0;
 exports.buildViolationPayload = buildViolationPayload;
 const axios_1 = __importDefault(require("axios"));
+const logger_1 = require("./logger");
 class AlertError extends Error {
     constructor(message) {
         super(message);
@@ -116,12 +117,12 @@ class ViolationWebhookDispatcher {
         }
     }
     handleQueueFull() {
-        const message = 'Monora violation webhook queue full; dropping alert';
+        const message = 'Violation webhook queue full; dropping alert';
         if (this.queueFullMode === 'raise') {
             throw new AlertError(message);
         }
         if (this.queueFullMode === 'warn') {
-            console.error(message);
+            logger_1.logger.warning(message);
         }
     }
     handleFailure(error) {
@@ -130,7 +131,7 @@ class ViolationWebhookDispatcher {
             return;
         }
         if (this.failureMode === 'warn') {
-            console.error(`Monora violation webhook failed: ${error}`);
+            logger_1.logger.error('Violation webhook failed: %s', error);
         }
     }
 }

package/dist/circuit_breaker.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Circuit breaker pattern for fault tolerance.
+ *
+ * Implements the circuit breaker pattern to prevent cascading failures
+ * when external services become unavailable. The circuit breaker has
+ * three states:
+ *
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Circuit tripped, requests fail fast without attempting
+ * - HALF_OPEN: Testing recovery, limited requests allowed
+ */
+/**
+ * Circuit breaker states.
+ */
+export declare enum CircuitState {
+    CLOSED = "closed",
+    OPEN = "open",
+    HALF_OPEN = "half_open"
+}
+/**
+ * Configuration options for circuit breaker.
+ */
+export interface CircuitBreakerConfig {
+    /** Enable circuit breaker (default: true) */
+    enabled?: boolean;
+    /** Consecutive failures before opening circuit (default: 5) */
+    failure_threshold?: number;
+    /** Successes needed in half-open to close (default: 2) */
+    success_threshold?: number;
+    /** Seconds before attempting half-open (default: 60) */
+    reset_timeout_sec?: number;
+}
+/**
+ * Error thrown when circuit breaker is open.
+ */
+export declare class CircuitBreakerError extends Error {
+    readonly state: CircuitState;
+    constructor(message: string, state: CircuitState);
+}
+/**
+ * Circuit breaker for protecting external service calls.
+ *
+ * Example usage:
+ * ```typescript
+ * const cb = new CircuitBreaker({
+ *   failure_threshold: 5,
+ *   reset_timeout_sec: 60
+ * });
+ *
+ * async function callExternalService() {
+ *   if (!cb.canExecute()) {
+ *     throw new CircuitBreakerError('Circuit is open', cb.state);
+ *   }
+ *   try {
+ *     const result = await makeRequest();
+ *     cb.recordSuccess();
+ *     return result;
+ *   } catch (error) {
+ *     cb.recordFailure();
+ *     throw error;
+ *   }
+ * }
+ * ```
+ */
+export declare class CircuitBreaker {
+    private readonly failureThreshold;
+    private readonly successThreshold;
+    private readonly resetTimeoutSec;
+    private readonly name;
+    private _state;
+    private _failureCount;
+    private _successCount;
+    private _lastFailureTime;
+    constructor(config?: CircuitBreakerConfig, name?: string);
+    /**
+     * Get current circuit state, checking for timeout transition.
+     */
+    get state(): CircuitState;
+    /**
+     * Get current failure count.
+     */
+    get failureCount(): number;
+    /**
+     * Get current success count (relevant in half-open state).
+     */
+    get successCount(): number;
+    /**
+     * Check if request can proceed.
+     *
+     * @returns True if circuit is closed or half-open, false if open.
+     */
+    canExecute(): boolean;
+    /**
+     * Record a successful operation.
+     *
+     * In half-open state, increments success count and may close circuit.
+     * In closed state, resets failure count.
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed operation.
+     *
+     * Increments failure count and may open circuit if threshold reached.
+     * In half-open state, immediately reopens circuit.
+     */
+    recordFailure(): void;
+    /**
+     * Manually reset circuit breaker to closed state.
+     */
+    reset(): void;
+    /**
+     * Return string representation.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=circuit_breaker.d.ts.map

package/dist/circuit_breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit_breaker.d.ts","sourceRoot":"","sources":["../src/circuit_breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,KAAK,EAAE,YAAY,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;CAKjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,GAAE,oBAAyB,EAAE,IAAI,CAAC,EAAE,MAAM;IAO5D;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAcxB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAwBrB;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAoBrB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,QAAQ,IAAI,MAAM;CAMnB"}

package/dist/circuit_breaker.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Circuit breaker pattern for fault tolerance.
+ *
+ * Implements the circuit breaker pattern to prevent cascading failures
+ * when external services become unavailable. The circuit breaker has
+ * three states:
+ *
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Circuit tripped, requests fail fast without attempting
+ * - HALF_OPEN: Testing recovery, limited requests allowed
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.CircuitBreakerError = exports.CircuitState = void 0;
+const logger_1 = require("./logger");
+/**
+ * Circuit breaker states.
+ */
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "closed";
+    CircuitState["OPEN"] = "open";
+    CircuitState["HALF_OPEN"] = "half_open";
+})(CircuitState || (exports.CircuitState = CircuitState = {}));
+/**
+ * Error thrown when circuit breaker is open.
+ */
+class CircuitBreakerError extends Error {
+    constructor(message, state) {
+        super(message);
+        this.name = 'CircuitBreakerError';
+        this.state = state;
+    }
+}
+exports.CircuitBreakerError = CircuitBreakerError;
+/**
+ * Circuit breaker for protecting external service calls.
+ *
+ * Example usage:
+ * ```typescript
+ * const cb = new CircuitBreaker({
+ *   failure_threshold: 5,
+ *   reset_timeout_sec: 60
+ * });
+ *
+ * async function callExternalService() {
+ *   if (!cb.canExecute()) {
+ *     throw new CircuitBreakerError('Circuit is open', cb.state);
+ *   }
+ *   try {
+ *     const result = await makeRequest();
+ *     cb.recordSuccess();
+ *     return result;
+ *   } catch (error) {
+ *     cb.recordFailure();
+ *     throw error;
+ *   }
+ * }
+ * ```
+ */
+class CircuitBreaker {
+    constructor(config = {}, name) {
+        this._state = CircuitState.CLOSED;
+        this._failureCount = 0;
+        this._successCount = 0;
+        this._lastFailureTime = 0;
+        this.failureThreshold = config.failure_threshold ?? 5;
+        this.successThreshold = config.success_threshold ?? 2;
+        this.resetTimeoutSec = config.reset_timeout_sec ?? 60.0;
+        this.name = name ?? 'circuit_breaker';
+    }
+    /**
+     * Get current circuit state, checking for timeout transition.
+     */
+    get state() {
+        if (this._state === CircuitState.OPEN) {
+            const elapsed = (Date.now() - this._lastFailureTime) / 1000;
+            if (elapsed >= this.resetTimeoutSec) {
+                logger_1.logger.debug('[%s] Circuit transitioning OPEN -> HALF_OPEN after %.1fs', this.name, elapsed);
+                this._state = CircuitState.HALF_OPEN;
+                this._successCount = 0;
+            }
+        }
+        return this._state;
+    }
+    /**
+     * Get current failure count.
+     */
+    get failureCount() {
+        return this._failureCount;
+    }
+    /**
+     * Get current success count (relevant in half-open state).
+     */
+    get successCount() {
+        return this._successCount;
+    }
+    /**
+     * Check if request can proceed.
+     *
+     * @returns True if circuit is closed or half-open, false if open.
+     */
+    canExecute() {
+        return this.state !== CircuitState.OPEN;
+    }
+    /**
+     * Record a successful operation.
+     *
+     * In half-open state, increments success count and may close circuit.
+     * In closed state, resets failure count.
+     */
+    recordSuccess() {
+        if (this._state === CircuitState.HALF_OPEN) {
+            this._successCount++;
+            logger_1.logger.debug('[%s] Success recorded in HALF_OPEN (%d/%d)', this.name, this._successCount, this.successThreshold);
+            if (this._successCount >= this.successThreshold) {
+                logger_1.logger.info('[%s] Circuit CLOSED after %d consecutive successes', this.name, this._successCount);
+                this._state = CircuitState.CLOSED;
+                this._failureCount = 0;
+            }
+        }
+        else if (this._state === CircuitState.CLOSED) {
+            // Reset failure count on success
+            this._failureCount = 0;
+        }
+    }
+    /**
+     * Record a failed operation.
+     *
+     * Increments failure count and may open circuit if threshold reached.
+     * In half-open state, immediately reopens circuit.
+     */
+    recordFailure() {
+        this._failureCount++;
+        this._lastFailureTime = Date.now();
+        if (this._state === CircuitState.HALF_OPEN) {
+            logger_1.logger.warning('[%s] Circuit reopening HALF_OPEN -> OPEN after failure', this.name);
+            this._state = CircuitState.OPEN;
+        }
+        else if (this._failureCount >= this.failureThreshold) {
+            logger_1.logger.warning('[%s] Circuit OPEN after %d consecutive failures', this.name, this._failureCount);
+            this._state = CircuitState.OPEN;
+        }
+    }
+    /**
+     * Manually reset circuit breaker to closed state.
+     */
+    reset() {
+        logger_1.logger.info('[%s] Circuit manually reset to CLOSED', this.name);
+        this._state = CircuitState.CLOSED;
+        this._failureCount = 0;
+        this._successCount = 0;
+        this._lastFailureTime = 0;
+    }
+    /**
+     * Return string representation.
+     */
+    toString() {
+        return (`CircuitBreaker(name=${this.name}, state=${this.state}, ` +
+            `failures=${this._failureCount}, threshold=${this.failureThreshold})`);
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;

package/dist/config.d.ts

@@ -2,6 +2,12 @@
  * Configuration loading and normalization.
  */
 export type PresetName = 'minimal' | 'development' | 'production' | 'compliance' | 'poc';
+export interface CircuitBreakerConfig {
+    enabled?: boolean;
+    failure_threshold?: number;
+    success_threshold?: number;
+    reset_timeout_sec?: number;
+}
 export interface SinkConfig {
     type: string;
     format?: string;
@@ -14,6 +20,7 @@ export interface SinkConfig {
     retry_attempts?: number;
     rotation?: string;
     max_size_mb?: number;
+    circuit_breaker?: CircuitBreakerConfig;
     [key: string]: any;
 }
 /**
@@ -100,6 +107,9 @@ export interface MonoraConfig {
         batch_size?: number;
         flush_interval_sec?: number;
         queue_full_timeout_sec?: number | null;
+        adaptive_batching?: boolean;
+        min_batch_size?: number;
+        max_batch_size?: number;
     };
     wal?: {
         enabled?: boolean;
@@ -124,6 +134,21 @@ export interface MonoraConfig {
         generate_transparency_report?: boolean;
         transparency_report_formats?: string[];
     };
+    telemetry?: {
+        enabled?: boolean;
+        backend?: 'prometheus' | 'statsd';
+        prometheus?: {
+            port?: number;
+            start_server?: boolean;
+            push_gateway?: string;
+            job_name?: string;
+        };
+        statsd?: {
+            host?: string;
+            port?: number;
+            prefix?: string;
+        };
+    };
 }
 export declare function loadConfig(options?: {
     configPath?: string;

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -43,6 +43,7 @@ exports.getPresetConfig = getPresetConfig;
 exports.buildConfigFromOptions = buildConfigFromOptions;
 const fs = __importStar(require("fs"));
 const yaml = __importStar(require("js-yaml"));
+const logger_1 = require("./logger");
 /**
  * Preset configurations for quick setup.
  */
@@ -189,6 +190,9 @@ const DEFAULT_CONFIG = {
         batch_size: 50,
         flush_interval_sec: 1.0,
         queue_full_timeout_sec: null,
+        adaptive_batching: true,
+        min_batch_size: 10,
+        max_batch_size: 500,
     },
     wal: {
         enabled: false,
@@ -237,7 +241,7 @@ function loadConfig(options) {
 function loadConfigFile(configPath, silent = false) {
     if (!fs.existsSync(configPath)) {
         if (!silent) {
-            console.warn(`Monora: Config file not found: ${configPath}. Using defaults.`);
+            logger_1.logger.warning('Config file not found: %s. Using defaults.', configPath);
         }
         return {};
     }
@@ -395,7 +399,7 @@ function normalizeDataHandlingMode(config) {
     }
     const normalized = mode.toLowerCase();
     if (normalized === 'mask' || normalized === 'encrypt') {
-        console.warn(`Monora: data_handling.mode '${mode}' is deprecated; using 'redact' instead.`);
+        logger_1.logger.warning("data_handling.mode '%s' is deprecated; using 'redact' instead.", mode);
         config.data_handling.mode = 'redact';
         return;
     }