logroller 2.1.0 → 3.0.0

package/dist/{shutdown.d.ts → index.d.cts}

@@ -1,5 +1,8 @@
-import type { RotateFileStream } from "./rotate-file-stream.js";
-export interface ShutdownOptions {
+import { R as RotateFileStream } from './rotate-file-stream.cjs';
+export { C as ClockInfo, a as RotateFileStreamEventMap, b as RotateFileStreamOptions, c as RotatedInfo, d as RotationReason, S as SealInfo, e as SegmentInfo, f as StreamStats, g as createStream } from './rotate-file-stream.cjs';
+import 'node:stream';
+
+interface ShutdownOptions {
     /** Signals to listen on. @default ["SIGINT", "SIGTERM"] */
     signals?: NodeJS.Signals[];
     /** Hard-exit deadline (ms) if a stream refuses to end.
@@ -23,10 +26,14 @@ export interface ShutdownOptions {
  * const flush = installShutdown(logStream);
  * process.on("exit", () => { void flush(); });
  */
-export declare function installShutdown(streams: RotateFileStream | RotateFileStream[], opts?: ShutdownOptions): () => Promise<void>;
+declare function installShutdown(streams: RotateFileStream | RotateFileStream[], opts?: ShutdownOptions): () => Promise<void>;
 /**
  * End every registered stream (flush buffered writes) with a deadline.
- * Does NOT exit the process. Double-ending an already-ended stream is
- * harmless — the error lands in the ignored callback.
+ * Does NOT exit the process. Resolves `true` when every stream finished,
+ * `false` when the deadline hit first. Concurrent calls share one flush.
+ * Ended/destroyed streams leave the registry.
  */
-export declare function flushAll(timeoutMs?: number): Promise<void>;
+declare function flushAll(timeoutMs?: number): Promise<boolean>;
+
+export { RotateFileStream, flushAll, installShutdown };
+export type { ShutdownOptions };

package/dist/index.d.ts

@@ -1,9 +1,39 @@
+import { R as RotateFileStream } from './rotate-file-stream.js';
+export { C as ClockInfo, a as RotateFileStreamEventMap, b as RotateFileStreamOptions, c as RotatedInfo, d as RotationReason, S as SealInfo, e as SegmentInfo, f as StreamStats, g as createStream } from './rotate-file-stream.js';
+import 'node:stream';
+
+interface ShutdownOptions {
+    /** Signals to listen on. @default ["SIGINT", "SIGTERM"] */
+    signals?: NodeJS.Signals[];
+    /** Hard-exit deadline (ms) if a stream refuses to end.
+     * @default 5000 */
+    timeoutMs?: number;
+    /** Process exit code. @default 0 */
+    code?: number;
+}
 /**
- * logroller — zero-dependency rotating file streams for Node.js.
+ * Register streams for graceful shutdown: on SIGINT/SIGTERM every
+ * registered stream is ended — flushing buffered writes and finishing the
+ * audit manifest — before the process exits, with a hard deadline.
  *
- * @packageDocumentation
+ * Safe to call multiple times: process listeners install once, streams
+ * accumulate in the registry.
+ *
+ * Returns `flush()`, the same graceful end WITHOUT exiting — for tests
+ * and custom signal handling.
+ *
+ * @example
+ * const flush = installShutdown(logStream);
+ * process.on("exit", () => { void flush(); });
+ */
+declare function installShutdown(streams: RotateFileStream | RotateFileStream[], opts?: ShutdownOptions): () => Promise<void>;
+/**
+ * End every registered stream (flush buffered writes) with a deadline.
+ * Does NOT exit the process. Resolves `true` when every stream finished,
+ * `false` when the deadline hit first. Concurrent calls share one flush.
+ * Ended/destroyed streams leave the registry.
  */
-export { createStream, RotateFileStream } from "./rotate-file-stream.js";
-export { flushAll, installShutdown } from "./shutdown.js";
-export type { ShutdownOptions } from "./shutdown.js";
-export type { ClockInfo, RotatedInfo, RotateFileStreamEventMap, RotateFileStreamOptions, RotationReason, SealInfo, SegmentInfo, StreamStats } from "./types.js";
+declare function flushAll(timeoutMs?: number): Promise<boolean>;
+
+export { RotateFileStream, flushAll, installShutdown };
+export type { ShutdownOptions };