@spinajs/log-source-graphana-loki 2.0.481 → 2.0.482

package/lib/cjs/index.d.ts

@@ -1,9 +1,31 @@
 import { IInstanceCheck } from "@spinajs/di";
-import { Log, ILogEntry, LogTarget, ICommonTargetOptions } from "@spinajs/log";
-import { Axios } from "axios";
+import { Log, ILogEntry, LogTarget, ICommonTargetOptions, BatchQueue } from "@spinajs/log";
+import { AxiosInstance } from "axios";
+import { ResiliencePipeline } from "@spinajs/util";
+/**
+ * Decide whether a failed Loki push is worth retrying.
+ *
+ * Retryable: any error without an HTTP response ( network / timeout / DNS, eg.
+ * ECONNREFUSED / ETIMEDOUT / ECONNRESET / EAI_AGAIN ), or an HTTP response with
+ * status 429 / 502 / 503 / 504. Everything else ( 4xx client errors like 400 /
+ * 401 / 403 / 404, and any other status ) is treated as a permanent error that
+ * must surface rather than loop forever.
+ */
+export declare function isRetryableLokiError(error: unknown): boolean;
+/**
+ * Read a `Retry-After` header from a Loki error response and return the delay in
+ * milliseconds. Supports both the numeric ( delta-seconds ) and HTTP-date forms.
+ * Returns `undefined` when there is no usable header.
+ */
+export declare function retryAfterMs(error: unknown): number | undefined;
 export interface IGraphanaOptions extends ICommonTargetOptions {
     interval: number;
     bufferSize: number;
+    /**
+     * Hard cap on the number of entries retained for retry. When a flush fails and the
+     * retained + newly buffered entries exceed this, the oldest are dropped.
+     */
+    maxBufferSize: number;
     timeout: number;
     host: string;
     auth: {
@@ -14,24 +36,38 @@ export interface IGraphanaOptions extends ICommonTargetOptions {
         app: string;
     };
 }
-declare enum TargetStatus {
-    WRITTING = 0,
-    PENDING = 1,
-    IDLE = 2
-}
 export declare class GraphanaLokiLogTarget extends LogTarget<IGraphanaOptions> implements IInstanceCheck {
     protected Log: Log;
-    protected Entries: ILogEntry[];
-    protected WriteEntries: ILogEntry[];
-    protected Status: TargetStatus;
-    protected FlushTimer: NodeJS.Timeout;
-    protected AxiosInstance: Axios;
+    /**
+     * The single buffered-batch queue that owns accumulation, the flush timer and
+     * the maxQueue cap. The actual Loki push happens in `send`, wired as its
+     * `onFlush`.
+     */
+    protected Queue: BatchQueue<ILogEntry>;
+    /**
+     * Set true when the queue overflows maxBufferSize, so the drop warning is
+     * emitted ONCE per overflow episode and reset when a flush succeeds.
+     */
+    protected Overflowed: boolean;
+    protected AxiosInstance: AxiosInstance;
+    /**
+     * Reusable resilience pipeline guarding the Loki push with exponential
+     * backoff + jitter, honoring `Retry-After` and only retrying transient errors.
+     */
+    protected RetryPipeline: ResiliencePipeline<void>;
     constructor(options: IGraphanaOptions);
     __checkInstance__(creationOptions: IGraphanaOptions[]): boolean;
     resolve(): void;
     write(data: ILogEntry): void;
+    forceFlush(): Promise<void>;
     dispose(): Promise<void>;
-    protected flush(): void;
+    /**
+     * Push a single batch to Loki. Wired as the queue's `onFlush`.
+     *
+     * MUST resolve ( never reject ) so shutdown()/forceFlush() cannot reject: on a
+     * retryable-exhausted failure the batch is requeued at the front, on a
+     * non-retryable error it is dropped and surfaced via HasError/Error.
+     */
+    protected send(batch: ILogEntry[]): Promise<void>;
 }
-export {};
 //# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAgC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAU,MAAM,cAAc,CAAC;AAGvF,OAAc,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGrC,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAE5D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAWD,aAAK,YAAY;IACf,QAAQ,IAAA;IACR,OAAO,IAAA;IACP,IAAI,IAAA;CACL;AAID,qBAEa,qBAAsB,SAAQ,SAAS,CAAC,gBAAgB,CAAE,YAAW,cAAc;IAE9F,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEnB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,CAAM;IACpC,SAAS,CAAC,YAAY,EAAE,SAAS,EAAE,CAAM;IAEzC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAqB;IAEnD,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC;IACrC,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC;gBAEnB,OAAO,EAAE,gBAAgB;IAarC,iBAAiB,CAAC,eAAe,EAAE,gBAAgB,EAAE,GAAG,OAAO;IAIxD,OAAO,IAAI,IAAI;IAyBf,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IA2BtB,OAAO;IAWpB,SAAS,CAAC,KAAK;CA8ChB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAgC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAU,UAAU,EAAE,MAAM,cAAc,CAAC;AAGnG,OAAc,EAAc,aAAa,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAe,kBAAkB,EAAuC,MAAM,eAAe,CAAC;AAQrG;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAwB/D;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAE5D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAaD,qBAEa,qBAAsB,SAAQ,SAAS,CAAC,gBAAgB,CAAE,YAAW,cAAc;IAE9F,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEnB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAEvC;;;OAGG;IACH,SAAS,CAAC,UAAU,UAAS;IAE7B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IAEvC;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAEtC,OAAO,EAAE,gBAAgB;IAoBrC,iBAAiB,CAAC,eAAe,EAAE,gBAAgB,EAAE,GAAG,OAAO;IAIxD,OAAO,IAAI,IAAI;IA8Df,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAY5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO;IAKpB;;;;;;OAMG;cACa,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkExD"}

package/lib/cjs/index.js

@@ -13,97 +13,174 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GraphanaLokiLogTarget = void 0;
+exports.isRetryableLokiError = isRetryableLokiError;
+exports.retryAfterMs = retryAfterMs;
 /* eslint-disable promise/always-return */
 /* eslint-disable security/detect-object-injection */
 const configuration_common_1 = require("@spinajs/configuration-common");
 const di_1 = require("@spinajs/di");
 const log_1 = require("@spinajs/log");
 const axios_1 = __importDefault(require("axios"));
-var TargetStatus;
-(function (TargetStatus) {
-    TargetStatus[TargetStatus["WRITTING"] = 0] = "WRITTING";
-    TargetStatus[TargetStatus["PENDING"] = 1] = "PENDING";
-    TargetStatus[TargetStatus["IDLE"] = 2] = "IDLE";
-})(TargetStatus || (TargetStatus = {}));
+const util_1 = require("@spinajs/util");
+/**
+ * HTTP status codes worth retrying against Loki: rate limiting and transient
+ * upstream / gateway failures.
+ */
+const RETRYABLE_STATUS = new Set([429, 502, 503, 504]);
+/**
+ * Decide whether a failed Loki push is worth retrying.
+ *
+ * Retryable: any error without an HTTP response ( network / timeout / DNS, eg.
+ * ECONNREFUSED / ETIMEDOUT / ECONNRESET / EAI_AGAIN ), or an HTTP response with
+ * status 429 / 502 / 503 / 504. Everything else ( 4xx client errors like 400 /
+ * 401 / 403 / 404, and any other status ) is treated as a permanent error that
+ * must surface rather than loop forever.
+ */
+function isRetryableLokiError(error) {
+    const status = error?.response?.status;
+    // No HTTP response -> network / timeout / DNS failure ( axios reports these
+    // without a `.response`, carrying codes like ECONNREFUSED / ETIMEDOUT /
+    // ECONNRESET / EAI_AGAIN ) -> retryable.
+    if (status === undefined) {
+        return true;
+    }
+    return RETRYABLE_STATUS.has(status);
+}
+/**
+ * Read a `Retry-After` header from a Loki error response and return the delay in
+ * milliseconds. Supports both the numeric ( delta-seconds ) and HTTP-date forms.
+ * Returns `undefined` when there is no usable header.
+ */
+function retryAfterMs(error) {
+    const err = error;
+    const headers = err?.response?.headers;
+    const raw = headers?.["retry-after"];
+    if (raw === undefined || raw === null) {
+        return undefined;
+    }
+    const value = Array.isArray(raw) ? raw[0] : raw;
+    // numeric delta-seconds ( either a real number or a numeric string )
+    const asNumber = typeof value === "number" ? value : Number(value);
+    if (typeof value !== "boolean" && !Number.isNaN(asNumber) && `${value}`.trim() !== "") {
+        return Math.max(0, asNumber * 1000);
+    }
+    // HTTP-date form
+    const asDate = Date.parse(String(value));
+    if (!Number.isNaN(asDate)) {
+        return Math.max(0, asDate - Date.now());
+    }
+    return undefined;
+}
 // we mark per instance check becouse we can have multiple file targes
 // for different files/paths/logs but we dont want to create every time writer for same.
 let GraphanaLokiLogTarget = class GraphanaLokiLogTarget extends log_1.LogTarget {
     constructor(options) {
         super(options);
-        this.Entries = [];
-        this.WriteEntries = [];
-        this.Status = TargetStatus.IDLE;
+        /**
+         * Set true when the queue overflows maxBufferSize, so the drop warning is
+         * emitted ONCE per overflow episode and reset when a flush succeeds.
+         */
+        this.Overflowed = false;
+        // Config-driven targets ( resolved through the logger config ) nest their
+        // settings under an `options` sub-object ( like FileTarget ), while direct
+        // construction passes them flat. Hoist any nested options onto this.Options
+        // at highest precedence so both forms resolve the same flat reads below.
+        const nested = (options?.options ?? {});
         this.Options = Object.assign({
             interval: 3000,
             bufferSize: 10,
+            maxBufferSize: 1000,
             timeout: 1000,
-        }, this.Options);
+        }, this.Options, nested);
     }
     __checkInstance__(creationOptions) {
         return this.Options.name === creationOptions[0].name;
     }
     resolve() {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        // A Loki endpoint may be unauthenticated: only attach the Basic auth header
+        // when credentials are actually configured, so a config without `auth`
+        // doesn't throw on `auth.username`.
+        if (this.Options.auth?.username) {
+            headers.Authorization = `Basic ${Buffer.from(`${this.Options.auth.username}:${this.Options.auth.password}`).toString("base64")}`;
+        }
         this.AxiosInstance = axios_1.default.create({
             baseURL: this.Options.host,
-            headers: {
-                "Content-Type": "application/json",
-                Authorization: `Basic ${Buffer.from(`${this.Options.auth.username}:${this.Options.auth.password}`).toString("base64")}`,
-            },
+            headers,
             timeout: this.Options.timeout,
         });
-        this.FlushTimer = setInterval(() => {
-            // do not flush, if we already writting to file
-            if (this.Status !== TargetStatus.IDLE) {
-                return;
-            }
-            this.WriteEntries = [...this.WriteEntries, ...this.Entries];
-            this.Entries = [];
-            setImmediate(() => {
-                this.flush();
-            });
-        }, this.Options.interval ?? 3000);
+        // one reusable pipeline: exponential backoff + jitter, 5 attempts, 1s..5s,
+        // honoring Retry-After and retrying only transient errors ( network + 429 /
+        // 502 / 503 / 504 ). Non-retryable errors fall straight through to .catch.
+        this.RetryPipeline = new util_1.ResiliencePipelineBuilder()
+            .addRetry({
+            MaxRetryAttempts: 5,
+            Delay: util_1.TimeSpan.fromSeconds(1),
+            MaxDelay: util_1.TimeSpan.fromSeconds(5),
+            BackoffType: util_1.BackoffType.Exponential,
+            UseJitter: true,
+            ShouldHandle: (o) => o.Error !== undefined && isRetryableLokiError(o.Error),
+            DelayGenerator: ({ Outcome }) => {
+                const ms = retryAfterMs(Outcome.Error);
+                return ms !== undefined ? util_1.TimeSpan.fromMilliseconds(ms) : undefined;
+            },
+        })
+            .build();
+        // one BatchQueue owns accumulation, the periodic flush timer and the
+        // maxQueue cap ( dropping the oldest ). The actual push happens in send().
+        this.Queue = new log_1.BatchQueue({
+            maxBatch: this.Options.bufferSize,
+            maxQueue: this.Options.maxBufferSize,
+            flushIntervalMs: this.Options.interval ?? 3000,
+            onFlush: (batch) => this.send(batch),
+            onOverflow: (droppedItems) => {
+                // emit the drop warning ONCE per overflow episode; reset on the next
+                // successful send() so a later episode warns again.
+                if (!this.Overflowed) {
+                    this.Overflowed = true;
+                    this.Log.warn(`Graphana loki buffer exceeded ${this.Options.maxBufferSize} entries, dropped ${droppedItems.length} oldest entries.`);
+                }
+                // spill each dropped entry to the fallback ( if a wrapper wired one ) so
+                // a durable target catches exactly what overflow discarded.
+                for (const entry of droppedItems) {
+                    this.OnDropped?.(entry);
+                }
+            },
+        });
+        super.resolve();
     }
     write(data) {
         if (!this.Options.enabled) {
             return;
         }
         data.Variables["n_timestamp"] = new Date().getTime() * 1000000;
-        this.Entries.push(data);
-        // if we already writting, skip buffer check & write to file
-        // wait until write is finished
-        if (this.Status !== TargetStatus.IDLE) {
-            return;
-        }
-        if (this.Entries.length >= this.Options.bufferSize) {
-            this.Status = TargetStatus.PENDING;
-            this.WriteEntries = [...this.WriteEntries, ...this.Entries];
-            this.Entries = [];
-            // write at end of nodejs event loop all buffered messages at once
-            setImmediate(() => {
-                this.flush();
-            });
-        }
+        // fire-and-forget: Loki did not await the buffer write before either. A
+        // size-triggered flush ( when the batch fills ) runs in the background.
+        void this.Queue.enqueue(data);
+    }
+    forceFlush() {
+        return this.Queue ? this.Queue.forceFlush() : Promise.resolve();
     }
     async dispose() {
-        // stop flush timer
-        clearInterval(this.FlushTimer);
-        this.WriteEntries = [...this.WriteEntries, ...this.Entries];
-        this.Entries = [];
-        // write all messages from buffer
-        this.flush();
+        // stop the flush timer and perform a final best-effort flush.
+        await this.Queue.shutdown();
     }
-    flush() {
-        if (this.WriteEntries.length === 0) {
-            this.Status = TargetStatus.IDLE;
-            return;
-        }
+    /**
+     * Push a single batch to Loki. Wired as the queue's `onFlush`.
+     *
+     * MUST resolve ( never reject ) so shutdown()/forceFlush() cannot reject: on a
+     * retryable-exhausted failure the batch is requeued at the front, on a
+     * non-retryable error it is dropped and surfaced via HasError/Error.
+     */
+    async send(batch) {
         const streams = new Map();
         const keyFor = (x) => {
             return [this.Options.labels.app, x.Variables.logger, x.Variables.level, ...Object.values(this.Options.labels)].join("-");
         };
         const valFor = (x) => [x.Variables["n_timestamp"].toString(), (0, configuration_common_1.format)(x.Variables, this.Options.layout)];
-        this.Status = TargetStatus.WRITTING;
-        this.WriteEntries.forEach((x) => {
+        batch.forEach((x) => {
             const key = keyFor(x);
             const stream = streams.get(key);
             if (!stream) {
@@ -119,17 +196,40 @@ let GraphanaLokiLogTarget = class GraphanaLokiLogTarget extends log_1.LogTarget
             }
             stream.values.push(valFor(x));
         });
-        this.AxiosInstance.post("/loki/api/v1/push", { streams: [...streams.values()] })
-            .then(() => {
-            this.Status = TargetStatus.IDLE;
-            this.Log.trace(`Wrote buffered messages to graphana target at url ${this.Options.host}, ${this.WriteEntries.length} messages.`);
-            this.WriteEntries = [];
-        })
-            .catch((err) => {
-            // log error message to others if applicable eg. console
-            this.Log.error(err, `Cannot write log messages to  graphana target`);
-            this.Status = TargetStatus.IDLE;
-        });
+        // wrap ONLY the push in the resilience pipeline: transient failures are
+        // retried inline with backoff; we reach the catch only after retries are
+        // exhausted or immediately on a non-retryable error.
+        try {
+            await this.RetryPipeline.execute(() => this.AxiosInstance.post("/loki/api/v1/push", { streams: [...streams.values()] }).then(() => undefined));
+            // successful write -> clear any previous error state
+            this.HasError = false;
+            this.Error = null;
+            // drained successfully - allow the next overflow episode to warn again
+            this.Overflowed = false;
+            this.Log.trace(`Wrote buffered messages to graphana target at url ${this.Options.host}, ${batch.length} messages.`);
+        }
+        catch (err) {
+            // reached only after retries are exhausted ( transient ) or immediately
+            // for a non-retryable error.
+            this.HasError = true;
+            this.Error = err;
+            if (isRetryableLokiError(err)) {
+                // retryable but exhausted: put the batch back at the front so the next
+                // flush retries it. The queue enforces the maxQueue cap ( dropping the
+                // oldest + onOverflow ) so the retry buffer never grows without bound.
+                this.Log.error(err, `Cannot write log messages to graphana target - retries exhausted, retaining entries for next flush.`);
+                this.Queue.requeueFront(batch);
+                return;
+            }
+            // permanent error ( eg. 400 malformed, 401 bad auth ): retrying forever
+            // would only hide a config problem. Drop the batch and surface it, but
+            // first spill each undelivered entry to the fallback ( if a wrapper wired
+            // one ) so a durable target catches exactly what was not delivered.
+            for (const entry of batch) {
+                this.OnDropped?.(entry);
+            }
+            this.Log.error(err, `Cannot write log messages to graphana target - dropping ${batch.length} entries because the error is non-retryable.`);
+        }
     }
 };
 exports.GraphanaLokiLogTarget = GraphanaLokiLogTarget;

package/lib/cjs/index.js.map

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

package/lib/mjs/index.d.ts

@@ -1,9 +1,31 @@
 import { IInstanceCheck } from "@spinajs/di";
-import { Log, ILogEntry, LogTarget, ICommonTargetOptions } from "@spinajs/log";
-import { Axios } from "axios";
+import { Log, ILogEntry, LogTarget, ICommonTargetOptions, BatchQueue } from "@spinajs/log";
+import { AxiosInstance } from "axios";
+import { ResiliencePipeline } from "@spinajs/util";
+/**
+ * Decide whether a failed Loki push is worth retrying.
+ *
+ * Retryable: any error without an HTTP response ( network / timeout / DNS, eg.
+ * ECONNREFUSED / ETIMEDOUT / ECONNRESET / EAI_AGAIN ), or an HTTP response with
+ * status 429 / 502 / 503 / 504. Everything else ( 4xx client errors like 400 /
+ * 401 / 403 / 404, and any other status ) is treated as a permanent error that
+ * must surface rather than loop forever.
+ */
+export declare function isRetryableLokiError(error: unknown): boolean;
+/**
+ * Read a `Retry-After` header from a Loki error response and return the delay in
+ * milliseconds. Supports both the numeric ( delta-seconds ) and HTTP-date forms.
+ * Returns `undefined` when there is no usable header.
+ */
+export declare function retryAfterMs(error: unknown): number | undefined;
 export interface IGraphanaOptions extends ICommonTargetOptions {
     interval: number;
     bufferSize: number;
+    /**
+     * Hard cap on the number of entries retained for retry. When a flush fails and the
+     * retained + newly buffered entries exceed this, the oldest are dropped.
+     */
+    maxBufferSize: number;
     timeout: number;
     host: string;
     auth: {
@@ -14,24 +36,38 @@ export interface IGraphanaOptions extends ICommonTargetOptions {
         app: string;
     };
 }
-declare enum TargetStatus {
-    WRITTING = 0,
-    PENDING = 1,
-    IDLE = 2
-}
 export declare class GraphanaLokiLogTarget extends LogTarget<IGraphanaOptions> implements IInstanceCheck {
     protected Log: Log;
-    protected Entries: ILogEntry[];
-    protected WriteEntries: ILogEntry[];
-    protected Status: TargetStatus;
-    protected FlushTimer: NodeJS.Timeout;
-    protected AxiosInstance: Axios;
+    /**
+     * The single buffered-batch queue that owns accumulation, the flush timer and
+     * the maxQueue cap. The actual Loki push happens in `send`, wired as its
+     * `onFlush`.
+     */
+    protected Queue: BatchQueue<ILogEntry>;
+    /**
+     * Set true when the queue overflows maxBufferSize, so the drop warning is
+     * emitted ONCE per overflow episode and reset when a flush succeeds.
+     */
+    protected Overflowed: boolean;
+    protected AxiosInstance: AxiosInstance;
+    /**
+     * Reusable resilience pipeline guarding the Loki push with exponential
+     * backoff + jitter, honoring `Retry-After` and only retrying transient errors.
+     */
+    protected RetryPipeline: ResiliencePipeline<void>;
     constructor(options: IGraphanaOptions);
     __checkInstance__(creationOptions: IGraphanaOptions[]): boolean;
     resolve(): void;
     write(data: ILogEntry): void;
+    forceFlush(): Promise<void>;
     dispose(): Promise<void>;
-    protected flush(): void;
+    /**
+     * Push a single batch to Loki. Wired as the queue's `onFlush`.
+     *
+     * MUST resolve ( never reject ) so shutdown()/forceFlush() cannot reject: on a
+     * retryable-exhausted failure the batch is requeued at the front, on a
+     * non-retryable error it is dropped and surfaced via HasError/Error.
+     */
+    protected send(batch: ILogEntry[]): Promise<void>;
 }
-export {};
 //# sourceMappingURL=index.d.ts.map

package/lib/mjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAgC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAU,MAAM,cAAc,CAAC;AAGvF,OAAc,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGrC,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAE5D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAWD,aAAK,YAAY;IACf,QAAQ,IAAA;IACR,OAAO,IAAA;IACP,IAAI,IAAA;CACL;AAID,qBAEa,qBAAsB,SAAQ,SAAS,CAAC,gBAAgB,CAAE,YAAW,cAAc;IAE9F,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEnB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,CAAM;IACpC,SAAS,CAAC,YAAY,EAAE,SAAS,EAAE,CAAM;IAEzC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAqB;IAEnD,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC;IACrC,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC;gBAEnB,OAAO,EAAE,gBAAgB;IAarC,iBAAiB,CAAC,eAAe,EAAE,gBAAgB,EAAE,GAAG,OAAO;IAIxD,OAAO,IAAI,IAAI;IAyBf,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IA2BtB,OAAO;IAWpB,SAAS,CAAC,KAAK;CA8ChB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAgC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAU,UAAU,EAAE,MAAM,cAAc,CAAC;AAGnG,OAAc,EAAc,aAAa,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAe,kBAAkB,EAAuC,MAAM,eAAe,CAAC;AAQrG;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAwB/D;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAE5D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAaD,qBAEa,qBAAsB,SAAQ,SAAS,CAAC,gBAAgB,CAAE,YAAW,cAAc;IAE9F,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEnB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAEvC;;;OAGG;IACH,SAAS,CAAC,UAAU,UAAS;IAE7B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IAEvC;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAEtC,OAAO,EAAE,gBAAgB;IAoBrC,iBAAiB,CAAC,eAAe,EAAE,gBAAgB,EAAE,GAAG,OAAO;IAIxD,OAAO,IAAI,IAAI;IA8Df,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAY5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO;IAKpB;;;;;;OAMG;cACa,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkExD"}