@rawnodes/logger 2.4.0 → 2.6.0

package/README.md

@@ -272,7 +272,6 @@ const logger = Logger.create({
   console: { format: 'plain' },
   cloudwatch: {
     logGroupName: '/app/my-service',
-    logStreamName: `${hostname}-${Date.now()}`,
     region: 'us-east-1',
     accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
@@ -284,6 +283,91 @@ const logger = Logger.create({
 });
 ```
 
+#### Log Stream Name
+
+The `logStreamName` field is optional and supports multiple configuration formats:
+
+```typescript
+// Option 1: Static string
+cloudwatch: {
+  logGroupName: '/app/my-service',
+  logStreamName: 'my-static-stream',
+  // ...
+}
+
+// Option 2: Predefined pattern
+cloudwatch: {
+  logGroupName: '/app/my-service',
+  logStreamName: { pattern: 'hostname-date' },
+  // ...
+}
+
+// Option 3: Custom template
+cloudwatch: {
+  logGroupName: '/app/my-service',
+  logStreamName: { template: '{hostname}/{env}/{date}' },
+  // ...
+}
+
+// Option 4: Omit for default (hostname)
+cloudwatch: {
+  logGroupName: '/app/my-service',
+  // logStreamName defaults to hostname
+  // ...
+}
+```
+
+**Available patterns:**
+
+| Pattern | Example Output |
+|---------|----------------|
+| `hostname` | `my-server` |
+| `hostname-date` | `my-server/2025-01-15` |
+| `hostname-uuid` | `my-server-a1b2c3d4` |
+| `date` | `2025-01-15` |
+| `uuid` | `a1b2c3d4-e5f6-7890-abcd` |
+
+**Template variables:**
+
+| Variable | Description |
+|----------|-------------|
+| `{hostname}` | Server hostname (config.hostname → HOSTNAME env → os.hostname()) |
+| `{date}` | Current date (YYYY-MM-DD) |
+| `{datetime}` | Current datetime (YYYY-MM-DD-HH-mm-ss) |
+| `{uuid}` | 8-char UUID (generated once at startup) |
+| `{pid}` | Process ID |
+| `{env}` | NODE_ENV (default: "development") |
+
+**Hostname resolution priority:**
+1. `config.hostname` (from logger config)
+2. `process.env.HOSTNAME` (useful in Docker/Kubernetes)
+3. `os.hostname()`
+
+**Examples:**
+
+```typescript
+// Kubernetes-friendly: pod name as stream
+cloudwatch: {
+  logGroupName: '/app/my-service/production',
+  logStreamName: { pattern: 'hostname' },  // -> "my-app-pod-abc123"
+  // ...
+}
+
+// Daily rotation with hostname
+cloudwatch: {
+  logGroupName: '/app/my-service',
+  logStreamName: { pattern: 'hostname-date' },  // -> "my-server/2025-01-15"
+  // ...
+}
+
+// Custom format with environment
+cloudwatch: {
+  logGroupName: '/app/my-service',
+  logStreamName: { template: '{env}/{hostname}/{date}' },  // -> "production/my-server/2025-01-15"
+  // ...
+}
+```
+
 ### Transport Options
 
 All external transports support:
@@ -330,6 +414,68 @@ logger.for('payments').error('Payment failed');
 logger.for('auth').error('Login failed');
 ```
 
+## Graceful Shutdown
+
+External transports (Discord, Telegram, CloudWatch) buffer messages before sending. To ensure no logs are lost on process exit, use graceful shutdown.
+
+### Automatic (Recommended)
+
+Enable `autoShutdown` in config to automatically handle SIGTERM/SIGINT:
+
+```typescript
+const logger = Logger.create({
+  level: 'info',
+  console: { format: 'plain' },
+  cloudwatch: { /* ... */ },
+  autoShutdown: true,  // Auto-register shutdown handlers
+});
+
+// Or with options:
+const logger = Logger.create({
+  level: 'info',
+  console: { format: 'plain' },
+  cloudwatch: { /* ... */ },
+  autoShutdown: {
+    timeout: 10000,              // Max wait time (default: 5000ms)
+    signals: ['SIGTERM'],        // Signals to handle (default: ['SIGTERM', 'SIGINT'])
+  },
+});
+```
+
+### Manual
+
+For more control, use `registerShutdown` or call `shutdown()` directly:
+
+```typescript
+import { Logger, registerShutdown } from '@rawnodes/logger';
+
+const logger = Logger.create(config);
+
+// Option 1: Register handlers manually
+registerShutdown(logger, {
+  timeout: 10000,
+  onShutdown: async () => {
+    console.log('Flushing logs...');
+  },
+});
+
+// Option 2: Call shutdown directly (e.g., in your own signal handler)
+process.on('SIGTERM', async () => {
+  await logger.shutdown();  // Flush all buffered messages
+  process.exit(0);
+});
+```
+
+### In Tests
+
+For tests, call `shutdown()` in `afterAll` to flush pending logs:
+
+```typescript
+afterAll(async () => {
+  await logger.shutdown();
+});
+```
+
 ## Singleton Pattern
 
 For app-wide logging:

package/dist/index.d.mts

@@ -64,9 +64,19 @@ interface TelegramConfig extends HttpTransportBaseConfig {
     threadId?: number;
     replyToMessageId?: number;
 }
+type LogStreamPattern = 'hostname' | 'hostname-date' | 'hostname-uuid' | 'date' | 'uuid';
+interface LogStreamPatternConfig {
+    pattern: LogStreamPattern;
+}
+interface LogStreamTemplateConfig {
+    /** Custom template with variables: {hostname}, {date}, {datetime}, {uuid}, {pid}, {env} */
+    template: string;
+}
+type LogStreamName = string | LogStreamPatternConfig | LogStreamTemplateConfig;
 interface CloudWatchConfig extends HttpTransportBaseConfig {
     logGroupName: string;
-    logStreamName: string;
+    /** Log stream name - string, pattern config, or template config. Defaults to hostname pattern */
+    logStreamName?: LogStreamName;
     region: string;
     accessKeyId: string;
     secretAccessKey: string;
@@ -90,6 +100,12 @@ interface CallerInfo {
     column?: number;
     function?: string;
 }
+interface AutoShutdownConfig {
+    /** Timeout in ms before forcing exit (default: 5000) */
+    timeout?: number;
+    /** Custom signals to handle (default: ['SIGTERM', 'SIGINT']) */
+    signals?: NodeJS.Signals[];
+}
 interface LoggerConfig {
     level: LevelConfig;
     console: ConsoleConfig;
@@ -101,6 +117,8 @@ interface LoggerConfig {
     caller?: boolean | CallerConfig;
     /** Hostname to include in all log entries. Defaults to os.hostname() if not specified */
     hostname?: string;
+    /** Auto-register graceful shutdown handlers. Pass true for defaults or config object */
+    autoShutdown?: boolean | AutoShutdownConfig;
 }
 type LoggerContext = Record<string, unknown>;
 type LevelOverrideMatch<TContext extends LoggerContext> = Partial<TContext> & {
@@ -131,6 +149,11 @@ declare class Logger<TContext extends LoggerContext = LoggerContext> {
     removeLevelOverride(match: LevelOverrideMatch<TContext>): boolean;
     clearLevelOverrides(): void;
     getLevelOverrides(): LevelOverride<TContext>[];
+    /**
+     * Gracefully shutdown the logger, flushing all pending messages.
+     * Should be called before process exit to ensure no logs are lost.
+     */
+    shutdown(): Promise<void>;
     profile(id: string, meta?: object): void;
     error(errorOrMessage: Error | string, messageOrMeta?: string | Meta, meta?: Meta): void;
     warn(message: string, meta?: Meta): void;
@@ -155,10 +178,6 @@ interface SingletonLogger<TContext extends LoggerContext> {
 }
 declare function createSingletonLogger<TContext extends LoggerContext = LoggerContext>(): SingletonLogger<TContext>;
 
-declare function matchesContext(storeContext: LoggerContext | undefined, loggerContext: string | undefined, match: Record<string, unknown> & {
-    context?: string;
-}): boolean;
-
 interface BufferedMessage {
     level: LogLevel;
     message: string;
@@ -206,6 +225,10 @@ declare abstract class BaseHttpTransport extends EventEmitter {
     protected abstract sendBatch(messages: BufferedMessage[]): Promise<void>;
 }
 
+declare function matchesContext(storeContext: LoggerContext | undefined, loggerContext: string | undefined, match: Record<string, unknown> & {
+    context?: string;
+}): boolean;
+
 declare class DiscordTransport extends BaseHttpTransport {
     private config;
     constructor(config: DiscordConfig);
@@ -240,7 +263,8 @@ declare class CloudWatchTransport extends BaseHttpTransport {
     private sequenceToken;
     private initialized;
     private initPromise;
-    constructor(config: CloudWatchConfig);
+    private resolvedLogStreamName;
+    constructor(config: CloudWatchConfig, configHostname?: string);
     protected sendBatch(messages: BufferedMessage[]): Promise<void>;
     private ensureInitialized;
     private initialize;
@@ -284,7 +308,35 @@ declare function createMasker(options?: MaskSecretsOptions): (obj: unknown) => u
 declare function getCallerInfo(config: CallerConfig, additionalOffset?: number): CallerInfo | undefined;
 declare function formatCallerInfo(info: CallerInfo): string;
 
-declare function flattenObject(obj: Record<string, unknown>, prefix?: string): Record<string, unknown>;
+interface GracefulShutdownOptions {
+    /** Timeout in ms before forcing exit (default: 5000) */
+    timeout?: number;
+    /** Exit code on successful shutdown (default: 0) */
+    exitCode?: number;
+    /** Custom signals to handle (default: ['SIGTERM', 'SIGINT']) */
+    signals?: NodeJS.Signals[];
+    /** Called before shutdown starts */
+    onShutdown?: () => void | Promise<void>;
+}
+/**
+ * Register graceful shutdown handlers for the logger.
+ * Ensures all buffered logs are flushed before process exit.
+ *
+ * @example
+ * ```typescript
+ * const logger = Logger.create(config);
+ * registerShutdown(logger);
+ *
+ * // Or with options:
+ * registerShutdown(logger, {
+ *   timeout: 10000,
+ *   onShutdown: () => console.log('Shutting down...'),
+ * });
+ * ```
+ */
+declare function registerShutdown<TContext extends LoggerContext>(logger: Logger<TContext>, options?: GracefulShutdownOptions): () => Promise<void>;
+
+declare function flattenObject(obj: Record<string, unknown>, prefix?: string, ancestors?: WeakSet<object>, depth?: number): Record<string, unknown>;
 declare function formatLogfmtValue(value: unknown): string;
 declare function formatLogfmt(data: Record<string, unknown>): string;
 
@@ -296,10 +348,15 @@ declare const FileConfigSchema: z.ZodType<FileConfig>;
 declare const HttpTransportBaseConfigSchema: z.ZodType<HttpTransportBaseConfig>;
 declare const DiscordConfigSchema: z.ZodType<DiscordConfig>;
 declare const TelegramConfigSchema: z.ZodType<TelegramConfig>;
+declare const LogStreamPatternSchema: z.ZodType<LogStreamPattern>;
+declare const LogStreamPatternConfigSchema: z.ZodType<LogStreamPatternConfig>;
+declare const LogStreamTemplateConfigSchema: z.ZodType<LogStreamTemplateConfig>;
+declare const LogStreamNameSchema: z.ZodType<LogStreamName>;
 declare const CloudWatchConfigSchema: z.ZodType<CloudWatchConfig>;
 declare const LevelConfigObjectSchema: z.ZodType<LevelConfigObject>;
 declare const LevelConfigSchema: z.ZodType<LevelConfig>;
 declare const CallerConfigSchema: z.ZodType<CallerConfig>;
+declare const AutoShutdownConfigSchema: z.ZodType<AutoShutdownConfig>;
 declare const LoggerConfigSchema: z.ZodObject<{
     level: z.ZodType<LevelConfig, unknown, z.core.$ZodTypeInternals<LevelConfig, unknown>>;
     console: z.ZodType<ConsoleConfig, unknown, z.core.$ZodTypeInternals<ConsoleConfig, unknown>>;
@@ -309,6 +366,7 @@ declare const LoggerConfigSchema: z.ZodObject<{
     cloudwatch: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<CloudWatchConfig, unknown, z.core.$ZodTypeInternals<CloudWatchConfig, unknown>>, z.ZodArray<z.ZodType<CloudWatchConfig, unknown, z.core.$ZodTypeInternals<CloudWatchConfig, unknown>>>]>>;
     caller: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodType<CallerConfig, unknown, z.core.$ZodTypeInternals<CallerConfig, unknown>>]>>;
     hostname: z.ZodOptional<z.ZodString>;
+    autoShutdown: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodType<AutoShutdownConfig, unknown, z.core.$ZodTypeInternals<AutoShutdownConfig, unknown>>]>>;
 }, z.core.$strip>;
 declare function validateConfig(config: unknown): z.infer<typeof LoggerConfigSchema>;
 declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<{
@@ -320,6 +378,7 @@ declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<{
     cloudwatch?: CloudWatchConfig | CloudWatchConfig[] | undefined;
     caller?: boolean | CallerConfig | undefined;
     hostname?: string | undefined;
+    autoShutdown?: boolean | AutoShutdownConfig | undefined;
 }>;
 
-export { BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, safeValidateConfig, validateConfig };
+export { type AutoShutdownConfig, AutoShutdownConfigSchema, BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type GracefulShutdownOptions, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, type LogStreamName, LogStreamNameSchema, type LogStreamPattern, type LogStreamPatternConfig, LogStreamPatternConfigSchema, LogStreamPatternSchema, type LogStreamTemplateConfig, LogStreamTemplateConfigSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, registerShutdown, safeValidateConfig, validateConfig };

package/dist/index.d.ts

@@ -64,9 +64,19 @@ interface TelegramConfig extends HttpTransportBaseConfig {
     threadId?: number;
     replyToMessageId?: number;
 }
+type LogStreamPattern = 'hostname' | 'hostname-date' | 'hostname-uuid' | 'date' | 'uuid';
+interface LogStreamPatternConfig {
+    pattern: LogStreamPattern;
+}
+interface LogStreamTemplateConfig {
+    /** Custom template with variables: {hostname}, {date}, {datetime}, {uuid}, {pid}, {env} */
+    template: string;
+}
+type LogStreamName = string | LogStreamPatternConfig | LogStreamTemplateConfig;
 interface CloudWatchConfig extends HttpTransportBaseConfig {
     logGroupName: string;
-    logStreamName: string;
+    /** Log stream name - string, pattern config, or template config. Defaults to hostname pattern */
+    logStreamName?: LogStreamName;
     region: string;
     accessKeyId: string;
     secretAccessKey: string;
@@ -90,6 +100,12 @@ interface CallerInfo {
     column?: number;
     function?: string;
 }
+interface AutoShutdownConfig {
+    /** Timeout in ms before forcing exit (default: 5000) */
+    timeout?: number;
+    /** Custom signals to handle (default: ['SIGTERM', 'SIGINT']) */
+    signals?: NodeJS.Signals[];
+}
 interface LoggerConfig {
     level: LevelConfig;
     console: ConsoleConfig;
@@ -101,6 +117,8 @@ interface LoggerConfig {
     caller?: boolean | CallerConfig;
     /** Hostname to include in all log entries. Defaults to os.hostname() if not specified */
     hostname?: string;
+    /** Auto-register graceful shutdown handlers. Pass true for defaults or config object */
+    autoShutdown?: boolean | AutoShutdownConfig;
 }
 type LoggerContext = Record<string, unknown>;
 type LevelOverrideMatch<TContext extends LoggerContext> = Partial<TContext> & {
@@ -131,6 +149,11 @@ declare class Logger<TContext extends LoggerContext = LoggerContext> {
     removeLevelOverride(match: LevelOverrideMatch<TContext>): boolean;
     clearLevelOverrides(): void;
     getLevelOverrides(): LevelOverride<TContext>[];
+    /**
+     * Gracefully shutdown the logger, flushing all pending messages.
+     * Should be called before process exit to ensure no logs are lost.
+     */
+    shutdown(): Promise<void>;
     profile(id: string, meta?: object): void;
     error(errorOrMessage: Error | string, messageOrMeta?: string | Meta, meta?: Meta): void;
     warn(message: string, meta?: Meta): void;
@@ -155,10 +178,6 @@ interface SingletonLogger<TContext extends LoggerContext> {
 }
 declare function createSingletonLogger<TContext extends LoggerContext = LoggerContext>(): SingletonLogger<TContext>;
 
-declare function matchesContext(storeContext: LoggerContext | undefined, loggerContext: string | undefined, match: Record<string, unknown> & {
-    context?: string;
-}): boolean;
-
 interface BufferedMessage {
     level: LogLevel;
     message: string;
@@ -206,6 +225,10 @@ declare abstract class BaseHttpTransport extends EventEmitter {
     protected abstract sendBatch(messages: BufferedMessage[]): Promise<void>;
 }
 
+declare function matchesContext(storeContext: LoggerContext | undefined, loggerContext: string | undefined, match: Record<string, unknown> & {
+    context?: string;
+}): boolean;
+
 declare class DiscordTransport extends BaseHttpTransport {
     private config;
     constructor(config: DiscordConfig);
@@ -240,7 +263,8 @@ declare class CloudWatchTransport extends BaseHttpTransport {
     private sequenceToken;
     private initialized;
     private initPromise;
-    constructor(config: CloudWatchConfig);
+    private resolvedLogStreamName;
+    constructor(config: CloudWatchConfig, configHostname?: string);
     protected sendBatch(messages: BufferedMessage[]): Promise<void>;
     private ensureInitialized;
     private initialize;
@@ -284,7 +308,35 @@ declare function createMasker(options?: MaskSecretsOptions): (obj: unknown) => u
 declare function getCallerInfo(config: CallerConfig, additionalOffset?: number): CallerInfo | undefined;
 declare function formatCallerInfo(info: CallerInfo): string;
 
-declare function flattenObject(obj: Record<string, unknown>, prefix?: string): Record<string, unknown>;
+interface GracefulShutdownOptions {
+    /** Timeout in ms before forcing exit (default: 5000) */
+    timeout?: number;
+    /** Exit code on successful shutdown (default: 0) */
+    exitCode?: number;
+    /** Custom signals to handle (default: ['SIGTERM', 'SIGINT']) */
+    signals?: NodeJS.Signals[];
+    /** Called before shutdown starts */
+    onShutdown?: () => void | Promise<void>;
+}
+/**
+ * Register graceful shutdown handlers for the logger.
+ * Ensures all buffered logs are flushed before process exit.
+ *
+ * @example
+ * ```typescript
+ * const logger = Logger.create(config);
+ * registerShutdown(logger);
+ *
+ * // Or with options:
+ * registerShutdown(logger, {
+ *   timeout: 10000,
+ *   onShutdown: () => console.log('Shutting down...'),
+ * });
+ * ```
+ */
+declare function registerShutdown<TContext extends LoggerContext>(logger: Logger<TContext>, options?: GracefulShutdownOptions): () => Promise<void>;
+
+declare function flattenObject(obj: Record<string, unknown>, prefix?: string, ancestors?: WeakSet<object>, depth?: number): Record<string, unknown>;
 declare function formatLogfmtValue(value: unknown): string;
 declare function formatLogfmt(data: Record<string, unknown>): string;
 
@@ -296,10 +348,15 @@ declare const FileConfigSchema: z.ZodType<FileConfig>;
 declare const HttpTransportBaseConfigSchema: z.ZodType<HttpTransportBaseConfig>;
 declare const DiscordConfigSchema: z.ZodType<DiscordConfig>;
 declare const TelegramConfigSchema: z.ZodType<TelegramConfig>;
+declare const LogStreamPatternSchema: z.ZodType<LogStreamPattern>;
+declare const LogStreamPatternConfigSchema: z.ZodType<LogStreamPatternConfig>;
+declare const LogStreamTemplateConfigSchema: z.ZodType<LogStreamTemplateConfig>;
+declare const LogStreamNameSchema: z.ZodType<LogStreamName>;
 declare const CloudWatchConfigSchema: z.ZodType<CloudWatchConfig>;
 declare const LevelConfigObjectSchema: z.ZodType<LevelConfigObject>;
 declare const LevelConfigSchema: z.ZodType<LevelConfig>;
 declare const CallerConfigSchema: z.ZodType<CallerConfig>;
+declare const AutoShutdownConfigSchema: z.ZodType<AutoShutdownConfig>;
 declare const LoggerConfigSchema: z.ZodObject<{
     level: z.ZodType<LevelConfig, unknown, z.core.$ZodTypeInternals<LevelConfig, unknown>>;
     console: z.ZodType<ConsoleConfig, unknown, z.core.$ZodTypeInternals<ConsoleConfig, unknown>>;
@@ -309,6 +366,7 @@ declare const LoggerConfigSchema: z.ZodObject<{
     cloudwatch: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<CloudWatchConfig, unknown, z.core.$ZodTypeInternals<CloudWatchConfig, unknown>>, z.ZodArray<z.ZodType<CloudWatchConfig, unknown, z.core.$ZodTypeInternals<CloudWatchConfig, unknown>>>]>>;
     caller: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodType<CallerConfig, unknown, z.core.$ZodTypeInternals<CallerConfig, unknown>>]>>;
     hostname: z.ZodOptional<z.ZodString>;
+    autoShutdown: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodType<AutoShutdownConfig, unknown, z.core.$ZodTypeInternals<AutoShutdownConfig, unknown>>]>>;
 }, z.core.$strip>;
 declare function validateConfig(config: unknown): z.infer<typeof LoggerConfigSchema>;
 declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<{
@@ -320,6 +378,7 @@ declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<{
     cloudwatch?: CloudWatchConfig | CloudWatchConfig[] | undefined;
     caller?: boolean | CallerConfig | undefined;
     hostname?: string | undefined;
+    autoShutdown?: boolean | AutoShutdownConfig | undefined;
 }>;
 
-export { BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, safeValidateConfig, validateConfig };
+export { type AutoShutdownConfig, AutoShutdownConfigSchema, BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CallerConfig, CallerConfigSchema, type CallerInfo, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type GracefulShutdownOptions, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, type LogStreamName, LogStreamNameSchema, type LogStreamPattern, type LogStreamPatternConfig, LogStreamPatternConfigSchema, LogStreamPatternSchema, type LogStreamTemplateConfig, LogStreamTemplateConfigSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatCallerInfo, formatLogfmt, formatLogfmtValue, generateRequestId, getCallerInfo, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, registerShutdown, safeValidateConfig, validateConfig };