@visulima/pail 4.0.0-alpha.11 → 4.0.0-alpha.13

package/dist/reporter/http/abstract-http-reporter.js

@@ -1,432 +1,2 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  Buffer
-} = __cjs_getBuiltinModule("node:buffer");
-import { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-nOj0Ft1F.js';
-const {
-  gzipSync
-} = __cjs_getBuiltinModule("node:zlib");
-
-const compressData = async (data) => {
-  const CompressionStreamClass = globalThis.CompressionStream;
-  if (CompressionStreamClass) {
-    const stream = new CompressionStreamClass("gzip");
-    const writer = stream.writable.getWriter();
-    const reader = stream.readable.getReader();
-    const encoder = new TextEncoder();
-    const chunks = [];
-    await writer.write(encoder.encode(data));
-    await writer.close();
-    let done = false;
-    while (!done) {
-      const result = await reader.read();
-      done = result.done;
-      if (result.value) {
-        chunks.push(result.value);
-      }
-    }
-    const totalLength = chunks.reduce((accumulator, chunk) => accumulator + chunk.length, 0);
-    const resultBuffer = new Uint8Array(totalLength);
-    let offset = 0;
-    for (let i = 0; i < chunks.length; i += 1) {
-      const chunk = chunks[i];
-      resultBuffer.set(chunk, offset);
-      offset += chunk.length;
-    }
-    return resultBuffer;
-  }
-  return gzipSync(data);
-};
-
-class LogSizeError extends Error {
-  /**
-   * The log entry data that caused the error
-   */
-  logData;
-  /**
-   * The actual size of the log entry in bytes
-   */
-  actualSize;
-  /**
-   * The maximum allowed size in bytes
-   */
-  maxSize;
-  /**
-   * Creates a new LogSizeError instance.
-   * @param message Descriptive error message explaining the size violation
-   * @param logData The log entry data that caused the error
-   * @param actualSize Size of the log entry in bytes
-   * @param maxSize Maximum allowed size in bytes
-   * @example
-   * ```typescript
-   * throw new LogSizeError("Log too large", logData, 2000000, 1000000);
-   * ```
-   */
-  constructor(message, logData, actualSize, maxSize) {
-    super(message);
-    this.name = "LogSizeError";
-    this.logData = logData;
-    this.actualSize = actualSize;
-    this.maxSize = maxSize;
-  }
-}
-
-const calculateBackoffDelay = (baseDelay, attempt) => baseDelay * 2 ** attempt;
-const sleep = (delay) => new Promise((resolve) => {
-  setTimeout(resolve, delay);
-});
-const prepareRequestBody = (body) => {
-  if (typeof body === "string") {
-    return body;
-  }
-  return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
-};
-const processResponse = async (response, url, method, headers, body, onDebugRequestResponse, onError) => {
-  const responseHeaders = {};
-  response.headers.forEach((value, key) => {
-    responseHeaders[key] = value;
-  });
-  const responseBody = await response.text();
-  const requestResponse = {
-    req: {
-      body,
-      headers,
-      method,
-      url
-    },
-    res: {
-      body: responseBody,
-      headers: responseHeaders,
-      status: response.status,
-      statusText: response.statusText
-    }
-  };
-  if (onDebugRequestResponse) {
-    onDebugRequestResponse(requestResponse);
-  }
-  if (response.ok) {
-    return false;
-  }
-  if (response.status < 500 && response.status !== 429) {
-    const error = new Error(`HTTP ${String(response.status)}: ${response.statusText}`);
-    if (onError) {
-      onError(error);
-    }
-    throw error;
-  }
-  return true;
-};
-const handleRateLimit = (response, respectRateLimit, retryDelay, attempt, maxRetries) => {
-  if (response.status === 429 && respectRateLimit && attempt < maxRetries) {
-    const retryAfter = response.headers.get("retry-after");
-    return retryAfter ? Number.parseInt(retryAfter, 10) * 1e3 : calculateBackoffDelay(retryDelay, attempt);
-  }
-  return void 0;
-};
-const handleServerError = (response, retryDelay, attempt, maxRetries) => {
-  if (response.status >= 500 && attempt < maxRetries) {
-    return calculateBackoffDelay(retryDelay, attempt);
-  }
-  return void 0;
-};
-const calculateRetryDelay = (response, respectRateLimit, retryDelay, attempt, maxRetries) => {
-  const rateLimitDelay = handleRateLimit(response, respectRateLimit, retryDelay, attempt, maxRetries);
-  if (rateLimitDelay !== void 0) {
-    return rateLimitDelay;
-  }
-  return handleServerError(response, retryDelay, attempt, maxRetries);
-};
-const handleRetryError = async (error, attempt, maxRetries, retryDelay, onError) => {
-  if (attempt < maxRetries) {
-    const delay = calculateBackoffDelay(retryDelay, attempt);
-    await sleep(delay);
-    return true;
-  }
-  if (onError) {
-    onError(error);
-  }
-  return false;
-};
-const sendWithRetry = async (url, method, headers, body, maxRetries, retryDelay, respectRateLimit, onDebugRequestResponse, onError) => {
-  let attempt = 0;
-  while (attempt <= maxRetries) {
-    try {
-      const requestBody = prepareRequestBody(body);
-      const response = await fetch(url, {
-        body: requestBody,
-        headers,
-        method
-      });
-      const shouldRetry = await processResponse(response, url, method, headers, body, onDebugRequestResponse, onError);
-      if (!shouldRetry) {
-        return;
-      }
-      const retryDelayValue = calculateRetryDelay(response, respectRateLimit, retryDelay, attempt, maxRetries);
-      if (retryDelayValue !== void 0) {
-        await sleep(retryDelayValue);
-        attempt += 1;
-        continue;
-      }
-      if (!response.ok) {
-        const error = new Error(`HTTP ${String(response.status)}: ${response.statusText}`);
-        if (onError) {
-          onError(error);
-        }
-        throw error;
-      }
-      return;
-    } catch (error) {
-      const shouldRetry = await handleRetryError(error, attempt, maxRetries, retryDelay, onError);
-      if (shouldRetry) {
-        attempt += 1;
-        continue;
-      }
-      throw error;
-    }
-  }
-};
-
-class AbstractHttpReporter extends AbstractJsonReporter {
-  url;
-  method;
-  headers;
-  contentType;
-  batchContentType;
-  onError;
-  onDebug;
-  onDebugRequestResponse;
-  payloadTemplate;
-  compression;
-  maxRetries;
-  retryDelay;
-  respectRateLimit;
-  enableBatchSend;
-  batchSize;
-  batchSendTimeout;
-  batchSendDelimiter;
-  batchMode;
-  batchFieldName;
-  maxLogSize;
-  maxPayloadSize;
-  edgeCompat;
-  // Batch management
-  batchQueue = [];
-  batchTimeout;
-  isProcessingBatch = false;
-  currentBatchSize = 0;
-  // Track uncompressed size of current batch
-  /**
-   * Creates a new instance of AbstractHttpReporter.
-   * @param config Configuration options for the reporter
-   */
-  constructor(config) {
-    super(config);
-    this.url = config.url;
-    this.method = config.method ?? "POST";
-    this.headers = config.headers ?? {};
-    this.contentType = config.contentType ?? "application/json";
-    this.batchContentType = config.batchContentType ?? "application/json";
-    this.onError = config.onError;
-    this.onDebug = config.onDebug;
-    this.onDebugRequestResponse = config.onDebugRequestResponse;
-    this.payloadTemplate = config.payloadTemplate ?? ((data) => JSON.stringify(data));
-    this.compression = config.compression ?? false;
-    this.maxRetries = config.maxRetries ?? 3;
-    this.retryDelay = config.retryDelay ?? 1e3;
-    this.respectRateLimit = config.respectRateLimit ?? true;
-    this.enableBatchSend = config.enableBatchSend ?? true;
-    this.batchSize = config.batchSize ?? 100;
-    this.batchSendTimeout = config.batchSendTimeout ?? 5e3;
-    this.batchSendDelimiter = config.batchSendDelimiter ?? "\n";
-    this.batchMode = config.batchMode ?? "delimiter";
-    this.batchFieldName = config.batchFieldName;
-    if (this.batchMode === "field" && !this.batchFieldName) {
-      throw new Error("batchFieldName is required when batchMode is 'field'");
-    }
-    this.maxLogSize = config.maxLogSize ?? 1048576;
-    this.maxPayloadSize = config.maxPayloadSize ?? 5242880;
-    this.edgeCompat = config.edgeCompat ?? false;
-  }
-  /**
-   * Processes and ships log entries to the HTTP endpoint.
-   * @param message The JSON-formatted log message
-   * @param logLevel The log level of the message
-   * @protected
-   */
-  // eslint-disable-next-line no-underscore-dangle
-  _log(message, logLevel) {
-    try {
-      const logData = JSON.parse(message);
-      const logLevelString = logLevel;
-      const messageString = logData.message;
-      const payloadTemplate = {
-        logLevel: logLevelString,
-        message: messageString ?? ""
-      };
-      if (logData.data) {
-        payloadTemplate["data"] = logData.data;
-      } else if (logData.context) {
-        payloadTemplate["data"] = logData.context;
-      } else {
-        const rest = { ...logData };
-        delete rest.message;
-        if (Object.keys(rest).length > 0) {
-          payloadTemplate["data"] = rest;
-        }
-      }
-      const payload = this.payloadTemplate(payloadTemplate);
-      if (this.onDebug) {
-        this.onDebug({ data: payloadTemplate.data, logLevel: logLevelString, message: messageString });
-      }
-      const logEntrySize = this.edgeCompat || typeof TextEncoder === "undefined" ? Buffer.byteLength(payload, "utf8") : new TextEncoder().encode(payload).length;
-      if (logEntrySize > this.maxLogSize) {
-        const error = new LogSizeError(
-          `Log entry exceeds maximum size of ${String(this.maxLogSize)} bytes. Size: ${String(logEntrySize)} bytes`,
-          { data: payloadTemplate.data, logLevel: logLevelString, message: messageString },
-          logEntrySize,
-          this.maxLogSize
-        );
-        if (this.onError) {
-          this.onError(error);
-        }
-        return;
-      }
-      if (this.enableBatchSend) {
-        this.addToBatch(payload, logEntrySize);
-      } else {
-        this.sendPayload(payload).catch((error) => {
-          if (this.onError) {
-            this.onError(error);
-          }
-        });
-      }
-    } catch (error) {
-      if (this.onError) {
-        this.onError(error);
-      }
-    }
-  }
-  /**
-   * Adds a payload to the batch queue and triggers sending if conditions are met.
-   */
-  addToBatch(payload, logEntrySize) {
-    const payloadSizeWithEntry = this.currentBatchSize + logEntrySize + this.batchSendDelimiter.length;
-    const payloadSizeThreshold = this.maxPayloadSize * 0.9;
-    if (payloadSizeWithEntry > payloadSizeThreshold && this.batchQueue.length > 0) {
-      void this.processBatch();
-    }
-    this.batchQueue.push(payload);
-    this.currentBatchSize += logEntrySize + this.batchSendDelimiter.length;
-    this.batchTimeout ??= setTimeout(() => {
-      void this.processBatch();
-    }, this.batchSendTimeout);
-    if (this.batchQueue.length >= this.batchSize) {
-      void this.processBatch();
-    }
-  }
-  /**
-   * Processes the current batch and sends it to the HTTP endpoint.
-   */
-  async processBatch() {
-    if (this.isProcessingBatch || this.batchQueue.length === 0) {
-      return;
-    }
-    this.isProcessingBatch = true;
-    if (this.batchTimeout) {
-      clearTimeout(this.batchTimeout);
-      this.batchTimeout = void 0;
-    }
-    const batch = this.batchQueue.splice(0, this.batchSize);
-    this.currentBatchSize = 0;
-    for (let i = 0; i < this.batchQueue.length; i += 1) {
-      const payload = this.batchQueue[i];
-      const payloadSize = this.edgeCompat || typeof TextEncoder === "undefined" ? Buffer.byteLength(payload, "utf8") : new TextEncoder().encode(payload).length;
-      this.currentBatchSize += payloadSize + (i < this.batchQueue.length - 1 ? this.batchSendDelimiter.length : 0);
-    }
-    try {
-      await this.sendBatch(batch);
-    } catch (error) {
-      if (this.onError) {
-        this.onError(error);
-      }
-    } finally {
-      this.isProcessingBatch = false;
-      if (this.batchQueue.length > 0) {
-        void this.processBatch();
-      }
-    }
-  }
-  /**
-   * Sends a batch of payloads to the HTTP endpoint.
-   */
-  async sendBatch(batch) {
-    let batchPayload;
-    switch (this.batchMode) {
-      case "array": {
-        const batchEntries = batch.map((payload) => JSON.parse(payload));
-        batchPayload = JSON.stringify(batchEntries);
-        break;
-      }
-      case "field": {
-        const fieldEntries = batch.map((payload) => JSON.parse(payload));
-        const batchObject = this.batchFieldName ? { [this.batchFieldName]: fieldEntries } : {};
-        batchPayload = JSON.stringify(batchObject);
-        break;
-      }
-      default: {
-        batchPayload = batch.join(this.batchSendDelimiter);
-        break;
-      }
-    }
-    await this.sendPayload(batchPayload, this.batchContentType);
-  }
-  /**
-   * Sends a single payload to the HTTP endpoint.
-   */
-  async sendPayload(payload, contentType) {
-    const headers = typeof this.headers === "function" ? this.headers() : { ...this.headers };
-    headers["content-type"] ??= contentType ?? this.contentType;
-    let finalPayload = payload;
-    if (this.compression && !this.edgeCompat) {
-      try {
-        finalPayload = await compressData(payload);
-        headers["content-encoding"] = "gzip";
-      } catch (error) {
-        if (this.onError) {
-          this.onError(new Error(`Compression failed: ${String(error)}`));
-        }
-      }
-    }
-    await sendWithRetry(
-      this.url,
-      this.method,
-      headers,
-      finalPayload,
-      this.maxRetries,
-      this.retryDelay,
-      this.respectRateLimit,
-      this.onDebugRequestResponse,
-      this.onError
-    );
-  }
-}
-
-export { AbstractHttpReporter };
+var w=Object.defineProperty;var m=(t,e)=>w(t,"name",{value:e,configurable:!0});import{createRequire as x}from"node:module";import{AbstractJsonReporter as E}from"../../packem_shared/AbstractJsonReporter-BawNFYxI.js";const z=x(import.meta.url),p=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,S=m(t=>{if(typeof p<"u"&&p.versions&&p.versions.node){const[e,s]=p.versions.node.split(".").map(Number);if(e>22||e===22&&s>=3||e===20&&s>=16)return p.getBuiltinModule(t)}return z(t)},"__cjs_getBuiltinModule"),{Buffer:y}=S("node:buffer"),{gzipSync:R}=S("node:zlib");var B=Object.defineProperty,v=m((t,e)=>B(t,"name",{value:e,configurable:!0}),"d");const D=v(async t=>{const e=globalThis.CompressionStream;if(e){const s=new e("gzip"),a=s.writable.getWriter(),i=s.readable.getReader(),r=new TextEncoder,h=[];await a.write(r.encode(t)),await a.close();let u=!1;for(;!u;){const n=await i.read();u=n.done,n.value&&h.push(n.value)}const c=h.reduce((n,b)=>n+b.length,0),o=new Uint8Array(c);let l=0;for(let n=0;n<h.length;n+=1){const b=h[n];o.set(b,l),l+=b.length}return o}return R(t)},"compressData");var P=Object.defineProperty,L=m((t,e)=>P(t,"name",{value:e,configurable:!0}),"n");class N extends Error{static{m(this,"u")}static{L(this,"LogSizeError")}logData;actualSize;maxSize;constructor(e,s,a,i){super(e),this.name="LogSizeError",this.logData=s,this.actualSize=a,this.maxSize=i}}var j=Object.defineProperty,d=m((t,e)=>j(t,"name",{value:e,configurable:!0}),"o");const g=d((t,e)=>t*2**e,"calculateBackoffDelay"),T=d(t=>new Promise(e=>{setTimeout(e,t)}),"sleep"),O=d(t=>typeof t=="string"?t:new Uint8Array(t.buffer,t.byteOffset,t.byteLength),"prepareRequestBody"),_=d(async(t,e,s,a,i,r,h)=>{const u={};t.headers.forEach((l,n)=>{u[n]=l});const c=await t.text(),o={req:{body:i,headers:a,method:s,url:e},res:{body:c,headers:u,status:t.status,statusText:t.statusText}};if(r&&r(o),t.ok)return!1;if(t.status<500&&t.status!==429){const l=new Error(`HTTP ${String(t.status)}: ${t.statusText}`);throw h&&h(l),l}return!0},"processResponse"),C=d((t,e,s,a,i)=>{if(t.status===429&&e&&a<i){const r=t.headers.get("retry-after");return r?Number.parseInt(r,10)*1e3:g(s,a)}},"handleRateLimit"),q=d((t,e,s,a)=>{if(t.status>=500&&s<a)return g(e,s)},"handleServerError"),Q=d((t,e,s,a,i)=>{const r=C(t,e,s,a,i);return r!==void 0?r:q(t,s,a,i)},"calculateRetryDelay"),k=d(async(t,e,s,a,i)=>{if(e<s){const r=g(a,e);return await T(r),!0}return i&&i(t),!1},"handleRetryError"),M=d(async(t,e,s,a,i,r,h,u,c)=>{let o=0;for(;o<=i;)try{const l=O(a),n=await fetch(t,{body:l,headers:s,method:e});if(!await _(n,t,e,s,a,u,c))return;const b=Q(n,h,r,o,i);if(b!==void 0){await T(b),o+=1;continue}if(!n.ok){const f=new Error(`HTTP ${String(n.status)}: ${n.statusText}`);throw c&&c(f),f}return}catch(l){if(await k(l,o,i,r,c)){o+=1;continue}throw l}},"sendWithRetry");var F=Object.defineProperty,J=m((t,e)=>F(t,"name",{value:e,configurable:!0}),"c");class U extends E{static{m(this,"AbstractHttpReporter")}static{J(this,"AbstractHttpReporter")}url;method;headers;contentType;batchContentType;onError;onDebug;onDebugRequestResponse;payloadTemplate;compression;maxRetries;retryDelay;respectRateLimit;enableBatchSend;batchSize;batchSendTimeout;batchSendDelimiter;batchMode;batchFieldName;maxLogSize;maxPayloadSize;edgeCompat;batchQueue=[];batchTimeout;isProcessingBatch=!1;currentBatchSize=0;constructor(e){if(super(e),this.url=e.url,this.method=e.method??"POST",this.headers=e.headers??{},this.contentType=e.contentType??"application/json",this.batchContentType=e.batchContentType??"application/json",this.onError=e.onError,this.onDebug=e.onDebug,this.onDebugRequestResponse=e.onDebugRequestResponse,this.payloadTemplate=e.payloadTemplate??(s=>JSON.stringify(s)),this.compression=e.compression??!1,this.maxRetries=e.maxRetries??3,this.retryDelay=e.retryDelay??1e3,this.respectRateLimit=e.respectRateLimit??!0,this.enableBatchSend=e.enableBatchSend??!0,this.batchSize=e.batchSize??100,this.batchSendTimeout=e.batchSendTimeout??5e3,this.batchSendDelimiter=e.batchSendDelimiter??`
+`,this.batchMode=e.batchMode??"delimiter",this.batchFieldName=e.batchFieldName,this.batchMode==="field"&&!this.batchFieldName)throw new Error("batchFieldName is required when batchMode is 'field'");this.maxLogSize=e.maxLogSize??1048576,this.maxPayloadSize=e.maxPayloadSize??5242880,this.edgeCompat=e.edgeCompat??!1}_log(e,s){try{const a=JSON.parse(e),i=s,r=a.message,h={logLevel:i,message:r??""};if(a.data)h.data=a.data;else if(a.context)h.data=a.context;else{const o={...a};delete o.message,Object.keys(o).length>0&&(h.data=o)}const u=this.payloadTemplate(h);this.onDebug&&this.onDebug({data:h.data,logLevel:i,message:r});const c=this.edgeCompat||typeof TextEncoder>"u"?y.byteLength(u,"utf8"):new TextEncoder().encode(u).length;if(c>this.maxLogSize){const o=new N(`Log entry exceeds maximum size of ${String(this.maxLogSize)} bytes. Size: ${String(c)} bytes`,{data:h.data,logLevel:i,message:r},c,this.maxLogSize);this.onError&&this.onError(o);return}this.enableBatchSend?this.addToBatch(u,c):this.sendPayload(u).catch(o=>{this.onError&&this.onError(o)})}catch(a){this.onError&&this.onError(a)}}addToBatch(e,s){const a=this.currentBatchSize+s+this.batchSendDelimiter.length,i=this.maxPayloadSize*.9;a>i&&this.batchQueue.length>0&&this.processBatch(),this.batchQueue.push(e),this.currentBatchSize+=s+this.batchSendDelimiter.length,this.batchTimeout??=setTimeout(()=>{this.processBatch()},this.batchSendTimeout),this.batchQueue.length>=this.batchSize&&this.processBatch()}async processBatch(){if(this.isProcessingBatch||this.batchQueue.length===0)return;this.isProcessingBatch=!0,this.batchTimeout&&(clearTimeout(this.batchTimeout),this.batchTimeout=void 0);const e=this.batchQueue.splice(0,this.batchSize);this.currentBatchSize=0;for(let s=0;s<this.batchQueue.length;s+=1){const a=this.batchQueue[s],i=this.edgeCompat||typeof TextEncoder>"u"?y.byteLength(a,"utf8"):new TextEncoder().encode(a).length;this.currentBatchSize+=i+(s<this.batchQueue.length-1?this.batchSendDelimiter.length:0)}try{await this.sendBatch(e)}catch(s){this.onError&&this.onError(s)}finally{this.isProcessingBatch=!1,this.batchQueue.length>0&&this.processBatch()}}async sendBatch(e){let s;switch(this.batchMode){case"array":{const a=e.map(i=>JSON.parse(i));s=JSON.stringify(a);break}case"field":{const a=e.map(r=>JSON.parse(r)),i=this.batchFieldName?{[this.batchFieldName]:a}:{};s=JSON.stringify(i);break}default:{s=e.join(this.batchSendDelimiter);break}}await this.sendPayload(s,this.batchContentType)}async sendPayload(e,s){const a=typeof this.headers=="function"?this.headers():{...this.headers};a["content-type"]??=s??this.contentType;let i=e;if(this.compression&&!this.edgeCompat)try{i=await D(e),a["content-encoding"]="gzip"}catch(r){this.onError&&this.onError(new Error(`Compression failed: ${String(r)}`))}await M(this.url,this.method,a,i,this.maxRetries,this.retryDelay,this.respectRateLimit,this.onDebugRequestResponse,this.onError)}}export{U as AbstractHttpReporter};

package/dist/reporter/http/http-reporter.d.ts

@@ -1,39 +1,43 @@
-import type { AbstractHttpReporterOptions } from "./abstract-http-reporter.d.ts";
-import { AbstractHttpReporter } from "./abstract-http-reporter.d.ts";
+import { AbstractHttpReporterOptions, AbstractHttpReporter } from "./abstract-http-reporter.js";
+import "../../packem_shared/types.d-ByY2ZuYG.js";
+import '@visulima/colorize';
+import '@visulima/interactive-manager';
+import "../../packem_shared/abstract-json-reporter.d-Bz3lZEDi.js";
+import 'safe-stable-stringify';
 /**
- * HTTP Reporter.
- *
- * A reporter that sends logs to HTTP endpoints.
- * Supports batching, compression, retries, and rate limiting.
- * Works in both Node.js server and browser environments.
- * @template L - The log level type
- * @example
- * ```typescript
- * import { createPail } from "@visulima/pail";
- * import { HttpReporter } from "@visulima/pail/reporter/http";
- *
- * const logger = createPail({
- *   reporters: [
- *     new HttpReporter({
- *       url: "https://api.example.com/logs",
- *       method: "POST",
- *       headers: {
- *         "Authorization": "Bearer token"
- *       },
- *       enableBatchSend: true,
- *       batchSize: 100
- *     })
- *   ]
- * });
- *
- * logger.info("Application started", { version: "1.0.0" });
- * ```
- */
+* HTTP Reporter.
+*
+* A reporter that sends logs to HTTP endpoints.
+* Supports batching, compression, retries, and rate limiting.
+* Works in both Node.js server and browser environments.
+* @template L - The log level type
+* @example
+* ```typescript
+* import { createPail } from "@visulima/pail";
+* import { HttpReporter } from "@visulima/pail/reporter/http";
+*
+* const logger = createPail({
+*   reporters: [
+*     new HttpReporter({
+*       url: "https://api.example.com/logs",
+*       method: "POST",
+*       headers: {
+*         "Authorization": "Bearer token"
+*       },
+*       enableBatchSend: true,
+*       batchSize: 100
+*     })
+*   ]
+* });
+*
+* logger.info("Application started", { version: "1.0.0" });
+* ```
+*/
 declare class HttpReporter<L extends string = string> extends AbstractHttpReporter<L> {
-    /**
-     * Creates a new HTTP Reporter instance.
-     * @param options Configuration options for HTTP reporting
-     */
-    constructor(options: AbstractHttpReporterOptions);
+  /**
+  * Creates a new HTTP Reporter instance.
+  * @param options Configuration options for HTTP reporting
+  */
+  constructor(options: AbstractHttpReporterOptions);
 }
-export default HttpReporter;
+export { HttpReporter as default };