@agimon-ai/foundation-file-logger 0.2.0

package/LICENSE

@@ -0,0 +1,52 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             AgiFlow
+Licensed Work:        @agimon-ai/public-packages
+                      The Licensed Work is (c) 2026 AgiFlow.
+Additional Use Grant: None
+Change Date:          2030-03-06
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/dist/file.d.cts

@@ -0,0 +1,20 @@
+import { n as FileTransportOptions } from "./index.cjs";
+import { LogEntry, Transport } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/transports/file.d.ts
+declare class FileTransport implements Transport {
+  name: string;
+  level?: FileTransportOptions['level'];
+  private readonly filePath;
+  private readonly append;
+  private readonly ensureDir;
+  private readonly formatter;
+  private initialized;
+  private writeQueue;
+  constructor(options: FileTransportOptions);
+  private initialize;
+  log(entry: LogEntry): Promise<void>;
+}
+//#endregion
+export { FileTransport as t };
+//# sourceMappingURL=file.d.cts.map

package/dist/file.d.mts

@@ -0,0 +1,20 @@
+import { n as FileTransportOptions } from "./index.mjs";
+import { LogEntry, Transport } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/transports/file.d.ts
+declare class FileTransport implements Transport {
+  name: string;
+  level?: FileTransportOptions['level'];
+  private readonly filePath;
+  private readonly append;
+  private readonly ensureDir;
+  private readonly formatter;
+  private initialized;
+  private writeQueue;
+  constructor(options: FileTransportOptions);
+  private initialize;
+  log(entry: LogEntry): Promise<void>;
+}
+//#endregion
+export { FileTransport as t };
+//# sourceMappingURL=file.d.mts.map

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./transports/file.cjs`),t=require(`./installConsoleFileLogger.cjs`),n=require(`./logger.cjs`);exports.FileTransport=e.FileTransport,exports.createFileLogger=n.createFileLogger,exports.installConsoleFileLogger=t.installConsoleFileLogger;

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import { Environment, LogContext, LogFormatter, LogLevel, Transport } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/types/file-transport-options.d.ts
+type FileTransportOptions = {
+  readonly path: string;
+  readonly append?: boolean;
+  readonly ensureDir?: boolean;
+  readonly level?: LogLevel;
+  readonly formatter?: LogFormatter;
+};
+//#endregion
+//#region src/types/file-logger-options.d.ts
+type FileLoggerOptions = {
+  readonly service?: string;
+  readonly level?: LogLevel;
+  readonly environment?: Environment;
+  readonly context?: LogContext;
+  readonly file: FileTransportOptions;
+  readonly additionalTransports?: readonly Transport[];
+};
+//#endregion
+export { FileTransportOptions as n, FileLoggerOptions as t };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,23 @@
+import { Environment, LogContext, LogFormatter, LogLevel, Transport } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/types/file-transport-options.d.ts
+type FileTransportOptions = {
+  readonly path: string;
+  readonly append?: boolean;
+  readonly ensureDir?: boolean;
+  readonly level?: LogLevel;
+  readonly formatter?: LogFormatter;
+};
+//#endregion
+//#region src/types/file-logger-options.d.ts
+type FileLoggerOptions = {
+  readonly service?: string;
+  readonly level?: LogLevel;
+  readonly environment?: Environment;
+  readonly context?: LogContext;
+  readonly file: FileTransportOptions;
+  readonly additionalTransports?: readonly Transport[];
+};
+//#endregion
+export { FileTransportOptions as n, FileLoggerOptions as t };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1 @@
+import{FileTransport as e}from"./transports/file.mjs";import{installConsoleFileLogger as t}from"./installConsoleFileLogger.mjs";import{createFileLogger as n}from"./logger.mjs";export{e as FileTransport,n as createFileLogger,t as installConsoleFileLogger};

package/dist/index2.d.cts

@@ -0,0 +1,5 @@
+import { n as FileTransportOptions, t as FileLoggerOptions } from "./index.cjs";
+import { InstallConsoleFileLoggerOptions, installConsoleFileLogger } from "./installConsoleFileLogger.cjs";
+import { createFileLogger } from "./logger.cjs";
+import { t as FileTransport } from "./file.cjs";
+export { type FileLoggerOptions, FileTransport, type FileTransportOptions, type InstallConsoleFileLoggerOptions, createFileLogger, installConsoleFileLogger };

package/dist/index2.d.mts

@@ -0,0 +1,5 @@
+import { n as FileTransportOptions, t as FileLoggerOptions } from "./index.mjs";
+import { InstallConsoleFileLoggerOptions, installConsoleFileLogger } from "./installConsoleFileLogger.mjs";
+import { createFileLogger } from "./logger.mjs";
+import { t as FileTransport } from "./file.mjs";
+export { type FileLoggerOptions, FileTransport, type FileTransportOptions, type InstallConsoleFileLoggerOptions, createFileLogger, installConsoleFileLogger };

package/dist/installConsoleFileLogger.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./transports/file.cjs`);let t=require(`node:path`),n=require(`@agimon-ai/foundation-universal-logger`);const r=`__agimon_console_file_logger_state__`;function i(){let e=globalThis;return e[r]||(e[r]={isForwarding:!1,originals:{}}),e[r]}function a(e){return e.file?.path?e.file.path:(0,t.join)(e.logDir||process.env.AGIMON_LOG_DIR||(0,t.join)(process.cwd(),`.logs`),e.fileName||`${e.service}.log`)}function o(e,t){return t.length===0?{message:`console.${e}`,rest:[]}:typeof t[0]==`string`?{message:t[0],rest:t.slice(1)}:t[0]instanceof Error?{message:t[0].message,rest:t}:{message:`console.${e}`,rest:t}}function s(e,t,n){let{message:r,rest:i}=o(t,n);switch(t){case`log`:case`info`:e.info(r,...i);break;case`warn`:e.warn(r,...i);break;case`debug`:e.debug(r,...i);break;case`trace`:e.trace(r,...i);break;case`error`:{let[t,...n]=i;t instanceof Error?e.error(r,t,...n):e.error(r,void 0,...i);break}}}function c(t){let r=i();if(r.logger)return r.logger;let o=new e.FileTransport({path:a(t),append:t.file?.append,ensureDir:t.file?.ensureDir,level:t.file?.level,formatter:t.file?.formatter}),c=(0,n.createLogger)({service:t.service,level:t.level||`info`,context:t.context,transports:[o]});for(let e of[`log`,`info`,`warn`,`error`,`debug`,`trace`]){let t=console[e].bind(console);r.originals[e]=t,console[e]=(...n)=>{if(t(...n),!r.isForwarding){r.isForwarding=!0;try{s(c,e,n)}finally{r.isForwarding=!1}}}}return r.logger=c,c}exports.installConsoleFileLogger=c;
+//# sourceMappingURL=installConsoleFileLogger.cjs.map

package/dist/installConsoleFileLogger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"installConsoleFileLogger.cjs","names":["FileTransport"],"sources":["../src/installConsoleFileLogger.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { createLogger as createUniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport type { LogContext, LogLevel, UniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport { FileTransport } from './transports';\nimport type { FileTransportOptions } from './types';\n\ntype ConsoleMethod = 'log' | 'info' | 'warn' | 'error' | 'debug' | 'trace';\n\ntype ConsoleFileLoggerState = {\n  isForwarding: boolean;\n  logger?: UniversalLogger;\n  originals: Partial<Record<ConsoleMethod, (...args: unknown[]) => void>>;\n};\n\nconst STATE_KEY = '__agimon_console_file_logger_state__';\n\nexport type InstallConsoleFileLoggerOptions = {\n  readonly service: string;\n  readonly level?: LogLevel;\n  readonly context?: LogContext;\n  readonly logDir?: string;\n  readonly fileName?: string;\n  readonly file?: Omit<FileTransportOptions, 'path'> & { readonly path?: string };\n};\n\nfunction getState(): ConsoleFileLoggerState {\n  const globalStore = globalThis as typeof globalThis & {\n    [STATE_KEY]?: ConsoleFileLoggerState;\n  };\n\n  if (!globalStore[STATE_KEY]) {\n    globalStore[STATE_KEY] = {\n      isForwarding: false,\n      originals: {},\n    };\n  }\n\n  return globalStore[STATE_KEY];\n}\n\nfunction resolveFilePath(options: InstallConsoleFileLoggerOptions): string {\n  if (options.file?.path) {\n    return options.file.path;\n  }\n\n  const directory = options.logDir || process.env.AGIMON_LOG_DIR || join(process.cwd(), '.logs');\n  const fileName = options.fileName || `${options.service}.log`;\n\n  return join(directory, fileName);\n}\n\nfunction normalizeConsoleArgs(method: ConsoleMethod, args: unknown[]): { message: string; rest: unknown[] } {\n  if (args.length === 0) {\n    return { message: `console.${method}`, rest: [] };\n  }\n\n  if (typeof args[0] === 'string') {\n    return { message: args[0], rest: args.slice(1) };\n  }\n\n  if (args[0] instanceof Error) {\n    return { message: args[0].message, rest: args };\n  }\n\n  return { message: `console.${method}`, rest: args };\n}\n\nfunction forwardToFileLogger(logger: UniversalLogger, method: ConsoleMethod, args: unknown[]): void {\n  const { message, rest } = normalizeConsoleArgs(method, args);\n\n  switch (method) {\n    case 'log':\n    case 'info':\n      logger.info(message, ...rest);\n      break;\n    case 'warn':\n      logger.warn(message, ...rest);\n      break;\n    case 'debug':\n      logger.debug(message, ...rest);\n      break;\n    case 'trace':\n      logger.trace(message, ...rest);\n      break;\n    case 'error': {\n      const [maybeError, ...others] = rest;\n      if (maybeError instanceof Error) {\n        logger.error(message, maybeError, ...others);\n      } else {\n        logger.error(message, undefined, ...rest);\n      }\n      break;\n    }\n  }\n}\n\nexport function installConsoleFileLogger(options: InstallConsoleFileLoggerOptions): UniversalLogger {\n  const state = getState();\n  if (state.logger) {\n    return state.logger;\n  }\n\n  const filePath = resolveFilePath(options);\n  const fileTransport = new FileTransport({\n    path: filePath,\n    append: options.file?.append,\n    ensureDir: options.file?.ensureDir,\n    level: options.file?.level,\n    formatter: options.file?.formatter,\n  });\n\n  const logger = createUniversalLogger({\n    service: options.service,\n    level: options.level || 'info',\n    context: options.context,\n    transports: [fileTransport],\n  });\n\n  const methods: ConsoleMethod[] = ['log', 'info', 'warn', 'error', 'debug', 'trace'];\n  for (const method of methods) {\n    const original = console[method].bind(console);\n    state.originals[method] = original;\n\n    (console as Console)[method] = (...args: unknown[]) => {\n      original(...args);\n\n      if (state.isForwarding) {\n        return;\n      }\n\n      state.isForwarding = true;\n      try {\n        forwardToFileLogger(logger, method, args);\n      } finally {\n        state.isForwarding = false;\n      }\n    };\n  }\n\n  state.logger = logger;\n  return logger;\n}\n"],"mappings":"2LAcA,MAAM,EAAY,uCAWlB,SAAS,GAAmC,CAC1C,IAAM,EAAc,WAWpB,OAPK,EAAY,KACf,EAAY,GAAa,CACvB,aAAc,GACd,UAAW,EAAE,CACd,EAGI,EAAY,GAGrB,SAAS,EAAgB,EAAkD,CAQzE,OAPI,EAAQ,MAAM,KACT,EAAQ,KAAK,MAMtB,EAAA,EAAA,MAHkB,EAAQ,QAAU,QAAQ,IAAI,iBAAA,EAAA,EAAA,MAAuB,QAAQ,KAAK,CAAE,QAAQ,CAC7E,EAAQ,UAAY,GAAG,EAAQ,QAAQ,MAExB,CAGlC,SAAS,EAAqB,EAAuB,EAAuD,CAa1G,OAZI,EAAK,SAAW,EACX,CAAE,QAAS,WAAW,IAAU,KAAM,EAAE,CAAE,CAG/C,OAAO,EAAK,IAAO,SACd,CAAE,QAAS,EAAK,GAAI,KAAM,EAAK,MAAM,EAAE,CAAE,CAG9C,EAAK,aAAc,MACd,CAAE,QAAS,EAAK,GAAG,QAAS,KAAM,EAAM,CAG1C,CAAE,QAAS,WAAW,IAAU,KAAM,EAAM,CAGrD,SAAS,EAAoB,EAAyB,EAAuB,EAAuB,CAClG,GAAM,CAAE,UAAS,QAAS,EAAqB,EAAQ,EAAK,CAE5D,OAAQ,EAAR,CACE,IAAK,MACL,IAAK,OACH,EAAO,KAAK,EAAS,GAAG,EAAK,CAC7B,MACF,IAAK,OACH,EAAO,KAAK,EAAS,GAAG,EAAK,CAC7B,MACF,IAAK,QACH,EAAO,MAAM,EAAS,GAAG,EAAK,CAC9B,MACF,IAAK,QACH,EAAO,MAAM,EAAS,GAAG,EAAK,CAC9B,MACF,IAAK,QAAS,CACZ,GAAM,CAAC,EAAY,GAAG,GAAU,EAC5B,aAAsB,MACxB,EAAO,MAAM,EAAS,EAAY,GAAG,EAAO,CAE5C,EAAO,MAAM,EAAS,IAAA,GAAW,GAAG,EAAK,CAE3C,QAKN,SAAgB,EAAyB,EAA2D,CAClG,IAAM,EAAQ,GAAU,CACxB,GAAI,EAAM,OACR,OAAO,EAAM,OAIf,IAAM,EAAgB,IAAIA,EAAAA,cAAc,CACtC,KAFe,EAAgB,EAAQ,CAGvC,OAAQ,EAAQ,MAAM,OACtB,UAAW,EAAQ,MAAM,UACzB,MAAO,EAAQ,MAAM,MACrB,UAAW,EAAQ,MAAM,UAC1B,CAAC,CAEI,GAAA,EAAA,EAAA,cAA+B,CACnC,QAAS,EAAQ,QACjB,MAAO,EAAQ,OAAS,OACxB,QAAS,EAAQ,QACjB,WAAY,CAAC,EAAc,CAC5B,CAAC,CAGF,IAAK,IAAM,IADsB,CAAC,MAAO,OAAQ,OAAQ,QAAS,QAAS,QAAQ,CACrD,CAC5B,IAAM,EAAW,QAAQ,GAAQ,KAAK,QAAQ,CAC9C,EAAM,UAAU,GAAU,EAEzB,QAAoB,IAAW,GAAG,IAAoB,CACrD,KAAS,GAAG,EAAK,CAEb,GAAM,aAIV,GAAM,aAAe,GACrB,GAAI,CACF,EAAoB,EAAQ,EAAQ,EAAK,QACjC,CACR,EAAM,aAAe,MAM3B,MADA,GAAM,OAAS,EACR"}

package/dist/installConsoleFileLogger.d.cts

@@ -0,0 +1,18 @@
+import { n as FileTransportOptions } from "./index.cjs";
+import { LogContext, LogLevel, UniversalLogger } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/installConsoleFileLogger.d.ts
+type InstallConsoleFileLoggerOptions = {
+  readonly service: string;
+  readonly level?: LogLevel;
+  readonly context?: LogContext;
+  readonly logDir?: string;
+  readonly fileName?: string;
+  readonly file?: Omit<FileTransportOptions, 'path'> & {
+    readonly path?: string;
+  };
+};
+declare function installConsoleFileLogger(options: InstallConsoleFileLoggerOptions): UniversalLogger;
+//#endregion
+export { InstallConsoleFileLoggerOptions, installConsoleFileLogger };
+//# sourceMappingURL=installConsoleFileLogger.d.cts.map

package/dist/installConsoleFileLogger.d.mts

@@ -0,0 +1,18 @@
+import { n as FileTransportOptions } from "./index.mjs";
+import { LogContext, LogLevel, UniversalLogger } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/installConsoleFileLogger.d.ts
+type InstallConsoleFileLoggerOptions = {
+  readonly service: string;
+  readonly level?: LogLevel;
+  readonly context?: LogContext;
+  readonly logDir?: string;
+  readonly fileName?: string;
+  readonly file?: Omit<FileTransportOptions, 'path'> & {
+    readonly path?: string;
+  };
+};
+declare function installConsoleFileLogger(options: InstallConsoleFileLoggerOptions): UniversalLogger;
+//#endregion
+export { InstallConsoleFileLoggerOptions, installConsoleFileLogger };
+//# sourceMappingURL=installConsoleFileLogger.d.mts.map

package/dist/installConsoleFileLogger.mjs

@@ -0,0 +1,2 @@
+import{FileTransport as e}from"./transports/file.mjs";import{join as t}from"node:path";import{createLogger as n}from"@agimon-ai/foundation-universal-logger";const r=`__agimon_console_file_logger_state__`;function i(){let e=globalThis;return e[r]||(e[r]={isForwarding:!1,originals:{}}),e[r]}function a(e){return e.file?.path?e.file.path:t(e.logDir||process.env.AGIMON_LOG_DIR||t(process.cwd(),`.logs`),e.fileName||`${e.service}.log`)}function o(e,t){return t.length===0?{message:`console.${e}`,rest:[]}:typeof t[0]==`string`?{message:t[0],rest:t.slice(1)}:t[0]instanceof Error?{message:t[0].message,rest:t}:{message:`console.${e}`,rest:t}}function s(e,t,n){let{message:r,rest:i}=o(t,n);switch(t){case`log`:case`info`:e.info(r,...i);break;case`warn`:e.warn(r,...i);break;case`debug`:e.debug(r,...i);break;case`trace`:e.trace(r,...i);break;case`error`:{let[t,...n]=i;t instanceof Error?e.error(r,t,...n):e.error(r,void 0,...i);break}}}function c(t){let r=i();if(r.logger)return r.logger;let o=new e({path:a(t),append:t.file?.append,ensureDir:t.file?.ensureDir,level:t.file?.level,formatter:t.file?.formatter}),c=n({service:t.service,level:t.level||`info`,context:t.context,transports:[o]});for(let e of[`log`,`info`,`warn`,`error`,`debug`,`trace`]){let t=console[e].bind(console);r.originals[e]=t,console[e]=(...n)=>{if(t(...n),!r.isForwarding){r.isForwarding=!0;try{s(c,e,n)}finally{r.isForwarding=!1}}}}return r.logger=c,c}export{c as installConsoleFileLogger};
+//# sourceMappingURL=installConsoleFileLogger.mjs.map

package/dist/installConsoleFileLogger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"installConsoleFileLogger.mjs","names":["createUniversalLogger"],"sources":["../src/installConsoleFileLogger.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { createLogger as createUniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport type { LogContext, LogLevel, UniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport { FileTransport } from './transports';\nimport type { FileTransportOptions } from './types';\n\ntype ConsoleMethod = 'log' | 'info' | 'warn' | 'error' | 'debug' | 'trace';\n\ntype ConsoleFileLoggerState = {\n  isForwarding: boolean;\n  logger?: UniversalLogger;\n  originals: Partial<Record<ConsoleMethod, (...args: unknown[]) => void>>;\n};\n\nconst STATE_KEY = '__agimon_console_file_logger_state__';\n\nexport type InstallConsoleFileLoggerOptions = {\n  readonly service: string;\n  readonly level?: LogLevel;\n  readonly context?: LogContext;\n  readonly logDir?: string;\n  readonly fileName?: string;\n  readonly file?: Omit<FileTransportOptions, 'path'> & { readonly path?: string };\n};\n\nfunction getState(): ConsoleFileLoggerState {\n  const globalStore = globalThis as typeof globalThis & {\n    [STATE_KEY]?: ConsoleFileLoggerState;\n  };\n\n  if (!globalStore[STATE_KEY]) {\n    globalStore[STATE_KEY] = {\n      isForwarding: false,\n      originals: {},\n    };\n  }\n\n  return globalStore[STATE_KEY];\n}\n\nfunction resolveFilePath(options: InstallConsoleFileLoggerOptions): string {\n  if (options.file?.path) {\n    return options.file.path;\n  }\n\n  const directory = options.logDir || process.env.AGIMON_LOG_DIR || join(process.cwd(), '.logs');\n  const fileName = options.fileName || `${options.service}.log`;\n\n  return join(directory, fileName);\n}\n\nfunction normalizeConsoleArgs(method: ConsoleMethod, args: unknown[]): { message: string; rest: unknown[] } {\n  if (args.length === 0) {\n    return { message: `console.${method}`, rest: [] };\n  }\n\n  if (typeof args[0] === 'string') {\n    return { message: args[0], rest: args.slice(1) };\n  }\n\n  if (args[0] instanceof Error) {\n    return { message: args[0].message, rest: args };\n  }\n\n  return { message: `console.${method}`, rest: args };\n}\n\nfunction forwardToFileLogger(logger: UniversalLogger, method: ConsoleMethod, args: unknown[]): void {\n  const { message, rest } = normalizeConsoleArgs(method, args);\n\n  switch (method) {\n    case 'log':\n    case 'info':\n      logger.info(message, ...rest);\n      break;\n    case 'warn':\n      logger.warn(message, ...rest);\n      break;\n    case 'debug':\n      logger.debug(message, ...rest);\n      break;\n    case 'trace':\n      logger.trace(message, ...rest);\n      break;\n    case 'error': {\n      const [maybeError, ...others] = rest;\n      if (maybeError instanceof Error) {\n        logger.error(message, maybeError, ...others);\n      } else {\n        logger.error(message, undefined, ...rest);\n      }\n      break;\n    }\n  }\n}\n\nexport function installConsoleFileLogger(options: InstallConsoleFileLoggerOptions): UniversalLogger {\n  const state = getState();\n  if (state.logger) {\n    return state.logger;\n  }\n\n  const filePath = resolveFilePath(options);\n  const fileTransport = new FileTransport({\n    path: filePath,\n    append: options.file?.append,\n    ensureDir: options.file?.ensureDir,\n    level: options.file?.level,\n    formatter: options.file?.formatter,\n  });\n\n  const logger = createUniversalLogger({\n    service: options.service,\n    level: options.level || 'info',\n    context: options.context,\n    transports: [fileTransport],\n  });\n\n  const methods: ConsoleMethod[] = ['log', 'info', 'warn', 'error', 'debug', 'trace'];\n  for (const method of methods) {\n    const original = console[method].bind(console);\n    state.originals[method] = original;\n\n    (console as Console)[method] = (...args: unknown[]) => {\n      original(...args);\n\n      if (state.isForwarding) {\n        return;\n      }\n\n      state.isForwarding = true;\n      try {\n        forwardToFileLogger(logger, method, args);\n      } finally {\n        state.isForwarding = false;\n      }\n    };\n  }\n\n  state.logger = logger;\n  return logger;\n}\n"],"mappings":"6JAcA,MAAM,EAAY,uCAWlB,SAAS,GAAmC,CAC1C,IAAM,EAAc,WAWpB,OAPK,EAAY,KACf,EAAY,GAAa,CACvB,aAAc,GACd,UAAW,EAAE,CACd,EAGI,EAAY,GAGrB,SAAS,EAAgB,EAAkD,CAQzE,OAPI,EAAQ,MAAM,KACT,EAAQ,KAAK,KAMf,EAHW,EAAQ,QAAU,QAAQ,IAAI,gBAAkB,EAAK,QAAQ,KAAK,CAAE,QAAQ,CAC7E,EAAQ,UAAY,GAAG,EAAQ,QAAQ,MAExB,CAGlC,SAAS,EAAqB,EAAuB,EAAuD,CAa1G,OAZI,EAAK,SAAW,EACX,CAAE,QAAS,WAAW,IAAU,KAAM,EAAE,CAAE,CAG/C,OAAO,EAAK,IAAO,SACd,CAAE,QAAS,EAAK,GAAI,KAAM,EAAK,MAAM,EAAE,CAAE,CAG9C,EAAK,aAAc,MACd,CAAE,QAAS,EAAK,GAAG,QAAS,KAAM,EAAM,CAG1C,CAAE,QAAS,WAAW,IAAU,KAAM,EAAM,CAGrD,SAAS,EAAoB,EAAyB,EAAuB,EAAuB,CAClG,GAAM,CAAE,UAAS,QAAS,EAAqB,EAAQ,EAAK,CAE5D,OAAQ,EAAR,CACE,IAAK,MACL,IAAK,OACH,EAAO,KAAK,EAAS,GAAG,EAAK,CAC7B,MACF,IAAK,OACH,EAAO,KAAK,EAAS,GAAG,EAAK,CAC7B,MACF,IAAK,QACH,EAAO,MAAM,EAAS,GAAG,EAAK,CAC9B,MACF,IAAK,QACH,EAAO,MAAM,EAAS,GAAG,EAAK,CAC9B,MACF,IAAK,QAAS,CACZ,GAAM,CAAC,EAAY,GAAG,GAAU,EAC5B,aAAsB,MACxB,EAAO,MAAM,EAAS,EAAY,GAAG,EAAO,CAE5C,EAAO,MAAM,EAAS,IAAA,GAAW,GAAG,EAAK,CAE3C,QAKN,SAAgB,EAAyB,EAA2D,CAClG,IAAM,EAAQ,GAAU,CACxB,GAAI,EAAM,OACR,OAAO,EAAM,OAIf,IAAM,EAAgB,IAAI,EAAc,CACtC,KAFe,EAAgB,EAAQ,CAGvC,OAAQ,EAAQ,MAAM,OACtB,UAAW,EAAQ,MAAM,UACzB,MAAO,EAAQ,MAAM,MACrB,UAAW,EAAQ,MAAM,UAC1B,CAAC,CAEI,EAASA,EAAsB,CACnC,QAAS,EAAQ,QACjB,MAAO,EAAQ,OAAS,OACxB,QAAS,EAAQ,QACjB,WAAY,CAAC,EAAc,CAC5B,CAAC,CAGF,IAAK,IAAM,IADsB,CAAC,MAAO,OAAQ,OAAQ,QAAS,QAAS,QAAQ,CACrD,CAC5B,IAAM,EAAW,QAAQ,GAAQ,KAAK,QAAQ,CAC9C,EAAM,UAAU,GAAU,EAEzB,QAAoB,IAAW,GAAG,IAAoB,CACrD,KAAS,GAAG,EAAK,CAEb,GAAM,aAIV,GAAM,aAAe,GACrB,GAAI,CACF,EAAoB,EAAQ,EAAQ,EAAK,QACjC,CACR,EAAM,aAAe,MAM3B,MADA,GAAM,OAAS,EACR"}

package/dist/logger.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./transports/file.cjs`);let t=require(`@agimon-ai/foundation-universal-logger`);function n(n){let r=[new t.ConsoleTransport,new e.FileTransport(n.file),...n.additionalTransports??[]];return(0,t.createLogger)({service:n.service,level:n.level,environment:n.environment,context:n.context,transports:r})}exports.createFileLogger=n;
+//# sourceMappingURL=logger.cjs.map

package/dist/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","names":["ConsoleTransport","FileTransport"],"sources":["../src/logger.ts"],"sourcesContent":["import { ConsoleTransport, createLogger as createUniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport type { UniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport { FileTransport } from './transports';\nimport type { FileLoggerOptions } from './types';\n\nexport function createFileLogger(options: FileLoggerOptions): UniversalLogger {\n  const transports = [new ConsoleTransport(), new FileTransport(options.file), ...(options.additionalTransports ?? [])];\n\n  return createUniversalLogger({\n    service: options.service,\n    level: options.level,\n    environment: options.environment,\n    context: options.context,\n    transports,\n  });\n}\n"],"mappings":"oKAKA,SAAgB,EAAiB,EAA6C,CAC5E,IAAM,EAAa,CAAC,IAAIA,EAAAA,iBAAoB,IAAIC,EAAAA,cAAc,EAAQ,KAAK,CAAE,GAAI,EAAQ,sBAAwB,EAAE,CAAE,CAErH,OAAA,EAAA,EAAA,cAA6B,CAC3B,QAAS,EAAQ,QACjB,MAAO,EAAQ,MACf,YAAa,EAAQ,YACrB,QAAS,EAAQ,QACjB,aACD,CAAC"}

package/dist/logger.d.cts

@@ -0,0 +1,8 @@
+import { t as FileLoggerOptions } from "./index.cjs";
+import { UniversalLogger } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/logger.d.ts
+declare function createFileLogger(options: FileLoggerOptions): UniversalLogger;
+//#endregion
+export { createFileLogger };
+//# sourceMappingURL=logger.d.cts.map

package/dist/logger.d.mts

@@ -0,0 +1,8 @@
+import { t as FileLoggerOptions } from "./index.mjs";
+import { UniversalLogger } from "@agimon-ai/foundation-universal-logger";
+
+//#region src/logger.d.ts
+declare function createFileLogger(options: FileLoggerOptions): UniversalLogger;
+//#endregion
+export { createFileLogger };
+//# sourceMappingURL=logger.d.mts.map

package/dist/logger.mjs

@@ -0,0 +1,2 @@
+import{FileTransport as e}from"./transports/file.mjs";import{ConsoleTransport as t,createLogger as n}from"@agimon-ai/foundation-universal-logger";function r(r){let i=[new t,new e(r.file),...r.additionalTransports??[]];return n({service:r.service,level:r.level,environment:r.environment,context:r.context,transports:i})}export{r as createFileLogger};
+//# sourceMappingURL=logger.mjs.map

package/dist/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":["createUniversalLogger"],"sources":["../src/logger.ts"],"sourcesContent":["import { ConsoleTransport, createLogger as createUniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport type { UniversalLogger } from '@agimon-ai/foundation-universal-logger';\nimport { FileTransport } from './transports';\nimport type { FileLoggerOptions } from './types';\n\nexport function createFileLogger(options: FileLoggerOptions): UniversalLogger {\n  const transports = [new ConsoleTransport(), new FileTransport(options.file), ...(options.additionalTransports ?? [])];\n\n  return createUniversalLogger({\n    service: options.service,\n    level: options.level,\n    environment: options.environment,\n    context: options.context,\n    transports,\n  });\n}\n"],"mappings":"kJAKA,SAAgB,EAAiB,EAA6C,CAC5E,IAAM,EAAa,CAAC,IAAI,EAAoB,IAAI,EAAc,EAAQ,KAAK,CAAE,GAAI,EAAQ,sBAAwB,EAAE,CAAE,CAErH,OAAOA,EAAsB,CAC3B,QAAS,EAAQ,QACjB,MAAO,EAAQ,MACf,YAAa,EAAQ,YACrB,QAAS,EAAQ,QACjB,aACD,CAAC"}

package/dist/transports/file.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`node:path`),t=require(`@agimon-ai/foundation-universal-logger`),n=require(`node:fs/promises`);var r=class{name=`file`;level;filePath;append;ensureDir;formatter;initialized=!1;writeQueue=Promise.resolve();constructor(e){this.filePath=e.path,this.append=e.append??!0,this.ensureDir=e.ensureDir??!0,this.level=e.level,this.formatter=e.formatter??new t.JsonLogFormatter}async initialize(){this.initialized||=(this.ensureDir&&await(0,n.mkdir)((0,e.dirname)(this.filePath),{recursive:!0}),this.append||await(0,n.writeFile)(this.filePath,``,`utf8`),!0)}async log(e){await this.initialize();let t=`${this.formatter.format(e)}\n`;this.writeQueue=this.writeQueue.then(()=>(0,n.appendFile)(this.filePath,t,`utf8`)).catch(()=>void 0),await this.writeQueue}};exports.FileTransport=r;
+//# sourceMappingURL=file.cjs.map

package/dist/transports/file.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.cjs","names":["JsonLogFormatter"],"sources":["../../src/transports/file.ts"],"sourcesContent":["import { appendFile, mkdir, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { JsonLogFormatter } from '@agimon-ai/foundation-universal-logger';\nimport type { LogEntry, Transport } from '@agimon-ai/foundation-universal-logger';\nimport type { FileTransportOptions } from '../types';\n\nexport class FileTransport implements Transport {\n  name = 'file';\n  level?: FileTransportOptions['level'];\n\n  private readonly filePath: string;\n  private readonly append: boolean;\n  private readonly ensureDir: boolean;\n  private readonly formatter: NonNullable<FileTransportOptions['formatter']>;\n  private initialized = false;\n  private writeQueue: Promise<void> = Promise.resolve();\n\n  constructor(options: FileTransportOptions) {\n    this.filePath = options.path;\n    this.append = options.append ?? true;\n    this.ensureDir = options.ensureDir ?? true;\n    this.level = options.level;\n    this.formatter = options.formatter ?? new JsonLogFormatter();\n  }\n\n  private async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    if (this.ensureDir) {\n      await mkdir(dirname(this.filePath), { recursive: true });\n    }\n\n    if (!this.append) {\n      await writeFile(this.filePath, '', 'utf8');\n    }\n\n    this.initialized = true;\n  }\n\n  async log(entry: LogEntry): Promise<void> {\n    await this.initialize();\n\n    const line = `${this.formatter.format(entry)}\\n`;\n    this.writeQueue = this.writeQueue.then(() => appendFile(this.filePath, line, 'utf8')).catch(() => undefined);\n    await this.writeQueue;\n  }\n}\n"],"mappings":"gLAMA,IAAa,EAAb,KAAgD,CAC9C,KAAO,OACP,MAEA,SACA,OACA,UACA,UACA,YAAsB,GACtB,WAAoC,QAAQ,SAAS,CAErD,YAAY,EAA+B,CACzC,KAAK,SAAW,EAAQ,KACxB,KAAK,OAAS,EAAQ,QAAU,GAChC,KAAK,UAAY,EAAQ,WAAa,GACtC,KAAK,MAAQ,EAAQ,MACrB,KAAK,UAAY,EAAQ,WAAa,IAAIA,EAAAA,iBAG5C,MAAc,YAA4B,CACpC,AAYJ,KAAK,eARD,KAAK,WACP,MAAA,EAAA,EAAA,QAAA,EAAA,EAAA,SAAoB,KAAK,SAAS,CAAE,CAAE,UAAW,GAAM,CAAC,CAGrD,KAAK,QACR,MAAA,EAAA,EAAA,WAAgB,KAAK,SAAU,GAAI,OAAO,CAGzB,IAGrB,MAAM,IAAI,EAAgC,CACxC,MAAM,KAAK,YAAY,CAEvB,IAAM,EAAO,GAAG,KAAK,UAAU,OAAO,EAAM,CAAC,IAC7C,KAAK,WAAa,KAAK,WAAW,UAAA,EAAA,EAAA,YAAsB,KAAK,SAAU,EAAM,OAAO,CAAC,CAAC,UAAY,IAAA,GAAU,CAC5G,MAAM,KAAK"}

package/dist/transports/file.d.cts

@@ -0,0 +1,2 @@
+import { t as FileTransport } from "../file.cjs";
+export { FileTransport };

package/dist/transports/file.d.mts

@@ -0,0 +1,2 @@
+import { t as FileTransport } from "../file.mjs";
+export { FileTransport };

package/dist/transports/file.mjs

@@ -0,0 +1,2 @@
+import{dirname as e}from"node:path";import{JsonLogFormatter as t}from"@agimon-ai/foundation-universal-logger";import{appendFile as n,mkdir as r,writeFile as i}from"node:fs/promises";var a=class{name=`file`;level;filePath;append;ensureDir;formatter;initialized=!1;writeQueue=Promise.resolve();constructor(e){this.filePath=e.path,this.append=e.append??!0,this.ensureDir=e.ensureDir??!0,this.level=e.level,this.formatter=e.formatter??new t}async initialize(){this.initialized||=(this.ensureDir&&await r(e(this.filePath),{recursive:!0}),this.append||await i(this.filePath,``,`utf8`),!0)}async log(e){await this.initialize();let t=`${this.formatter.format(e)}\n`;this.writeQueue=this.writeQueue.then(()=>n(this.filePath,t,`utf8`)).catch(()=>void 0),await this.writeQueue}};export{a as FileTransport};
+//# sourceMappingURL=file.mjs.map

package/dist/transports/file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.mjs","names":[],"sources":["../../src/transports/file.ts"],"sourcesContent":["import { appendFile, mkdir, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { JsonLogFormatter } from '@agimon-ai/foundation-universal-logger';\nimport type { LogEntry, Transport } from '@agimon-ai/foundation-universal-logger';\nimport type { FileTransportOptions } from '../types';\n\nexport class FileTransport implements Transport {\n  name = 'file';\n  level?: FileTransportOptions['level'];\n\n  private readonly filePath: string;\n  private readonly append: boolean;\n  private readonly ensureDir: boolean;\n  private readonly formatter: NonNullable<FileTransportOptions['formatter']>;\n  private initialized = false;\n  private writeQueue: Promise<void> = Promise.resolve();\n\n  constructor(options: FileTransportOptions) {\n    this.filePath = options.path;\n    this.append = options.append ?? true;\n    this.ensureDir = options.ensureDir ?? true;\n    this.level = options.level;\n    this.formatter = options.formatter ?? new JsonLogFormatter();\n  }\n\n  private async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    if (this.ensureDir) {\n      await mkdir(dirname(this.filePath), { recursive: true });\n    }\n\n    if (!this.append) {\n      await writeFile(this.filePath, '', 'utf8');\n    }\n\n    this.initialized = true;\n  }\n\n  async log(entry: LogEntry): Promise<void> {\n    await this.initialize();\n\n    const line = `${this.formatter.format(entry)}\\n`;\n    this.writeQueue = this.writeQueue.then(() => appendFile(this.filePath, line, 'utf8')).catch(() => undefined);\n    await this.writeQueue;\n  }\n}\n"],"mappings":"sLAMA,IAAa,EAAb,KAAgD,CAC9C,KAAO,OACP,MAEA,SACA,OACA,UACA,UACA,YAAsB,GACtB,WAAoC,QAAQ,SAAS,CAErD,YAAY,EAA+B,CACzC,KAAK,SAAW,EAAQ,KACxB,KAAK,OAAS,EAAQ,QAAU,GAChC,KAAK,UAAY,EAAQ,WAAa,GACtC,KAAK,MAAQ,EAAQ,MACrB,KAAK,UAAY,EAAQ,WAAa,IAAI,EAG5C,MAAc,YAA4B,CACpC,AAYJ,KAAK,eARD,KAAK,WACP,MAAM,EAAM,EAAQ,KAAK,SAAS,CAAE,CAAE,UAAW,GAAM,CAAC,CAGrD,KAAK,QACR,MAAM,EAAU,KAAK,SAAU,GAAI,OAAO,CAGzB,IAGrB,MAAM,IAAI,EAAgC,CACxC,MAAM,KAAK,YAAY,CAEvB,IAAM,EAAO,GAAG,KAAK,UAAU,OAAO,EAAM,CAAC,IAC7C,KAAK,WAAa,KAAK,WAAW,SAAW,EAAW,KAAK,SAAU,EAAM,OAAO,CAAC,CAAC,UAAY,IAAA,GAAU,CAC5G,MAAM,KAAK"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@agimon-ai/foundation-file-logger",
+  "version": "0.2.0",
+  "description": "Node-oriented logger that outputs to both console and file",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agimon-ai/foundation-universal-logger": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.6.0",
+    "tsdown": "0.21.7",
+    "typescript": "6.0.2",
+    "vitest": "4.1.4"
+  },
+  "author": "Vuong Ngo",
+  "license": "BUSL-1.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./installConsoleFileLogger": {
+      "types": "./dist/installConsoleFileLogger.d.mts",
+      "import": "./dist/installConsoleFileLogger.mjs",
+      "require": "./dist/installConsoleFileLogger.cjs"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.mts",
+      "import": "./dist/logger.mjs",
+      "require": "./dist/logger.cjs"
+    },
+    "./transports/file": {
+      "types": "./dist/transports/file.d.mts",
+      "import": "./dist/transports/file.mjs",
+      "require": "./dist/transports/file.cjs"
+    },
+    "./*": "./*"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --coverage.enabled=false",
+    "lint": "eslint src",
+    "fixcode": "pnpm exec biome check --write",
+    "typecheck": "tsc --noEmit"
+  }
+}