@mihari/logger-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mihari Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @mihari/logger-core
+
+Core transport, batching, and client logic for the mihari log collection library.
+
+## Installation
+
+```bash
+npm install @mihari/logger-core
+```
+
+## Usage
+
+```typescript
+import { MihariClient } from "@mihari/logger-core";
+
+const client = new MihariClient({
+  token: "your-api-token",
+  endpoint: "https://logs.example.com",
+  batchSize: 10,
+  flushInterval: 5000,
+});
+
+client.info("Hello from core", { module: "auth" });
+
+// Flush manually
+await client.flush();
+
+// Shutdown gracefully
+await client.shutdown();
+```
+
+## Components
+
+- **MihariClient** - Base client with info/warn/error/debug/fatal methods
+- **HttpTransport** - HTTP POST with Bearer auth, gzip support, and retry with exponential backoff
+- **Batcher** - Configurable batching with flush intervals and queue size limits
+
+## License
+
+MIT

package/dist/batcher.d.ts

@@ -0,0 +1,32 @@
+import { LogEntry, BatchOptions } from "@mihari/logger-types";
+export type FlushCallback = (logs: readonly LogEntry[]) => Promise<void>;
+export 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;
+}
+//# sourceMappingURL=batcher.d.ts.map

package/dist/batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../src/batcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAM9D,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,KAAK,CAA+C;gBAEhD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa;IAQzD;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAa1B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,SAAS;CAMlB"}

package/dist/batcher.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Batcher = void 0;
+const DEFAULT_BATCH_SIZE = 10;
+const DEFAULT_FLUSH_INTERVAL_MS = 5000;
+const DEFAULT_MAX_QUEUE_SIZE = 1000;
+class Batcher {
+    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) {
+            // Drop the oldest entry when the queue is full
+            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) {
+            // Re-add entries to the front of the queue on failure,
+            // respecting the max queue size
+            const combined = [...batch, ...this.queue];
+            this.queue = combined.slice(0, this.maxQueueSize);
+            // Rethrow so callers know the flush failed
+            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);
+            // Allow the Node.js process to exit even if the timer is active
+            if (typeof this.timer === "object" && "unref" in this.timer) {
+                this.timer.unref();
+            }
+        }
+    }
+    stopTimer() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+exports.Batcher = Batcher;
+//# sourceMappingURL=batcher.js.map

package/dist/batcher.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,53 @@
+import { LogLevel, MihariConfig, CompressFn } from "@mihari/logger-types";
+import { HttpTransport } from "./transport";
+import { Batcher } from "./batcher";
+export 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>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAY,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,YAAY;IACvB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IACxC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAExB,MAAM,EAAE,YAAY;IAsBhC;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAInC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;OAIG;IACI,GAAG,CACR,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAaP;;;OAGG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGxD"}

package/dist/client.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MihariClient = void 0;
+const logger_types_1 = require("@mihari/logger-types");
+const transport_1 = require("./transport");
+const batcher_1 = require("./batcher");
+const utils_1 = require("./utils");
+class MihariClient {
+    constructor(config) {
+        this.config = config;
+        this.transport = new transport_1.HttpTransport({
+            token: config.token,
+            endpoint: config.endpoint,
+            compression: config.compression,
+            retries: config.retries,
+        });
+        this.batcher = new batcher_1.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(logger_types_1.LogLevel.Debug, message, metadata);
+    }
+    /**
+     * Logs an info-level message.
+     */
+    info(message, metadata) {
+        this.log(logger_types_1.LogLevel.Info, message, metadata);
+    }
+    /**
+     * Logs a warn-level message.
+     */
+    warn(message, metadata) {
+        this.log(logger_types_1.LogLevel.Warn, message, metadata);
+    }
+    /**
+     * Logs an error-level message.
+     */
+    error(message, metadata) {
+        this.log(logger_types_1.LogLevel.Error, message, metadata);
+    }
+    /**
+     * Logs a fatal-level message.
+     */
+    fatal(message, metadata) {
+        this.log(logger_types_1.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: (0, utils_1.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 {};
+    }
+}
+exports.MihariClient = MihariClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,uDAAoF;AACpF,2CAA4C;AAC5C,uCAAoC;AACpC,mCAAuC;AAEvC,MAAa,YAAY;IAKvB,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,SAAS,GAAG,IAAI,yBAAa,CAAC;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CACxB;YACE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,EAAc;QAC1B,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,QAAkC;QACvD,IAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,QAAkC;QACtD,IAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,QAAkC;QACtD,IAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,QAAkC;QACvD,IAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,QAAkC;QACvD,IAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,GAAG,CACR,KAAe,EACf,OAAe,EACf,QAAkC;QAElC,MAAM,KAAK,GAAa;YACtB,EAAE,EAAE,IAAA,oBAAY,GAAE;YAClB,KAAK;YACL,OAAO;YACP,GAAG,IAAI,CAAC,kBAAkB,EAAE;YAC5B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC/B,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;SACpB,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACO,kBAAkB;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAhHD,oCAgHC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+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

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+"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; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/transport.d.ts

@@ -0,0 +1,21 @@
+import { LogEntry, TransportOptions, TransportResponse, CompressFn } from "@mihari/logger-types";
+export 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;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMjG,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAA2B;gBAEjC,OAAO,EAAE,gBAAgB;IAOrC;;;OAGG;IACH,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAInC;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAsDnD,OAAO;CAetB"}

package/dist/transport.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpTransport = void 0;
+const utils_1 = require("./utils");
+const DEFAULT_RETRIES = 3;
+const RETRY_BASE_DELAY_MS = 1000;
+class HttpTransport {
+    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));
+                // Do not retry auth or validation errors
+                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 (0, utils_1.sleep)(delay);
+                }
+            }
+        }
+        throw lastError ?? new Error("Transport failed after retries");
+    }
+    async doFetch(body, headers) {
+        // Use global fetch (available in Node 18+ and all modern browsers)
+        const res = await fetch(`${this.endpoint}`, {
+            method: "POST",
+            headers,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            body: body,
+        });
+        const json = await res.json().catch(() => ({}));
+        return { status: res.status, json };
+    }
+}
+exports.HttpTransport = HttpTransport;
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns the current timestamp in ISO 8601 format.
+ */
+export declare function isoTimestamp(): string;
+/**
+ * Detects whether the current runtime is a browser environment.
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Detects whether the current runtime is Node.js.
+ */
+export declare function isNode(): boolean;
+/**
+ * Waits for the specified number of milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAMhC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isoTimestamp = isoTimestamp;
+exports.isBrowser = isBrowser;
+exports.isNode = isNode;
+exports.sleep = sleep;
+/**
+ * Returns the current timestamp in ISO 8601 format.
+ */
+function isoTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Detects whether the current runtime is a browser environment.
+ */
+function isBrowser() {
+    return (typeof globalThis !== "undefined" &&
+        typeof globalThis.window !== "undefined" &&
+        typeof globalThis.document !== "undefined");
+}
+/**
+ * Detects whether the current runtime is Node.js.
+ */
+function isNode() {
+    return (typeof process !== "undefined" &&
+        process.versions != null &&
+        process.versions.node != null);
+}
+/**
+ * Waits for the specified number of milliseconds.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAGA,oCAEC;AAKD,8BAMC;AAKD,wBAMC;AAKD,sBAEC;AAlCD;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAAsC,CAAC,MAAM,KAAK,WAAW;QACrE,OAAQ,UAAsC,CAAC,QAAQ,KAAK,WAAW,CACxE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM;IACpB,OAAO,CACL,OAAO,OAAO,KAAK,WAAW;QAC9B,OAAO,CAAC,QAAQ,IAAI,IAAI;QACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAC9B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@mihari/logger-core",
+  "version": "0.1.0",
+  "description": "Core transport, batching, and client logic for mihari",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "cd ../.. && npx vitest run --config vitest.config.ts packages/core"
+  },
+  "dependencies": {
+    "@mihari/logger-types": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mihari/mihari-js",
+    "directory": "packages/core"
+  },
+  "gitHead": "dc10a3217caa819965eb3a1e2ff3901a16e510aa"
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+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";