logroller 2.0.2 → 2.1.1

package/dist/index.esm.js

@@ -1,1077 +1,2 @@
-/*! logroller v2.0.1 | MIT License */
-import { randomUUID } from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-import { Writable } from 'node:stream';
-import zlib from 'node:zlib';
-import { pipeline } from 'node:stream/promises';
-
-/** `stat().size` guarded to 0; string paths only. */
-const statSizeSafe = (p) => {
-    try {
-        return typeof p === "string" ? fs.statSync(p).size : 0;
-    }
-    catch {
-        return 0;
-    }
-};
-const existsSafe = (p) => {
-    try {
-        return fs.existsSync(p);
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Compress `src` → `dst`, deleting `src` ONLY on verified success.
- * On failure removes the partial `dst` and reports via callback —
- * logs degrade to uncompressed rather than losing data.
- */
-async function gzipMove(src, dst, onWarn) {
-    try {
-        await pipeline(fs.createReadStream(src), zlib.createGzip({ level: 6 }), fs.createWriteStream(dst));
-        await fs.promises.unlink(src);
-        return true;
-    }
-    catch (err) {
-        await fs.promises.unlink(dst).catch(() => { });
-        onWarn?.(err);
-        return false;
-    }
-}
-const endStream = (ws) => ws ? new Promise((resolve) => ws.end(() => resolve())) : Promise.resolve();
-
-const UNITS = {
-    b: 1, k: 1024, kb: 1024,
-    m: 1048576, mb: 1048576,
-    g: 1073741824, gb: 1073741824,
-};
-const FREQ_MULT = {
-    ms: 1, s: 1000, m: 60_000, h: 3_600_000,
-};
-function parseDuration(value, defaultUnit, fieldName) {
-    if (typeof value === "number") {
-        return Math.round(value * FREQ_MULT[defaultUnit]);
-    }
-    const m = /^\s*(-?\d+(?:\.\d+)?)\s*(ms|s|m|h)?\s*$/i.exec(value);
-    if (!m)
-        throw new Error(`Invalid ${fieldName} "${value}"`);
-    return Math.round(Number.parseFloat(m[1]) * FREQ_MULT[(m[2] ?? defaultUnit).toLowerCase()]);
-}
-function parseSize(v) {
-    if (v === undefined || v === null || v === 0)
-        return 0;
-    if (typeof v === "number")
-        return v;
-    const m = /^\s*(\d+(?:\.\d+)?)\s*(b|kb|k|mb|m|gb|g)?\s*$/i.exec(v);
-    if (!m)
-        throw new Error(`Invalid maxSize "${v}"`);
-    return Math.round(Number.parseFloat(m[1]) * (UNITS[m[2]?.toLowerCase()] ?? 1));
-}
-function parseMaxFiles(v) {
-    if (v === undefined || v === null || v === "" || v === 0)
-        return null;
-    if (typeof v === "number")
-        return { count: v };
-    const m = /^\s*(\d+)\s*d\s*$/i.exec(v);
-    if (m)
-        return { days: Number.parseInt(m[1], 10) };
-    const n = /^\s*(\d+)\s*$/.exec(v);
-    if (n)
-        return { count: Number.parseInt(n[1], 10) };
-    throw new Error(`Invalid maxFiles "${v}"`);
-}
-function parseFrequency(v) {
-    if (v === undefined || v === null)
-        return { type: "daily" };
-    if (v === "daily")
-        return { type: "daily" };
-    if (typeof v === "number") {
-        if (v <= 0)
-            throw new Error(`Invalid frequency "${v}"`);
-        return { type: "interval", ms: v };
-    }
-    const m = /^\s*(\d+)\s*(ms|s|m|h)\s*$/i.exec(v);
-    if (!m)
-        throw new Error(`Invalid frequency "${v}"`);
-    return { type: "interval", ms: Number.parseInt(m[1], 10) * FREQ_MULT[m[2].toLowerCase()] };
-}
-function parseClockOffset(v) {
-    if (v === undefined || v === null || v === "")
-        return 0;
-    return parseDuration(v, "h", "addHours");
-}
-function parseClockStep(v) {
-    if (v === undefined || v === null || v === "")
-        return 0;
-    return parseDuration(v, "h", "addHours");
-}
-
-/* Timezone-aware helpers built exclusively on Intl (zero deps). */
-const _dtfCache = new Map();
-/** Cached `Intl.DateTimeFormat`; throws synchronously for invalid zones. */
-function getDtf(tz) {
-    let dtf = _dtfCache.get(tz);
-    if (!dtf) {
-        try {
-            dtf = new Intl.DateTimeFormat("en-US", {
-                timeZone: tz,
-                hourCycle: "h23",
-                year: "numeric",
-                month: "2-digit",
-                day: "2-digit",
-                hour: "2-digit",
-                minute: "2-digit",
-                second: "2-digit",
-            });
-        }
-        catch {
-            throw new Error(`Invalid timeZone "${tz}"`);
-        }
-        _dtfCache.set(tz, dtf);
-    }
-    return dtf;
-}
-function partsIn(tz, date) {
-    const o = {};
-    for (const p of getDtf(tz).formatToParts(date))
-        o[p.type] = p.value;
-    return o;
-}
-const pad2 = (n) => n.padStart(2, "0");
-/** Escape a literal string for embedding inside a RegExp. */
-function escRe(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, String.raw `\$&`);
-}
-/** Substitute YYYY|YY|MM|DD|HH|mm|ss tokens in `pattern`. */
-function formatStamp(pattern, parts) {
-    return pattern.replace(/YYYY|YY|MM|DD|HH|mm|ss/g, (token) => {
-        switch (token) {
-            case "YYYY":
-                return parts.year;
-            case "YY":
-                return parts.year.slice(-2);
-            case "MM":
-                return pad2(parts.month);
-            case "DD":
-                return pad2(parts.day);
-            case "HH":
-                return pad2(parts.hour);
-            case "mm":
-                return pad2(parts.minute);
-            case "ss":
-                return pad2(parts.second);
-            default:
-                return token;
-        }
-    });
-}
-/** Offset of `tz` vs UTC at instant `date`, milliseconds. */
-function tzOffsetMs(tz, date) {
-    const p = partsIn(tz, date);
-    return (Date.UTC(+p.year, +p.month - 1, +p.day, +p.hour, +p.minute, +p.second) -
-        (date.getTime() - (date.getTime() % 1000)));
-}
-/** Next local midnight in `tz`, DST-corrected by fixed-point iteration. */
-function nextMidnight(tz, fromMs) {
-    const p = partsIn(tz, new Date(fromMs));
-    const localNext = Date.UTC(+p.year, +p.month - 1, +p.day + 1);
-    let inst = localNext - tzOffsetMs(tz, new Date(localNext));
-    for (let i = 0; i < 3; i++) {
-        const cand = localNext - tzOffsetMs(tz, new Date(inst));
-        if (cand === inst)
-            break;
-        inst = cand;
-    }
-    if (inst <= fromMs)
-        inst += 86_400_000;
-    return inst;
-}
-/** Next epoch-aligned boundary (e.g. hh:00 for step = 1h). */
-const nextAligned = (from, step) => Math.floor(from / step) * step + step;
-
-const BUMP_DEFAULT_MS = 60_000;
-const AUDIT_MAX_FILES = 600;
-const AUDIT_MAX_EVENTS = 200;
-const HEARTBEAT_STALE_MS = 30_000;
-const TIMER_POLL_MS = 1_000;
-const emptyAudit = (prefix, ext, datePattern, tz) => ({
-    version: 1,
-    prefix,
-    ext,
-    datePattern,
-    tz,
-    createdAt: null,
-    updatedAt: null,
-    activeStamp: null,
-    activeIndex: null,
-    writer: null,
-    files: {},
-    events: [],
-});
-/**
- * A `Writable` that appends to dated log files, rolling segments on time
- * and/or size, optionally gzipping sealed segments, enforcing retention,
- * and resuming an unbroken series across restarts via disk scan + audit
- * manifest.
- *
- * @example
- * ```ts
- * const log = createStream({
- *   filename: "logs/app-%DATE%.log",
- *   maxSize: "20m",
- *   maxFiles: "90d",
- *   zippedArchive: true,
- * });
- * log.write("hello\n");          // or: readable.pipe(log)
- * ```
- */
-class RotateFileStream extends Writable {
-    tz;
-    template;
-    dir;
-    datePattern;
-    zippedArchive;
-    maxSize;
-    maxFiles;
-    freq;
-    unrefTimers;
-    /* ---- filename-template pieces ---- */
-    _tL;
-    _tMid;
-    _tExt;
-    _rxFor;
-    _rxActive;
-    /* ---- audit manifest ---- */
-    _auditEnabled;
-    _auditPath;
-    _bootId = randomUUID();
-    /* ---- virtual test clock ---- */
-    _offsetMs;
-    _stepMs;
-    _bumpEvery;
-    /* ---- live state ---- */
-    _curStamp;
-    _index;
-    _ws = null;
-    _path = null;
-    _bytes = 0;
-    _timer = null;
-    _bumpTimer = null;
-    _ended = false;
-    _tail = Promise.resolve();
-    _warnedBackward = false;
-    _audit;
-    constructor(opts = {}) {
-        super(opts.highWaterMark ? { highWaterMark: opts.highWaterMark } : {});
-        const filename = opts.filename;
-        if (typeof filename !== "string" || !filename.includes("%DATE%")) {
-            throw new Error("opts.filename must contain '%DATE%' (e.g. 'logs/app-%DATE%.log')");
-        }
-        this.tz = opts.tz || "UTC";
-        getDtf(this.tz); // validate early, fail fast
-        this.template = path.basename(filename);
-        this.dir = path.dirname(filename);
-        this.datePattern = opts.datePattern || "YYYY-MM-DD";
-        this.zippedArchive = !!opts.zippedArchive;
-        this.maxSize = parseSize(opts.maxSize ?? 0);
-        this.maxFiles = parseMaxFiles(opts.maxFiles);
-        this.freq = parseFrequency(opts.frequency);
-        this.unrefTimers = !!opts.unrefTimers;
-        this._offsetMs = parseClockOffset(opts.addHours);
-        this._stepMs = parseClockStep(opts.addHoursEveryMin);
-        this._bumpEvery = Math.max(50, opts.clockStepIntervalMs ?? BUMP_DEFAULT_MS);
-        /* Split "prefix-%DATE%mid.ext" → pieces so indices land BETWEEN the
-           stamp and the extension: prefix-STAMP.N.ext                       */
-        const li = this.template.indexOf("%DATE%");
-        const rest = this.template.slice(li + "%DATE%".length);
-        const dot = rest.lastIndexOf(".");
-        this._tL = this.template.slice(0, li);
-        this._tMid = dot >= 0 ? rest.slice(0, dot) : "";
-        this._tExt = dot >= 0 ? rest.slice(dot) : "";
-        this._rxFor = (stampSrc) => new RegExp("^" +
-            escRe(this._tL) + stampSrc + escRe(this._tMid) +
-            "(?:\\.(\\d+))?" + escRe(this._tExt) + "(?:\\.gz)?$");
-        this._rxActive = this._rxFor("[^.]+");
-        this._auditEnabled = opts.audit !== false;
-        const stem = (this._tL.replace(/[^\w.-]+/g, "") || "log")
-            .replace(/^[-.]+|[-.]+$/g, "");
-        this._auditPath = path.join(this.dir, opts.auditFile || `${stem}_audit.json`);
-        fs.mkdirSync(this.dir, { recursive: true });
-        this._curStamp = this._stampNow();
-        this._audit = emptyAudit(this._tL, this._tExt, this.datePattern, this.tz);
-        const hadAudit = this._auditEnabled && this._loadAudit();
-        this._index = this._recoverIndexFor(this._curStamp);
-        const aiBoot = this._audit.activeIndex;
-        if (hadAudit && aiBoot !== null && this._audit.activeStamp === this._curStamp) {
-            this._index = Math.max(this._index, aiBoot);
-        }
-        if (this._offsetMs !== 0 || this._stepMs !== 0) {
-            process.nextTick(() => this.emit("clock", {
-                addHours: opts.addHours ?? undefined,
-                addHoursEveryMin: opts.addHoursEveryMin ?? undefined,
-                offsetMs: this._offsetMs,
-            }));
-        }
-        process.nextTick(() => {
-            const warn = (m) => this.emit("warn", new Error(m));
-            if (this.freq.type === "interval") {
-                if (this.freq.ms < 86_400_000 && !this.datePattern.includes("HH")) {
-                    warn(`frequency "${opts.frequency}" needs HH in datePattern — ` +
-                        "segments would collapse onto one filename");
-                }
-                if (this.freq.ms < 60_000 && !this.datePattern.includes("mm")) {
-                    warn(`frequency "${opts.frequency}" needs mm in datePattern`);
-                }
-            }
-            else if (!this.datePattern.includes("DD")) {
-                warn("daily frequency needs DD in datePattern");
-            }
-        });
-        /* Boot housekeeping is job #1 of the serial queue — chained HERE in the
-           constructor so it deterministically precedes any write job: zombie
-           demotion sees `_path === null`, gzip repair cannot race a reopen.  */
-        this._job(async () => {
-            await this._sealOrphanedPastStamps();
-            if (this._auditEnabled) {
-                this._demoteZombieActives();
-                this._reconcileWithDisk();
-                await this._repairInterruptedGzips();
-                this._aevent("boot", { stamp: this._curStamp, index: this._index });
-                this._saveAudit();
-            }
-            if (this.maxFiles)
-                this._retire();
-        }).catch(() => { });
-        this._armTimer();
-        this._armBump();
-        this.once("close", () => {
-            this._stopTimer();
-            this._stopBump();
-        });
-    }
-    on(event, listener) {
-        return super.on(event, listener);
-    }
-    once(event, listener) {
-        return super.once(event, listener);
-    }
-    emit(event, ...args) {
-        return super.emit(event, ...args);
-    }
-    /* ==================================================================
-     * Public API
-     * ================================================================ */
-    /** Absolute path of the segment currently written; `null` until first write. */
-    get filename() {
-        return this._path;
-    }
-    /** Index of the active segment within the current period. */
-    get currentIndex() {
-        return this._index;
-    }
-    /** Force an immediate rotation and resolve when the next slot is staged. */
-    rotateNow() {
-        return this._job(() => this._rotate("manual"));
-    }
-    /**
-     * Apply ONE virtual-clock tick immediately (bypasses the interval timer
-     * for deterministic tests). Crossing into a new period triggers the same
-     * archive flow as a real midnight roll.
-     */
-    advanceClock() {
-        return this._job(() => this._applyBump());
-    }
-    /* ==================================================================
-     * Writable contract
-     * ================================================================ */
-    _write(chunk, encoding, callback) {
-        if (this._ended) {
-            process.nextTick(callback, new Error("write after end"));
-            return;
-        }
-        const len = chunk.length;
-        this._job(async () => {
-            try {
-                // guarded roll (never rotates into a regressed stamp)
-                if (this._stampAdvanced(this._stampNow()))
-                    await this._rotate("time");
-                await this._ensureOpen();
-                if (this.maxSize > 0 &&
-                    this._bytes > 0 &&
-                    this._bytes + len > this.maxSize) {
-                    await this._rotate("size");
-                    await this._ensureOpen();
-                }
-                const ws = this._ws;
-                if (!ws)
-                    throw new Error("segment write stream not open");
-                await new Promise((resolve, reject) => ws.write(chunk, encoding, (e) => (e ? reject(e) : resolve())));
-                this._bytes += len;
-                callback();
-            }
-            catch (err) {
-                this.emit("error", err);
-                callback(err);
-            }
-        }).catch(() => { });
-    }
-    _final(callback) {
-        this._ended = true;
-        this._stopTimer();
-        this._stopBump();
-        this._job(async () => {
-            await endStream(this._ws);
-            const base = this._path && path.basename(this._path);
-            if (base && this._audit.files[base]) {
-                const rec = this._audit.files[base];
-                rec.state = "closed";
-                rec.closedAt = new Date().toISOString();
-                rec.bytes = statSizeSafe(this._path);
-                this._aevent("close", { file: base });
-                this._saveAudit();
-            }
-            this._ws = null;
-            this._path = null;
-        })
-            .catch(() => { })
-            .finally(() => callback());
-    }
-    destroy(...args) {
-        this._stopTimer();
-        this._stopBump();
-        return super.destroy(...args);
-    }
-    /* ==================================================================
-     * Serialisation — every mutating operation funnels through one queue
-     * so rotations/gzips/writes never interleave.
-     * ================================================================ */
-    _job(fn) {
-        const run = this._tail.then(fn, fn);
-        this._tail = run.catch(() => { });
-        return run;
-    }
-    _now() {
-        return Date.now() + this._offsetMs;
-    }
-    _stampNow(d = new Date(this._now())) {
-        return formatStamp(this.datePattern, partsIn(this.tz, d));
-    }
-    _resolveName(stamp, index) {
-        const base = path.join(this.dir, this._tL + stamp + this._tMid + this._tExt);
-        if (!index)
-            return base;
-        return /\.[^.]+$/.test(base)
-            ? base.replace(/\.[^.]+$/, `.${index}$&`)
-            : `${base}.${index}`;
-    }
-    /**
-     * true only when the period legally advanced. A regressed
-     * clock (NTP correction, manual change) never reopens a past family:
-     * writes continue in the current segment until real time catches up.
-     * Requires zero-padded datePattern tokens (documented assumption).
-     */
-    _stampAdvanced(stamp) {
-        if (stamp > this._curStamp)
-            return true;
-        if (stamp < this._curStamp && !this._warnedBackward) {
-            this._warnedBackward = true;
-            this.emit("warn", new Error(`clock moved backward (stamp ${stamp} < ${this._curStamp}); ` +
-                "keeping current segment until the clock catches up"));
-        }
-        return false;
-    }
-    /**
-     * Highest viable segment index for `stamp`.
-     * Disk is truth: resume a raw tail; start after sealed ones.
-     * The audit pointer (same stamp only) may only RAISE the result.
-     */
-    _recoverIndexFor(stamp) {
-        const rx = this._rxFor(escRe(stamp));
-        let maxAny = -1;
-        let maxRaw = -1;
-        let names = [];
-        try {
-            names = fs.readdirSync(this.dir);
-        }
-        catch {
-            /* unreadable dir → fresh series */
-        }
-        for (const n of names) {
-            const m = rx.exec(n);
-            if (!m)
-                continue;
-            const idx = m[1] ? Number.parseInt(m[1], 10) : 0;
-            if (idx > maxAny)
-                maxAny = idx;
-            if (!n.endsWith(".gz") && idx > maxRaw)
-                maxRaw = idx;
-        }
-        let idx = maxRaw >= 0 ? maxRaw : maxAny >= 0 ? maxAny + 1 : 0;
-        const ai = this._audit.activeIndex;
-        if (this._auditEnabled && ai !== null && this._audit.activeStamp === stamp) {
-            idx = Math.max(idx, ai);
-        }
-        return idx;
-    }
-    async _ensureOpen() {
-        if (this._ws)
-            return;
-        const p = this._resolveName(this._curStamp, this._index);
-        this._bytes = statSizeSafe(p);
-        const ws = fs.createWriteStream(p, { flags: "a" });
-        ws.on("error", (e) => this.emit("error", e));
-        this._ws = ws;
-        this._path = p;
-        if (this._auditEnabled) {
-            const base = path.basename(p);
-            // reopen = NEW incarnation. Never inherit lifecycle
-            // fields from the previous record (observed in the wild as
-            // abandonedAt < openedAt on reactivated segments).
-            this._audit.files[base] = {
-                index: this._index,
-                state: "active",
-                gzipPending: false,
-                openedAt: new Date().toISOString(),
-            };
-            this._setActivePointer(this._index);
-            this._aevent("open", {
-                file: base,
-                index: this._index,
-                resumedBytes: this._bytes,
-            });
-            this._saveAudit();
-        }
-        this.emit("open", p);
-    }
-    async _rotate(kind) {
-        const oldPath = this._path;
-        const oldWs = this._ws;
-        this._ws = null;
-        this._path = null;
-        this._bytes = 0;
-        let archive = null;
-        if (oldWs && oldPath) {
-            await endStream(oldWs);
-            const realBytes = statSizeSafe(oldPath);
-            const oldBase = path.basename(oldPath);
-            const rec = this._auditEnabled ? this._audit.files[oldBase] : undefined;
-            if (this.zippedArchive && realBytes > 0) {
-                archive = `${oldPath}.gz`;
-                /* Mark intent BEFORE compressing: crash mid-gzip becomes a
-                   repairable `gzipPending` flag instead of silent divergence.  */
-                if (rec) {
-                    rec.gzipPending = true;
-                    rec.bytes = realBytes;
-                    this._saveAudit();
-                }
-                const ok = await gzipMove(oldPath, archive, (e) => this.emit("warn", e));
-                if (ok) {
-                    this._finishArchivedRecord(oldBase);
-                }
-                else {
-                    if (rec) {
-                        rec.gzipPending = false;
-                        rec.state = "kept-raw";
-                    }
-                    this._aevent("gzip-failed", { file: oldBase });
-                    archive = null;
-                }
-            }
-            else if (realBytes === 0) {
-                // a concurrent writer may have archived this segment
-                // between our last stat and now — adopt its artifact instead of
-                // recording a false `drop-empty` that orphans the .gz.
-                const adoptedGz = `${oldPath}.gz`;
-                if (existsSafe(adoptedGz)) {
-                    this._finishArchivedRecord(oldBase);
-                    archive = adoptedGz;
-                }
-                else {
-                    try {
-                        fs.unlinkSync(oldPath);
-                    }
-                    catch {
-                        /* already gone */
-                    }
-                    if (rec)
-                        delete this._audit.files[oldBase];
-                    this._aevent("drop-empty", { file: oldBase });
-                }
-            }
-            else if (rec) {
-                rec.state = "sealed";
-                rec.bytes = realBytes;
-            }
-        }
-        let stamp = this._stampNow();
-        // a rotation itself must never move the series backward
-        // (covers rotateNow()/interval/size paths the upstream guards miss)
-        if (stamp < this._curStamp) {
-            if (!this._warnedBackward) {
-                this._warnedBackward = true;
-                this.emit("warn", new Error(`clock moved backward (stamp ${stamp} < ${this._curStamp}); ` +
-                    "rotation clamped to the current period"));
-            }
-            stamp = this._curStamp;
-        }
-        const newPeriod = stamp !== this._curStamp;
-        this._curStamp = stamp;
-        /* Never blind-reset to 0 — recover what THIS stamp already owns. */
-        this._index =
-            newPeriod || kind === "time"
-                ? this._recoverIndexFor(stamp)
-                : this._index + 1;
-        this._bytes = 0;
-        if (this._auditEnabled) {
-            this._setActivePointer(this._index);
-            this._aevent("rotate", { reason: kind, nextIndex: this._index, stamp });
-            this._saveAudit();
-        }
-        if (kind === "time" || kind === "manual")
-            this._armTimer();
-        if (oldPath) {
-            this.emit("rotated", {
-                reason: kind,
-                oldFile: oldPath,
-                archive,
-                newFile: this._resolveName(stamp, this._index),
-            });
-        }
-        this._retire();
-    }
-    /* ==================================================================
-     * Timers
-     * ================================================================ */
-    _hasContent() {
-        return this._ws
-            ? this._bytes > 0 || statSizeSafe(this._path) > 0
-            : !!(this._path && statSizeSafe(this._path) > 0);
-    }
-    _armTimer() {
-        this._stopTimer();
-        if (this._ended)
-            return;
-        const now = this._now();
-        const next = this.freq.type === "daily"
-            ? nextMidnight(this.tz, now)
-            : nextAligned(now, this.freq.ms);
-        // anti-spin. A backward clock can put the computed
-        // boundary in the past; poll gently instead of firing every 100 ms.
-        const delta = next - this._now();
-        const delay = delta < 0 ? TIMER_POLL_MS : Math.max(100, delta);
-        this._timer = setTimeout(() => {
-            this._job(async () => {
-                const stamp = this._stampNow();
-                if (this.freq.type !== "daily") {
-                    /* interval rotation is schedule-based; runs regardless of
-                       stamp movement */
-                    if (this._hasContent())
-                        await this._rotate("time");
-                }
-                else if (this._stampAdvanced(stamp)) {
-                    // guarded daily branch
-                    if (this._hasContent()) {
-                        await this._rotate("time");
-                    }
-                    else {
-                        /* idle boundary slide — no file created for empty days */
-                        this._curStamp = stamp;
-                        this._index = this._recoverIndexFor(stamp);
-                        if (this._auditEnabled) {
-                            this._setActivePointer(this._index);
-                            this._aevent("period", { stamp });
-                            this._saveAudit();
-                        }
-                        this.emit("period", stamp);
-                    }
-                }
-                /* stamp regressed or unchanged → keep current segment, re-arm */
-                this._armTimer();
-            }).catch(() => { });
-        }, delay);
-        if (this.unrefTimers)
-            this._timer.unref();
-    }
-    _armBump() {
-        this._stopBump();
-        if (!this._stepMs || this._ended)
-            return;
-        this._bumpTimer = setInterval(() => this._job(() => this._applyBump()).catch(() => { }), this._bumpEvery);
-        if (this.unrefTimers)
-            this._bumpTimer.unref();
-    }
-    _stopBump() {
-        if (this._bumpTimer) {
-            clearInterval(this._bumpTimer);
-            this._bumpTimer = null;
-        }
-    }
-    async _applyBump() {
-        if (this._ended)
-            return;
-        this._offsetMs += this._stepMs;
-        this._armTimer();
-        const stamp = this._stampNow();
-        // guarded crossing (virtual clock can't roll backward either)
-        if (this._stampAdvanced(stamp)) {
-            if (this._hasContent()) {
-                await this._rotate("time");
-            }
-            else {
-                this._curStamp = stamp;
-                this._index = this._recoverIndexFor(stamp);
-                if (this._auditEnabled) {
-                    this._setActivePointer(this._index);
-                    this._aevent("period", { stamp, virtual: true });
-                }
-                this.emit("period", stamp);
-            }
-        }
-        if (this._auditEnabled) {
-            this._aevent("clock-step", {
-                addedMsPerMin: this._stepMs,
-                offsetMs: this._offsetMs,
-                stamp,
-            });
-            this._saveAudit();
-        }
-    }
-    _stopTimer() {
-        if (this._timer) {
-            clearTimeout(this._timer);
-            this._timer = null;
-        }
-    }
-    /* ==================================================================
-     * Audit manifest
-     * ================================================================ */
-    _loadAudit() {
-        let parsed;
-        try {
-            parsed = JSON.parse(fs.readFileSync(this._auditPath, "utf8"));
-        }
-        catch {
-            // unparseable manifest is quarantined too (was silently
-            // clobbered by the first save — caught by the quarantine test)
-            try {
-                fs.renameSync(this._auditPath, `${this._auditPath}.corrupt`);
-            }
-            catch {
-                /* ignore */
-            }
-            return false;
-        }
-        const j = parsed;
-        if (!j || j.version !== 1 || j.prefix !== this._tL || j.ext !== this._tExt) {
-            try {
-                fs.renameSync(this._auditPath, `${this._auditPath}.corrupt`);
-            }
-            catch {
-                /* ignore */
-            }
-            return false;
-        }
-        this._audit.createdAt = j.createdAt ?? new Date().toISOString();
-        this._audit.activeStamp =
-            typeof j.activeStamp === "string" ? j.activeStamp : null;
-        this._audit.activeIndex =
-            Number.isInteger(j.activeIndex) ? j.activeIndex : null;
-        this._audit.files =
-            j.files && typeof j.files === "object"
-                ? j.files
-                : {};
-        this._audit.events = Array.isArray(j.events)
-            ? j.events.slice(-AUDIT_MAX_EVENTS)
-            : [];
-        /* Detect another LIVE process on this family before clobbering it. */
-        const w = j.writer;
-        if (w &&
-            typeof w.bootId === "string" &&
-            w.bootId !== this._bootId &&
-            typeof w.heartbeat === "number" &&
-            Date.now() - w.heartbeat < HEARTBEAT_STALE_MS) {
-            const err = new Error(`concurrent writer detected (pid ${w.pid}, boot ${w.bootId}); ` +
-                "two processes share this log family and will race. " +
-                "If running 'node --watch', exclude the logs dir via --watch-path.");
-            this.emit("warn", err);
-            this._audit.events.push({
-                id: randomUUID(),
-                t: new Date().toISOString(),
-                type: "concurrent-writer",
-                otherPid: w.pid,
-                otherBoot: w.bootId,
-            });
-        }
-        return true;
-    }
-    _saveAudit() {
-        if (!this._auditEnabled)
-            return;
-        try {
-            this._pruneAuditFiles();
-            this._audit.updatedAt = new Date().toISOString();
-            this._audit.writer = {
-                pid: process.pid,
-                bootId: this._bootId,
-                heartbeat: Date.now(),
-            };
-            const tmp = `${this._auditPath}.tmp`;
-            fs.writeFileSync(tmp, JSON.stringify(this._audit, null, 1));
-            fs.renameSync(tmp, this._auditPath);
-        }
-        catch (e) {
-            this.emit("warn", e);
-        }
-    }
-    _pruneAuditFiles() {
-        const files = this._audit.files;
-        const keys = Object.keys(files);
-        if (keys.length <= AUDIT_MAX_FILES)
-            return;
-        const activeBase = this._path && path.basename(this._path);
-        const lastTouch = (r) => r.archivedAt ?? r.closedAt ?? r.abandonedAt ?? r.openedAt ?? "";
-        const stale = keys
-            .filter((k) => k !== activeBase && files[k].state !== "active")
-            .sort((a, b) => lastTouch(files[a]).localeCompare(lastTouch(files[b])));
-        const excess = keys.length - AUDIT_MAX_FILES + 50;
-        for (const key of stale.slice(0, excess))
-            delete files[key];
-    }
-    _aevent(type, extra = {}) {
-        if (!this._auditEnabled)
-            return;
-        const events = this._audit.events;
-        events.push({ id: randomUUID(), t: new Date().toISOString(), type, ...extra });
-        if (events.length > AUDIT_MAX_EVENTS) {
-            events.splice(0, events.length - AUDIT_MAX_EVENTS);
-        }
-    }
-    _setActivePointer(index) {
-        this._audit.activeStamp = this._curStamp;
-        this._audit.activeIndex = index;
-    }
-    /** Records left `active` by dead processes → `abandoned`. */
-    _demoteZombieActives() {
-        const activeBase = this._path && path.basename(this._path);
-        for (const [name, rec] of Object.entries(this._audit.files)) {
-            if (rec.state === "active" && name !== activeBase) {
-                rec.state = "abandoned";
-                rec.abandonedAt = new Date().toISOString();
-                this._aevent("abandon", { file: name });
-            }
-        }
-    }
-    /** Heal audit-vs-disk divergence after crashes / external tampering. */
-    _reconcileWithDisk() {
-        for (const name of Object.keys(this._audit.files)) {
-            const rec = this._audit.files[name];
-            if (rec.gzipPending)
-                continue; // handled by the repair pass
-            if (name.endsWith(".gz")) {
-                const gzExists = existsSafe(path.join(this.dir, name));
-                const rawName = name.slice(0, -3);
-                const rawExists = existsSafe(path.join(this.dir, rawName));
-                if (gzExists)
-                    continue;
-                if (rawExists) {
-                    delete this._audit.files[name];
-                    this._audit.files[rawName] = { ...rec, state: "sealed" };
-                    this._aevent("archive-regressed", { file: name, backTo: rawName });
-                    this.emit("warn", new Error(`archive ${name} missing but raw ${rawName} exists`));
-                    continue;
-                }
-                this._aevent("vanished", { file: name });
-                delete this._audit.files[name];
-                continue;
-            }
-            const rawExists = existsSafe(path.join(this.dir, name));
-            const gzExists = existsSafe(path.join(this.dir, `${name}.gz`));
-            if (rawExists)
-                continue;
-            if (gzExists) {
-                this._finishArchivedRecord(name, true); // unlink was interrupted
-                continue;
-            }
-            this._aevent("vanished", { file: name });
-            delete this._audit.files[name];
-        }
-    }
-    /**
-     * DISK-DRIVEN seal. Seal raw segments whose period has
-     * already passed (crash near midnight, virtual-clock leftovers,
-     * untracked/pruned files). Iterates the DIRECTORY, not the manifest:
-     * the filesystem is the source of truth; the manifest is an index.
-     */
-    async _sealOrphanedPastStamps() {
-        if (!this.zippedArchive)
-            return;
-        const stampRx = new RegExp("^" + escRe(this._tL) + "(.+?)" + escRe(this._tMid) +
-            "(?:\\.\\d+)?" + escRe(this._tExt) + "(?:\\.gz)?$");
-        let names = [];
-        try {
-            names = fs.readdirSync(this.dir);
-        }
-        catch {
-            return;
-        }
-        for (const name of names) {
-            if (name.endsWith(".gz"))
-                continue;
-            if (name === (this._path && path.basename(this._path)))
-                continue;
-            const stamp = stampRx.exec(name)?.[1];
-            // lexicographic compare is safe for zero-padded patterns (YYYY-MM-DD…);
-            // also guards the current stamp and anything future-dated
-            if (!stamp || stamp >= this._curStamp)
-                continue;
-            const full = path.join(this.dir, name);
-            if (!existsSafe(full) || statSizeSafe(full) === 0)
-                continue;
-            const ok = await gzipMove(full, `${full}.gz`, (e) => this.emit("warn", e));
-            if (!ok)
-                continue;
-            if (this._auditEnabled && this._audit.files[name]) {
-                // tracked → re-key record name → name.gz (emits archive + journal)
-                this._finishArchivedRecord(name, true);
-            }
-            else {
-                // untracked → record it fresh so future reconciles see truth
-                const gzName = `${name}.gz`;
-                if (this._auditEnabled) {
-                    this._audit.files[gzName] = {
-                        state: "archived",
-                        gzipPending: false,
-                        archivedAt: new Date().toISOString(),
-                    };
-                    this._aevent("seal-past", { file: gzName });
-                }
-                this.emit("archive", path.join(this.dir, gzName));
-            }
-        }
-    }
-    async _repairInterruptedGzips() {
-        for (const [name, rec] of Object.entries(this._audit.files)) {
-            if (!rec.gzipPending)
-                continue;
-            const src = path.join(this.dir, name);
-            const dst = `${src}.gz`;
-            if (!existsSafe(src)) {
-                rec.gzipPending = false;
-                rec.state = "lost";
-                this._aevent("gzip-lost", { file: name });
-                continue;
-            }
-            if (existsSafe(dst)) {
-                try {
-                    fs.unlinkSync(src);
-                }
-                catch {
-                    /* ignore */
-                }
-                this._finishArchivedRecord(name, true);
-                continue;
-            }
-            const ok = await gzipMove(src, dst, (e) => this.emit("warn", e));
-            if (ok) {
-                this._finishArchivedRecord(name, true);
-            }
-            else {
-                rec.gzipPending = false;
-                rec.state = "kept-raw";
-                this._aevent("gzip-failed", { file: name });
-            }
-        }
-    }
-    /** Seal a record; re-key `name` → `name.gz` so scans stop ghosting. */
-    _finishArchivedRecord(rawName, repaired = false) {
-        const rec = this._audit.files[rawName];
-        if (!rec)
-            return;
-        rec.gzipPending = false;
-        rec.state = "archived";
-        rec.archivedAt = new Date().toISOString();
-        if (rawName.endsWith(".gz")) {
-            this.emit("archive", path.join(this.dir, rawName));
-            this._aevent("archive", { file: rawName, ...(repaired && { repaired }) });
-            return;
-        }
-        const gzName = `${rawName}.gz`;
-        delete this._audit.files[rawName];
-        this._audit.files[gzName] = rec;
-        this.emit("archive", path.join(this.dir, gzName));
-        this._aevent("archive", { file: gzName, ...(repaired && { repaired }) });
-    }
-    /* ==================================================================
-     * Retention
-     * ================================================================ */
-    async _retire() {
-        const policy = this.maxFiles;
-        if (!policy)
-            return;
-        const activeBase = this._path && path.basename(this._path);
-        const activeStem = activeBase?.replace(/(?:\.\d+)?(?:\.log|)(?:\.gz)?$/, "");
-        const reserved = [
-            path.basename(this._auditPath),
-            `${path.basename(this._auditPath)}.tmp`,
-            `${path.basename(this._auditPath)}.corrupt`,
-        ];
-        try {
-            const dirEntries = await fs.promises.readdir(this.dir);
-            const candidates = dirEntries.filter((n) => this._rxActive.test(n) &&
-                n !== activeBase &&
-                !(activeStem && n.startsWith(activeStem)) &&
-                !reserved.includes(n));
-            const stats = [];
-            for (const name of candidates) {
-                const full = path.join(this.dir, name);
-                try {
-                    stats.push({ full, mtimeMs: (await fs.promises.stat(full)).mtimeMs });
-                }
-                catch {
-                    /* raced deletion */
-                }
-            }
-            stats.sort((a, b) => a.mtimeMs - b.mtimeMs); // oldest first
-            const kill = new Set();
-            if (policy.days != null) {
-                const cutoff = this._now() - policy.days * 86_400_000;
-                for (const f of stats)
-                    if (f.mtimeMs < cutoff)
-                        kill.add(f.full);
-            }
-            if (policy.count != null) {
-                const survivors = stats.filter((f) => !kill.has(f.full));
-                const excessCount = survivors.length - policy.count;
-                for (let i = 0; i < excessCount; i++)
-                    kill.add(survivors[i].full);
-            }
-            if (kill.size === 0)
-                return;
-            for (const file of kill) {
-                await fs.promises.unlink(file).catch(() => { });
-                if (this._auditEnabled) {
-                    delete this._audit.files[path.basename(file)];
-                    this._aevent("deleted", { file: path.basename(file) });
-                }
-                this.emit("deleted", file);
-            }
-            this._saveAudit();
-        }
-        catch (e) {
-            this.emit("warn", e);
-        }
-    }
-}
-/**
- * Convenience factory mirroring common rotator APIs.
- *
- * @example
- * const log = createStream({ filename: "logs/app-%DATE%.log" });
- */
-function createStream(options) {
-    return new RotateFileStream(options);
-}
-
-export { RotateFileStream, createStream };
+/*! logroller v2.1.1 | MIT License */
+import{randomUUID as t}from"node:crypto";import e from"node:fs";import i from"node:path";import{Writable as s}from"node:stream";import n from"node:zlib";import{pipeline as a}from"node:stream/promises";const r=t=>{try{return"string"==typeof t?e.statSync(t).size:0}catch{return 0}},h=t=>{try{return e.existsSync(t)}catch{return!1}};async function o(t,i,s,r=6){try{return await a(e.createReadStream(t),n.createGzip({level:r}),e.createWriteStream(i)),await e.promises.unlink(t),!0}catch(t){return await e.promises.unlink(i).catch(()=>{}),s?.(t),!1}}const d=t=>t?new Promise(e=>t.end(()=>e())):Promise.resolve(),c={b:1,k:1024,kb:1024,m:1048576,mb:1048576,g:1073741824,gb:1073741824},u={ms:1,s:1e3,m:6e4,h:36e5,hour:36e5,hours:36e5};function l(t,e,i){if("number"==typeof t)return Math.round(t*u[e]);const s=/^\s*(-?\d+(?:\.\d+)?)\s*(h(?:our)?s?|ms|s|m)?\s*$/i.exec(t);if(!s)throw new Error(`Invalid ${i} "${t}"`);const n=(s[2]??e).toLowerCase(),a=u[n];if(void 0===a)throw new Error(`Invalid ${i} unit "${s[2]}" in "${t}"`);return Math.round(Number.parseFloat(s[1])*a)}function _(t){if(null==t||0===t)return 0;if("number"==typeof t)return t;const e=/^\s*(\d+(?:\.\d+)?)\s*(b|kb|k|mb|m|gb|g)?\s*$/i.exec(t);if(!e)throw new Error(`Invalid maxSize "${t}"`);return Math.round(Number.parseFloat(e[1])*(c[e[2]?.toLowerCase()]??1))}const m={ms:1,s:1e3,m:6e4,h:36e5};const p=new Map;function f(t){let e=p.get(t);if(!e){try{e=new Intl.DateTimeFormat("en-US",{timeZone:t,hourCycle:"h23",year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit"})}catch{throw new Error(`Invalid timeZone "${t}"`)}p.set(t,e)}return e}function w(t,e){const i={};for(const s of f(t).formatToParts(e))i[s.type]=s.value;return i}const y=t=>t.padStart(2,"0");function v(t){return t.replace(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`)}function b(t,e){const i=w(t,e);return Date.UTC(+i.year,+i.month-1,+i.day,+i.hour,+i.minute,+i.second)-(e.getTime()-e.getTime()%1e3)}class g extends s{tz;template;dir;datePattern;zippedArchive;maxSize;maxFiles;freq;unrefTimers;maxTotalSize;_tL;_tMid;_tExt;_rxFor;_rxActive;_auditEnabled;_auditPath;_bootId=t();_onSeal;_sealHookTimeoutMs;_compressionLevel;_symlinkPath=null;_offsetMs;_stepMs;_bumpEvery;_curStamp;_index;_ws=null;_path=null;_bytes=0;_timer=null;_bumpTimer=null;_ended=!1;_tail=Promise.resolve();_warnedBackward=!1;_audit;constructor(t={}){super(t.highWaterMark?{highWaterMark:t.highWaterMark}:{});const s=t.filename;if("string"!=typeof s||!s.includes("%DATE%"))throw new Error("opts.filename must contain '%DATE%' (e.g. 'logs/app-%DATE%.log')");var n;this.tz=t.tz||"UTC",f(this.tz),this.template=i.basename(s),this.dir=i.dirname(s),this.datePattern=t.datePattern||"YYYY-MM-DD",this.zippedArchive=!!t.zippedArchive,this.maxSize=_(t.maxSize??0),this.maxFiles=function(t){if(null==t||""===t||0===t)return null;if("number"==typeof t){if(t<0)throw new Error(`Invalid maxFiles "${t}"`);return{count:t}}const e=/^\s*(\d+)\s*d\s*$/i.exec(t);if(e)return{days:Number.parseInt(e[1],10)};const i=/^\s*(\d+)\s*$/.exec(t);if(i)return{count:Number.parseInt(i[1],10)};throw new Error(`Invalid maxFiles "${t}"`)}(t.maxFiles),this.maxTotalSize=_(t.maxTotalSize??0),this.freq=function(t){if(null==t)return{type:"daily"};if("daily"===t)return{type:"daily"};if("number"==typeof t){if(t<=0)throw new Error(`Invalid frequency "${t}"`);return{type:"interval",ms:t}}const e=/^\s*(\d+)\s*(ms|s|m|h)\s*$/i.exec(t);if(!e)throw new Error(`Invalid frequency "${t}"`);return{type:"interval",ms:Number.parseInt(e[1],10)*m[e[2].toLowerCase()]}}(t.frequency),this.unrefTimers=!!t.unrefTimers,this._offsetMs=null==(n=t.addHours)||""===n?0:l(n,"h","addHours"),this._stepMs=function(t){return null==t||""===t?0:l(t,"h","addHoursEveryMin")}(t.addHoursEveryMin),this._bumpEvery=Math.max(50,t.clockStepIntervalMs??6e4),this._compressionLevel=Math.min(9,Math.max(0,t.compressionLevel??6)),this._onSeal=t.onSeal,this._sealHookTimeoutMs=Math.max(0,t.sealHookTimeoutMs??3e4);const a=this.template.indexOf("%DATE%"),r=this.template.slice(a+6),h=r.lastIndexOf(".");this._tL=this.template.slice(0,a),this._tMid=h>=0?r.slice(0,h):"",this._tExt=h>=0?r.slice(h):"",this._rxFor=t=>new RegExp("^"+v(this._tL)+t+v(this._tMid)+"(?:\\.(\\d+))?"+v(this._tExt)+"(?:\\.gz)?$"),this._rxActive=this._rxFor("[^.]+"),this._auditEnabled=!1!==t.audit;const o=(this._tL.replace(/[^\w.-]+/g,"")||"log").replace(/^[-.]+|[-.]+$/g,"");var d,c,u,p;this._auditPath=i.join(this.dir,t.auditFile||`${o}_audit.json`),this._symlinkPath=t.symlink?i.join(this.dir,"string"==typeof t.symlink?t.symlink:`${o}-current.log`):null,e.mkdirSync(this.dir,{recursive:!0}),this._curStamp=this._stampNow(),this._audit=(d=this._tL,c=this._tExt,u=this.datePattern,p=this.tz,{version:1,prefix:d,ext:c,datePattern:u,tz:p,createdAt:null,updatedAt:null,activeStamp:null,activeIndex:null,writer:null,files:{},events:[]});const w=this._auditEnabled&&this._loadAudit();this._index=this._recoverIndexFor(this._curStamp);const y=this._audit.activeIndex;w&&null!==y&&this._audit.activeStamp===this._curStamp&&(this._index=Math.max(this._index,y)),0===this._offsetMs&&0===this._stepMs||process.nextTick(()=>this.emit("clock",{addHours:t.addHours??void 0,addHoursEveryMin:t.addHoursEveryMin??void 0,offsetMs:this._offsetMs})),process.nextTick(()=>{const e=t=>this.emit("warn",new Error(t));"interval"===this.freq.type?(this.freq.ms<864e5&&!this.datePattern.includes("HH")&&e(`frequency "${t.frequency}" needs HH in datePattern — segments would collapse onto one filename`),this.freq.ms<6e4&&!this.datePattern.includes("mm")&&e(`frequency "${t.frequency}" needs mm in datePattern`)):this.datePattern.includes("DD")||e("daily frequency needs DD in datePattern")}),this._job(async()=>{await this._sealOrphanedPastStamps(),this._auditEnabled&&(this._demoteZombieActives(),this._reconcileWithDisk(),await this._repairInterruptedGzips(),this._aevent("boot",{stamp:this._curStamp,index:this._index}),this._saveAudit()),(this.maxFiles||this.maxTotalSize>0)&&this._retire()}).catch(()=>{}),this._armTimer(),this._armBump(),this.once("close",()=>{this._stopTimer(),this._stopBump()})}on(t,e){return super.on(t,e)}once(t,e){return super.once(t,e)}emit(t,...e){return super.emit(t,...e)}get filename(){return this._path}get currentIndex(){return this._index}rotateNow(){return this._job(()=>this._rotate("manual"))}advanceClock(){return this._job(()=>this._applyBump())}listSegments(){const t=new RegExp("^"+v(this._tL)+"(.+?)"+v(this._tMid)+"(?:\\.(\\d+))?"+v(this._tExt)+"(?:\\.gz)?$"),s=this._symlinkPath&&i.basename(this._symlinkPath),n=[];let a=[];try{a=e.readdirSync(this.dir)}catch{return n}for(const e of a){if(e===s)continue;const a=t.exec(e);if(!a)continue;const h=this._audit.files[e];n.push({file:i.join(this.dir,e),stamp:a[1],index:a[2]?Number.parseInt(a[2],10):0,gzipped:e.endsWith(".gz"),bytes:r(i.join(this.dir,e)),state:h?.state??"untracked",openedAt:h?.openedAt,archivedAt:h?.archivedAt})}return n.sort((t,e)=>t.stamp.localeCompare(e.stamp)||t.index-e.index),n}stats(){const t=this.listSegments();return{dir:this.dir,currentStamp:this._curStamp,activeFile:this._path,activeIndex:this._index,segments:t.length,archived:t.filter(t=>t.gzipped).length,totalBytes:t.reduce((t,e)=>t+e.bytes,0),clockOffsetMs:this._offsetMs,symlink:this._symlinkPath}}_write(t,e,i){if(this._ended)return void process.nextTick(i,new Error("write after end"));const s=t.length;this._job(async()=>{try{this._stampAdvanced(this._stampNow())&&await this._rotate("time"),await this._ensureOpen(),this.maxSize>0&&this._bytes>0&&this._bytes+s>this.maxSize&&(await this._rotate("size"),await this._ensureOpen());const n=this._ws;if(!n)throw new Error("segment write stream not open");await new Promise((i,s)=>n.write(t,e,t=>t?s(t):i())),this._bytes+=s,i()}catch(t){this.emit("error",t),i(t)}}).catch(()=>{})}_final(t){this._ended=!0,this._stopTimer(),this._stopBump(),this._job(async()=>{await d(this._ws);const t=this._path&&i.basename(this._path);if(t&&this._audit.files[t]){const e=this._audit.files[t];e.state="closed",e.closedAt=(new Date).toISOString(),e.bytes=r(this._path),this._aevent("close",{file:t}),this._saveAudit()}this._ws=null,this._path=null}).catch(()=>{}).finally(()=>t())}destroy(...t){return this._stopTimer(),this._stopBump(),super.destroy(...t)}_job(t){const e=this._tail.then(t,t);return this._tail=e.catch(()=>{}),e}_now(){return Date.now()+this._offsetMs}_stampNow(t=new Date(this._now())){return e=this.datePattern,i=w(this.tz,t),e.replace(/YYYY|YY|MM|DD|HH|mm|ss/g,t=>{switch(t){case"YYYY":return i.year;case"YY":return i.year.slice(-2);case"MM":return y(i.month);case"DD":return y(i.day);case"HH":return y(i.hour);case"mm":return y(i.minute);case"ss":return y(i.second);default:return t}});var e,i}_resolveName(t,e){const s=i.join(this.dir,this._tL+t+this._tMid+this._tExt);return e?/\.[^.]+$/.test(s)?s.replace(/\.[^.]+$/,`.${e}$&`):`${s}.${e}`:s}_stampAdvanced(t){return t>this._curStamp||(t<this._curStamp&&!this._warnedBackward&&(this._warnedBackward=!0,this.emit("warn",new Error(`clock moved backward (stamp ${t} < ${this._curStamp}); keeping current segment until the clock catches up`))),!1)}_recoverIndexFor(t){const i=this._rxFor(v(t));let s=-1,n=-1,a=[];try{a=e.readdirSync(this.dir)}catch{}for(const t of a){const e=i.exec(t);if(!e)continue;const a=e[1]?Number.parseInt(e[1],10):0;a>s&&(s=a),!t.endsWith(".gz")&&a>n&&(n=a)}let r=n>=0?n:s>=0?s+1:0;const h=this._audit.activeIndex;return this._auditEnabled&&null!==h&&this._audit.activeStamp===t&&(r=Math.max(r,h)),r}_updateSymlink(){const t=this._symlinkPath;if(!t||!this._path)return;const s=`${t}.tmp`;try{try{e.unlinkSync(s)}catch{}e.symlinkSync(i.basename(this._path),s,"file"),e.renameSync(s,t)}catch(e){this._symlinkPath=null,this.emit("warn",new Error(`symlink unavailable ("${t}"): ${e.message} — continuing without it`))}}async _runSealHook(t,e){const s=this._onSeal;if(!s)return;let n;try{await Promise.race([Promise.resolve().then(()=>s({raw:t,gz:e})),new Promise((s,a)=>{n=setTimeout(()=>a(new Error(`onSeal hook timed out after ${this._sealHookTimeoutMs}ms (${i.basename(e??t)})`)),this._sealHookTimeoutMs)})])}catch(t){this.emit("warn",t)}finally{n&&clearTimeout(n)}}async _ensureOpen(){if(this._ws)return;const t=this._resolveName(this._curStamp,this._index);this._bytes=r(t);const s=e.createWriteStream(t,{flags:"a"});if(s.on("error",t=>this.emit("error",t)),this._ws=s,this._path=t,this._updateSymlink(),this._auditEnabled){const e=i.basename(t);this._audit.files[e]={index:this._index,state:"active",gzipPending:!1,openedAt:(new Date).toISOString()},this._setActivePointer(this._index),this._aevent("open",{file:e,index:this._index,resumedBytes:this._bytes}),this._saveAudit()}this.emit("open",t)}async _rotate(t){const s=this._path,n=this._ws;this._ws=null,this._path=null,this._bytes=0;let a=null;if(n&&s){await d(n);const t=r(s),c=i.basename(s),u=this._auditEnabled?this._audit.files[c]:void 0;if(this.zippedArchive&&t>0){a=`${s}.gz`,u&&(u.gzipPending=!0,u.bytes=t,this._saveAudit());await o(s,a,t=>this.emit("warn",t),this._compressionLevel)?(this._finishArchivedRecord(c),await this._runSealHook(s,a)):(u&&(u.gzipPending=!1,u.state="kept-raw"),this._aevent("gzip-failed",{file:c}),a=null,await this._runSealHook(s,null))}else if(0===t){const t=`${s}.gz`;if(h(t))this._finishArchivedRecord(c),a=t,await this._runSealHook(s,t);else{try{e.unlinkSync(s)}catch{}u&&delete this._audit.files[c],this._aevent("drop-empty",{file:c})}}else t>0&&(u&&(u.state="sealed",u.bytes=t),await this._runSealHook(s,null))}let c=this._stampNow();c<this._curStamp&&(this._warnedBackward||(this._warnedBackward=!0,this.emit("warn",new Error(`clock moved backward (stamp ${c} < ${this._curStamp}); rotation clamped to the current period`))),c=this._curStamp);const u=c!==this._curStamp;this._curStamp=c,this._index=u||"time"===t?this._recoverIndexFor(c):this._index+1,this._bytes=0,this._auditEnabled&&(this._setActivePointer(this._index),this._aevent("rotate",{reason:t,nextIndex:this._index,stamp:c}),this._saveAudit()),"time"!==t&&"manual"!==t||this._armTimer(),s&&this.emit("rotated",{reason:t,oldFile:s,archive:a,newFile:this._resolveName(c,this._index)}),this._retire()}_hasContent(){return this._ws?this._bytes>0||r(this._path)>0:!!(this._path&&r(this._path)>0)}_armTimer(){if(this._stopTimer(),this._ended)return;const t=this._now();var e,i;const s=("daily"===this.freq.type?function(t,e){const i=w(t,new Date(e)),s=Date.UTC(+i.year,+i.month-1,+i.day+1);let n=s-b(t,new Date(s));for(let e=0;e<3;e++){const e=s-b(t,new Date(n));if(e===n)break;n=e}return n<=e&&(n+=864e5),n}(this.tz,t):(e=t,i=this.freq.ms,Math.floor(e/i)*i+i))-this._now(),n=s<0?1e3:Math.max(100,s);this._timer=setTimeout(()=>{this._job(async()=>{const t=this._stampNow();"daily"!==this.freq.type?this._hasContent()&&await this._rotate("time"):this._stampAdvanced(t)&&(this._hasContent()?await this._rotate("time"):(this._curStamp=t,this._index=this._recoverIndexFor(t),this._auditEnabled&&(this._setActivePointer(this._index),this._aevent("period",{stamp:t}),this._saveAudit()),this.emit("period",t))),this._armTimer()}).catch(()=>{})},n),this.unrefTimers&&this._timer.unref()}_armBump(){this._stopBump(),this._stepMs&&!this._ended&&(this._bumpTimer=setInterval(()=>this._job(()=>this._applyBump()).catch(()=>{}),this._bumpEvery),this.unrefTimers&&this._bumpTimer.unref())}_stopBump(){this._bumpTimer&&(clearInterval(this._bumpTimer),this._bumpTimer=null)}async _applyBump(){if(this._ended)return;this._offsetMs+=this._stepMs,this._armTimer();const t=this._stampNow();this._stampAdvanced(t)&&(this._hasContent()?await this._rotate("time"):(this._curStamp=t,this._index=this._recoverIndexFor(t),this._auditEnabled&&(this._setActivePointer(this._index),this._aevent("period",{stamp:t,virtual:!0})),this.emit("period",t))),this._auditEnabled&&(this._aevent("clock-step",{addedMsPerMin:this._stepMs,offsetMs:this._offsetMs,stamp:t}),this._saveAudit())}_stopTimer(){this._timer&&(clearTimeout(this._timer),this._timer=null)}_loadAudit(){let i;try{i=JSON.parse(e.readFileSync(this._auditPath,"utf8"))}catch{try{e.renameSync(this._auditPath,`${this._auditPath}.corrupt`)}catch{}return!1}const s=i;if(!s||1!==s.version||s.prefix!==this._tL||s.ext!==this._tExt){try{e.renameSync(this._auditPath,`${this._auditPath}.corrupt`)}catch{}return!1}this._audit.createdAt=s.createdAt??(new Date).toISOString(),this._audit.activeStamp="string"==typeof s.activeStamp?s.activeStamp:null,this._audit.activeIndex=Number.isInteger(s.activeIndex)?s.activeIndex:null,this._audit.files=s.files&&"object"==typeof s.files?s.files:{},this._audit.events=Array.isArray(s.events)?s.events.slice(-200):[];const n=s.writer;if(n&&"string"==typeof n.bootId&&n.bootId!==this._bootId&&"number"==typeof n.heartbeat&&Date.now()-n.heartbeat<3e4){const e=new Error(`concurrent writer detected (pid ${n.pid}, boot ${n.bootId}); two processes share this log family and will race. If running 'node --watch', exclude the logs dir via --watch-path.`);this.emit("warn",e),this._audit.events.push({id:t(),t:(new Date).toISOString(),type:"concurrent-writer",otherPid:n.pid,otherBoot:n.bootId})}return!0}_saveAudit(){if(this._auditEnabled)try{this._pruneAuditFiles(),this._audit.updatedAt=(new Date).toISOString(),this._audit.writer={pid:process.pid,bootId:this._bootId,heartbeat:Date.now()};const t=`${this._auditPath}.tmp`;e.writeFileSync(t,JSON.stringify(this._audit,null,1)),e.renameSync(t,this._auditPath)}catch(t){this.emit("warn",t)}}_pruneAuditFiles(){const t=this._audit.files,e=Object.keys(t);if(e.length<=600)return;const s=this._path&&i.basename(this._path),n=t=>t.archivedAt??t.closedAt??t.abandonedAt??t.openedAt??"",a=e.filter(e=>e!==s&&"active"!==t[e].state).sort((e,i)=>n(t[e]).localeCompare(n(t[i]))),r=e.length-600+50;for(const e of a.slice(0,r))delete t[e]}_aevent(e,i={}){if(!this._auditEnabled)return;const s=this._audit.events;s.push({id:t(),t:(new Date).toISOString(),type:e,...i}),s.length>200&&s.splice(0,s.length-200)}_setActivePointer(t){this._audit.activeStamp=this._curStamp,this._audit.activeIndex=t}_demoteZombieActives(){const t=this._path&&i.basename(this._path);for(const[e,i]of Object.entries(this._audit.files))"active"===i.state&&e!==t&&(i.state="abandoned",i.abandonedAt=(new Date).toISOString(),this._aevent("abandon",{file:e}))}_reconcileWithDisk(){for(const t of Object.keys(this._audit.files)){const e=this._audit.files[t];if(e.gzipPending)continue;if(t.endsWith(".gz")){const s=h(i.join(this.dir,t)),n=t.slice(0,-3),a=h(i.join(this.dir,n));if(s)continue;if(a){delete this._audit.files[t],this._audit.files[n]={...e,state:"sealed"},this._aevent("archive-regressed",{file:t,backTo:n}),this.emit("warn",new Error(`archive ${t} missing but raw ${n} exists`));continue}this._aevent("vanished",{file:t}),delete this._audit.files[t];continue}const s=h(i.join(this.dir,t)),n=h(i.join(this.dir,`${t}.gz`));s||(n?this._finishArchivedRecord(t,!0):(this._aevent("vanished",{file:t}),delete this._audit.files[t]))}}async _sealOrphanedPastStamps(){if(!this.zippedArchive)return;const t=new RegExp("^"+v(this._tL)+"(.+?)"+v(this._tMid)+"(?:\\.\\d+)?"+v(this._tExt)+"(?:\\.gz)?$");let s=[];try{s=e.readdirSync(this.dir)}catch{return}for(const e of s){if(e.endsWith(".gz"))continue;if(e===(this._path&&i.basename(this._path)))continue;const s=t.exec(e)?.[1];if(!s||s>=this._curStamp)continue;const n=i.join(this.dir,e);if(!h(n)||0===r(n))continue;const a=`${n}.gz`;await o(n,a,t=>this.emit("warn",t),this._compressionLevel)&&(this._auditEnabled&&this._audit.files[e]?this._finishArchivedRecord(e,!0):(this._auditEnabled&&(this._audit.files[a]={state:"archived",gzipPending:!1,archivedAt:(new Date).toISOString()},this._aevent("seal-past",{file:a})),this.emit("archive",a)),await this._runSealHook(n,a))}}async _repairInterruptedGzips(){for(const[t,s]of Object.entries(this._audit.files)){if(!s.gzipPending)continue;const n=i.join(this.dir,t),a=`${n}.gz`;if(!h(n)){s.gzipPending=!1,s.state="lost",this._aevent("gzip-lost",{file:t});continue}if(h(a)){try{e.unlinkSync(n)}catch{}this._finishArchivedRecord(t,!0),await this._runSealHook(n,a);continue}await o(n,a,t=>this.emit("warn",t),this._compressionLevel)?(this._finishArchivedRecord(t,!0),await this._runSealHook(n,a)):(s.gzipPending=!1,s.state="kept-raw",this._aevent("gzip-failed",{file:t}))}}_finishArchivedRecord(t,e=!1){const s=this._audit.files[t];if(!s)return;if(s.gzipPending=!1,s.state="archived",s.archivedAt=(new Date).toISOString(),t.endsWith(".gz"))return this.emit("archive",i.join(this.dir,t)),void this._aevent("archive",{file:t,...e&&{repaired:e}});const n=`${t}.gz`;delete this._audit.files[t],this._audit.files[n]=s,this.emit("archive",i.join(this.dir,n)),this._aevent("archive",{file:n,...e&&{repaired:e}})}async _retire(){const t=this.maxFiles;if(!t&&this.maxTotalSize<=0)return;const s=this._path&&i.basename(this._path),n=s?.replace(/(?:\.\d+)?(?:\.log|)(?:\.gz)?$/,""),a=[i.basename(this._auditPath),`${i.basename(this._auditPath)}.tmp`,`${i.basename(this._auditPath)}.corrupt`,...this._symlinkPath?[i.basename(this._symlinkPath),`${i.basename(this._symlinkPath)}.tmp`]:[]];try{const r=(await e.promises.readdir(this.dir)).filter(t=>this._rxActive.test(t)&&t!==s&&!(n&&t.startsWith(n))&&!a.includes(t)),h=[];for(const t of r){const s=i.join(this.dir,t);try{const t=await e.promises.stat(s);h.push({full:s,mtimeMs:t.mtimeMs,size:t.size})}catch{}}h.sort((t,e)=>t.mtimeMs-e.mtimeMs);const o=new Set;if(null!=t?.days){const e=this._now()-864e5*t.days;for(const t of h)t.mtimeMs<e&&o.add(t.full)}if(null!=t?.count){const e=h.filter(t=>!o.has(t.full)),i=e.length-t.count;for(let t=0;t<i;t++)o.add(e[t].full)}if(this.maxTotalSize>0){const t=h.filter(t=>!o.has(t.full));let e=t.reduce((t,e)=>t+e.size,0),i=0;for(;e>this.maxTotalSize&&i<t.length;)o.add(t[i].full),e-=t[i].size,i++}if(0===o.size)return;for(const t of o)await e.promises.unlink(t).catch(()=>{}),this._auditEnabled&&(delete this._audit.files[i.basename(t)],this._aevent("deleted",{file:i.basename(t)})),this.emit("deleted",t);this._saveAudit()}catch(t){this.emit("warn",t)}}}function x(t){return new g(t)}const S=new Set;let k=!1,z=!1;function A(t,e={}){const i=Array.isArray(t)?t:[t];for(const t of i)S.add(t);if(!k){k=!0;const t=e.timeoutMs??5e3,i=e.code??0;for(const s of e.signals??["SIGINT","SIGTERM"])process.on(s,()=>{M(t).finally(()=>process.exit(i))})}return async()=>{await M(e.timeoutMs??5e3);for(const t of i)S.delete(t)}}async function M(t=5e3){if(z)return;z=!0;const e=setTimeout(()=>process.exit(1),t);e.unref();try{await Promise.allSettled([...S].map(t=>new Promise(e=>t.end(()=>e()))))}finally{clearTimeout(e),z=!1}}export{g as RotateFileStream,x as createStream,M as flushAll,A as installShutdown};