@abbacchio/browser-transport 0.1.3 → 0.2.0

package/README.md

@@ -48,7 +48,7 @@ import { interceptConsole, stopInterceptConsole } from '@abbacchio/browser-trans
 interceptConsole({
   url: 'http://localhost:4000/api/logs',
   channel: 'my-frontend',
-  appName: 'my-app',
+  namespace: 'my-app',
   secretKey: 'optional-encryption-key', // optional
 })
 
@@ -69,7 +69,7 @@ import { createLogger } from '@abbacchio/browser-transport'
 const log = createLogger({
   url: 'http://localhost:4000/api/logs',
   channel: 'my-app',
-  name: 'my-service',
+  namespace: 'my-service',
 })
 
 log.info('User logged in', { userId: 123 })
@@ -121,7 +121,9 @@ Start intercepting console methods.
 interface ConsoleInterceptorOptions {
   url?: string           // Server URL (default: 'http://localhost:4000/api/logs')
   channel?: string       // Channel name (default: 'default')
+  namespace?: string     // Namespace for logs (takes precedence over appName)
   appName?: string       // Logger name (default: 'browser')
+  enabled?: boolean      // Whether to send logs (default: true)
   secretKey?: string     // Encryption key (optional)
   batchSize?: number     // Logs per batch (default: 10)
   flushInterval?: number // Ms between flushes (default: 1000)
@@ -138,7 +140,9 @@ Create a structured logger instance.
 interface LoggerOptions {
   url?: string
   channel?: string
-  name?: string          // Logger name/namespace
+  namespace?: string     // Logger namespace (takes precedence over name)
+  name?: string          // Logger name (deprecated, use namespace)
+  enabled?: boolean      // Whether to send logs (default: true)
   level?: number | 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal'
   secretKey?: string
   batchSize?: number
@@ -180,6 +184,32 @@ const log = useLogger()              // Get logger instance
 const { info, warn, error } = useAbbacchio()  // Get logging methods
 ```
 
+## Disabling in Production
+
+Use `enabled: false` to prevent logs from being sent. Logs are silently dropped.
+
+```javascript
+import { createLogger } from '@abbacchio/browser-transport'
+
+const log = createLogger({
+  channel: 'my-app',
+  enabled: process.env.NODE_ENV !== 'production',
+})
+
+// Or toggle at runtime via the underlying client
+import { createClient } from '@abbacchio/browser-transport'
+
+const client = createClient({ enabled: false })
+client.enable()   // start sending
+client.disable()  // stop sending
+```
+
+You can also toggle via `configure()`:
+
+```javascript
+client.configure({ enabled: true })
+```
+
 ## Encryption
 
 All options support optional end-to-end encryption:

package/dist/auto.d.ts

@@ -1,5 +1,5 @@
 /**
- * Auto-initialize console interception
+ * Auto-initialize console interception (OTLP native)
  *
  * Simply import this module to start capturing console output:
  *
@@ -7,7 +7,7 @@
  * ```typescript
  * import '@abbacchio/browser-transport/auto'
  *
- * // All console.log calls now go to Abbacchio
+ * // All console.log calls now go to Abbacchio via OTLP
  * console.log('This is captured!')
  * ```
  *
@@ -17,10 +17,9 @@
  * ```html
  * <script>
  *   window.__ABBACCHIO_CONFIG__ = {
- *     url: 'http://localhost:4000/api/logs',
- *     channel: 'my-app',
+ *     endpoint: 'http://localhost:4002',
+ *     serviceName: 'my-app',
  *     appName: 'my-web-app',
- *     secretKey: 'optional-encryption-key',
  *   }
  * </script>
  * <script type="module">

package/dist/auto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../src/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAoB,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGhF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;KAClD;CACF"}
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../src/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAoB,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;KAClD;CACF"}

package/dist/auto.js

@@ -1,5 +1,5 @@
 /**
- * Auto-initialize console interception
+ * Auto-initialize console interception (OTLP native)
  *
  * Simply import this module to start capturing console output:
  *
@@ -7,7 +7,7 @@
  * ```typescript
  * import '@abbacchio/browser-transport/auto'
  *
- * // All console.log calls now go to Abbacchio
+ * // All console.log calls now go to Abbacchio via OTLP
  * console.log('This is captured!')
  * ```
  *
@@ -17,10 +17,9 @@
  * ```html
  * <script>
  *   window.__ABBACCHIO_CONFIG__ = {
- *     url: 'http://localhost:4000/api/logs',
- *     channel: 'my-app',
+ *     endpoint: 'http://localhost:4002',
+ *     serviceName: 'my-app',
  *     appName: 'my-web-app',
- *     secretKey: 'optional-encryption-key',
  *   }
  * </script>
  * <script type="module">
@@ -29,12 +28,10 @@
  * ```
  */
 import { interceptConsole } from './console.js';
-// Get configuration from global variable or use defaults
 const config = (typeof window !== 'undefined' && window.__ABBACCHIO_CONFIG__) || {};
-// Start intercepting with merged config
 interceptConsole({
-    url: 'http://localhost:4000/api/logs',
-    channel: 'browser',
+    endpoint: 'http://localhost:4002',
+    serviceName: 'browser',
     appName: 'auto',
     ...config,
 });

package/dist/auto.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto.js","sourceRoot":"","sources":["../src/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,gBAAgB,EAAkC,MAAM,cAAc,CAAC;AAShF,yDAAyD;AACzD,MAAM,MAAM,GACV,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC;AAEvE,wCAAwC;AACxC,gBAAgB,CAAC;IACf,GAAG,EAAE,gCAAgC;IACrC,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,MAAM;IACf,GAAG,MAAM;CACV,CAAC,CAAC"}
+{"version":3,"file":"auto.js","sourceRoot":"","sources":["../src/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,gBAAgB,EAAkC,MAAM,cAAc,CAAC;AAQhF,MAAM,MAAM,GACV,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC;AAEvE,gBAAgB,CAAC;IACf,QAAQ,EAAE,uBAAuB;IACjC,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,MAAM;IACf,GAAG,MAAM;CACV,CAAC,CAAC"}

package/dist/client.d.ts

@@ -1,20 +1,26 @@
 /**
- * Browser HTTP client for Abbacchio
- * Handles batching, encryption, and sending logs to the server
+ * Browser HTTP client for Abbacchio (OTLP native)
+ * Sends logs to POST /v1/logs, metrics to POST /v1/metrics, traces to POST /v1/traces
  */
 export interface AbbacchioClientOptions {
-    /** Server URL endpoint */
+    /** Base URL of the OTLP server (e.g. "http://localhost:4002"). Logs go to {endpoint}/v1/logs */
+    endpoint?: string;
+    /** @deprecated Use `endpoint` instead */
     url?: string;
-    /** Secret key for encryption. If provided, logs will be encrypted before sending */
+    /** Secret key for encryption. If provided, payloads will be encrypted before sending */
     secretKey?: string;
-    /** Channel/app name for multi-app support. Defaults to 'default' */
-    channel?: string;
-    /** Number of logs to batch before sending. Defaults to 10 */
+    /** Service name — maps to OTLP resource attribute `service.name`. Defaults to 'default' */
+    serviceName?: string;
+    /** Additional OTLP resource attributes */
+    resourceAttributes?: Record<string, string>;
+    /** Number of log records to batch before sending. Defaults to 10 */
     batchSize?: number;
     /** Interval in ms between flushes. Defaults to 1000 */
     flushInterval?: number;
     /** Additional headers to send with requests */
     headers?: Record<string, string>;
+    /** Whether to send logs to the server. Defaults to true */
+    enabled?: boolean;
 }
 export interface LogEntry {
     level: number;
@@ -24,51 +30,83 @@ export interface LogEntry {
     [key: string]: unknown;
 }
 /**
- * Browser HTTP client for Abbacchio.
- * Handles batching, encryption, and HTTP communication.
+ * A metric data point to send via OTLP.
+ */
+export interface MetricRecord {
+    name: string;
+    description?: string;
+    unit?: string;
+    type: 'sum' | 'gauge';
+    value: number;
+    attributes?: Record<string, unknown>;
+    isMonotonic?: boolean;
+}
+/**
+ * A trace span to send via OTLP.
+ */
+export interface SpanRecord {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind?: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes?: Record<string, unknown>;
+    status?: {
+        code: number;
+        message?: string;
+    };
+}
+/**
+ * Browser HTTP client for Abbacchio (OTLP native).
+ * Sends logs via POST /v1/logs in ExportLogsServiceRequest format.
  */
 export declare class AbbacchioClient {
-    private url;
+    private endpoint;
     private secretKey?;
-    private channel;
+    private serviceName;
+    private resourceAttributes;
     private batchSize;
     private flushInterval;
     private headers;
+    private enabled;
     private buffer;
+    private metricBuffer;
+    private spanBuffer;
     private timer;
+    private metricTimer;
+    private spanTimer;
     private isClosed;
     constructor(options?: AbbacchioClientOptions);
-    /**
-     * Process a log entry (encrypt if secretKey is provided)
-     */
-    private processLog;
-    /**
-     * Add a log to the buffer and trigger send if needed
-     */
+    enable(): void;
+    disable(): void;
+    isEnabled(): boolean;
+    /** Add a log to the buffer and trigger send if needed */
     add(log: LogEntry): void;
-    /**
-     * Schedule a send after the interval
-     */
     private scheduleSend;
-    /**
-     * Flush the buffer and send to server
-     */
+    /** Flush all buffers (logs, metrics, traces) */
     flush(): Promise<void>;
-    /**
-     * Send logs to the Abbacchio server
-     */
-    private sendToServer;
-    /**
-     * Close the client and flush any remaining logs
-     */
+    flushLogs(): Promise<void>;
+    private sendLogs;
+    /** Add a metric data point to the buffer */
+    addMetric(metric: MetricRecord): void;
+    private scheduleMetricFlush;
+    flushMetrics(): Promise<void>;
+    private sendMetrics;
+    /** Add a trace span to the buffer */
+    addSpan(span: SpanRecord): void;
+    private scheduleSpanFlush;
+    flushSpans(): Promise<void>;
+    private sendSpans;
     close(): Promise<void>;
-    /**
-     * Update client configuration
-     */
+    private buildResourceAttributes;
+    private post;
+    /** Update client configuration */
     configure(options: Partial<AbbacchioClientOptions>): void;
 }
 /**
- * Create a new Abbacchio client instance
+ * Create a new Abbacchio OTLP client instance
  */
 export declare function createClient(options?: AbbacchioClientOptions): AbbacchioClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAyB;IAExC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,sBAA2B;IAehD;;OAEG;YACW,UAAU;IAOxB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAYxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;CAQ1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAE9E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}