@mihari/logger-core 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -0,0 +1,122 @@
+import { TransportOptions, CompressFn, LogEntry, TransportResponse, BatchOptions, MihariConfig, LogLevel } from '@mihari/logger-types';
+export { BatchOptions, CompressFn, LogEntry, LogLevel, MihariConfig, TransportError, TransportOptions, TransportResponse } from '@mihari/logger-types';
+
+declare class HttpTransport {
+    private readonly token;
+    private readonly endpoint;
+    private readonly compression;
+    private readonly maxRetries;
+    private compressFn;
+    constructor(options: TransportOptions);
+    /**
+     * Sets the compression function. This allows node and browser
+     * environments to inject their own gzip implementation.
+     */
+    setCompressFn(fn: CompressFn): void;
+    /**
+     * Sends an array of log entries to the ingestion endpoint with
+     * retry logic using exponential backoff.
+     */
+    send(logs: readonly LogEntry[]): Promise<TransportResponse>;
+    private doFetch;
+}
+
+type FlushCallback = (logs: readonly LogEntry[]) => Promise<void>;
+declare class Batcher {
+    private queue;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private readonly maxQueueSize;
+    private readonly onFlush;
+    private timer;
+    constructor(options: BatchOptions, onFlush: FlushCallback);
+    /**
+     * Adds a log entry to the queue. Triggers a flush if the
+     * batch size threshold is reached.
+     */
+    add(entry: LogEntry): void;
+    /**
+     * Flushes all queued log entries by calling the onFlush callback.
+     * Returns a promise that resolves when the flush is complete.
+     */
+    flush(): Promise<void>;
+    /**
+     * Returns the number of entries currently in the queue.
+     */
+    get size(): number;
+    /**
+     * Stops the periodic flush timer and flushes remaining entries.
+     */
+    shutdown(): Promise<void>;
+    private startTimer;
+    private stopTimer;
+}
+
+declare class MihariClient {
+    protected readonly config: MihariConfig;
+    protected readonly transport: HttpTransport;
+    protected readonly batcher: Batcher;
+    constructor(config: MihariConfig);
+    /**
+     * Sets the compression function used by the transport layer.
+     */
+    setCompressFn(fn: CompressFn): void;
+    /**
+     * Logs a debug-level message.
+     */
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs an info-level message.
+     */
+    info(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs a warn-level message.
+     */
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs an error-level message.
+     */
+    error(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs a fatal-level message.
+     */
+    fatal(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Flushes all pending log entries.
+     */
+    flush(): Promise<void>;
+    /**
+     * Shuts down the client, flushing remaining entries.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Creates a log entry and adds it to the batch queue.
+     * Subclasses can override getDefaultMetadata() to inject
+     * environment-specific fields.
+     */
+    log(level: LogLevel, message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Returns default metadata to include with every log entry.
+     * Override in subclasses to add environment-specific fields.
+     */
+    protected getDefaultMetadata(): Record<string, unknown>;
+}
+
+/**
+ * Returns the current timestamp in ISO 8601 format.
+ */
+declare function isoTimestamp(): string;
+/**
+ * Detects whether the current runtime is a browser environment.
+ */
+declare function isBrowser(): boolean;
+/**
+ * Detects whether the current runtime is Node.js.
+ */
+declare function isNode(): boolean;
+/**
+ * Waits for the specified number of milliseconds.
+ */
+declare function sleep(ms: number): Promise<void>;
+
+export { Batcher, type FlushCallback, HttpTransport, MihariClient, isBrowser, isNode, isoTimestamp, sleep };

package/dist/index.d.ts

@@ -1,7 +1,122 @@
-export { MihariClient } from "./client";
-export { HttpTransport } from "./transport";
-export { Batcher } from "./batcher";
-export type { FlushCallback } from "./batcher";
-export { isoTimestamp, isBrowser, isNode, sleep } from "./utils";
-export { LogLevel, LogEntry, MihariConfig, TransportOptions, BatchOptions, TransportResponse, TransportError, CompressFn, } from "@mihari/logger-types";
-//# sourceMappingURL=index.d.ts.map
+import { TransportOptions, CompressFn, LogEntry, TransportResponse, BatchOptions, MihariConfig, LogLevel } from '@mihari/logger-types';
+export { BatchOptions, CompressFn, LogEntry, LogLevel, MihariConfig, TransportError, TransportOptions, TransportResponse } from '@mihari/logger-types';
+
+declare class HttpTransport {
+    private readonly token;
+    private readonly endpoint;
+    private readonly compression;
+    private readonly maxRetries;
+    private compressFn;
+    constructor(options: TransportOptions);
+    /**
+     * Sets the compression function. This allows node and browser
+     * environments to inject their own gzip implementation.
+     */
+    setCompressFn(fn: CompressFn): void;
+    /**
+     * Sends an array of log entries to the ingestion endpoint with
+     * retry logic using exponential backoff.
+     */
+    send(logs: readonly LogEntry[]): Promise<TransportResponse>;
+    private doFetch;
+}
+
+type FlushCallback = (logs: readonly LogEntry[]) => Promise<void>;
+declare class Batcher {
+    private queue;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private readonly maxQueueSize;
+    private readonly onFlush;
+    private timer;
+    constructor(options: BatchOptions, onFlush: FlushCallback);
+    /**
+     * Adds a log entry to the queue. Triggers a flush if the
+     * batch size threshold is reached.
+     */
+    add(entry: LogEntry): void;
+    /**
+     * Flushes all queued log entries by calling the onFlush callback.
+     * Returns a promise that resolves when the flush is complete.
+     */
+    flush(): Promise<void>;
+    /**
+     * Returns the number of entries currently in the queue.
+     */
+    get size(): number;
+    /**
+     * Stops the periodic flush timer and flushes remaining entries.
+     */
+    shutdown(): Promise<void>;
+    private startTimer;
+    private stopTimer;
+}
+
+declare class MihariClient {
+    protected readonly config: MihariConfig;
+    protected readonly transport: HttpTransport;
+    protected readonly batcher: Batcher;
+    constructor(config: MihariConfig);
+    /**
+     * Sets the compression function used by the transport layer.
+     */
+    setCompressFn(fn: CompressFn): void;
+    /**
+     * Logs a debug-level message.
+     */
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs an info-level message.
+     */
+    info(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs a warn-level message.
+     */
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs an error-level message.
+     */
+    error(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Logs a fatal-level message.
+     */
+    fatal(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Flushes all pending log entries.
+     */
+    flush(): Promise<void>;
+    /**
+     * Shuts down the client, flushing remaining entries.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Creates a log entry and adds it to the batch queue.
+     * Subclasses can override getDefaultMetadata() to inject
+     * environment-specific fields.
+     */
+    log(level: LogLevel, message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Returns default metadata to include with every log entry.
+     * Override in subclasses to add environment-specific fields.
+     */
+    protected getDefaultMetadata(): Record<string, unknown>;
+}
+
+/**
+ * Returns the current timestamp in ISO 8601 format.
+ */
+declare function isoTimestamp(): string;
+/**
+ * Detects whether the current runtime is a browser environment.
+ */
+declare function isBrowser(): boolean;
+/**
+ * Detects whether the current runtime is Node.js.
+ */
+declare function isNode(): boolean;
+/**
+ * Waits for the specified number of milliseconds.
+ */
+declare function sleep(ms: number): Promise<void>;
+
+export { Batcher, type FlushCallback, HttpTransport, MihariClient, isBrowser, isNode, isoTimestamp, sleep };

package/dist/index.js

@@ -1,17 +1,321 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogLevel = exports.sleep = exports.isNode = exports.isBrowser = exports.isoTimestamp = exports.Batcher = exports.HttpTransport = exports.MihariClient = void 0;
-var client_1 = require("./client");
-Object.defineProperty(exports, "MihariClient", { enumerable: true, get: function () { return client_1.MihariClient; } });
-var transport_1 = require("./transport");
-Object.defineProperty(exports, "HttpTransport", { enumerable: true, get: function () { return transport_1.HttpTransport; } });
-var batcher_1 = require("./batcher");
-Object.defineProperty(exports, "Batcher", { enumerable: true, get: function () { return batcher_1.Batcher; } });
-var utils_1 = require("./utils");
-Object.defineProperty(exports, "isoTimestamp", { enumerable: true, get: function () { return utils_1.isoTimestamp; } });
-Object.defineProperty(exports, "isBrowser", { enumerable: true, get: function () { return utils_1.isBrowser; } });
-Object.defineProperty(exports, "isNode", { enumerable: true, get: function () { return utils_1.isNode; } });
-Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return utils_1.sleep; } });
-var logger_types_1 = require("@mihari/logger-types");
-Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_types_1.LogLevel; } });
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BatchOptions: () => import_logger_types2.BatchOptions,
+  Batcher: () => Batcher,
+  CompressFn: () => import_logger_types2.CompressFn,
+  HttpTransport: () => HttpTransport,
+  LogEntry: () => import_logger_types2.LogEntry,
+  LogLevel: () => import_logger_types2.LogLevel,
+  MihariClient: () => MihariClient,
+  MihariConfig: () => import_logger_types2.MihariConfig,
+  TransportError: () => import_logger_types2.TransportError,
+  TransportOptions: () => import_logger_types2.TransportOptions,
+  TransportResponse: () => import_logger_types2.TransportResponse,
+  isBrowser: () => isBrowser,
+  isNode: () => isNode,
+  isoTimestamp: () => isoTimestamp,
+  sleep: () => sleep
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_logger_types = require("@mihari/logger-types");
+
+// src/utils.ts
+function isoTimestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function isBrowser() {
+  return typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined" && typeof globalThis.document !== "undefined";
+}
+function isNode() {
+  return typeof process !== "undefined" && process.versions != null && process.versions.node != null;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/transport.ts
+var DEFAULT_RETRIES = 3;
+var RETRY_BASE_DELAY_MS = 1e3;
+var HttpTransport = class {
+  constructor(options) {
+    this.compressFn = null;
+    this.token = options.token;
+    this.endpoint = options.endpoint.replace(/\/+$/, "");
+    this.compression = options.compression ?? true;
+    this.maxRetries = options.retries ?? DEFAULT_RETRIES;
+  }
+  /**
+   * Sets the compression function. This allows node and browser
+   * environments to inject their own gzip implementation.
+   */
+  setCompressFn(fn) {
+    this.compressFn = fn;
+  }
+  /**
+   * Sends an array of log entries to the ingestion endpoint with
+   * retry logic using exponential backoff.
+   */
+  async send(logs) {
+    const payload = JSON.stringify(logs);
+    let body = payload;
+    const headers = {
+      "Authorization": `Bearer ${this.token}`,
+      "Content-Type": "application/json"
+    };
+    if (this.compression && this.compressFn) {
+      const encoded = new TextEncoder().encode(payload);
+      body = await this.compressFn(encoded);
+      headers["Content-Encoding"] = "gzip";
+    }
+    let lastError = null;
+    for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+      try {
+        const response = await this.doFetch(body, headers);
+        if (response.status === 202) {
+          return response.json;
+        }
+        if (response.status === 401) {
+          throw new Error("Invalid or missing authentication token");
+        }
+        if (response.status === 400) {
+          throw new Error("No valid logs found");
+        }
+        throw new Error(`Unexpected response status: ${response.status}`);
+      } catch (err) {
+        lastError = err instanceof Error ? err : new Error(String(err));
+        if (lastError.message === "Invalid or missing authentication token" || lastError.message === "No valid logs found") {
+          throw lastError;
+        }
+        if (attempt < this.maxRetries - 1) {
+          const delay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+          await sleep(delay);
+        }
+      }
+    }
+    throw lastError ?? new Error("Transport failed after retries");
+  }
+  async doFetch(body, headers) {
+    const res = await fetch(`${this.endpoint}`, {
+      method: "POST",
+      headers,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      body
+    });
+    const json = await res.json().catch(() => ({}));
+    return { status: res.status, json };
+  }
+};
+
+// src/batcher.ts
+var DEFAULT_BATCH_SIZE = 10;
+var DEFAULT_FLUSH_INTERVAL_MS = 5e3;
+var DEFAULT_MAX_QUEUE_SIZE = 1e3;
+var Batcher = class {
+  constructor(options, onFlush) {
+    this.queue = [];
+    this.timer = null;
+    this.batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
+    this.flushIntervalMs = options.flushInterval ?? DEFAULT_FLUSH_INTERVAL_MS;
+    this.maxQueueSize = options.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE;
+    this.onFlush = onFlush;
+    this.startTimer();
+  }
+  /**
+   * Adds a log entry to the queue. Triggers a flush if the
+   * batch size threshold is reached.
+   */
+  add(entry) {
+    if (this.queue.length >= this.maxQueueSize) {
+      this.queue.shift();
+    }
+    this.queue = [...this.queue, entry];
+    if (this.queue.length >= this.batchSize) {
+      void this.flush();
+    }
+  }
+  /**
+   * Flushes all queued log entries by calling the onFlush callback.
+   * Returns a promise that resolves when the flush is complete.
+   */
+  async flush() {
+    if (this.queue.length === 0) {
+      return;
+    }
+    const batch = [...this.queue];
+    this.queue = [];
+    try {
+      await this.onFlush(batch);
+    } catch (err) {
+      const combined = [...batch, ...this.queue];
+      this.queue = combined.slice(0, this.maxQueueSize);
+      throw err;
+    }
+  }
+  /**
+   * Returns the number of entries currently in the queue.
+   */
+  get size() {
+    return this.queue.length;
+  }
+  /**
+   * Stops the periodic flush timer and flushes remaining entries.
+   */
+  async shutdown() {
+    this.stopTimer();
+    await this.flush();
+  }
+  startTimer() {
+    if (this.flushIntervalMs > 0) {
+      this.timer = setInterval(() => {
+        void this.flush();
+      }, this.flushIntervalMs);
+      if (typeof this.timer === "object" && "unref" in this.timer) {
+        this.timer.unref();
+      }
+    }
+  }
+  stopTimer() {
+    if (this.timer !== null) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+};
+
+// src/client.ts
+var MihariClient = class {
+  constructor(config) {
+    this.config = config;
+    this.transport = new HttpTransport({
+      token: config.token,
+      endpoint: config.endpoint,
+      compression: config.compression,
+      retries: config.retries
+    });
+    this.batcher = new Batcher(
+      {
+        batchSize: config.batchSize,
+        flushInterval: config.flushInterval,
+        maxQueueSize: config.maxQueueSize
+      },
+      async (logs) => {
+        await this.transport.send(logs);
+      }
+    );
+  }
+  /**
+   * Sets the compression function used by the transport layer.
+   */
+  setCompressFn(fn) {
+    this.transport.setCompressFn(fn);
+  }
+  /**
+   * Logs a debug-level message.
+   */
+  debug(message, metadata) {
+    this.log(import_logger_types.LogLevel.Debug, message, metadata);
+  }
+  /**
+   * Logs an info-level message.
+   */
+  info(message, metadata) {
+    this.log(import_logger_types.LogLevel.Info, message, metadata);
+  }
+  /**
+   * Logs a warn-level message.
+   */
+  warn(message, metadata) {
+    this.log(import_logger_types.LogLevel.Warn, message, metadata);
+  }
+  /**
+   * Logs an error-level message.
+   */
+  error(message, metadata) {
+    this.log(import_logger_types.LogLevel.Error, message, metadata);
+  }
+  /**
+   * Logs a fatal-level message.
+   */
+  fatal(message, metadata) {
+    this.log(import_logger_types.LogLevel.Fatal, message, metadata);
+  }
+  /**
+   * Flushes all pending log entries.
+   */
+  async flush() {
+    await this.batcher.flush();
+  }
+  /**
+   * Shuts down the client, flushing remaining entries.
+   */
+  async shutdown() {
+    await this.batcher.shutdown();
+  }
+  /**
+   * Creates a log entry and adds it to the batch queue.
+   * Subclasses can override getDefaultMetadata() to inject
+   * environment-specific fields.
+   */
+  log(level, message, metadata) {
+    const entry = {
+      dt: isoTimestamp(),
+      level,
+      message,
+      ...this.getDefaultMetadata(),
+      ...this.config.metadata ?? {},
+      ...metadata ?? {}
+    };
+    this.batcher.add(entry);
+  }
+  /**
+   * Returns default metadata to include with every log entry.
+   * Override in subclasses to add environment-specific fields.
+   */
+  getDefaultMetadata() {
+    return {};
+  }
+};
+
+// src/index.ts
+var import_logger_types2 = require("@mihari/logger-types");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BatchOptions,
+  Batcher,
+  CompressFn,
+  HttpTransport,
+  LogEntry,
+  LogLevel,
+  MihariClient,
+  MihariConfig,
+  TransportError,
+  TransportOptions,
+  TransportResponse,
+  isBrowser,
+  isNode,
+  isoTimestamp,
+  sleep
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AACtB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB,iCAAiE;AAAxD,qGAAA,YAAY,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,+FAAA,MAAM,OAAA;AAAE,8FAAA,KAAK,OAAA;AAC/C,qDAS8B;AAR5B,wGAAA,QAAQ,OAAA"}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/utils.ts","../src/transport.ts","../src/batcher.ts"],"sourcesContent":["export { MihariClient } from \"./client\";\nexport { HttpTransport } from \"./transport\";\nexport { Batcher } from \"./batcher\";\nexport type { FlushCallback } from \"./batcher\";\nexport { isoTimestamp, isBrowser, isNode, sleep } from \"./utils\";\nexport {\n  LogLevel,\n  LogEntry,\n  MihariConfig,\n  TransportOptions,\n  BatchOptions,\n  TransportResponse,\n  TransportError,\n  CompressFn,\n} from \"@mihari/logger-types\";\n","import { LogLevel, LogEntry, MihariConfig, CompressFn } from \"@mihari/logger-types\";\nimport { HttpTransport } from \"./transport\";\nimport { Batcher } from \"./batcher\";\nimport { isoTimestamp } from \"./utils\";\n\nexport class MihariClient {\n  protected readonly config: MihariConfig;\n  protected readonly transport: HttpTransport;\n  protected readonly batcher: Batcher;\n\n  constructor(config: MihariConfig) {\n    this.config = config;\n\n    this.transport = new HttpTransport({\n      token: config.token,\n      endpoint: config.endpoint,\n      compression: config.compression,\n      retries: config.retries,\n    });\n\n    this.batcher = new Batcher(\n      {\n        batchSize: config.batchSize,\n        flushInterval: config.flushInterval,\n        maxQueueSize: config.maxQueueSize,\n      },\n      async (logs) => {\n        await this.transport.send(logs);\n      }\n    );\n  }\n\n  /**\n   * Sets the compression function used by the transport layer.\n   */\n  setCompressFn(fn: CompressFn): void {\n    this.transport.setCompressFn(fn);\n  }\n\n  /**\n   * Logs a debug-level message.\n   */\n  debug(message: string, metadata?: Record<string, unknown>): void {\n    this.log(LogLevel.Debug, message, metadata);\n  }\n\n  /**\n   * Logs an info-level message.\n   */\n  info(message: string, metadata?: Record<string, unknown>): void {\n    this.log(LogLevel.Info, message, metadata);\n  }\n\n  /**\n   * Logs a warn-level message.\n   */\n  warn(message: string, metadata?: Record<string, unknown>): void {\n    this.log(LogLevel.Warn, message, metadata);\n  }\n\n  /**\n   * Logs an error-level message.\n   */\n  error(message: string, metadata?: Record<string, unknown>): void {\n    this.log(LogLevel.Error, message, metadata);\n  }\n\n  /**\n   * Logs a fatal-level message.\n   */\n  fatal(message: string, metadata?: Record<string, unknown>): void {\n    this.log(LogLevel.Fatal, message, metadata);\n  }\n\n  /**\n   * Flushes all pending log entries.\n   */\n  async flush(): Promise<void> {\n    await this.batcher.flush();\n  }\n\n  /**\n   * Shuts down the client, flushing remaining entries.\n   */\n  async shutdown(): Promise<void> {\n    await this.batcher.shutdown();\n  }\n\n  /**\n   * Creates a log entry and adds it to the batch queue.\n   * Subclasses can override getDefaultMetadata() to inject\n   * environment-specific fields.\n   */\n  public log(\n    level: LogLevel,\n    message: string,\n    metadata?: Record<string, unknown>\n  ): void {\n    const entry: LogEntry = {\n      dt: isoTimestamp(),\n      level,\n      message,\n      ...this.getDefaultMetadata(),\n      ...(this.config.metadata ?? {}),\n      ...(metadata ?? {}),\n    };\n\n    this.batcher.add(entry);\n  }\n\n  /**\n   * Returns default metadata to include with every log entry.\n   * Override in subclasses to add environment-specific fields.\n   */\n  protected getDefaultMetadata(): Record<string, unknown> {\n    return {};\n  }\n}\n","/**\n * Returns the current timestamp in ISO 8601 format.\n */\nexport function isoTimestamp(): string {\n  return new Date().toISOString();\n}\n\n/**\n * Detects whether the current runtime is a browser environment.\n */\nexport function isBrowser(): boolean {\n  return (\n    typeof globalThis !== \"undefined\" &&\n    typeof (globalThis as Record<string, unknown>).window !== \"undefined\" &&\n    typeof (globalThis as Record<string, unknown>).document !== \"undefined\"\n  );\n}\n\n/**\n * Detects whether the current runtime is Node.js.\n */\nexport function isNode(): boolean {\n  return (\n    typeof process !== \"undefined\" &&\n    process.versions != null &&\n    process.versions.node != null\n  );\n}\n\n/**\n * Waits for the specified number of milliseconds.\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { LogEntry, TransportOptions, TransportResponse, CompressFn } from \"@mihari/logger-types\";\nimport { sleep } from \"./utils\";\n\nconst DEFAULT_RETRIES = 3;\nconst RETRY_BASE_DELAY_MS = 1000;\n\nexport class HttpTransport {\n  private readonly token: string;\n  private readonly endpoint: string;\n  private readonly compression: boolean;\n  private readonly maxRetries: number;\n  private compressFn: CompressFn | null = null;\n\n  constructor(options: TransportOptions) {\n    this.token = options.token;\n    this.endpoint = options.endpoint.replace(/\\/+$/, \"\");\n    this.compression = options.compression ?? true;\n    this.maxRetries = options.retries ?? DEFAULT_RETRIES;\n  }\n\n  /**\n   * Sets the compression function. This allows node and browser\n   * environments to inject their own gzip implementation.\n   */\n  setCompressFn(fn: CompressFn): void {\n    this.compressFn = fn;\n  }\n\n  /**\n   * Sends an array of log entries to the ingestion endpoint with\n   * retry logic using exponential backoff.\n   */\n  async send(logs: readonly LogEntry[]): Promise<TransportResponse> {\n    const payload = JSON.stringify(logs);\n    let body: string | Uint8Array = payload;\n    const headers: Record<string, string> = {\n      \"Authorization\": `Bearer ${this.token}`,\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.compression && this.compressFn) {\n      const encoded = new TextEncoder().encode(payload);\n      body = await this.compressFn(encoded);\n      headers[\"Content-Encoding\"] = \"gzip\";\n    }\n\n    let lastError: Error | null = null;\n\n    for (let attempt = 0; attempt < this.maxRetries; attempt++) {\n      try {\n        const response = await this.doFetch(body, headers);\n\n        if (response.status === 202) {\n          return response.json as TransportResponse;\n        }\n\n        if (response.status === 401) {\n          throw new Error(\"Invalid or missing authentication token\");\n        }\n\n        if (response.status === 400) {\n          throw new Error(\"No valid logs found\");\n        }\n\n        throw new Error(`Unexpected response status: ${response.status}`);\n      } catch (err) {\n        lastError = err instanceof Error ? err : new Error(String(err));\n\n        // Do not retry auth or validation errors\n        if (\n          lastError.message === \"Invalid or missing authentication token\" ||\n          lastError.message === \"No valid logs found\"\n        ) {\n          throw lastError;\n        }\n\n        if (attempt < this.maxRetries - 1) {\n          const delay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);\n          await sleep(delay);\n        }\n      }\n    }\n\n    throw lastError ?? new Error(\"Transport failed after retries\");\n  }\n\n  private async doFetch(\n    body: string | Uint8Array,\n    headers: Record<string, string>\n  ): Promise<{ status: number; json: unknown }> {\n    // Use global fetch (available in Node 18+ and all modern browsers)\n    const res = await fetch(`${this.endpoint}`, {\n      method: \"POST\",\n      headers,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      body: body as any,\n    });\n\n    const json = await res.json().catch(() => ({}));\n    return { status: res.status, json };\n  }\n}\n","import { LogEntry, BatchOptions } from \"@mihari/logger-types\";\n\nconst DEFAULT_BATCH_SIZE = 10;\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_MAX_QUEUE_SIZE = 1000;\n\nexport type FlushCallback = (logs: readonly LogEntry[]) => Promise<void>;\n\nexport class Batcher {\n  private queue: LogEntry[] = [];\n  private readonly batchSize: number;\n  private readonly flushIntervalMs: number;\n  private readonly maxQueueSize: number;\n  private readonly onFlush: FlushCallback;\n  private timer: ReturnType<typeof setInterval> | null = null;\n\n  constructor(options: BatchOptions, onFlush: FlushCallback) {\n    this.batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;\n    this.flushIntervalMs = options.flushInterval ?? DEFAULT_FLUSH_INTERVAL_MS;\n    this.maxQueueSize = options.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE;\n    this.onFlush = onFlush;\n    this.startTimer();\n  }\n\n  /**\n   * Adds a log entry to the queue. Triggers a flush if the\n   * batch size threshold is reached.\n   */\n  add(entry: LogEntry): void {\n    if (this.queue.length >= this.maxQueueSize) {\n      // Drop the oldest entry when the queue is full\n      this.queue.shift();\n    }\n\n    this.queue = [...this.queue, entry];\n\n    if (this.queue.length >= this.batchSize) {\n      void this.flush();\n    }\n  }\n\n  /**\n   * Flushes all queued log entries by calling the onFlush callback.\n   * Returns a promise that resolves when the flush is complete.\n   */\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) {\n      return;\n    }\n\n    const batch = [...this.queue];\n    this.queue = [];\n\n    try {\n      await this.onFlush(batch);\n    } catch (err) {\n      // Re-add entries to the front of the queue on failure,\n      // respecting the max queue size\n      const combined = [...batch, ...this.queue];\n      this.queue = combined.slice(0, this.maxQueueSize);\n      // Rethrow so callers know the flush failed\n      throw err;\n    }\n  }\n\n  /**\n   * Returns the number of entries currently in the queue.\n   */\n  get size(): number {\n    return this.queue.length;\n  }\n\n  /**\n   * Stops the periodic flush timer and flushes remaining entries.\n   */\n  async shutdown(): Promise<void> {\n    this.stopTimer();\n    await this.flush();\n  }\n\n  private startTimer(): void {\n    if (this.flushIntervalMs > 0) {\n      this.timer = setInterval(() => {\n        void this.flush();\n      }, this.flushIntervalMs);\n\n      // Allow the Node.js process to exit even if the timer is active\n      if (typeof this.timer === \"object\" && \"unref\" in this.timer) {\n        this.timer.unref();\n      }\n    }\n  }\n\n  private stopTimer(): void {\n    if (this.timer !== null) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n  }\n}\n"],"mappings":"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","names":["import_logger_types"]}