@abbacchio/transport 0.1.4 → 0.2.0

package/dist/client.d.ts

@@ -1,100 +1,147 @@
 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. If set, used as the full URL for log ingestion. */
     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;
-    /** Default namespace for all logs. Per-log namespace/name fields take precedence */
-    namespace?: 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 */
     interval?: number;
     /** Additional headers to send with requests */
     headers?: Record<string, string>;
-    /** Whether to send logs to the server. Defaults to true */
+    /** Whether to send data to the server. Defaults to true */
     enabled?: boolean;
 }
 /**
- * Shared HTTP client for all Abbacchio transports.
- * Handles batching, encryption, and HTTP communication.
+ * A log entry in the format the transports produce before OTLP conversion.
+ */
+export interface LogRecord {
+    level?: number;
+    msg?: string;
+    message?: string;
+    time?: number;
+    [key: string]: unknown;
+}
+/**
+ * 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 histogram data point to send via OTLP.
+ *
+ * Each record is a single observation. The client accumulates observations
+ * into OTLP Histogram data points (with explicit bucket boundaries) on flush.
+ */
+export interface HistogramRecord {
+    name: string;
+    description?: string;
+    unit?: string;
+    /** The observed value (e.g. request duration in ms) */
+    value: number;
+    attributes?: Record<string, unknown>;
+    /**
+     * Explicit bucket boundaries. Defaults to a standard latency distribution:
+     * [5, 10, 25, 50, 75, 100, 250, 500, 750, 1000, 2500, 5000, 10000]
+     */
+    explicitBounds?: number[];
+}
+/**
+ * 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;
+    };
+}
+/**
+ * OTLP-native HTTP client for Abbacchio.
+ * Sends logs to POST /v1/logs, metrics to POST /v1/metrics, traces to POST /v1/traces.
  */
 export declare class AbbacchioClient {
-    private url;
+    private endpoint;
     private secretKey?;
-    private channel?;
-    private namespace?;
+    private serviceName;
+    private resourceAttributes;
     private batchSize;
     private interval;
     private headers;
     private enabled;
-    private buffer;
-    private timer;
+    private logBuffer;
+    private metricBuffer;
+    private histogramBuffer;
+    private spanBuffer;
+    private logTimer;
+    private metricTimer;
+    private histogramTimer;
+    private spanTimer;
     constructor(options?: AbbacchioClientOptions);
-    /**
-     * Change the channel dynamically after initialization
-     */
-    setChannel(channel: string | undefined): void;
-    /**
-     * Get the current channel
-     */
-    getChannel(): string | undefined;
-    /**
-     * Change the namespace dynamically after initialization
-     */
-    setNamespace(namespace: string | undefined): void;
-    /**
-     * Get the current namespace
-     */
-    getNamespace(): string | undefined;
-    /**
-     * Enable sending logs to the server
-     */
+    /** Change the service name dynamically */
+    setServiceName(name: string): void;
+    /** Get the current service name */
+    getServiceName(): string;
+    /** Enable sending data to the server */
     enable(): void;
-    /**
-     * Disable sending logs to the server. Logs will be silently dropped.
-     */
+    /** Disable sending data to the server. Data will be silently dropped. */
     disable(): void;
-    /**
-     * Check if the client is currently enabled
-     */
+    /** Check if the client is currently enabled */
     isEnabled(): boolean;
-    /**
-     * Process a log entry: inject default namespace, then encrypt if needed
-     */
-    private processLog;
-    /**
-     * Add a log to the buffer and trigger send if needed
-     */
-    add(log: unknown): void;
-    /**
-     * Add multiple logs at once
-     */
-    addBatch(logs: unknown[]): void;
-    /**
-     * Send logs immediately without batching
-     */
-    send(logs: unknown[]): Promise<void>;
-    /**
-     * Schedule a send after the interval
-     */
-    private scheduleSend;
-    /**
-     * Flush the buffer and send to server
-     */
+    /** Add a log record to the buffer */
+    add(log: LogRecord | unknown): void;
+    /** Add multiple log records at once */
+    addBatch(logs: (LogRecord | unknown)[]): void;
+    /** Send logs immediately without batching */
+    send(logs: (LogRecord | unknown)[]): Promise<void>;
+    private scheduleLogFlush;
+    flushLogs(): Promise<void>;
+    private sendLogs;
+    /** Add a metric data point to the buffer */
+    addMetric(metric: MetricRecord): void;
+    private scheduleMetricFlush;
+    flushMetrics(): Promise<void>;
+    private sendMetrics;
+    private static DEFAULT_BOUNDS;
+    /** Add a histogram observation to the buffer */
+    addHistogram(record: HistogramRecord): void;
+    private scheduleHistogramFlush;
+    flushHistograms(): Promise<void>;
+    private sendHistograms;
+    /** Add a trace span to the buffer */
+    addSpan(span: SpanRecord): void;
+    private scheduleSpanFlush;
+    flushSpans(): Promise<void>;
+    private sendSpans;
+    /** Flush all buffers and close the client */
     flush(): Promise<void>;
-    /**
-     * Send logs to the Abbacchio server
-     */
-    private sendToServer;
-    /**
-     * Close the client and flush any remaining logs
-     */
+    /** Close the client and flush any remaining data */
     close(): Promise<void>;
+    private buildResourceAttributes;
+    private post;
 }
 /**
- * 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":"AAEA,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,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAU;IAEzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAA8C;gBAE/C,OAAO,GAAE,sBAA2B;IAWhD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI7C;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIjD;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAWvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAa/B;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1C;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B;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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"}