@venizia/ignis-helpers 0.4.8-13 → 0.4.8-14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/dist/esm/common/redact.js.map +1 -1
  2. package/dist/esm/common/types/class.d.ts +14 -12
  3. package/dist/esm/common/types/class.js.map +1 -1
  4. package/dist/esm/common/types/const-value.d.ts +3 -3
  5. package/dist/esm/common/types/const-value.js.map +1 -1
  6. package/dist/esm/common/types/injection.d.ts +1 -1
  7. package/dist/esm/common/types/injection.js.map +1 -1
  8. package/dist/esm/common/types/utility.d.ts +0 -4
  9. package/dist/esm/common/types/utility.js.map +1 -1
  10. package/dist/esm/modules/env/app-env.d.ts +17 -8
  11. package/dist/esm/modules/env/app-env.js +18 -15
  12. package/dist/esm/modules/env/app-env.js.map +1 -1
  13. package/dist/esm/modules/env/common/types.d.ts +22 -6
  14. package/dist/esm/modules/env/common/types.js.map +1 -1
  15. package/dist/esm/modules/logger/base/abstract.d.ts +6 -7
  16. package/dist/esm/modules/logger/base/abstract.js.map +1 -1
  17. package/dist/esm/modules/logger/base/base.d.ts +7 -8
  18. package/dist/esm/modules/logger/base/base.js.map +1 -1
  19. package/dist/esm/modules/logger/base/console.d.ts +6 -7
  20. package/dist/esm/modules/logger/base/console.js.map +1 -1
  21. package/dist/esm/modules/logger/common/types.d.ts +7 -7
  22. package/dist/esm/modules/logger/common/types.js.map +1 -1
  23. package/dist/esm/modules/logger/factory.js.map +1 -1
  24. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  25. package/dist/esm/modules/logger/hf/logger.d.ts +6 -7
  26. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  27. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  28. package/dist/esm/modules/logger/pino/destination.d.ts +1 -1
  29. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  30. package/dist/esm/modules/logger/pino/logger.d.ts +1 -2
  31. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  32. package/dist/esm/modules/logger/winston/formats.js +2 -2
  33. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  34. package/dist/esm/modules/logger/winston/logger.d.ts +1 -2
  35. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  36. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -1
  37. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -1
  38. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  39. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +5 -5
  40. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  41. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +1 -2
  42. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  43. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts +1 -1
  44. package/dist/esm/modules/network/http-request/fetcher/common/types.js.map +1 -1
  45. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +1 -2
  46. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +5 -6
  47. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  48. package/dist/esm/modules/network/utilities/query-string.d.ts +2 -2
  49. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  50. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  51. package/dist/esm/modules/queue/kafka/base.d.ts +1 -1
  52. package/dist/esm/modules/queue/kafka/base.js +13 -2
  53. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  54. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -1
  55. package/dist/esm/modules/redis/cluster/cluster.helper.js +10 -3
  56. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  57. package/dist/esm/modules/redis/cluster/index.d.ts +1 -0
  58. package/dist/esm/modules/redis/cluster/index.js +1 -0
  59. package/dist/esm/modules/redis/cluster/index.js.map +1 -1
  60. package/dist/esm/modules/redis/cluster/types.d.ts +20 -0
  61. package/dist/esm/modules/redis/cluster/types.js +2 -0
  62. package/dist/esm/modules/redis/cluster/types.js.map +1 -0
  63. package/dist/esm/modules/redis/common/constants.d.ts +2 -8
  64. package/dist/esm/modules/redis/common/constants.js +2 -5
  65. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  66. package/dist/esm/modules/redis/common/types.d.ts +9 -62
  67. package/dist/esm/modules/redis/common/types.js.map +1 -1
  68. package/dist/esm/modules/redis/factory.d.ts +3 -4
  69. package/dist/esm/modules/redis/factory.js.map +1 -1
  70. package/dist/esm/modules/redis/sentinel/constants.d.ts +14 -0
  71. package/dist/esm/modules/redis/sentinel/constants.js +11 -0
  72. package/dist/esm/modules/redis/sentinel/constants.js.map +1 -0
  73. package/dist/esm/modules/redis/sentinel/index.d.ts +2 -0
  74. package/dist/esm/modules/redis/sentinel/index.js +2 -0
  75. package/dist/esm/modules/redis/sentinel/index.js.map +1 -1
  76. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -1
  77. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +18 -9
  78. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  79. package/dist/esm/modules/redis/sentinel/types.d.ts +26 -0
  80. package/dist/esm/modules/redis/sentinel/types.js +2 -0
  81. package/dist/esm/modules/redis/sentinel/types.js.map +1 -0
  82. package/dist/esm/modules/redis/single/index.d.ts +1 -0
  83. package/dist/esm/modules/redis/single/index.js +1 -0
  84. package/dist/esm/modules/redis/single/index.js.map +1 -1
  85. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -1
  86. package/dist/esm/modules/redis/single/single.helper.js +1 -1
  87. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  88. package/dist/esm/modules/redis/single/types.d.ts +15 -0
  89. package/dist/esm/modules/redis/single/types.js +2 -0
  90. package/dist/esm/modules/redis/single/types.js.map +1 -0
  91. package/dist/esm/modules/secrets/base/abstract.helper.js +6 -1
  92. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  93. package/dist/esm/modules/secrets/common/types/registration.d.ts +25 -6
  94. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  95. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -1
  96. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  97. package/dist/esm/modules/secrets/factory.js +7 -6
  98. package/dist/esm/modules/secrets/factory.js.map +1 -1
  99. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +12 -10
  100. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +50 -25
  101. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  102. package/dist/esm/modules/storage/in-memory/helper.d.ts +2 -3
  103. package/dist/esm/modules/storage/in-memory/helper.js.map +1 -1
  104. package/dist/esm/modules/worker-thread/common/types.d.ts +2 -2
  105. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  106. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +2 -2
  107. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  108. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -1
  109. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  110. package/dist/esm/utilities/module.utility.d.ts +8 -5
  111. package/dist/esm/utilities/module.utility.js +5 -1
  112. package/dist/esm/utilities/module.utility.js.map +1 -1
  113. package/dist/esm/utilities/parse.utility.d.ts +34 -6
  114. package/dist/esm/utilities/parse.utility.js +82 -15
  115. package/dist/esm/utilities/parse.utility.js.map +1 -1
  116. package/dist/esm/utilities/performance.utility.d.ts +3 -3
  117. package/dist/esm/utilities/performance.utility.js.map +1 -1
  118. package/dist/esm/utilities/promise.utility.d.ts +1 -1
  119. package/dist/esm/utilities/promise.utility.js.map +1 -1
  120. package/package.json +3 -3
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/logger/factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { AbstractLogger } from './base/abstract';\nimport { ConsoleLogger } from './base/console';\nimport { LoggerDebugGate } from './common/debug-gate';\nimport { type ILogger, type ILoggerProvider, LogLevels, type TLogLevel } from './common/types';\n\n/**\n * Stable wrapper the factory hands out. The delegate is resolved on the first log call or by `use()`, never at\n * construction, so no provider is touched until a line is written. The wrapper also applies the factory's level to every\n * provider the same way. Mutual reference with LoggerFactory is by design - hence the `no-use-before-define` disables.\n */\nclass LoggerDelegator extends AbstractLogger {\n private _delegate?: ILogger;\n private _generation = -1;\n\n constructor(private readonly scope: string) {\n super();\n }\n\n /** Takes the new provider's logger for this scope at once: the wrappers of this copy do not wait for their next line. */\n repoint(provider: ILoggerProvider): void {\n this._delegate = provider.get(this.scope);\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._generation = LoggerFactory.currentGeneration();\n }\n\n /** The provider's logger for this scope, taken again whenever any copy of the module chose another provider (one integer compare per line). */\n private delegate(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const generation = LoggerFactory.currentGeneration();\n\n if (!this._delegate || this._generation !== generation) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._delegate = LoggerFactory.currentProvider().get(this.scope);\n this._generation = generation;\n }\n\n return this._delegate;\n }\n\n /** The level the application set, else the shared debug gate for `debug`: a provider that has no gate of its own is gated the same way. */\n private isEnabled(level: TLogLevel): boolean {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return false;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const threshold = LoggerFactory.currentLevel();\n\n return threshold === undefined || LogLevels.isEnabled({ level, threshold });\n }\n\n /** The one place a level method passes its line to the provider, after the one level check. */\n private forward(opts: {\n method: 'debug' | 'info' | 'warn' | 'error' | 'emerg';\n message: string;\n args: AnyType[];\n }): void {\n const { method, message, args } = opts;\n\n if (this.isEnabled(method)) {\n this.delegate()[method](message, ...args);\n }\n }\n\n debug(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.DEBUG, message, args });\n }\n\n info(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.INFO, message, args });\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.WARN, message, args });\n }\n\n error(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.ERROR, message, args });\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.EMERG, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n if (this.isEnabled(level)) {\n this.delegate().log(level, message, ...args);\n }\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return LoggerFactory.getLogger([childScope]);\n }\n}\n\n/** A bundle can carry two copies of this module - the application's ESM import and core's CJS require. The chosen provider, the level and a counter of choices live in these globalThis slots so `use()` in one copy is seen, on the next line, by the loggers of the other. */\nconst PROVIDER_SLOT = Symbol.for('ignis:logger-provider');\nconst LEVEL_SLOT = Symbol.for('ignis:logger-level');\nconst GENERATION_SLOT = Symbol.for('ignis:logger-generation');\n\n/**\n * The one way to get a logger, and the same everywhere: the server, a script and a browser. It names no provider: the\n * default is the console (`ConsoleLogger`), and an application chooses another with `use()`. It imports nothing from\n * node, so it is part of the browser-pure `core` entry.\n */\nexport class LoggerFactory {\n private static cache = new Map<string, LoggerDelegator>();\n\n /**\n * Choose the application's provider and/or the level. A provider re-points every wrapper issued so far. The level\n * (a `LogLevels` value the application passes) is applied by the wrapper to every provider alike, and it also\n * decides whether `debug` lines are written at all: `debug` turns the gate on, anything above it turns it off,\n * whatever the environment says. A level that is not a `LogLevels` value (a typo, an uppercase name from the\n * environment) is ignored: it must never open debug.\n */\n static use(opts: { provider?: ILoggerProvider; level?: TLogLevel }): void {\n const { provider, level } = opts;\n\n if (level !== undefined && LogLevels.isValid(level)) {\n Reflect.set(globalThis, LEVEL_SLOT, level);\n LoggerDebugGate.force({\n isOpen: LogLevels.isEnabled({ level: LogLevels.DEBUG, threshold: level }),\n });\n }\n\n if (provider === undefined) {\n return;\n }\n\n Reflect.set(globalThis, PROVIDER_SLOT, provider);\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(provider);\n }\n }\n\n /** Choose `provider` only when the application has not chosen one: a framework's startup default, never an override. */\n static useUnlessChosen(opts: { provider: ILoggerProvider }): void {\n if (!this.isChosen()) {\n this.use({ provider: opts.provider });\n }\n }\n\n /** Whether an application (or a framework default through `useUnlessChosen`) has chosen a provider. */\n static isChosen(): boolean {\n return this.sharedProvider() !== undefined;\n }\n\n /** The slot is the only record of the choice, so a `use()` or a `reset()` in any copy of the module is seen by all. */\n static currentProvider(): ILoggerProvider {\n return this.sharedProvider() ?? ConsoleLogger;\n }\n\n /** Moves whenever a provider is chosen or reset, in any copy: a wrapper that cached its logger takes it again. */\n static currentGeneration(): number {\n const generation: number | undefined = Reflect.get(globalThis, GENERATION_SLOT);\n\n return generation ?? 0;\n }\n\n private static bumpGeneration(): void {\n Reflect.set(globalThis, GENERATION_SLOT, this.currentGeneration() + 1);\n }\n\n /** The level the application set, or `undefined`: then every provider applies its own gate. */\n static currentLevel(): TLogLevel | undefined {\n const level: TLogLevel | undefined = Reflect.get(globalThis, LEVEL_SLOT);\n\n return level;\n }\n\n /** The provider chosen by any copy of this module, if any. */\n private static sharedProvider(): ILoggerProvider | undefined {\n const shared: ILoggerProvider | undefined = Reflect.get(globalThis, PROVIDER_SLOT);\n\n return shared;\n }\n\n /** Back to the default provider and no level, and every wrapper takes the console again: for a test, or a host that starts over. */\n static reset(): void {\n Reflect.deleteProperty(globalThis, PROVIDER_SLOT);\n Reflect.deleteProperty(globalThis, LEVEL_SLOT);\n LoggerDebugGate.force({ isOpen: undefined });\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(ConsoleLogger);\n }\n }\n\n static getLogger(scopes: string[]): ILogger {\n const scope = scopes.filter((part) => part.length > 0).join('-');\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new LoggerDelegator(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n}\n"]}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/logger/factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { AbstractLogger } from './base/abstract';\nimport { ConsoleLogger } from './base/console';\nimport { LoggerDebugGate } from './common/debug-gate';\nimport { type ILogger, type ILoggerProvider, LogLevels, type TLogLevel } from './common/types';\n\n/**\n * Stable wrapper the factory hands out. The delegate is resolved on the first log call or by `use()`, never at\n * construction, so no provider is touched until a line is written. The wrapper also applies the factory's level to every\n * provider the same way. Mutual reference with LoggerFactory is by design - hence the `no-use-before-define` disables.\n */\nclass LoggerDelegator extends AbstractLogger {\n private _delegate?: ILogger;\n private _generation = -1;\n\n constructor(private readonly scope: string) {\n super();\n }\n\n /** Takes the new provider's logger for this scope at once: the wrappers of this copy do not wait for their next line. */\n repoint(provider: ILoggerProvider): void {\n this._delegate = provider.get(this.scope);\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._generation = LoggerFactory.currentGeneration();\n }\n\n /** The provider's logger for this scope, taken again whenever any copy of the module chose another provider (one integer compare per line). */\n private delegate(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const generation = LoggerFactory.currentGeneration();\n\n if (!this._delegate || this._generation !== generation) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._delegate = LoggerFactory.currentProvider().get(this.scope);\n this._generation = generation;\n }\n\n return this._delegate;\n }\n\n /** The level the application set, else the shared debug gate for `debug`: a provider that has no gate of its own is gated the same way. */\n private isEnabled(level: TLogLevel): boolean {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return false;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const threshold = LoggerFactory.currentLevel();\n\n return threshold === undefined || LogLevels.isEnabled({ level, threshold });\n }\n\n /** The one place a level method passes its line to the provider, after the one level check. */\n private forward(opts: {\n method: 'debug' | 'info' | 'warn' | 'error' | 'emerg';\n message: string;\n args: unknown[];\n }): void {\n const { method, message, args } = opts;\n\n if (this.isEnabled(method)) {\n this.delegate()[method](message, ...args);\n }\n }\n\n debug(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.DEBUG, message, args });\n }\n\n info(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.INFO, message, args });\n }\n\n warn(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.WARN, message, args });\n }\n\n error(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.ERROR, message, args });\n }\n\n emerg(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.EMERG, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: unknown[]) {\n if (this.isEnabled(level)) {\n this.delegate().log(level, message, ...args);\n }\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return LoggerFactory.getLogger([childScope]);\n }\n}\n\n/** A bundle can carry two copies of this module - the application's ESM import and core's CJS require. The chosen provider, the level and a counter of choices live in these globalThis slots so `use()` in one copy is seen, on the next line, by the loggers of the other. */\nconst PROVIDER_SLOT = Symbol.for('ignis:logger-provider');\nconst LEVEL_SLOT = Symbol.for('ignis:logger-level');\nconst GENERATION_SLOT = Symbol.for('ignis:logger-generation');\n\n/**\n * The one way to get a logger, and the same everywhere: the server, a script and a browser. It names no provider: the\n * default is the console (`ConsoleLogger`), and an application chooses another with `use()`. It imports nothing from\n * node, so it is part of the browser-pure `core` entry.\n */\nexport class LoggerFactory {\n private static cache = new Map<string, LoggerDelegator>();\n\n /**\n * Choose the application's provider and/or the level. A provider re-points every wrapper issued so far. The level\n * (a `LogLevels` value the application passes) is applied by the wrapper to every provider alike, and it also\n * decides whether `debug` lines are written at all: `debug` turns the gate on, anything above it turns it off,\n * whatever the environment says. A level that is not a `LogLevels` value (a typo, an uppercase name from the\n * environment) is ignored: it must never open debug.\n */\n static use(opts: { provider?: ILoggerProvider; level?: TLogLevel }): void {\n const { provider, level } = opts;\n\n if (level !== undefined && LogLevels.isValid(level)) {\n Reflect.set(globalThis, LEVEL_SLOT, level);\n LoggerDebugGate.force({\n isOpen: LogLevels.isEnabled({ level: LogLevels.DEBUG, threshold: level }),\n });\n }\n\n if (provider === undefined) {\n return;\n }\n\n Reflect.set(globalThis, PROVIDER_SLOT, provider);\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(provider);\n }\n }\n\n /** Choose `provider` only when the application has not chosen one: a framework's startup default, never an override. */\n static useUnlessChosen(opts: { provider: ILoggerProvider }): void {\n if (!this.isChosen()) {\n this.use({ provider: opts.provider });\n }\n }\n\n /** Whether an application (or a framework default through `useUnlessChosen`) has chosen a provider. */\n static isChosen(): boolean {\n return this.sharedProvider() !== undefined;\n }\n\n /** The slot is the only record of the choice, so a `use()` or a `reset()` in any copy of the module is seen by all. */\n static currentProvider(): ILoggerProvider {\n return this.sharedProvider() ?? ConsoleLogger;\n }\n\n /** Moves whenever a provider is chosen or reset, in any copy: a wrapper that cached its logger takes it again. */\n static currentGeneration(): number {\n const generation: number | undefined = Reflect.get(globalThis, GENERATION_SLOT);\n\n return generation ?? 0;\n }\n\n private static bumpGeneration(): void {\n Reflect.set(globalThis, GENERATION_SLOT, this.currentGeneration() + 1);\n }\n\n /** The level the application set, or `undefined`: then every provider applies its own gate. */\n static currentLevel(): TLogLevel | undefined {\n const level: TLogLevel | undefined = Reflect.get(globalThis, LEVEL_SLOT);\n\n return level;\n }\n\n /** The provider chosen by any copy of this module, if any. */\n private static sharedProvider(): ILoggerProvider | undefined {\n const shared: ILoggerProvider | undefined = Reflect.get(globalThis, PROVIDER_SLOT);\n\n return shared;\n }\n\n /** Back to the default provider and no level, and every wrapper takes the console again: for a test, or a host that starts over. */\n static reset(): void {\n Reflect.deleteProperty(globalThis, PROVIDER_SLOT);\n Reflect.deleteProperty(globalThis, LEVEL_SLOT);\n LoggerDebugGate.force({ isOpen: undefined });\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(ConsoleLogger);\n }\n }\n\n static getLogger(scopes: string[]): ILogger {\n const scope = scopes.filter((part) => part.length > 0).join('-');\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new LoggerDelegator(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"flusher.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/flusher.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'node:fs';\nimport { type AnyType } from '@/common/types';\nimport { isPromiseLike } from '@/utilities/promise.utility';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_DEFAULT_BATCH_SIZE,\n HF_DEFAULT_FLUSH_INTERVAL_MS,\n HF_LEVEL_NAMES,\n type IHfLogFlusherOptions,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type THfSink,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Drains the ring in bounded batches, yielding between them - see the spec's lap accounting. */\nexport class HfLogFlusher {\n private static readonly textDecoder = new TextDecoder();\n\n private flushIndex = 0;\n private inFlightDrain: Promise<void> | null = null;\n private timer: ReturnType<typeof setInterval> | null = null;\n private readonly sink: THfSink;\n private readonly batchSize: number;\n\n constructor(options?: IHfLogFlusherOptions) {\n this.sink = options?.sink ?? HfLogFlusher.buildDefaultSink(options?.filePath);\n\n const batchSize = options?.batchSize ?? HF_DEFAULT_BATCH_SIZE;\n\n if (!Number.isInteger(batchSize) || batchSize < 1) {\n // console, not the Logger: this IS the drain path - routing through a logger re-enters it.\n console.warn(\n '[HfLogFlusher] Invalid batchSize | value: %s | fallback: %s',\n batchSize,\n HF_DEFAULT_BATCH_SIZE,\n );\n this.batchSize = HF_DEFAULT_BATCH_SIZE;\n } else {\n this.batchSize = batchSize;\n }\n }\n\n private static renderEntry(ring: TRingState, sequence: number): string {\n const offset = (sequence & (BUFFER_SIZE - 1)) * ENTRY_SIZE;\n const bytes = ring.bytes;\n const iso = new Date(ring.f64[offset >> 3]).toISOString();\n const levelName = HF_LEVEL_NAMES[bytes[offset + OFFSET_LEVEL]] ?? 'info';\n const scopeLength = bytes[offset + OFFSET_SCOPE_LENGTH];\n const scope = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_SCOPE, offset + OFFSET_SCOPE + scopeLength),\n );\n const messageLength = bytes[offset + OFFSET_MESSAGE_LENGTH];\n const message = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_MESSAGE, offset + OFFSET_MESSAGE + messageLength),\n );\n\n return `${iso} [${levelName}] ${scope} ${message}`;\n }\n\n private static buildDefaultSink(filePath?: string): THfSink {\n return (batch) => {\n const rendered =\n (batch.dropped > 0\n ? `${new Date().toISOString()} [warn] HfLogFlusher ring lapped - ${batch.dropped} entries overwritten before they could be read\\n`\n : '') +\n batch.lines.join('\\n') +\n '\\n';\n\n if (filePath) {\n fs.appendFileSync(filePath, rendered);\n\n return;\n }\n\n process.stdout.write(rendered);\n };\n }\n\n flush(): Promise<void> {\n if (this.inFlightDrain) {\n return this.inFlightDrain;\n }\n\n this.inFlightDrain = this.drain().finally(() => {\n this.inFlightDrain = null;\n });\n\n return this.inFlightDrain;\n }\n\n private async drain(): Promise<void> {\n const ring = HfLogRing.get();\n\n while (this.flushIndex < ring.writeIndex) {\n // Lap accounting, re-checked every batch: the producer may advance during yields.\n let dropped = 0;\n const backlog = ring.writeIndex - this.flushIndex;\n\n if (backlog > BUFFER_SIZE) {\n dropped = backlog - BUFFER_SIZE;\n this.flushIndex = ring.writeIndex - BUFFER_SIZE;\n }\n\n const count = Math.min(this.batchSize, ring.writeIndex - this.flushIndex);\n const lines: Array<string> = [];\n\n for (let index = 0; index < count; index++) {\n lines.push(HfLogFlusher.renderEntry(ring, this.flushIndex++));\n }\n\n await this.deliverBatch({ lines, dropped });\n\n if (this.flushIndex < ring.writeIndex) {\n await new Promise((resolve) => setImmediate(resolve));\n }\n }\n }\n\n private async deliverBatch(opts: { lines: Array<string>; dropped: number }): Promise<void> {\n try {\n // THfSink is typed `=> void`, but an async sink still returns a thenable at runtime - await it inside the try so its rejection is caught here, never unhandled.\n const delivered = this.sink(opts) as AnyType;\n\n if (isPromiseLike(delivered)) {\n await delivered;\n }\n } catch (error) {\n console.error('[HfLogFlusher][drain] Sink failed | error: ', error);\n }\n }\n\n start(intervalMs = HF_DEFAULT_FLUSH_INTERVAL_MS): void {\n this.stop();\n this.timer = setInterval(() => {\n this.flush().catch((error) => {\n console.error('[HfLogFlusher][start] Flush failed | error: ', error);\n });\n }, intervalMs);\n this.timer.unref?.();\n }\n\n stop(): void {\n if (this.timer) {\n clearInterval(this.timer);\n this.timer = null;\n }\n }\n}\n"]}
1
+ {"version":3,"file":"flusher.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/flusher.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'node:fs';\nimport { isPromiseLike } from '@/utilities/promise.utility';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_DEFAULT_BATCH_SIZE,\n HF_DEFAULT_FLUSH_INTERVAL_MS,\n HF_LEVEL_NAMES,\n type IHfLogFlusherOptions,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type THfSink,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Drains the ring in bounded batches, yielding between them - see the spec's lap accounting. */\nexport class HfLogFlusher {\n private static readonly textDecoder = new TextDecoder();\n\n private flushIndex = 0;\n private inFlightDrain: Promise<void> | null = null;\n private timer: ReturnType<typeof setInterval> | null = null;\n private readonly sink: THfSink;\n private readonly batchSize: number;\n\n constructor(options?: IHfLogFlusherOptions) {\n this.sink = options?.sink ?? HfLogFlusher.buildDefaultSink(options?.filePath);\n\n const batchSize = options?.batchSize ?? HF_DEFAULT_BATCH_SIZE;\n\n if (!Number.isInteger(batchSize) || batchSize < 1) {\n // console, not the Logger: this IS the drain path - routing through a logger re-enters it.\n console.warn(\n '[HfLogFlusher] Invalid batchSize | value: %s | fallback: %s',\n batchSize,\n HF_DEFAULT_BATCH_SIZE,\n );\n this.batchSize = HF_DEFAULT_BATCH_SIZE;\n } else {\n this.batchSize = batchSize;\n }\n }\n\n private static renderEntry(ring: TRingState, sequence: number): string {\n const offset = (sequence & (BUFFER_SIZE - 1)) * ENTRY_SIZE;\n const bytes = ring.bytes;\n const iso = new Date(ring.f64[offset >> 3]).toISOString();\n const levelName = HF_LEVEL_NAMES[bytes[offset + OFFSET_LEVEL]] ?? 'info';\n const scopeLength = bytes[offset + OFFSET_SCOPE_LENGTH];\n const scope = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_SCOPE, offset + OFFSET_SCOPE + scopeLength),\n );\n const messageLength = bytes[offset + OFFSET_MESSAGE_LENGTH];\n const message = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_MESSAGE, offset + OFFSET_MESSAGE + messageLength),\n );\n\n return `${iso} [${levelName}] ${scope} ${message}`;\n }\n\n private static buildDefaultSink(filePath?: string): THfSink {\n return (batch) => {\n const rendered =\n (batch.dropped > 0\n ? `${new Date().toISOString()} [warn] HfLogFlusher ring lapped - ${batch.dropped} entries overwritten before they could be read\\n`\n : '') +\n batch.lines.join('\\n') +\n '\\n';\n\n if (filePath) {\n fs.appendFileSync(filePath, rendered);\n\n return;\n }\n\n process.stdout.write(rendered);\n };\n }\n\n flush(): Promise<void> {\n if (this.inFlightDrain) {\n return this.inFlightDrain;\n }\n\n this.inFlightDrain = this.drain().finally(() => {\n this.inFlightDrain = null;\n });\n\n return this.inFlightDrain;\n }\n\n private async drain(): Promise<void> {\n const ring = HfLogRing.get();\n\n while (this.flushIndex < ring.writeIndex) {\n // Lap accounting, re-checked every batch: the producer may advance during yields.\n let dropped = 0;\n const backlog = ring.writeIndex - this.flushIndex;\n\n if (backlog > BUFFER_SIZE) {\n dropped = backlog - BUFFER_SIZE;\n this.flushIndex = ring.writeIndex - BUFFER_SIZE;\n }\n\n const count = Math.min(this.batchSize, ring.writeIndex - this.flushIndex);\n const lines: Array<string> = [];\n\n for (let index = 0; index < count; index++) {\n lines.push(HfLogFlusher.renderEntry(ring, this.flushIndex++));\n }\n\n await this.deliverBatch({ lines, dropped });\n\n if (this.flushIndex < ring.writeIndex) {\n await new Promise((resolve) => setImmediate(resolve));\n }\n }\n }\n\n private async deliverBatch(opts: { lines: Array<string>; dropped: number }): Promise<void> {\n try {\n // THfSink is typed `=> void`, but an async sink still returns a thenable at runtime - await it inside the try so its rejection is caught here, never unhandled.\n const delivered: unknown = this.sink(opts);\n\n if (isPromiseLike(delivered)) {\n await delivered;\n }\n } catch (error) {\n console.error('[HfLogFlusher][drain] Sink failed | error: ', error);\n }\n }\n\n start(intervalMs = HF_DEFAULT_FLUSH_INTERVAL_MS): void {\n this.stop();\n this.timer = setInterval(() => {\n this.flush().catch((error) => {\n console.error('[HfLogFlusher][start] Flush failed | error: ', error);\n });\n }, intervalMs);\n this.timer.unref?.();\n }\n\n stop(): void {\n if (this.timer) {\n clearInterval(this.timer);\n this.timer = null;\n }\n }\n}\n"]}
@@ -1,4 +1,3 @@
1
- import { type AnyType } from '../../../common/types/index.js';
2
1
  import { AbstractLogger } from '../base/index.js';
3
2
  import { type ILogger, type TLogLevel } from '../common/index.js';
4
3
  /** Ring-buffer logger for hot paths; extends AbstractLogger, NOT BaseLogger - BaseLogger's string-sink plumbing is exactly the cost this implementation exists to avoid. */
@@ -19,12 +18,12 @@ export declare class HfLogger extends AbstractLogger {
19
18
  private static evictOldestMessage;
20
19
  private writeEntry;
21
20
  private writeString;
22
- debug(message: string, ...args: AnyType[]): void;
23
- info(message: string, ...args: AnyType[]): void;
24
- warn(message: string, ...args: AnyType[]): void;
25
- error(message: string, ...args: AnyType[]): void;
26
- emerg(message: string, ...args: AnyType[]): void;
27
- log(level: TLogLevel, message: string, ...args: AnyType[]): void;
21
+ debug(message: string, ...args: unknown[]): void;
22
+ info(message: string, ...args: unknown[]): void;
23
+ warn(message: string, ...args: unknown[]): void;
24
+ error(message: string, ...args: unknown[]): void;
25
+ emerg(message: string, ...args: unknown[]): void;
26
+ log(level: TLogLevel, message: string, ...args: unknown[]): void;
28
27
  log(level: TLogLevel, messageBytes: Uint8Array): void;
29
28
  for(methodName: string): ILogger;
30
29
  }
@@ -1 +1 @@
1
- {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { AbstractLogger } from '../base';\nimport { type ILogger, LogLevels, LoggerDebugGate, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_LEVEL_CODES,\n HF_MESSAGE_MAX_BYTES,\n HF_SCOPE_MAX_BYTES,\n MESSAGE_CACHE_CAP,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Ring-buffer logger for hot paths; extends AbstractLogger, NOT BaseLogger - BaseLogger's string-sink plumbing is exactly the cost this implementation exists to avoid. */\nexport class HfLogger extends AbstractLogger {\n private static readonly textEncoder = new TextEncoder();\n private static readonly scopeCache = new Map<string, Uint8Array>();\n private static cache = new Map<string, HfLogger>();\n private static messageCache = new Map<string, Uint8Array>();\n\n private readonly scope: string;\n private readonly scopeBytes: Uint8Array;\n private readonly scopeLength: number;\n // Resolved once at construction (get() has already allocated the ring): saves a call and a null-check per log on a path budgeted in nanoseconds.\n private readonly ring: TRingState;\n\n private constructor(scope: string) {\n super();\n this.scope = scope;\n this.scopeBytes = HfLogger.encodeScope(scope);\n this.scopeLength = this.scopeBytes.length;\n this.ring = HfLogRing.get();\n }\n\n private static encodeScope(scope: string): Uint8Array {\n let bytes = HfLogger.scopeCache.get(scope);\n\n if (!bytes) {\n bytes = HfLogger.textEncoder.encode(scope).subarray(0, HF_SCOPE_MAX_BYTES);\n HfLogger.scopeCache.set(scope, bytes);\n }\n\n return bytes;\n }\n\n static get(scope: string): HfLogger {\n let logger = this.cache.get(scope);\n\n if (!logger) {\n logger = new HfLogger(scope); // first logger allocates the ring - never at import\n this.cache.set(scope, logger);\n }\n\n return logger;\n }\n\n /** Pre-encode a message at initialization time; the cache is FIFO-bounded so dynamic strings can't grow it without limit. */\n static encodeMessage(message: string): Uint8Array {\n const cached = this.messageCache.get(message);\n\n if (cached) {\n return cached;\n }\n\n const bytes = HfLogger.textEncoder.encode(message);\n\n if (this.messageCache.size >= MESSAGE_CACHE_CAP) {\n this.evictOldestMessage();\n }\n\n this.messageCache.set(message, bytes);\n\n return bytes;\n }\n\n private static evictOldestMessage(): void {\n const oldest = this.messageCache.keys().next().value;\n\n if (oldest === undefined) {\n return;\n }\n\n this.messageCache.delete(oldest);\n }\n\n private writeEntry(levelCode: number, messageBytes: Uint8Array): void {\n const ring = this.ring;\n const slot = ring.writeIndex++ & (BUFFER_SIZE - 1);\n const offset = slot * ENTRY_SIZE;\n ring.f64[offset >> 3] = performance.timeOrigin + performance.now();\n const bytes = ring.bytes;\n bytes[offset + OFFSET_LEVEL] = levelCode;\n bytes[offset + OFFSET_SCOPE_LENGTH] = this.scopeLength;\n bytes.set(this.scopeBytes, offset + OFFSET_SCOPE);\n const messageLength =\n messageBytes.length < HF_MESSAGE_MAX_BYTES ? messageBytes.length : HF_MESSAGE_MAX_BYTES;\n bytes[offset + OFFSET_MESSAGE_LENGTH] = messageLength;\n bytes.set(\n messageLength === messageBytes.length\n ? messageBytes\n : messageBytes.subarray(0, messageLength),\n offset + OFFSET_MESSAGE,\n );\n }\n\n private writeString(levelCode: number, message: string, args: Array<AnyType>): void {\n if (args.length > 0) {\n // Slow path, documented: args are formatted (deep inspection + redaction) - never dropped.\n this.writeEntry(\n levelCode,\n HfLogger.textEncoder.encode(LogFormatUtility.formatMessage({ message, args })),\n );\n\n return;\n }\n\n this.writeEntry(levelCode, HfLogger.encodeMessage(message));\n }\n\n debug(message: string, ...args: AnyType[]): void {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.writeString(HF_LEVEL_CODES.debug, message, args);\n }\n\n info(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.info, message, args);\n }\n\n warn(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.warn, message, args);\n }\n\n error(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.error, message, args);\n }\n\n emerg(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.emerg, message, args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]): void;\n log(level: TLogLevel, messageBytes: Uint8Array): void;\n log(level: TLogLevel, message: string | Uint8Array, ...args: AnyType[]): void {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return;\n }\n\n const levelCode = Object.hasOwn(HF_LEVEL_CODES, level)\n ? HF_LEVEL_CODES[level]\n : HF_LEVEL_CODES.info;\n\n if (typeof message === 'string') {\n this.writeString(levelCode, message, args);\n\n return;\n }\n\n this.writeEntry(levelCode, message);\n }\n\n for(methodName: string): ILogger {\n return HfLogger.get(`${this.scope}-${methodName}`);\n }\n}\n"]}
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { AbstractLogger } from '../base';\nimport { type ILogger, LogLevels, LoggerDebugGate, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_LEVEL_CODES,\n HF_MESSAGE_MAX_BYTES,\n HF_SCOPE_MAX_BYTES,\n MESSAGE_CACHE_CAP,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Ring-buffer logger for hot paths; extends AbstractLogger, NOT BaseLogger - BaseLogger's string-sink plumbing is exactly the cost this implementation exists to avoid. */\nexport class HfLogger extends AbstractLogger {\n private static readonly textEncoder = new TextEncoder();\n private static readonly scopeCache = new Map<string, Uint8Array>();\n private static cache = new Map<string, HfLogger>();\n private static messageCache = new Map<string, Uint8Array>();\n\n private readonly scope: string;\n private readonly scopeBytes: Uint8Array;\n private readonly scopeLength: number;\n // Resolved once at construction (get() has already allocated the ring): saves a call and a null-check per log on a path budgeted in nanoseconds.\n private readonly ring: TRingState;\n\n private constructor(scope: string) {\n super();\n this.scope = scope;\n this.scopeBytes = HfLogger.encodeScope(scope);\n this.scopeLength = this.scopeBytes.length;\n this.ring = HfLogRing.get();\n }\n\n private static encodeScope(scope: string): Uint8Array {\n let bytes = HfLogger.scopeCache.get(scope);\n\n if (!bytes) {\n bytes = HfLogger.textEncoder.encode(scope).subarray(0, HF_SCOPE_MAX_BYTES);\n HfLogger.scopeCache.set(scope, bytes);\n }\n\n return bytes;\n }\n\n static get(scope: string): HfLogger {\n let logger = this.cache.get(scope);\n\n if (!logger) {\n logger = new HfLogger(scope); // first logger allocates the ring - never at import\n this.cache.set(scope, logger);\n }\n\n return logger;\n }\n\n /** Pre-encode a message at initialization time; the cache is FIFO-bounded so dynamic strings can't grow it without limit. */\n static encodeMessage(message: string): Uint8Array {\n const cached = this.messageCache.get(message);\n\n if (cached) {\n return cached;\n }\n\n const bytes = HfLogger.textEncoder.encode(message);\n\n if (this.messageCache.size >= MESSAGE_CACHE_CAP) {\n this.evictOldestMessage();\n }\n\n this.messageCache.set(message, bytes);\n\n return bytes;\n }\n\n private static evictOldestMessage(): void {\n const oldest = this.messageCache.keys().next().value;\n\n if (oldest === undefined) {\n return;\n }\n\n this.messageCache.delete(oldest);\n }\n\n private writeEntry(levelCode: number, messageBytes: Uint8Array): void {\n const ring = this.ring;\n const slot = ring.writeIndex++ & (BUFFER_SIZE - 1);\n const offset = slot * ENTRY_SIZE;\n ring.f64[offset >> 3] = performance.timeOrigin + performance.now();\n const bytes = ring.bytes;\n bytes[offset + OFFSET_LEVEL] = levelCode;\n bytes[offset + OFFSET_SCOPE_LENGTH] = this.scopeLength;\n bytes.set(this.scopeBytes, offset + OFFSET_SCOPE);\n const messageLength =\n messageBytes.length < HF_MESSAGE_MAX_BYTES ? messageBytes.length : HF_MESSAGE_MAX_BYTES;\n bytes[offset + OFFSET_MESSAGE_LENGTH] = messageLength;\n bytes.set(\n messageLength === messageBytes.length\n ? messageBytes\n : messageBytes.subarray(0, messageLength),\n offset + OFFSET_MESSAGE,\n );\n }\n\n private writeString(levelCode: number, message: string, args: unknown[]): void {\n if (args.length > 0) {\n // Slow path, documented: args are formatted (deep inspection + redaction) - never dropped.\n this.writeEntry(\n levelCode,\n HfLogger.textEncoder.encode(LogFormatUtility.formatMessage({ message, args })),\n );\n\n return;\n }\n\n this.writeEntry(levelCode, HfLogger.encodeMessage(message));\n }\n\n debug(message: string, ...args: unknown[]): void {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.writeString(HF_LEVEL_CODES.debug, message, args);\n }\n\n info(message: string, ...args: unknown[]): void {\n this.writeString(HF_LEVEL_CODES.info, message, args);\n }\n\n warn(message: string, ...args: unknown[]): void {\n this.writeString(HF_LEVEL_CODES.warn, message, args);\n }\n\n error(message: string, ...args: unknown[]): void {\n this.writeString(HF_LEVEL_CODES.error, message, args);\n }\n\n emerg(message: string, ...args: unknown[]): void {\n this.writeString(HF_LEVEL_CODES.emerg, message, args);\n }\n\n log(level: TLogLevel, message: string, ...args: unknown[]): void;\n log(level: TLogLevel, messageBytes: Uint8Array): void;\n log(level: TLogLevel, message: string | Uint8Array, ...args: unknown[]): void {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return;\n }\n\n const levelCode = Object.hasOwn(HF_LEVEL_CODES, level)\n ? HF_LEVEL_CODES[level]\n : HF_LEVEL_CODES.info;\n\n if (typeof message === 'string') {\n this.writeString(levelCode, message, args);\n\n return;\n }\n\n this.writeEntry(levelCode, message);\n }\n\n for(methodName: string): ILogger {\n return HfLogger.get(`${this.scope}-${methodName}`);\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"backing.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/backing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAsB,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,oGAAoG;AACpG,MAAM,OAAO,iBAAiB;IAK5B,8KAA8K;IAC9K,MAAM,CAAC,YAAY;QACjB,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;YACzF,YAAY,EAAE,kBAAkB;SACjC,CAAC;IACJ,CAAC;IAED,sQAAsQ;IACtQ,MAAM,CAAC,GAAG;QACR,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACnF,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAC/B,iBAAiB,CAAC,YAAY,EAAE,EAChC,WAAW,CACK,CAAC;YACnB,iBAAiB,CAAC,SAAS,GAAG,WAAW,CAAC;QAC5C,CAAC;QAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,4QAA4Q;IAC5Q,MAAM,CAAC,GAAG,CAAC,IAAiC;QAC1C,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC/B,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,iBAAiB,CAAC,cAAc,EAAE,CAAC;QACrC,CAAC;QAED,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3C,iBAAiB,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,CAAC;IAEO,MAAM,CAAC,cAAc;QAC3B,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACF,iBAAiB,CAAC,SAAqB,CAAC,GAAG,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kEAAkE,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;CACF","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { type AnyType } from '@/common/types';\nimport pino from 'pino';\nimport { LoggerConfigUtility } from '../common';\n\nimport { PINO_CUSTOM_LEVELS, type TPinoInstance } from './common';\nimport { PinoDestination } from './destination';\n\n/** Owns the single pino instance every scope writes through, and the transport thread behind it. */\nexport class PinoBackingLogger {\n private static instance: TPinoInstance | undefined;\n /** The `ThreadStream` behind `instance`, held ONLY when built via a transport (pretty/roll) and `undefined` for `stdout` or an injected instance - tracked so a replacement can close the worker instead of orphaning it. */\n private static transport: pino.DestinationStream | undefined;\n\n /** Pure: pino constructor options derived from env at CALL time. Public so tests can build a REAL instance against an in-memory destination, without the impure singleton. */\n static buildOptions() {\n return {\n name: Defaults.APPLICATION_NAME,\n level: LoggerConfigUtility.resolveLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n customLevels: PINO_CUSTOM_LEVELS,\n };\n }\n\n /** Lazy, env-driven singleton, built once and reused by every scope entirely synchronously - the very first log line already targets the real env-configured destination, no stdout bootstrap. `set()` is the only way to replace it; this getter never resets it. */\n static get(): TPinoInstance {\n if (!PinoBackingLogger.instance) {\n const destination = PinoDestination.build({ plan: PinoDestination.resolvePlan() });\n PinoBackingLogger.instance = pino(\n PinoBackingLogger.buildOptions(),\n destination,\n ) as TPinoInstance;\n PinoBackingLogger.transport = destination;\n }\n\n return PinoBackingLogger.instance;\n }\n\n /** Replaces the singleton outright: an outgoing transport-backed instance (pretty/roll) is a `ThreadStream` on a live worker thread, so this flushes then `.end()`s it first rather than orphaning the worker; failures are logged via `console.error`, never swallowed. */\n static set(opts: { instance: TPinoInstance }): void {\n if (PinoBackingLogger.instance) {\n PinoBackingLogger.instance.flush();\n PinoBackingLogger.closeTransport();\n }\n\n PinoBackingLogger.instance = opts.instance;\n PinoBackingLogger.transport = undefined;\n }\n\n private static closeTransport(): void {\n if (!PinoBackingLogger.transport) {\n return;\n }\n\n try {\n (PinoBackingLogger.transport as AnyType).end();\n } catch (error) {\n console.error('[setPinoBackingLogger] Failed to close previous transport stream', error);\n }\n }\n}\n"]}
1
+ {"version":3,"file":"backing.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/backing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAsB,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,oGAAoG;AACpG,MAAM,OAAO,iBAAiB;IAK5B,8KAA8K;IAC9K,MAAM,CAAC,YAAY;QACjB,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;YACzF,YAAY,EAAE,kBAAkB;SACjC,CAAC;IACJ,CAAC;IAED,sQAAsQ;IACtQ,MAAM,CAAC,GAAG;QACR,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACnF,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAC/B,iBAAiB,CAAC,YAAY,EAAE,EAChC,WAAW,CACK,CAAC;YACnB,iBAAiB,CAAC,SAAS,GAAG,WAAW,CAAC;QAC5C,CAAC;QAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,4QAA4Q;IAC5Q,MAAM,CAAC,GAAG,CAAC,IAAiC;QAC1C,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC/B,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,iBAAiB,CAAC,cAAc,EAAE,CAAC;QACrC,CAAC;QAED,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3C,iBAAiB,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,CAAC;IAEO,MAAM,CAAC,cAAc;QAC3B,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,iBAAiB,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kEAAkE,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;CACF","sourcesContent":["import { Defaults } from '@/common/constants';\nimport pino from 'pino';\nimport { LoggerConfigUtility } from '../common';\n\nimport { PINO_CUSTOM_LEVELS, type TPinoInstance } from './common';\nimport { PinoDestination } from './destination';\n\n/** Owns the single pino instance every scope writes through, and the transport thread behind it. */\nexport class PinoBackingLogger {\n private static instance: TPinoInstance | undefined;\n /** The `ThreadStream` behind `instance`, held ONLY when built via a transport (pretty/roll) and `undefined` for `stdout` or an injected instance - tracked so a replacement can close the worker instead of orphaning it. */\n private static transport: ReturnType<typeof pino.transport> | undefined;\n\n /** Pure: pino constructor options derived from env at CALL time. Public so tests can build a REAL instance against an in-memory destination, without the impure singleton. */\n static buildOptions() {\n return {\n name: Defaults.APPLICATION_NAME,\n level: LoggerConfigUtility.resolveLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n customLevels: PINO_CUSTOM_LEVELS,\n };\n }\n\n /** Lazy, env-driven singleton, built once and reused by every scope entirely synchronously - the very first log line already targets the real env-configured destination, no stdout bootstrap. `set()` is the only way to replace it; this getter never resets it. */\n static get(): TPinoInstance {\n if (!PinoBackingLogger.instance) {\n const destination = PinoDestination.build({ plan: PinoDestination.resolvePlan() });\n PinoBackingLogger.instance = pino(\n PinoBackingLogger.buildOptions(),\n destination,\n ) as TPinoInstance;\n PinoBackingLogger.transport = destination;\n }\n\n return PinoBackingLogger.instance;\n }\n\n /** Replaces the singleton outright: an outgoing transport-backed instance (pretty/roll) is a `ThreadStream` on a live worker thread, so this flushes then `.end()`s it first rather than orphaning the worker; failures are logged via `console.error`, never swallowed. */\n static set(opts: { instance: TPinoInstance }): void {\n if (PinoBackingLogger.instance) {\n PinoBackingLogger.instance.flush();\n PinoBackingLogger.closeTransport();\n }\n\n PinoBackingLogger.instance = opts.instance;\n PinoBackingLogger.transport = undefined;\n }\n\n private static closeTransport(): void {\n if (!PinoBackingLogger.transport) {\n return;\n }\n\n try {\n PinoBackingLogger.transport.end();\n } catch (error) {\n console.error('[setPinoBackingLogger] Failed to close previous transport stream', error);\n }\n }\n}\n"]}
@@ -37,6 +37,6 @@ export declare class PinoDestination {
37
37
  /** `pino.transport()` is SYNCHRONOUS - it returns a `ThreadStream` that BUFFERS writes until its worker thread loads, so no async gating is needed; `ModuleUtility.assertInstalled` runs first so a missing optional peer fails loudly here, not as an opaque worker-thread crash. */
38
38
  static build(opts: {
39
39
  plan: TDestinationPlan;
40
- }): pino.DestinationStream | undefined;
40
+ }): ReturnType<typeof pino.transport> | undefined;
41
41
  }
42
42
  //# sourceMappingURL=destination.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"destination.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"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","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { ParseUtility } from '@/utilities/parse.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport path from 'node:path';\nimport pino from 'pino';\nimport { LoggerFormats, LoggerConfigUtility } from '../common';\n\nimport { PinoFrequencies, type TFrequency } from './common';\n\n/** Pure description of where pino should write, derived from env; `PinoDestination.build()` is the impure half that acts on it. */\nexport type TDestinationPlan =\n | { kind: 'stdout' }\n | { kind: 'pretty' }\n | {\n kind: 'roll';\n options: {\n file: string;\n frequency: TFrequency;\n size: string;\n limit: { count: number };\n mkdir: true;\n };\n };\n\n/** Reads `APP_ENV_LOGGER_*` and turns it into a destination. Warning prefixes name the operation, not the class - the tests and the published API still call these `mapFrequency`/`mapMaxFilesToCount`. */\nexport class PinoDestination {\n private static readonly DEFAULT_FREQUENCY: TFrequency = PinoFrequencies.HOURLY;\n private static readonly DEFAULT_MAX_FILES = '5d';\n\n /** `APP_ENV_LOGGER_FILE_FREQUENCY` -> pino-roll's `frequency`; an unrecognized value warns and falls back rather than throwing, so the app still boots. */\n static mapFrequency(opts: { value?: string }): TFrequency {\n const { value } = opts;\n const normalized = (value ?? '1h').trim().toLowerCase();\n\n switch (normalized) {\n case '1h': {\n return PinoFrequencies.HOURLY;\n }\n case '1d':\n case '24h': {\n return PinoFrequencies.DAILY;\n }\n default: {\n console.warn(\n '[mapFrequency] Invalid logger file frequency | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_FREQUENCY,\n );\n\n return PinoDestination.DEFAULT_FREQUENCY;\n }\n }\n }\n\n /** `null` means \"not a recognized shape\" - the caller decides what default to fall back to. */\n private static parseMaxFilesValue(value: string, frequency: TFrequency): number | null {\n const dayMatch = /^(\\d+)d$/i.exec(value);\n\n if (dayMatch) {\n const days = Number.parseInt(dayMatch[1], 10);\n\n return frequency === 'hourly' ? days * 24 : days;\n }\n\n const bareMatch = /^\\d+$/.exec(value);\n\n if (bareMatch) {\n return Number.parseInt(value, 10);\n }\n\n return null;\n }\n\n /** `APP_ENV_LOGGER_FILE_MAX_FILES` -> pino-roll's `limit.count`: `'<n>d'` scales by frequency (hourly: days*24), a bare integer is a literal count, unrecognized falls back to `'5d'`. */\n static mapMaxFilesToCount(opts: { value?: string; frequency: TFrequency }): number {\n const { value, frequency } = opts;\n const normalized = value?.trim();\n\n if (normalized) {\n const parsed = PinoDestination.parseMaxFilesValue(normalized, frequency);\n\n if (parsed !== null) {\n return parsed;\n }\n }\n\n // Unset is a normal configuration (mirror the sibling defaults) - only a PROVIDED value that failed to parse deserves a warning.\n if (normalized && normalized !== PinoDestination.DEFAULT_MAX_FILES) {\n console.warn(\n '[mapMaxFilesToCount] Invalid logger file max files value | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_MAX_FILES,\n );\n }\n\n return PinoDestination.parseMaxFilesValue(\n PinoDestination.DEFAULT_MAX_FILES,\n frequency,\n ) as number;\n }\n\n /** Pure: which destination pino should write to, derived from `APP_ENV_LOGGER_*` at CALL time. `DATE_PATTERN` is deliberately not read - pino-roll has no equivalent. */\n static resolvePlan(): TDestinationPlan {\n const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;\n\n if (folderPath && folderPath.trim() !== '') {\n const frequency = PinoDestination.mapFrequency({\n value: process.env.APP_ENV_LOGGER_FILE_FREQUENCY,\n });\n const count = PinoDestination.mapMaxFilesToCount({\n value: process.env.APP_ENV_LOGGER_FILE_MAX_FILES,\n frequency,\n });\n\n return {\n kind: 'roll',\n options: {\n file: path.join(folderPath, Defaults.APPLICATION_NAME),\n frequency,\n size:\n ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_MAX_SIZE }) ??\n '100m',\n limit: { count },\n mkdir: true,\n },\n };\n }\n\n // UNSET means NDJSON to stdout, the locked default for this provider; only an EXPLICIT `text` opts into pino-pretty, and falling back to TEXT here (winston's default) would make the documented minimal install (pino only, no pino-pretty) crash on its first log line.\n if (process.env.APP_ENV_LOGGER_FORMAT === LoggerFormats.TEXT) {\n return { kind: 'pretty' };\n }\n\n return { kind: 'stdout' };\n }\n\n /** `pino.transport()` is SYNCHRONOUS - it returns a `ThreadStream` that BUFFERS writes until its worker thread loads, so no async gating is needed; `ModuleUtility.assertInstalled` runs first so a missing optional peer fails loudly here, not as an opaque worker-thread crash. */\n static build(opts: { plan: TDestinationPlan }): pino.DestinationStream | undefined {\n const { plan } = opts;\n\n switch (plan.kind) {\n case 'stdout': {\n return undefined;\n }\n case 'pretty': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-pretty'] });\n\n // Only a decision is forwarded. Left alone, pino-pretty's own `isColorSupported` still\n // suppresses color when stdout is not a terminal - a check winston has no equivalent of.\n const colorize = LoggerConfigUtility.resolveColorize();\n\n return pino.transport({\n target: 'pino-pretty',\n ...(colorize === undefined ? {} : { options: { colorize } }),\n });\n }\n case 'roll': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-roll'] });\n\n return pino.transport({ target: 'pino-roll', options: plan.options });\n }\n default: {\n return undefined;\n }\n }\n }\n}\n"]}
1
+ {"version":3,"file":"destination.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"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","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { ParseUtility } from '@/utilities/parse.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport path from 'node:path';\nimport pino from 'pino';\nimport { LoggerFormats, LoggerConfigUtility } from '../common';\n\nimport { PinoFrequencies, type TFrequency } from './common';\n\n/** Pure description of where pino should write, derived from env; `PinoDestination.build()` is the impure half that acts on it. */\nexport type TDestinationPlan =\n | { kind: 'stdout' }\n | { kind: 'pretty' }\n | {\n kind: 'roll';\n options: {\n file: string;\n frequency: TFrequency;\n size: string;\n limit: { count: number };\n mkdir: true;\n };\n };\n\n/** Reads `APP_ENV_LOGGER_*` and turns it into a destination. Warning prefixes name the operation, not the class - the tests and the published API still call these `mapFrequency`/`mapMaxFilesToCount`. */\nexport class PinoDestination {\n private static readonly DEFAULT_FREQUENCY: TFrequency = PinoFrequencies.HOURLY;\n private static readonly DEFAULT_MAX_FILES = '5d';\n\n /** `APP_ENV_LOGGER_FILE_FREQUENCY` -> pino-roll's `frequency`; an unrecognized value warns and falls back rather than throwing, so the app still boots. */\n static mapFrequency(opts: { value?: string }): TFrequency {\n const { value } = opts;\n const normalized = (value ?? '1h').trim().toLowerCase();\n\n switch (normalized) {\n case '1h': {\n return PinoFrequencies.HOURLY;\n }\n case '1d':\n case '24h': {\n return PinoFrequencies.DAILY;\n }\n default: {\n console.warn(\n '[mapFrequency] Invalid logger file frequency | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_FREQUENCY,\n );\n\n return PinoDestination.DEFAULT_FREQUENCY;\n }\n }\n }\n\n /** `null` means \"not a recognized shape\" - the caller decides what default to fall back to. */\n private static parseMaxFilesValue(value: string, frequency: TFrequency): number | null {\n const dayMatch = /^(\\d+)d$/i.exec(value);\n\n if (dayMatch) {\n const days = Number.parseInt(dayMatch[1], 10);\n\n return frequency === 'hourly' ? days * 24 : days;\n }\n\n const bareMatch = /^\\d+$/.exec(value);\n\n if (bareMatch) {\n return Number.parseInt(value, 10);\n }\n\n return null;\n }\n\n /** `APP_ENV_LOGGER_FILE_MAX_FILES` -> pino-roll's `limit.count`: `'<n>d'` scales by frequency (hourly: days*24), a bare integer is a literal count, unrecognized falls back to `'5d'`. */\n static mapMaxFilesToCount(opts: { value?: string; frequency: TFrequency }): number {\n const { value, frequency } = opts;\n const normalized = value?.trim();\n\n if (normalized) {\n const parsed = PinoDestination.parseMaxFilesValue(normalized, frequency);\n\n if (parsed !== null) {\n return parsed;\n }\n }\n\n // Unset is a normal configuration (mirror the sibling defaults) - only a PROVIDED value that failed to parse deserves a warning.\n if (normalized && normalized !== PinoDestination.DEFAULT_MAX_FILES) {\n console.warn(\n '[mapMaxFilesToCount] Invalid logger file max files value | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_MAX_FILES,\n );\n }\n\n return PinoDestination.parseMaxFilesValue(\n PinoDestination.DEFAULT_MAX_FILES,\n frequency,\n ) as number;\n }\n\n /** Pure: which destination pino should write to, derived from `APP_ENV_LOGGER_*` at CALL time. `DATE_PATTERN` is deliberately not read - pino-roll has no equivalent. */\n static resolvePlan(): TDestinationPlan {\n const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;\n\n if (folderPath && folderPath.trim() !== '') {\n const frequency = PinoDestination.mapFrequency({\n value: process.env.APP_ENV_LOGGER_FILE_FREQUENCY,\n });\n const count = PinoDestination.mapMaxFilesToCount({\n value: process.env.APP_ENV_LOGGER_FILE_MAX_FILES,\n frequency,\n });\n\n return {\n kind: 'roll',\n options: {\n file: path.join(folderPath, Defaults.APPLICATION_NAME),\n frequency,\n size:\n ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_MAX_SIZE }) ??\n '100m',\n limit: { count },\n mkdir: true,\n },\n };\n }\n\n // UNSET means NDJSON to stdout, the locked default for this provider; only an EXPLICIT `text` opts into pino-pretty, and falling back to TEXT here (winston's default) would make the documented minimal install (pino only, no pino-pretty) crash on its first log line.\n if (process.env.APP_ENV_LOGGER_FORMAT === LoggerFormats.TEXT) {\n return { kind: 'pretty' };\n }\n\n return { kind: 'stdout' };\n }\n\n /** `pino.transport()` is SYNCHRONOUS - it returns a `ThreadStream` that BUFFERS writes until its worker thread loads, so no async gating is needed; `ModuleUtility.assertInstalled` runs first so a missing optional peer fails loudly here, not as an opaque worker-thread crash. */\n static build(opts: { plan: TDestinationPlan }): ReturnType<typeof pino.transport> | undefined {\n const { plan } = opts;\n\n switch (plan.kind) {\n case 'stdout': {\n return undefined;\n }\n case 'pretty': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-pretty'] });\n\n // Only a decision is forwarded. Left alone, pino-pretty's own `isColorSupported` still\n // suppresses color when stdout is not a terminal - a check winston has no equivalent of.\n const colorize = LoggerConfigUtility.resolveColorize();\n\n return pino.transport({\n target: 'pino-pretty',\n ...(colorize === undefined ? {} : { options: { colorize } }),\n });\n }\n case 'roll': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-roll'] });\n\n return pino.transport({ target: 'pino-roll', options: plan.options });\n }\n default: {\n return undefined;\n }\n }\n }\n}\n"]}
@@ -1,4 +1,3 @@
1
- import { type AnyType } from '../../../common/types/index.js';
2
1
  import { BaseLogger } from '../base/index.js';
3
2
  import { type ILogger, type TLogLevel } from '../common/index.js';
4
3
  /** pino provider satisfying `ILoggerProvider`, staying pino-native: numeric levels, `msg`, epoch `time`, pid/hostname pass through unchanged. No custom-instance param on `get()` unlike `WinstonLogger.get` - advanced/test injection goes through `PinoBackingLogger.set()`. */
@@ -10,7 +9,7 @@ export declare class PinoLogger extends BaseLogger {
10
9
  protected write(opts: {
11
10
  level: TLogLevel;
12
11
  message: string;
13
- args: Array<AnyType>;
12
+ args: unknown[];
14
13
  }): void;
15
14
  protected child(opts: {
16
15
  scope: string;
@@ -1 +1 @@
1
- {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,kRAAkR;AAClR,MAAM,OAAO,UAAW,SAAQ,UAAU;aACzB,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,YAAoB,KAAa;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6JAA6J;IACnJ,KAAK,CAAC,IAAiE;QAC/E,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5E,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAa,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { BaseLogger } from '../base';\nimport { type ILogger, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport { PinoBackingLogger } from './backing';\n\n/** pino provider satisfying `ILoggerProvider`, staying pino-native: numeric levels, `msg`, epoch `time`, pid/hostname pass through unchanged. No custom-instance param on `get()` unlike `WinstonLogger.get` - advanced/test injection goes through `PinoBackingLogger.set()`. */\nexport class PinoLogger extends BaseLogger {\n private static cache = new Map<string, PinoLogger>();\n\n private constructor(scope: string) {\n super({ scope });\n }\n\n static get(scope: string): PinoLogger {\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new PinoLogger(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n\n /** Resolves the backing instance at WRITE time and never caches it, so `PinoBackingLogger.set()` takes effect for every already-issued scope immediately. */\n protected write(opts: { level: TLogLevel; message: string; args: Array<AnyType> }) {\n const line =\n opts.args.length > 0\n ? LogFormatUtility.formatMessage({ message: opts.message, args: opts.args })\n : opts.message;\n\n const backing = PinoBackingLogger.get() as AnyType;\n backing[opts.level](this._formattedPrefix + line);\n }\n\n protected child(opts: { scope: string }): ILogger {\n return PinoLogger.get(opts.scope);\n }\n}\n"]}
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,kRAAkR;AAClR,MAAM,OAAO,UAAW,SAAQ,UAAU;aACzB,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,YAAoB,KAAa;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6JAA6J;IACnJ,KAAK,CAAC,IAA4D;QAC1E,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5E,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import { BaseLogger } from '../base';\nimport { type ILogger, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport { PinoBackingLogger } from './backing';\n\n/** pino provider satisfying `ILoggerProvider`, staying pino-native: numeric levels, `msg`, epoch `time`, pid/hostname pass through unchanged. No custom-instance param on `get()` unlike `WinstonLogger.get` - advanced/test injection goes through `PinoBackingLogger.set()`. */\nexport class PinoLogger extends BaseLogger {\n private static cache = new Map<string, PinoLogger>();\n\n private constructor(scope: string) {\n super({ scope });\n }\n\n static get(scope: string): PinoLogger {\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new PinoLogger(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n\n /** Resolves the backing instance at WRITE time and never caches it, so `PinoBackingLogger.set()` takes effect for every already-issued scope immediately. */\n protected write(opts: { level: TLogLevel; message: string; args: unknown[] }) {\n const line =\n opts.args.length > 0\n ? LogFormatUtility.formatMessage({ message: opts.message, args: opts.args })\n : opts.message;\n\n const backing = PinoBackingLogger.get();\n backing[opts.level](this._formattedPrefix + line);\n }\n\n protected child(opts: { scope: string }): ILogger {\n return PinoLogger.get(opts.scope);\n }\n}\n"]}
@@ -18,8 +18,8 @@ export class WinstonFormatFactory {
18
18
  /** Drop-in replacement for `winston.format.splat()` that formats through {@link LogFormatUtility.formatMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */
19
19
  static deepSplat() {
20
20
  return f((info) => {
21
- const args = info[SPLAT];
22
- if (!args?.length || typeof info.message !== 'string') {
21
+ const args = Reflect.get(info, SPLAT);
22
+ if (!Array.isArray(args) || !args.length || typeof info.message !== 'string') {
23
23
  return info;
24
24
  }
25
25
  info.message = LogFormatUtility.formatMessage({ message: info.message, args });
@@ -1 +1 @@
1
- {"version":3,"file":"formats.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/formats.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@venizia/ignis-inversion';\nimport winston from 'winston';\nimport { type AnyType } from '@/common/types';\nimport { LOGGER_FORMAT, LOGGER_PREFIX } from './common/constants';\nimport { LoggerFormats, LoggerConfigUtility, type TLoggerFormat } from '../common';\nimport { LogFormatUtility } from '../formatting';\n\nconst f = winston.format;\n\n/** Winston stashes the extra arguments of `logger.error(msg, ...args)` under this well-known key. */\nconst SPLAT = Symbol.for('splat');\n\n/**\n * Static methods never reach a sibling through `this` - the exported names in `define.ts` are\n * unbound aliases (`WinstonFormatFactory.method`), so `this` would be `undefined` there.\n */\nexport class WinstonFormatFactory {\n /** Per-line prep: label, timestamp, error normalization, deep splat. Final-string assembly is per-transport, so console can colorize while files/UDP get plain lines. */\n static prep(opts: { label: string }) {\n return f.combine(\n f.label({ label: opts.label }),\n f.timestamp(),\n f.errors({ stack: true }),\n WinstonFormatFactory.deepSplat(),\n );\n }\n\n /** Drop-in replacement for `winston.format.splat()` that formats through {@link LogFormatUtility.formatMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */\n static deepSplat() {\n return f((info) => {\n const args = (info as AnyType)[SPLAT] as Array<unknown> | undefined;\n\n if (!args?.length || typeof info.message !== 'string') {\n return info;\n }\n\n info.message = LogFormatUtility.formatMessage({ message: info.message, args });\n\n return info;\n })();\n }\n\n static textLine() {\n return f.printf(({ level, message, label, timestamp }) => {\n return `${timestamp} [${label}] ${level}: ${message}`;\n });\n }\n\n static json(opts: { label: string }) {\n return f.combine(WinstonFormatFactory.prep({ label: opts.label }), f.json());\n }\n\n static pretty(opts: { label: string; colorize?: boolean }) {\n // winston has no terminal detection of its own, so \"no opinion\" keeps the historical default.\n const { label, colorize = LoggerConfigUtility.resolveColorize() ?? true } = opts;\n\n if (colorize) {\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n f.colorize(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n static log(opts: { label: string; format?: TLoggerFormat }) {\n const format = opts.format ?? (LOGGER_FORMAT as TLoggerFormat);\n\n switch (format) {\n case LoggerFormats.JSON: {\n return WinstonFormatFactory.json({ label: opts.label });\n }\n case LoggerFormats.TEXT: {\n return WinstonFormatFactory.pretty({ label: opts.label });\n }\n default: {\n throw getError({\n message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n /** Per-transport assembly formats: console may colorize, a file never does - ANSI bytes in a rotated log file are noise every grep has to strip. */\n static assembly(opts: { format: TLoggerFormat; colorize: boolean }) {\n switch (opts.format) {\n case LoggerFormats.JSON: {\n return { console: f.json(), file: f.json() };\n }\n case LoggerFormats.TEXT: {\n return {\n console: opts.colorize\n ? f.combine(f.align(), f.colorize(), WinstonFormatFactory.textLine())\n : f.combine(f.align(), WinstonFormatFactory.textLine()),\n file: f.combine(f.align(), WinstonFormatFactory.textLine()),\n };\n }\n default: {\n throw getError({\n message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n static readonly applicationLogFormatter: winston.Logform.Format = WinstonFormatFactory.log({\n label: LOGGER_PREFIX,\n });\n}\n"]}
1
+ {"version":3,"file":"formats.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/formats.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@venizia/ignis-inversion';\nimport winston from 'winston';\nimport { LOGGER_FORMAT, LOGGER_PREFIX } from './common/constants';\nimport { LoggerFormats, LoggerConfigUtility, type TLoggerFormat } from '../common';\nimport { LogFormatUtility } from '../formatting';\n\nconst f = winston.format;\n\n/** Winston stashes the extra arguments of `logger.error(msg, ...args)` under this well-known key. */\nconst SPLAT = Symbol.for('splat');\n\n/**\n * Static methods never reach a sibling through `this` - the exported names in `define.ts` are\n * unbound aliases (`WinstonFormatFactory.method`), so `this` would be `undefined` there.\n */\nexport class WinstonFormatFactory {\n /** Per-line prep: label, timestamp, error normalization, deep splat. Final-string assembly is per-transport, so console can colorize while files/UDP get plain lines. */\n static prep(opts: { label: string }) {\n return f.combine(\n f.label({ label: opts.label }),\n f.timestamp(),\n f.errors({ stack: true }),\n WinstonFormatFactory.deepSplat(),\n );\n }\n\n /** Drop-in replacement for `winston.format.splat()` that formats through {@link LogFormatUtility.formatMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */\n static deepSplat() {\n return f((info) => {\n const args: unknown = Reflect.get(info, SPLAT);\n\n if (!Array.isArray(args) || !args.length || typeof info.message !== 'string') {\n return info;\n }\n\n info.message = LogFormatUtility.formatMessage({ message: info.message, args });\n\n return info;\n })();\n }\n\n static textLine() {\n return f.printf(({ level, message, label, timestamp }) => {\n return `${timestamp} [${label}] ${level}: ${message}`;\n });\n }\n\n static json(opts: { label: string }) {\n return f.combine(WinstonFormatFactory.prep({ label: opts.label }), f.json());\n }\n\n static pretty(opts: { label: string; colorize?: boolean }) {\n // winston has no terminal detection of its own, so \"no opinion\" keeps the historical default.\n const { label, colorize = LoggerConfigUtility.resolveColorize() ?? true } = opts;\n\n if (colorize) {\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n f.colorize(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n static log(opts: { label: string; format?: TLoggerFormat }) {\n const format = opts.format ?? (LOGGER_FORMAT as TLoggerFormat);\n\n switch (format) {\n case LoggerFormats.JSON: {\n return WinstonFormatFactory.json({ label: opts.label });\n }\n case LoggerFormats.TEXT: {\n return WinstonFormatFactory.pretty({ label: opts.label });\n }\n default: {\n throw getError({\n message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n /** Per-transport assembly formats: console may colorize, a file never does - ANSI bytes in a rotated log file are noise every grep has to strip. */\n static assembly(opts: { format: TLoggerFormat; colorize: boolean }) {\n switch (opts.format) {\n case LoggerFormats.JSON: {\n return { console: f.json(), file: f.json() };\n }\n case LoggerFormats.TEXT: {\n return {\n console: opts.colorize\n ? f.combine(f.align(), f.colorize(), WinstonFormatFactory.textLine())\n : f.combine(f.align(), WinstonFormatFactory.textLine()),\n file: f.combine(f.align(), WinstonFormatFactory.textLine()),\n };\n }\n default: {\n throw getError({\n message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n static readonly applicationLogFormatter: winston.Logform.Format = WinstonFormatFactory.log({\n label: LOGGER_PREFIX,\n });\n}\n"]}
@@ -1,5 +1,4 @@
1
1
  import type winston from 'winston';
2
- import { type AnyType } from '../../../common/types/index.js';
3
2
  import { BaseLogger } from '../base/index.js';
4
3
  import { type ILogger, type TLogLevel } from '../common/index.js';
5
4
  /** `ILogger` backed by winston, obtained with `get(scope)`; also exported as `Logger`. Lines below the winston logger level are skipped before formatting. */
@@ -12,7 +11,7 @@ export declare class WinstonLogger extends BaseLogger {
12
11
  protected write(opts: {
13
12
  level: TLogLevel;
14
13
  message: string;
15
- args: Array<AnyType>;
14
+ args: unknown[];
16
15
  }): void;
17
16
  protected child(opts: {
18
17
  scope: string;
@@ -1 +1 @@
1
- {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/logger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,8JAA8J;AAC9J,MAAM,OAAO,aAAc,SAAQ,UAAU;aAC5B,UAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAGxD,YAAoB,KAAa,EAAE,MAAsB;QACvD,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,4KAA4K;IAC5K,MAAM,CAAC,GAAG,CAAC,KAAa,EAAE,YAA6B;QACrD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAES,KAAK,CAAC,IAAiE;QAC/E,mFAAmF;QACnF,+FAA+F;QAC/F,6FAA6F;QAC7F,oCAAoC;QACpC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,IAAI,IAAI,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;YAC1C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;;AAGH,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,CAAC","sourcesContent":["import type winston from 'winston';\nimport { type AnyType } from '@/common/types';\nimport { BaseLogger } from '../base';\nimport { type ILogger, type TLogLevel } from '../common';\nimport { defaultWinstonLogger } from './define';\n\n/** `ILogger` backed by winston, obtained with `get(scope)`; also exported as `Logger`. Lines below the winston logger level are skipped before formatting. */\nexport class WinstonLogger extends BaseLogger {\n private static cache = new Map<string, WinstonLogger>();\n private readonly _logger: winston.Logger;\n\n private constructor(scope: string, logger: winston.Logger) {\n super({ scope });\n this._logger = logger;\n }\n\n /** Default-backed loggers are cached per scope; a custom-backed logger is a fresh wrapper every call - a scope-keyed cache can't tell different winston instances apart. */\n static get(scope: string, customLogger?: winston.Logger): WinstonLogger {\n if (customLogger) {\n return new WinstonLogger(scope, customLogger);\n }\n\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new WinstonLogger(scope, defaultWinstonLogger);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n\n protected write(opts: { level: TLogLevel; message: string; args: Array<AnyType> }) {\n // Asked BEFORE handing the line to winston. The deep-splat format - redaction plus\n // `util.inspect` over the whole argument graph - runs as part of winston's pipeline, so a line\n // the level was going to discard was formatted in full first. Measured: 3.6 us per discarded\n // line, against 0.08 us once gated.\n if (!this._logger.isLevelEnabled(opts.level)) {\n return;\n }\n\n this._logger.log(opts.level, this._formattedPrefix + opts.message, ...opts.args);\n }\n\n protected child(opts: { scope: string }): ILogger {\n if (this._logger === defaultWinstonLogger) {\n return WinstonLogger.get(opts.scope);\n }\n\n return new WinstonLogger(opts.scope, this._logger);\n }\n}\n\nexport { WinstonLogger as Logger };\n"]}
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,8JAA8J;AAC9J,MAAM,OAAO,aAAc,SAAQ,UAAU;aAC5B,UAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAGxD,YAAoB,KAAa,EAAE,MAAsB;QACvD,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,4KAA4K;IAC5K,MAAM,CAAC,GAAG,CAAC,KAAa,EAAE,YAA6B;QACrD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAES,KAAK,CAAC,IAA4D;QAC1E,mFAAmF;QACnF,+FAA+F;QAC/F,6FAA6F;QAC7F,oCAAoC;QACpC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,IAAI,IAAI,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;YAC1C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;;AAGH,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,CAAC","sourcesContent":["import type winston from 'winston';\nimport { BaseLogger } from '../base';\nimport { type ILogger, type TLogLevel } from '../common';\nimport { defaultWinstonLogger } from './define';\n\n/** `ILogger` backed by winston, obtained with `get(scope)`; also exported as `Logger`. Lines below the winston logger level are skipped before formatting. */\nexport class WinstonLogger extends BaseLogger {\n private static cache = new Map<string, WinstonLogger>();\n private readonly _logger: winston.Logger;\n\n private constructor(scope: string, logger: winston.Logger) {\n super({ scope });\n this._logger = logger;\n }\n\n /** Default-backed loggers are cached per scope; a custom-backed logger is a fresh wrapper every call - a scope-keyed cache can't tell different winston instances apart. */\n static get(scope: string, customLogger?: winston.Logger): WinstonLogger {\n if (customLogger) {\n return new WinstonLogger(scope, customLogger);\n }\n\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new WinstonLogger(scope, defaultWinstonLogger);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n\n protected write(opts: { level: TLogLevel; message: string; args: unknown[] }) {\n // Asked BEFORE handing the line to winston. The deep-splat format - redaction plus\n // `util.inspect` over the whole argument graph - runs as part of winston's pipeline, so a line\n // the level was going to discard was formatted in full first. Measured: 3.6 us per discarded\n // line, against 0.08 us once gated.\n if (!this._logger.isLevelEnabled(opts.level)) {\n return;\n }\n\n this._logger.log(opts.level, this._formattedPrefix + opts.message, ...opts.args);\n }\n\n protected child(opts: { scope: string }): ILogger {\n if (this._logger === defaultWinstonLogger) {\n return WinstonLogger.get(opts.scope);\n }\n\n return new WinstonLogger(opts.scope, this._logger);\n }\n}\n\nexport { WinstonLogger as Logger };\n"]}
@@ -17,7 +17,7 @@ export declare class DgramTransport extends Transport {
17
17
  message: string;
18
18
  label?: string;
19
19
  timestamp?: string;
20
- [extra: symbol]: any;
20
+ [extra: symbol]: unknown;
21
21
  }, callback: () => void): void;
22
22
  }
23
23
  //# sourceMappingURL=dgram.transport.d.ts.map
@@ -39,7 +39,7 @@ export class DgramTransport extends Transport {
39
39
  this.emit('logged', opts);
40
40
  });
41
41
  const logLevel = opts[Symbol.for('level')];
42
- if (!this.triggerLevels.has(logLevel)) {
42
+ if (typeof logLevel !== 'string' || !this.triggerLevels.has(logLevel)) {
43
43
  callback();
44
44
  return;
45
45
  }
@@ -1 +1 @@
1
- {"version":3,"file":"dgram.transport.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/transports/dgram.transport.ts"],"names":[],"mappings":"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","sourcesContent":["import dgram from 'node:dgram';\nimport Transport from 'winston-transport';\nimport { type IDgramTransportOptions } from '../common';\n\n/** Winston transport that sends the lines of the configured levels as UDP datagrams. A send failure is reported to the console and the socket is reopened on the next line; it never throws. `fromPartial` returns `null` when `label`, `host`, `port`, `levels` or `socketOptions` is missing. */\nexport class DgramTransport extends Transport {\n private label: string;\n private host: string;\n private port: number;\n private triggerLevels: Set<string>;\n private socketOptions: dgram.SocketOptions;\n\n private client: dgram.Socket | null;\n\n constructor(opts: IDgramTransportOptions) {\n const { label, host, port, levels, socketOptions, ...defaultTransportOptions } = opts;\n super(defaultTransportOptions);\n\n this.label = label;\n this.host = host;\n this.port = port;\n this.triggerLevels = new Set(levels);\n this.socketOptions = socketOptions;\n\n this.establish({ socketOptions: this.socketOptions });\n }\n\n static fromPartial(opts?: Partial<IDgramTransportOptions>): DgramTransport | null {\n if (\n !opts?.label ||\n !opts?.host ||\n !opts?.port ||\n !opts?.levels?.length ||\n !opts?.socketOptions\n ) {\n return null;\n }\n\n return new DgramTransport(opts as IDgramTransportOptions);\n }\n\n private establish(opts: { socketOptions: dgram.SocketOptions }) {\n this.client = dgram.createSocket(opts.socketOptions);\n\n this.client.on('error', (error) => {\n this.client?.close();\n this.client = null;\n\n console.error('[dgram][error] Error: ', error);\n });\n }\n\n private formatMessage(opts: { [extra: string | symbol]: any }) {\n const { timestamp, label, message, ...rest } = opts;\n\n return [timestamp, `[${this.label ?? label}]`, rest[Symbol.for('level')], message].join(' ');\n }\n\n override log(\n opts: {\n level: string;\n message: string;\n label?: string;\n timestamp?: string;\n [extra: symbol]: any;\n },\n callback: () => void,\n ) {\n setImmediate(() => {\n this.emit('logged', opts);\n });\n\n const logLevel = opts[Symbol.for('level')];\n\n if (!this.triggerLevels.has(logLevel)) {\n callback();\n\n return;\n }\n\n if (!this.client) {\n this.establish({ socketOptions: this.socketOptions });\n }\n\n const message = this.formatMessage(opts);\n this.client?.send(message, this.port, this.host, (error) => {\n if (error) {\n // console, not the Logger and not an 'error' EVENT: routing through the Logger would re-enter this very transport, and emitting 'error' with no listener attached kills the process over one lost UDP log line. Drop the socket so the next line reconnects.\n console.error('[DgramTransport][log] Failed to ship log line | error: ', error);\n this.client?.close();\n this.client = null;\n }\n\n callback();\n });\n }\n}\n"]}
1
+ {"version":3,"file":"dgram.transport.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/transports/dgram.transport.ts"],"names":[],"mappings":"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","sourcesContent":["import dgram from 'node:dgram';\nimport Transport from 'winston-transport';\nimport { type IDgramTransportOptions } from '../common';\n\n/** Winston transport that sends the lines of the configured levels as UDP datagrams. A send failure is reported to the console and the socket is reopened on the next line; it never throws. `fromPartial` returns `null` when `label`, `host`, `port`, `levels` or `socketOptions` is missing. */\nexport class DgramTransport extends Transport {\n private label: string;\n private host: string;\n private port: number;\n private triggerLevels: Set<string>;\n private socketOptions: dgram.SocketOptions;\n\n private client: dgram.Socket | null;\n\n constructor(opts: IDgramTransportOptions) {\n const { label, host, port, levels, socketOptions, ...defaultTransportOptions } = opts;\n super(defaultTransportOptions);\n\n this.label = label;\n this.host = host;\n this.port = port;\n this.triggerLevels = new Set(levels);\n this.socketOptions = socketOptions;\n\n this.establish({ socketOptions: this.socketOptions });\n }\n\n static fromPartial(opts?: Partial<IDgramTransportOptions>): DgramTransport | null {\n if (\n !opts?.label ||\n !opts?.host ||\n !opts?.port ||\n !opts?.levels?.length ||\n !opts?.socketOptions\n ) {\n return null;\n }\n\n return new DgramTransport(opts as IDgramTransportOptions);\n }\n\n private establish(opts: { socketOptions: dgram.SocketOptions }) {\n this.client = dgram.createSocket(opts.socketOptions);\n\n this.client.on('error', (error) => {\n this.client?.close();\n this.client = null;\n\n console.error('[dgram][error] Error: ', error);\n });\n }\n\n private formatMessage(opts: { [extra: string | symbol]: unknown }) {\n const { timestamp, label, message, ...rest } = opts;\n\n return [timestamp, `[${this.label ?? label}]`, rest[Symbol.for('level')], message].join(' ');\n }\n\n override log(\n opts: {\n level: string;\n message: string;\n label?: string;\n timestamp?: string;\n [extra: symbol]: unknown;\n },\n callback: () => void,\n ) {\n setImmediate(() => {\n this.emit('logged', opts);\n });\n\n const logLevel = opts[Symbol.for('level')];\n\n if (typeof logLevel !== 'string' || !this.triggerLevels.has(logLevel)) {\n callback();\n\n return;\n }\n\n if (!this.client) {\n this.establish({ socketOptions: this.socketOptions });\n }\n\n const message = this.formatMessage(opts);\n this.client?.send(message, this.port, this.host, (error) => {\n if (error) {\n // console, not the Logger and not an 'error' EVENT: routing through the Logger would re-enter this very transport, and emitting 'error' with no listener attached kills the process over one lost UDP log line. Drop the socket so the next line reconnects.\n console.error('[DgramTransport][log] Failed to ship log line | error: ', error);\n this.client?.close();\n this.client = null;\n }\n\n callback();\n });\n }\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { type AnyObject, type THttpMethod } from '../../../../common/index.js';
1
+ import { type THttpMethod } from '../../../../common/index.js';
2
2
  import { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';
3
3
  import { BaseNetworkRequest } from '../base-network-request.helper.js';
4
4
  import type { ILogger } from '../../../logger/common/types.js';
@@ -7,14 +7,14 @@ import { AbstractNetworkFetchableHelper, type IRequestOptions } from './base-fet
7
7
  export interface IAxiosRequestOptions extends AxiosRequestConfig, IRequestOptions {
8
8
  url: string;
9
9
  method?: THttpMethod;
10
- params?: AnyObject;
11
- body?: AnyObject;
12
- headers?: AnyObject;
10
+ params?: Record<string, unknown>;
11
+ body?: Record<string, unknown>;
12
+ headers?: Record<string, string>;
13
13
  /** Whether this call rejects an HTTPS server whose certificate fails verification; `false` turns verification off for this call. */
14
14
  rejectUnauthorized?: boolean;
15
15
  }
16
16
  /** Fetcher over an axios instance (`getWorker()`). HTTPS calls share one keep-alive agent that verifies certificates unless `rejectUnauthorized` is `false`; an `httpsAgent` passed in the request wins. */
17
- export declare class AxiosFetcher extends AbstractNetworkFetchableHelper<'axios', IAxiosRequestOptions, AxiosResponse<any, any>['data'], AxiosInstance> {
17
+ export declare class AxiosFetcher extends AbstractNetworkFetchableHelper<'axios', IAxiosRequestOptions, AxiosResponse<unknown>, AxiosInstance> {
18
18
  /**
19
19
  * One agent for the instance, not one per request. Built here so TLS verification is decided
20
20
  * ONCE, at construction, rather than per call - and so connections are actually reused: a fresh
@@ -1 +1 @@
1
- {"version":3,"file":"axios-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/axios-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyObject, HTTP, type THttpMethod } from '@/common';\nimport { RedactUtility } from '@/common/redact';\nimport axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';\nimport https from 'node:https';\nimport { stringify } from 'node:querystring';\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { AbstractNetworkFetchableHelper, type IRequestOptions } from './base-fetcher';\n\n/** Request accepted by `AxiosFetcher`: an axios config where `body` is sent as the axios `data`. `rejectUnauthorized` set here overrides the instance setting for this call. */\nexport interface IAxiosRequestOptions extends AxiosRequestConfig, IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n body?: AnyObject;\n headers?: AnyObject;\n /** Whether this call rejects an HTTPS server whose certificate fails verification; `false` turns verification off for this call. */\n rejectUnauthorized?: boolean;\n}\n\n/** Fetcher over an axios instance (`getWorker()`). HTTPS calls share one keep-alive agent that verifies certificates unless `rejectUnauthorized` is `false`; an `httpsAgent` passed in the request wins. */\nexport class AxiosFetcher extends AbstractNetworkFetchableHelper<\n 'axios',\n IAxiosRequestOptions,\n // The named type, not the `axios.` NAMESPACE: the namespace form resolves only under node16\n // module resolution, and this package also emits an ESM build under `bundler` resolution.\n AxiosResponse<any, any>['data'],\n AxiosInstance\n> {\n /**\n * One agent for the instance, not one per request. Built here so TLS verification is decided\n * ONCE, at construction, rather than per call - and so connections are actually reused: a fresh\n * agent per request forces a new TCP and TLS handshake every time (measured: 10 handshakes for 10\n * requests, versus 1).\n */\n private readonly httpsAgent: https.Agent;\n\n constructor(opts: {\n name: string;\n defaultConfigs: AxiosRequestConfig;\n logger?: ILogger;\n /**\n * Whether this instance rejects an HTTPS server whose certificate fails verification.\n * `false` turns verification off.\n * @default true\n */\n rejectUnauthorized?: boolean;\n }) {\n super({ name: opts.name, variant: 'axios' });\n const { defaultConfigs } = opts;\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.httpsAgent = new https.Agent({\n keepAlive: true,\n rejectUnauthorized: opts.rejectUnauthorized ?? true,\n });\n\n this.worker = axios.create({ ...defaultConfigs });\n }\n\n override send<T = unknown>(opts: IAxiosRequestOptions, logger?: ILogger) {\n const { url, method = HTTP.Methods.GET, params = {}, body: data, headers, ...rest } = opts;\n const props: AxiosRequestConfig = {\n url,\n method: method.toUpperCase(),\n params,\n data,\n headers,\n paramsSerializer: { serialize: (p) => stringify(p) },\n ...rest,\n };\n\n const protocol = this.getProtocol(url);\n\n if (protocol === HTTP.Protocols.HTTPS) {\n // A caller's own agent WINS. The previous code assigned after the `...rest` spread, so a\n // hardened agent - custom CA, pinning, mTLS - was overwritten and the secure path was\n // unreachable through the public seam.\n props.httpsAgent =\n rest.httpsAgent ??\n (opts.rejectUnauthorized === undefined\n ? this.httpsAgent\n : new https.Agent({ keepAlive: true, rejectUnauthorized: opts.rejectUnauthorized }));\n }\n\n logger\n ?.for(this.send.name)\n .info('URL: %s | Props: %s', url, RedactUtility.redactSecrets({ value: props }));\n\n return this.worker.request<T>(props);\n }\n}\n\n/** Options of `AxiosNetworkRequest`: an axios config with `baseUrl` in place of `baseURL`. */\nexport interface IAxiosNetworkRequestOptions {\n name: string;\n networkOptions: Omit<AxiosRequestConfig, 'baseURL'> & {\n baseUrl?: string;\n };\n}\n\n/** `BaseNetworkRequest` over an `AxiosFetcher`. Defaults: JSON content type, 60000 ms `timeout`, and no rejection for status below 500 (`validateStatus`). */\nexport class AxiosNetworkRequest extends BaseNetworkRequest<'axios'> {\n constructor(opts: IAxiosNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, timeout, ...rest } = networkOptions;\n\n const mergedHeaders: AnyObject = {\n ['content-type']: 'application/json; charset=utf-8',\n ...headers,\n };\n\n const defaultConfigs: AxiosRequestConfig = {\n withCredentials: true,\n validateStatus: (status: number) => status < 500,\n timeout: timeout ?? 60 * 1000,\n ...rest,\n baseURL: baseUrl,\n headers: mergedHeaders,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new AxiosFetcher({ name, defaultConfigs }),\n });\n }\n}\n"]}
1
+ {"version":3,"file":"axios-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/axios-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP, type THttpMethod } from '@/common';\nimport { RedactUtility } from '@/common/redact';\nimport axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';\nimport https from 'node:https';\nimport { stringify } from 'node:querystring';\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { AbstractNetworkFetchableHelper, type IRequestOptions } from './base-fetcher';\n\n/** Request accepted by `AxiosFetcher`: an axios config where `body` is sent as the axios `data`. `rejectUnauthorized` set here overrides the instance setting for this call. */\nexport interface IAxiosRequestOptions extends AxiosRequestConfig, IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: Record<string, unknown>;\n body?: Record<string, unknown>;\n headers?: Record<string, string>;\n /** Whether this call rejects an HTTPS server whose certificate fails verification; `false` turns verification off for this call. */\n rejectUnauthorized?: boolean;\n}\n\n/** Fetcher over an axios instance (`getWorker()`). HTTPS calls share one keep-alive agent that verifies certificates unless `rejectUnauthorized` is `false`; an `httpsAgent` passed in the request wins. */\nexport class AxiosFetcher extends AbstractNetworkFetchableHelper<\n 'axios',\n IAxiosRequestOptions,\n // The named type, not the `axios.` NAMESPACE: the namespace form resolves only under node16\n // module resolution, and this package also emits an ESM build under `bundler` resolution.\n AxiosResponse<unknown>,\n AxiosInstance\n> {\n /**\n * One agent for the instance, not one per request. Built here so TLS verification is decided\n * ONCE, at construction, rather than per call - and so connections are actually reused: a fresh\n * agent per request forces a new TCP and TLS handshake every time (measured: 10 handshakes for 10\n * requests, versus 1).\n */\n private readonly httpsAgent: https.Agent;\n\n constructor(opts: {\n name: string;\n defaultConfigs: AxiosRequestConfig;\n logger?: ILogger;\n /**\n * Whether this instance rejects an HTTPS server whose certificate fails verification.\n * `false` turns verification off.\n * @default true\n */\n rejectUnauthorized?: boolean;\n }) {\n super({ name: opts.name, variant: 'axios' });\n const { defaultConfigs } = opts;\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.httpsAgent = new https.Agent({\n keepAlive: true,\n rejectUnauthorized: opts.rejectUnauthorized ?? true,\n });\n\n this.worker = axios.create({ ...defaultConfigs });\n }\n\n override send<T = unknown>(opts: IAxiosRequestOptions, logger?: ILogger) {\n const { url, method = HTTP.Methods.GET, params = {}, body: data, headers, ...rest } = opts;\n const props: AxiosRequestConfig = {\n url,\n method: method.toUpperCase(),\n params,\n data,\n headers,\n paramsSerializer: { serialize: (p) => stringify(p) },\n ...rest,\n };\n\n const protocol = this.getProtocol(url);\n\n if (protocol === HTTP.Protocols.HTTPS) {\n // A caller's own agent WINS. The previous code assigned after the `...rest` spread, so a\n // hardened agent - custom CA, pinning, mTLS - was overwritten and the secure path was\n // unreachable through the public seam.\n props.httpsAgent =\n rest.httpsAgent ??\n (opts.rejectUnauthorized === undefined\n ? this.httpsAgent\n : new https.Agent({ keepAlive: true, rejectUnauthorized: opts.rejectUnauthorized }));\n }\n\n logger\n ?.for(this.send.name)\n .info('URL: %s | Props: %s', url, RedactUtility.redactSecrets({ value: props }));\n\n return this.worker.request<T>(props);\n }\n}\n\n/** Options of `AxiosNetworkRequest`: an axios config with `baseUrl` in place of `baseURL`. */\nexport interface IAxiosNetworkRequestOptions {\n name: string;\n networkOptions: Omit<AxiosRequestConfig, 'baseURL'> & {\n baseUrl?: string;\n };\n}\n\n/** `BaseNetworkRequest` over an `AxiosFetcher`. Defaults: JSON content type, 60000 ms `timeout`, and no rejection for status below 500 (`validateStatus`). */\nexport class AxiosNetworkRequest extends BaseNetworkRequest<'axios'> {\n constructor(opts: IAxiosNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, timeout, ...rest } = networkOptions;\n\n const mergedHeaders: NonNullable<AxiosRequestConfig['headers']> = {\n ['content-type']: 'application/json; charset=utf-8',\n ...headers,\n };\n\n const defaultConfigs: AxiosRequestConfig = {\n withCredentials: true,\n validateStatus: (status: number) => status < 500,\n timeout: timeout ?? 60 * 1000,\n ...rest,\n baseURL: baseUrl,\n headers: mergedHeaders,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new AxiosFetcher({ name, defaultConfigs }),\n });\n }\n}\n"]}
@@ -1,5 +1,4 @@
1
1
  import { type THttpMethod } from '../../../../common/constants/http.js';
2
- import { type AnyObject } from '../../../../common/types/index.js';
3
2
  import type { ILogger } from '../../../logger/common/types.js';
4
3
  import { type TFetcherVariant } from '../common/index.js';
5
4
  /** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */
@@ -8,7 +7,7 @@ export type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;
8
7
  export interface IRequestOptions {
9
8
  url: string;
10
9
  method?: THttpMethod;
11
- params?: AnyObject;
10
+ params?: Record<string, unknown>;
12
11
  timeout?: number;
13
12
  [extra: symbol | string]: unknown;
14
13
  }
@@ -1 +1 @@
1
- {"version":3,"file":"base-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,yBAAyB,CAAC;AAsCjE,yNAAyN;AACzN,MAAM,OAAgB,8BAA8B;IAUlD,YAAY,IAA8C;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAID,WAAW,CAAC,GAAW;QACrB,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IAC9E,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,IAAQ,EAAE,MAAuB;QACpC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,IAAQ,EAAE,MAAuB;QACtC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF","sourcesContent":["import { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { type AnyObject } from '@/common/types';\n// The leaf file, never the logger BARREL: that barrel reaches `node:module` and would drag this\n// browser-pure fetcher contract with it.\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { type TFetcherVariant } from '../common';\n\n/** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */\nexport type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;\n\n/** Options every fetcher accepts. `timeout` is in milliseconds; other keys pass through to the underlying client. */\nexport interface IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n timeout?: number;\n [extra: symbol | string]: unknown;\n}\n\n/** Contract of an HTTP fetcher: `send` takes the method from the options, the verb methods fix it, and `getWorker` returns the underlying client (`W`). */\nexport interface IFetchable<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> {\n send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n get(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n post(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n put(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n patch(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n delete(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n query(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n\n getVariant(): V;\n getWorker(): W;\n}\n\n/** `W` defaults to `unknown` so this stays free of `axios` - a concrete fetcher binds it to its real worker type (`AxiosInstance`, `typeof fetch`), which is then inherited on `this.worker` with no override needed. */\nexport abstract class AbstractNetworkFetchableHelper<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> implements IFetchable<V, RQ, RS, W> {\n protected name: string;\n protected variant: V;\n protected worker: W;\n\n constructor(opts: { name: string; variant: V; worker?: W }) {\n this.name = opts.name;\n this.variant = opts.variant;\n\n if (opts.worker !== undefined) {\n this.worker = opts.worker;\n }\n }\n\n abstract send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n\n getProtocol(url: string) {\n return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;\n }\n\n getVariant() {\n return this.variant;\n }\n\n getWorker(): W {\n return this.worker;\n }\n\n get(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.GET }, logger);\n }\n\n post(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.POST }, logger);\n }\n\n put(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.PUT }, logger);\n }\n\n patch(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.PATCH }, logger);\n }\n\n delete(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.DELETE }, logger);\n }\n\n query(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.QUERY }, logger);\n }\n}\n"]}
1
+ {"version":3,"file":"base-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,yBAAyB,CAAC;AAqCjE,yNAAyN;AACzN,MAAM,OAAgB,8BAA8B;IAUlD,YAAY,IAA8C;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAID,WAAW,CAAC,GAAW;QACrB,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IAC9E,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,IAAQ,EAAE,MAAuB;QACpC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,IAAQ,EAAE,MAAuB;QACtC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF","sourcesContent":["import { HTTP, type THttpMethod } from '@/common/constants/http';\n// The leaf file, never the logger BARREL: that barrel reaches `node:module` and would drag this\n// browser-pure fetcher contract with it.\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { type TFetcherVariant } from '../common';\n\n/** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */\nexport type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;\n\n/** Options every fetcher accepts. `timeout` is in milliseconds; other keys pass through to the underlying client. */\nexport interface IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: Record<string, unknown>;\n timeout?: number;\n [extra: symbol | string]: unknown;\n}\n\n/** Contract of an HTTP fetcher: `send` takes the method from the options, the verb methods fix it, and `getWorker` returns the underlying client (`W`). */\nexport interface IFetchable<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> {\n send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n get(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n post(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n put(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n patch(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n delete(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n query(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n\n getVariant(): V;\n getWorker(): W;\n}\n\n/** `W` defaults to `unknown` so this stays free of `axios` - a concrete fetcher binds it to its real worker type (`AxiosInstance`, `typeof fetch`), which is then inherited on `this.worker` with no override needed. */\nexport abstract class AbstractNetworkFetchableHelper<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> implements IFetchable<V, RQ, RS, W> {\n protected name: string;\n protected variant: V;\n protected worker: W;\n\n constructor(opts: { name: string; variant: V; worker?: W }) {\n this.name = opts.name;\n this.variant = opts.variant;\n\n if (opts.worker !== undefined) {\n this.worker = opts.worker;\n }\n }\n\n abstract send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n\n getProtocol(url: string) {\n return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;\n }\n\n getVariant() {\n return this.variant;\n }\n\n getWorker(): W {\n return this.worker;\n }\n\n get(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.GET }, logger);\n }\n\n post(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.POST }, logger);\n }\n\n put(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.PUT }, logger);\n }\n\n patch(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.PATCH }, logger);\n }\n\n delete(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.DELETE }, logger);\n }\n\n query(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.QUERY }, logger);\n }\n}\n"]}
@@ -1,5 +1,5 @@
1
1
  import type { AxiosInstance, AxiosResponse } from 'axios';
2
2
  import type { TFetcherVariant } from '../../common/index.js';
3
- export type TFetcherResponse<T extends TFetcherVariant> = T extends 'node-fetch' ? Response : AxiosResponse;
3
+ export type TFetcherResponse<T extends TFetcherVariant> = T extends 'node-fetch' ? Response : AxiosResponse<unknown>;
4
4
  export type TFetcherWorker<T extends TFetcherVariant> = T extends 'axios' ? AxiosInstance : typeof fetch;
5
5
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/modules/network/http-request/fetcher/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AxiosInstance, AxiosResponse } from 'axios';\nimport type { TFetcherVariant } from '../../common';\n\nexport type TFetcherResponse<T extends TFetcherVariant> = T extends 'node-fetch'\n ? Response\n : AxiosResponse;\n\nexport type TFetcherWorker<T extends TFetcherVariant> = T extends 'axios'\n ? AxiosInstance\n : typeof fetch;\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/modules/network/http-request/fetcher/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AxiosInstance, AxiosResponse } from 'axios';\nimport type { TFetcherVariant } from '../../common';\n\nexport type TFetcherResponse<T extends TFetcherVariant> = T extends 'node-fetch'\n ? Response\n : AxiosResponse<unknown>;\n\nexport type TFetcherWorker<T extends TFetcherVariant> = T extends 'axios'\n ? AxiosInstance\n : typeof fetch;\n"]}