@venizia/ignis-helpers 0.4.6 → 0.4.7-1
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.
- package/LICENSE.md +1 -3
- package/README.md +4 -5
- package/dist/esm/common/redact.d.ts +25 -17
- package/dist/esm/common/redact.d.ts.map +1 -1
- package/dist/esm/common/redact.js +50 -46
- package/dist/esm/common/redact.js.map +1 -1
- package/dist/esm/common/resolvers.d.ts +7 -5
- package/dist/esm/common/resolvers.d.ts.map +1 -1
- package/dist/esm/common/resolvers.js +11 -9
- package/dist/esm/common/resolvers.js.map +1 -1
- package/dist/esm/core.d.ts +6 -3
- package/dist/esm/core.d.ts.map +1 -1
- package/dist/esm/core.js +6 -3
- package/dist/esm/core.js.map +1 -1
- package/dist/esm/modules/base.js +4 -4
- package/dist/esm/modules/base.js.map +1 -1
- package/dist/esm/modules/cron/helper.js +4 -4
- package/dist/esm/modules/cron/helper.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/aes-legacy.algorithm.js +3 -3
- package/dist/esm/modules/crypto/algorithms/aes-legacy.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +5 -5
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/base.algorithm.js +3 -3
- package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
- package/dist/esm/modules/env/app-env.d.ts.map +1 -1
- package/dist/esm/modules/env/app-env.js +2 -2
- package/dist/esm/modules/env/app-env.js.map +1 -1
- package/dist/esm/modules/logger/common/constants.d.ts +23 -21
- package/dist/esm/modules/logger/common/constants.d.ts.map +1 -1
- package/dist/esm/modules/logger/common/constants.js +45 -42
- package/dist/esm/modules/logger/common/constants.js.map +1 -1
- package/dist/esm/modules/logger/factory.d.ts +5 -3
- package/dist/esm/modules/logger/factory.d.ts.map +1 -1
- package/dist/esm/modules/logger/factory.js +5 -3
- package/dist/esm/modules/logger/factory.js.map +1 -1
- package/dist/esm/modules/logger/formatting/deep-splat.d.ts +10 -6
- package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +1 -1
- package/dist/esm/modules/logger/formatting/deep-splat.js +73 -62
- package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
- package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +1 -1
- package/dist/esm/modules/logger/formatting/error-prettier.js +8 -6
- package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
- package/dist/esm/modules/logger/hf/logger.d.ts.map +1 -1
- package/dist/esm/modules/logger/hf/logger.js +2 -2
- package/dist/esm/modules/logger/hf/logger.js.map +1 -1
- package/dist/esm/modules/logger/pino/backing.d.ts +0 -9
- package/dist/esm/modules/logger/pino/backing.d.ts.map +1 -1
- package/dist/esm/modules/logger/pino/backing.js +3 -8
- package/dist/esm/modules/logger/pino/backing.js.map +1 -1
- package/dist/esm/modules/logger/pino/destination.d.ts +6 -9
- package/dist/esm/modules/logger/pino/destination.d.ts.map +1 -1
- package/dist/esm/modules/logger/pino/destination.js +12 -13
- package/dist/esm/modules/logger/pino/destination.js.map +1 -1
- package/dist/esm/modules/logger/pino/logger.js +2 -2
- package/dist/esm/modules/logger/pino/logger.js.map +1 -1
- package/dist/esm/modules/logger/resolver.js +2 -2
- package/dist/esm/modules/logger/resolver.js.map +1 -1
- package/dist/esm/modules/logger/slot.d.ts +39 -18
- package/dist/esm/modules/logger/slot.d.ts.map +1 -1
- package/dist/esm/modules/logger/slot.js +117 -110
- package/dist/esm/modules/logger/slot.js.map +1 -1
- package/dist/esm/modules/logger/winston/common/constants.d.ts.map +1 -1
- package/dist/esm/modules/logger/winston/common/constants.js +7 -6
- package/dist/esm/modules/logger/winston/common/constants.js.map +1 -1
- package/dist/esm/modules/logger/winston/define.d.ts +0 -7
- package/dist/esm/modules/logger/winston/define.d.ts.map +1 -1
- package/dist/esm/modules/logger/winston/define.js +0 -5
- package/dist/esm/modules/logger/winston/define.js.map +1 -1
- package/dist/esm/modules/logger/winston/formats.d.ts +2 -0
- package/dist/esm/modules/logger/winston/formats.d.ts.map +1 -1
- package/dist/esm/modules/logger/winston/formats.js +17 -4
- package/dist/esm/modules/logger/winston/formats.js.map +1 -1
- package/dist/esm/modules/logger/winston/index.d.ts +3 -2
- package/dist/esm/modules/logger/winston/index.d.ts.map +1 -1
- package/dist/esm/modules/logger/winston/index.js +3 -2
- package/dist/esm/modules/logger/winston/index.js.map +1 -1
- package/dist/esm/modules/logger/winston/logger-factory.js +4 -4
- package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
- package/dist/esm/modules/network/http-request/base-network-request.helper.js +2 -2
- package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
- package/dist/esm/modules/network/http-request/common/index.d.ts +0 -1
- package/dist/esm/modules/network/http-request/common/index.d.ts.map +1 -1
- package/dist/esm/modules/network/http-request/common/index.js +0 -1
- package/dist/esm/modules/network/http-request/common/index.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +4 -2
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +6 -4
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +4 -4
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +2 -2
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
- package/dist/esm/modules/network/utilities/query-string.d.ts +22 -20
- package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
- package/dist/esm/modules/network/utilities/query-string.js +48 -46
- package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts +0 -10
- package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/errors.js +0 -11
- package/dist/esm/modules/network/utilities/url-safety/common/errors.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.js +2 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.d.ts +10 -0
- package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.js +11 -0
- package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
- package/dist/esm/modules/pool/abstract.d.ts.map +1 -1
- package/dist/esm/modules/pool/abstract.js +4 -2
- package/dist/esm/modules/pool/abstract.js.map +1 -1
- package/dist/esm/modules/queue/bullmq/helper.d.ts.map +1 -1
- package/dist/esm/modules/queue/bullmq/helper.js +6 -6
- package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/esm/modules/queue/common/hook.d.ts +14 -12
- package/dist/esm/modules/queue/common/hook.d.ts.map +1 -1
- package/dist/esm/modules/queue/common/hook.js +21 -19
- package/dist/esm/modules/queue/common/hook.js.map +1 -1
- package/dist/esm/modules/queue/common/index.d.ts +0 -1
- package/dist/esm/modules/queue/common/index.d.ts.map +1 -1
- package/dist/esm/modules/queue/common/index.js +0 -1
- package/dist/esm/modules/queue/common/index.js.map +1 -1
- package/dist/esm/modules/queue/internal/sequential/helper.js +8 -8
- package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
- package/dist/esm/modules/queue/kafka/base.js +3 -3
- package/dist/esm/modules/queue/kafka/base.js.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/index.d.ts +0 -2
- package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/index.js +0 -2
- package/dist/esm/modules/queue/kafka/bundler/index.js.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts +8 -2
- package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/plugins.js +64 -7
- package/dist/esm/modules/queue/kafka/bundler/plugins.js.map +1 -1
- package/dist/esm/modules/queue/kafka/consumer.d.ts.map +1 -1
- package/dist/esm/modules/queue/kafka/consumer.js +26 -24
- package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
- package/dist/esm/modules/queue/mqtt/helper.js +10 -10
- package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
- package/dist/esm/modules/redis/base/abstract.helper.js +8 -8
- package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.js +2 -2
- package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
- package/dist/esm/modules/redis/factory.d.ts +13 -9
- package/dist/esm/modules/redis/factory.d.ts.map +1 -1
- package/dist/esm/modules/redis/factory.js +15 -13
- package/dist/esm/modules/redis/factory.js.map +1 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js +2 -2
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
- package/dist/esm/modules/redis/single/single.helper.js +2 -2
- package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
- package/dist/esm/modules/redis/utility.d.ts +13 -11
- package/dist/esm/modules/redis/utility.d.ts.map +1 -1
- package/dist/esm/modules/redis/utility.js +46 -44
- package/dist/esm/modules/redis/utility.js.map +1 -1
- package/dist/esm/modules/retry/helper.d.ts.map +1 -1
- package/dist/esm/modules/retry/helper.js +6 -4
- package/dist/esm/modules/retry/helper.js.map +1 -1
- package/dist/esm/modules/secrets/factory.d.ts +5 -3
- package/dist/esm/modules/secrets/factory.d.ts.map +1 -1
- package/dist/esm/modules/secrets/factory.js +36 -34
- package/dist/esm/modules/secrets/factory.js.map +1 -1
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +1 -1
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +4 -2
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +1 -1
- package/dist/esm/modules/socket/socket-io/server/helper.js +11 -11
- package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
- package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +1 -1
- package/dist/esm/modules/socket/websocket/emitter/helper.js +3 -3
- package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +1 -1
- package/dist/esm/modules/socket/websocket/server/delivery.js +5 -6
- package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +1 -1
- package/dist/esm/modules/socket/websocket/server/helper.js +7 -7
- package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
- package/dist/esm/modules/storage/base.d.ts.map +1 -1
- package/dist/esm/modules/storage/base.js +9 -8
- package/dist/esm/modules/storage/base.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.js +25 -18
- package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/utility.d.ts +95 -77
- package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +1 -1
- package/dist/esm/modules/storage/bun-s3/utility.js +261 -244
- package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
- package/dist/esm/modules/storage/common/errors.d.ts +0 -4
- package/dist/esm/modules/storage/common/errors.d.ts.map +1 -1
- package/dist/esm/modules/storage/common/errors.js +0 -10
- package/dist/esm/modules/storage/common/errors.js.map +1 -1
- package/dist/esm/modules/storage/common/utility.d.ts +11 -5
- package/dist/esm/modules/storage/common/utility.d.ts.map +1 -1
- package/dist/esm/modules/storage/common/utility.js +30 -17
- package/dist/esm/modules/storage/common/utility.js.map +1 -1
- package/dist/esm/modules/storage/disk/helper.d.ts.map +1 -1
- package/dist/esm/modules/storage/disk/helper.js +18 -9
- package/dist/esm/modules/storage/disk/helper.js.map +1 -1
- package/dist/esm/modules/tree/builder.d.ts.map +1 -1
- package/dist/esm/modules/tree/builder.js +2 -1
- package/dist/esm/modules/tree/builder.js.map +1 -1
- package/dist/esm/modules/uid/opaque.d.ts.map +1 -1
- package/dist/esm/modules/uid/opaque.js +4 -2
- package/dist/esm/modules/uid/opaque.js.map +1 -1
- package/dist/esm/modules/uid/uuid/helper.d.ts +1 -1
- package/dist/esm/modules/uid/uuid/helper.d.ts.map +1 -1
- package/dist/esm/modules/uid/uuid/helper.js +7 -7
- package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v4.d.ts +11 -8
- package/dist/esm/modules/uid/uuid/v4.d.ts.map +1 -1
- package/dist/esm/modules/uid/uuid/v4.js +51 -46
- package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v5.d.ts +17 -14
- package/dist/esm/modules/uid/uuid/v5.d.ts.map +1 -1
- package/dist/esm/modules/uid/uuid/v5.js +83 -78
- package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v7.d.ts +15 -10
- package/dist/esm/modules/uid/uuid/v7.d.ts.map +1 -1
- package/dist/esm/modules/uid/uuid/v7.js +88 -79
- package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
- package/dist/esm/modules/worker-thread/bus/base.js +2 -2
- package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/worker/base.d.ts.map +1 -1
- package/dist/esm/modules/worker-thread/worker/base.js +4 -3
- package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
- package/dist/esm/utilities/error.utility.d.ts +7 -0
- package/dist/esm/utilities/error.utility.d.ts.map +1 -0
- package/dist/esm/utilities/error.utility.js +9 -0
- package/dist/esm/utilities/error.utility.js.map +1 -0
- package/dist/esm/utilities/form-body.utility.d.ts +12 -10
- package/dist/esm/utilities/form-body.utility.d.ts.map +1 -1
- package/dist/esm/utilities/form-body.utility.js +19 -16
- package/dist/esm/utilities/form-body.utility.js.map +1 -1
- package/dist/esm/utilities/hr-time.utility.d.ts +7 -5
- package/dist/esm/utilities/hr-time.utility.d.ts.map +1 -1
- package/dist/esm/utilities/hr-time.utility.js +11 -9
- package/dist/esm/utilities/hr-time.utility.js.map +1 -1
- package/dist/esm/utilities/index.d.ts +2 -2
- package/dist/esm/utilities/index.d.ts.map +1 -1
- package/dist/esm/utilities/index.js +2 -2
- package/dist/esm/utilities/index.js.map +1 -1
- package/dist/esm/utilities/module.utility.d.ts.map +1 -1
- package/dist/esm/utilities/module.utility.js +4 -2
- package/dist/esm/utilities/module.utility.js.map +1 -1
- package/dist/esm/utilities/parse.utility.d.ts +89 -43
- package/dist/esm/utilities/parse.utility.d.ts.map +1 -1
- package/dist/esm/utilities/parse.utility.js +173 -141
- package/dist/esm/utilities/parse.utility.js.map +1 -1
- package/dist/esm/utilities/performance.utility.d.ts +15 -13
- package/dist/esm/utilities/performance.utility.d.ts.map +1 -1
- package/dist/esm/utilities/performance.utility.js +34 -29
- package/dist/esm/utilities/performance.utility.js.map +1 -1
- package/dist/esm/utilities/promise.utility.d.ts +20 -18
- package/dist/esm/utilities/promise.utility.d.ts.map +1 -1
- package/dist/esm/utilities/promise.utility.js +41 -51
- package/dist/esm/utilities/promise.utility.js.map +1 -1
- package/dist/esm/utilities/request.utility.d.ts +35 -29
- package/dist/esm/utilities/request.utility.d.ts.map +1 -1
- package/dist/esm/utilities/request.utility.js +117 -115
- package/dist/esm/utilities/request.utility.js.map +1 -1
- package/package.json +4 -15
- package/dist/esm/modules/logger/winston/formatters/deep-splat.d.ts +0 -4
- package/dist/esm/modules/logger/winston/formatters/deep-splat.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/formatters/deep-splat.js +0 -14
- package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +0 -1
- package/dist/esm/modules/logger/winston/formatters/index.d.ts +0 -2
- package/dist/esm/modules/logger/winston/formatters/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/formatters/index.js +0 -2
- package/dist/esm/modules/logger/winston/formatters/index.js.map +0 -1
- package/dist/esm/modules/network/http-request/common/types.d.ts +0 -2
- package/dist/esm/modules/network/http-request/common/types.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/common/types.js +0 -2
- package/dist/esm/modules/network/http-request/common/types.js.map +0 -1
- package/dist/esm/modules/queue/common/types.d.ts +0 -2
- package/dist/esm/modules/queue/common/types.d.ts.map +0 -1
- package/dist/esm/modules/queue/common/types.js +0 -2
- package/dist/esm/modules/queue/common/types.js.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts +0 -4
- package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js +0 -28
- package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.d.ts +0 -4
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +0 -26
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +0 -1
- package/dist/esm/modules/storage/minio/helper.d.ts +0 -55
- package/dist/esm/modules/storage/minio/helper.d.ts.map +0 -1
- package/dist/esm/modules/storage/minio/helper.js +0 -176
- package/dist/esm/modules/storage/minio/helper.js.map +0 -1
- package/dist/esm/modules/storage/minio/index.d.ts +0 -2
- package/dist/esm/modules/storage/minio/index.d.ts.map +0 -1
- package/dist/esm/modules/storage/minio/index.js +0 -2
- package/dist/esm/modules/storage/minio/index.js.map +0 -1
- package/dist/esm/utilities/sleep.utility.d.ts +0 -2
- package/dist/esm/utilities/sleep.utility.d.ts.map +0 -1
- package/dist/esm/utilities/sleep.utility.js +0 -4
- package/dist/esm/utilities/sleep.utility.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"destination.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"AAIA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D,mIAAmI;AACnI,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,UAAU,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACzB,KAAK,EAAE,IAAI,CAAC;KACb,CAAC;CACH,CAAC;AAEN,2MAA2M;AAC3M,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAEjD,2JAA2J;IAC3J,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;
|
|
1
|
+
{"version":3,"file":"destination.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"AAIA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D,mIAAmI;AACnI,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,UAAU,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACzB,KAAK,EAAE,IAAI,CAAC;KACb,CAAC;CACH,CAAC;AAEN,2MAA2M;AAC3M,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAEjD,2JAA2J;IAC3J,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;IAuBzD,+FAA+F;IAC/F,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAejC,0LAA0L;IAC1L,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM;IA0BlF,yKAAyK;IACzK,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAkCtC,sRAAsR;IACtR,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,GAAG,IAAI,CAAC,iBAAiB,GAAG,SAAS;CA2BnF"}
|
|
@@ -1,16 +1,17 @@
|
|
|
1
1
|
import { Defaults } from '../../../common/constants/index.js';
|
|
2
|
-
import {
|
|
2
|
+
import { ParseUtility } from '../../../utilities/parse.utility.js';
|
|
3
3
|
import { ModuleUtility } from '../../../utilities/module.utility.js';
|
|
4
4
|
import path from 'node:path';
|
|
5
5
|
import pino from 'pino';
|
|
6
|
-
import { LoggerFormats,
|
|
6
|
+
import { LoggerFormats, LoggerConfigUtility } from '../common/index.js';
|
|
7
7
|
import { PinoFrequencies } from './common/index.js';
|
|
8
8
|
/** 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`. */
|
|
9
9
|
export class PinoDestination {
|
|
10
10
|
static { this.DEFAULT_FREQUENCY = PinoFrequencies.HOURLY; }
|
|
11
11
|
static { this.DEFAULT_MAX_FILES = '5d'; }
|
|
12
12
|
/** `APP_ENV_LOGGER_FILE_FREQUENCY` -> pino-roll's `frequency`; an unrecognized value warns and falls back rather than throwing, so the app still boots. */
|
|
13
|
-
static mapFrequency(
|
|
13
|
+
static mapFrequency(opts) {
|
|
14
|
+
const { value } = opts;
|
|
14
15
|
const normalized = (value ?? '1h').trim().toLowerCase();
|
|
15
16
|
switch (normalized) {
|
|
16
17
|
case '1h': {
|
|
@@ -59,7 +60,9 @@ export class PinoDestination {
|
|
|
59
60
|
static resolvePlan() {
|
|
60
61
|
const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;
|
|
61
62
|
if (folderPath && folderPath.trim() !== '') {
|
|
62
|
-
const frequency = PinoDestination.mapFrequency(
|
|
63
|
+
const frequency = PinoDestination.mapFrequency({
|
|
64
|
+
value: process.env.APP_ENV_LOGGER_FILE_FREQUENCY,
|
|
65
|
+
});
|
|
63
66
|
const count = PinoDestination.mapMaxFilesToCount({
|
|
64
67
|
value: process.env.APP_ENV_LOGGER_FILE_MAX_FILES,
|
|
65
68
|
frequency,
|
|
@@ -69,7 +72,8 @@ export class PinoDestination {
|
|
|
69
72
|
options: {
|
|
70
73
|
file: path.join(folderPath, Defaults.APPLICATION_NAME),
|
|
71
74
|
frequency,
|
|
72
|
-
size: blankToUndefined(process.env.APP_ENV_LOGGER_FILE_MAX_SIZE) ??
|
|
75
|
+
size: ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_MAX_SIZE }) ??
|
|
76
|
+
'100m',
|
|
73
77
|
limit: { count },
|
|
74
78
|
mkdir: true,
|
|
75
79
|
},
|
|
@@ -82,7 +86,8 @@ export class PinoDestination {
|
|
|
82
86
|
return { kind: 'stdout' };
|
|
83
87
|
}
|
|
84
88
|
/** `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. */
|
|
85
|
-
static build(
|
|
89
|
+
static build(opts) {
|
|
90
|
+
const { plan } = opts;
|
|
86
91
|
switch (plan.kind) {
|
|
87
92
|
case 'stdout': {
|
|
88
93
|
return undefined;
|
|
@@ -91,7 +96,7 @@ export class PinoDestination {
|
|
|
91
96
|
ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-pretty'] });
|
|
92
97
|
// Only a decision is forwarded. Left alone, pino-pretty's own `isColorSupported` still
|
|
93
98
|
// suppresses color when stdout is not a terminal - a check winston has no equivalent of.
|
|
94
|
-
const colorize =
|
|
99
|
+
const colorize = LoggerConfigUtility.resolveColorize();
|
|
95
100
|
return pino.transport({
|
|
96
101
|
target: 'pino-pretty',
|
|
97
102
|
...(colorize === undefined ? {} : { options: { colorize } }),
|
|
@@ -107,10 +112,4 @@ export class PinoDestination {
|
|
|
107
112
|
}
|
|
108
113
|
}
|
|
109
114
|
}
|
|
110
|
-
// Published names, kept so `@venizia/ignis-helpers/pino` consumers do not have to move; the class
|
|
111
|
-
// above is the implementation and the entry point for new code.
|
|
112
|
-
export const mapFrequency = (value) => PinoDestination.mapFrequency(value);
|
|
113
|
-
export const mapMaxFilesToCount = (opts) => PinoDestination.mapMaxFilesToCount(opts);
|
|
114
|
-
export const resolveDestinationPlan = () => PinoDestination.resolvePlan();
|
|
115
|
-
export const buildDestination = (plan) => PinoDestination.build(plan);
|
|
116
115
|
//# sourceMappingURL=destination.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"destination.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAmB,MAAM,UAAU,CAAC;AAiB5D,2MAA2M;AAC3M,MAAM,OAAO,eAAe;aACF,sBAAiB,GAAe,eAAe,CAAC,MAAM,CAAC;aACvD,sBAAiB,GAAG,IAAI,CAAC;IAEjD,2JAA2J;IAC3J,MAAM,CAAC,YAAY,CAAC,KAAc;QAChC,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAExD,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,CAAC,CAAC;gBACV,OAAO,eAAe,CAAC,MAAM,CAAC;YAChC,CAAC;YACD,KAAK,IAAI,CAAC;YACV,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,OAAO,eAAe,CAAC,KAAK,CAAC;YAC/B,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,CAAC,IAAI,CACV,yEAAyE,EACzE,KAAK,EACL,eAAe,CAAC,iBAAiB,CAClC,CAAC;gBACF,OAAO,eAAe,CAAC,iBAAiB,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,+FAA+F;IACvF,MAAM,CAAC,kBAAkB,CAAC,KAAa,EAAE,SAAqB;QACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0LAA0L;IAC1L,MAAM,CAAC,kBAAkB,CAAC,IAA+C;QACvE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QAEjC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,eAAe,CAAC,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YACzE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,iIAAiI;QACjI,IAAI,UAAU,IAAI,UAAU,KAAK,eAAe,CAAC,iBAAiB,EAAE,CAAC;YACnE,OAAO,CAAC,IAAI,CACV,qFAAqF,EACrF,KAAK,EACL,eAAe,CAAC,iBAAiB,CAClC,CAAC;QACJ,CAAC;QAED,OAAO,eAAe,CAAC,kBAAkB,CACvC,eAAe,CAAC,iBAAiB,EACjC,SAAS,CACA,CAAC;IACd,CAAC;IAED,yKAAyK;IACzK,MAAM,CAAC,WAAW;QAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAE1D,IAAI,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC1F,MAAM,KAAK,GAAG,eAAe,CAAC,kBAAkB,CAAC;gBAC/C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,6BAA6B;gBAChD,SAAS;aACV,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC;oBACtD,SAAS;oBACT,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,MAAM;oBAC1E,KAAK,EAAE,EAAE,KAAK,EAAE;oBAChB,KAAK,EAAE,IAAI;iBACZ;aACF,CAAC;QACJ,CAAC;QAED,0QAA0Q;QAC1Q,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,aAAa,CAAC,IAAI,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,sRAAsR;IACtR,MAAM,CAAC,KAAK,CAAC,IAAsB;QACjC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,aAAa,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;gBAEjF,uFAAuF;gBACvF,yFAAyF;gBACzF,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;gBACzC,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,MAAM,EAAE,aAAa;oBACrB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,aAAa,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC/E,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;;AAGH,kGAAkG;AAClG,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAc,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAA+C,EAAU,EAAE,CAC5F,eAAe,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAqB,EAAE,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;AAE5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAsB,EAAsC,EAAE,CAC7F,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { blankToUndefined } from '@/utilities/parse.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport path from 'node:path';\nimport pino from 'pino';\nimport { LoggerFormats, resolveLoggerColorize } 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(value?: string): TFrequency {\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 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 if (dayMatch) {\n const days = Number.parseInt(dayMatch[1], 10);\n return frequency === 'hourly' ? days * 24 : days;\n }\n\n const bareMatch = /^\\d+$/.exec(value);\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 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(process.env.APP_ENV_LOGGER_FILE_FREQUENCY);\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: blankToUndefined(process.env.APP_ENV_LOGGER_FILE_MAX_SIZE) ?? '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(plan: TDestinationPlan): pino.DestinationStream | undefined {\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 = resolveLoggerColorize();\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 return pino.transport({ target: 'pino-roll', options: plan.options });\n }\n default: {\n return undefined;\n }\n }\n }\n}\n\n// Published names, kept so `@venizia/ignis-helpers/pino` consumers do not have to move; the class\n// above is the implementation and the entry point for new code.\nexport const mapFrequency = (value?: string): TFrequency => PinoDestination.mapFrequency(value);\n\nexport const mapMaxFilesToCount = (opts: { value?: string; frequency: TFrequency }): number =>\n PinoDestination.mapMaxFilesToCount(opts);\n\nexport const resolveDestinationPlan = (): TDestinationPlan => PinoDestination.resolvePlan();\n\nexport const buildDestination = (plan: TDestinationPlan): pino.DestinationStream | undefined =>\n PinoDestination.build(plan);\n"]}
|
|
1
|
+
{"version":3,"file":"destination.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAmB,MAAM,UAAU,CAAC;AAiB5D,2MAA2M;AAC3M,MAAM,OAAO,eAAe;aACF,sBAAiB,GAAe,eAAe,CAAC,MAAM,CAAC;aACvD,sBAAiB,GAAG,IAAI,CAAC;IAEjD,2JAA2J;IAC3J,MAAM,CAAC,YAAY,CAAC,IAAwB;QAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAExD,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,CAAC,CAAC;gBACV,OAAO,eAAe,CAAC,MAAM,CAAC;YAChC,CAAC;YACD,KAAK,IAAI,CAAC;YACV,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,OAAO,eAAe,CAAC,KAAK,CAAC;YAC/B,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,CAAC,IAAI,CACV,yEAAyE,EACzE,KAAK,EACL,eAAe,CAAC,iBAAiB,CAClC,CAAC;gBACF,OAAO,eAAe,CAAC,iBAAiB,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,+FAA+F;IACvF,MAAM,CAAC,kBAAkB,CAAC,KAAa,EAAE,SAAqB;QACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0LAA0L;IAC1L,MAAM,CAAC,kBAAkB,CAAC,IAA+C;QACvE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QAEjC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,eAAe,CAAC,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YACzE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,iIAAiI;QACjI,IAAI,UAAU,IAAI,UAAU,KAAK,eAAe,CAAC,iBAAiB,EAAE,CAAC;YACnE,OAAO,CAAC,IAAI,CACV,qFAAqF,EACrF,KAAK,EACL,eAAe,CAAC,iBAAiB,CAClC,CAAC;QACJ,CAAC;QAED,OAAO,eAAe,CAAC,kBAAkB,CACvC,eAAe,CAAC,iBAAiB,EACjC,SAAS,CACA,CAAC;IACd,CAAC;IAED,yKAAyK;IACzK,MAAM,CAAC,WAAW;QAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAE1D,IAAI,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC;gBAC7C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,6BAA6B;aACjD,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,eAAe,CAAC,kBAAkB,CAAC;gBAC/C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,6BAA6B;gBAChD,SAAS;aACV,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC;oBACtD,SAAS;oBACT,IAAI,EACF,YAAY,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,CAAC;wBAClF,MAAM;oBACR,KAAK,EAAE,EAAE,KAAK,EAAE;oBAChB,KAAK,EAAE,IAAI;iBACZ;aACF,CAAC;QACJ,CAAC;QAED,0QAA0Q;QAC1Q,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,aAAa,CAAC,IAAI,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,sRAAsR;IACtR,MAAM,CAAC,KAAK,CAAC,IAAgC;QAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,aAAa,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;gBAEjF,uFAAuF;gBACvF,yFAAyF;gBACzF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,eAAe,EAAE,CAAC;gBACvD,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,MAAM,EAAE,aAAa;oBACrB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,aAAa,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC/E,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC","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 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 if (dayMatch) {\n const days = Number.parseInt(dayMatch[1], 10);\n return frequency === 'hourly' ? days * 24 : days;\n }\n\n const bareMatch = /^\\d+$/.exec(value);\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 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 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 return pino.transport({ target: 'pino-roll', options: plan.options });\n }\n default: {\n return undefined;\n }\n }\n }\n}\n"]}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { BaseLogger } from '../base/index.js';
|
|
2
|
-
import {
|
|
2
|
+
import { LogFormatUtility } from '../formatting/index.js';
|
|
3
3
|
import { PinoBackingLogger } from './backing.js';
|
|
4
4
|
/** 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()`. */
|
|
5
5
|
export class PinoLogger extends BaseLogger {
|
|
@@ -18,7 +18,7 @@ export class PinoLogger extends BaseLogger {
|
|
|
18
18
|
/** Resolves the backing instance at WRITE time and never caches it, so `PinoBackingLogger.set()` takes effect for every already-issued scope immediately. */
|
|
19
19
|
write(opts) {
|
|
20
20
|
const line = opts.args.length > 0
|
|
21
|
-
?
|
|
21
|
+
? LogFormatUtility.formatMessage({ message: opts.message, args: opts.args })
|
|
22
22
|
: opts.message;
|
|
23
23
|
const backing = PinoBackingLogger.get();
|
|
24
24
|
backing[opts.level](this._formattedPrefix + line);
|
|
@@ -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;QACnC,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,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;
|
|
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;QACnC,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 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,6 +1,6 @@
|
|
|
1
1
|
import { AbstractLogger } from './base/abstract.js';
|
|
2
2
|
import { ConsoleLogger } from './base/console.js';
|
|
3
|
-
import {
|
|
3
|
+
import { LoggerSlot } from './slot.js';
|
|
4
4
|
/** Caches the resolved target and re-reads it only when `LoggerResolver`'s generation moves - one integer compare per call, so an instance built before `LoggerFactory` loaded upgrades the moment it does, without being reconstructed. Mutual reference with LoggerResolver is by design - hence the `no-use-before-define` disables. */
|
|
5
5
|
class ResolvedLogger extends AbstractLogger {
|
|
6
6
|
constructor(scopes) {
|
|
@@ -91,5 +91,5 @@ export class LoggerResolver {
|
|
|
91
91
|
// graph carrying `LoggerFactory` does - is what upgrades every helper from the console fallback,
|
|
92
92
|
// including helpers constructed before it loaded: the logger is resolved on first use, not in the
|
|
93
93
|
// constructor.
|
|
94
|
-
|
|
94
|
+
LoggerSlot.resolve = (opts) => LoggerResolver.resolve({ scopes: opts.scopes });
|
|
95
95
|
//# sourceMappingURL=resolver.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.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 { type ILogger, type TLogLevel } from './common/types';\nimport {
|
|
1
|
+
{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.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 { type ILogger, type TLogLevel } from './common/types';\nimport { LoggerSlot } from './slot';\n\nexport type TLoggerResolver = (opts: { scopes: Array<string> }) => ILogger;\n\n/** Caches the resolved target and re-reads it only when `LoggerResolver`'s generation moves - one integer compare per call, so an instance built before `LoggerFactory` loaded upgrades the moment it does, without being reconstructed. Mutual reference with LoggerResolver is by design - hence the `no-use-before-define` disables. */\nclass ResolvedLogger extends AbstractLogger {\n private target?: ILogger;\n private targetGeneration = -1;\n\n constructor(private readonly scopes: Array<string>) {\n super();\n }\n\n private resolveTarget(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const generation = LoggerResolver.currentGeneration();\n if (!this.target || this.targetGeneration !== generation) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this.target = LoggerResolver.resolveNow({ scopes: this.scopes });\n this.targetGeneration = generation;\n }\n\n return this.target;\n }\n\n debug(message: string, ...args: AnyType[]) {\n this.resolveTarget().debug(message, ...args);\n }\n\n info(message: string, ...args: AnyType[]) {\n this.resolveTarget().info(message, ...args);\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.resolveTarget().warn(message, ...args);\n }\n\n error(message: string, ...args: AnyType[]) {\n this.resolveTarget().error(message, ...args);\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.resolveTarget().emerg(message, ...args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n this.resolveTarget().log(level, message, ...args);\n }\n\n for(methodName: string): ILogger {\n return new ResolvedLogger([...this.scopes, methodName]);\n }\n}\n\n/** The only logger code `BaseHelper` reaches, so this module must stay free of node imports - `BaseHelper` sits under every base class in the framework. */\nexport class LoggerResolver {\n /** Declared before `active` because static field initialisers run in declaration order. */\n private static readonly consoleResolver: TLoggerResolver = (opts) => {\n // Warned here, on the first line actually routed to the console, not when a helper merely acquires its logger: a script that imports the barrel and installs a provider before logging must stay silent.\n LoggerResolver.warnConsoleFallbackOnce();\n return ConsoleLogger.get({ scope: opts.scopes.filter((el) => el && el.length > 0).join('-') });\n };\n\n private static active: TLoggerResolver = this.consoleResolver;\n private static generation = 0;\n\n /** `LoggerFactory` installs itself here from its own module body, so importing `LoggerFactory` as a value is what wires the real logger up - a side-effect-only import would not survive `sideEffects: false`. */\n static use(opts: { resolver: TLoggerResolver }): void {\n this.active = opts.resolver;\n this.generation += 1;\n }\n\n static reset(): void {\n this.active = this.consoleResolver;\n this.generation += 1;\n }\n\n /** Internal to this module - `ResolvedLogger` reads it to decide whether its cached target is stale. */\n static currentGeneration(): number {\n return this.generation;\n }\n\n /** Internal to this module - resolves through whatever is installed right now. */\n static resolveNow(opts: { scopes: Array<string> }): ILogger {\n return this.active({ scopes: opts.scopes });\n }\n\n /**\n * Without this, a node process logs to stdout while `APP_ENV_LOGGER_FOLDER_PATH` silently receives\n * nothing. A guarded property read, never an import: even a dynamic `import('@venizia/ignis-helpers')`\n * behind a node check puts the root barrel in this bundle and turns `/core` impure.\n */\n static warnConsoleFallbackOnce(): void {\n if (this.hasWarnedConsoleFallback || this.generation > 0) {\n return;\n }\n\n if (!globalThis.process?.versions?.node) {\n return;\n }\n\n this.hasWarnedConsoleFallback = true;\n ConsoleLogger.get({ scope: LoggerResolver.name }).warn(\n 'Logging to the console: no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` once at startup - `@venizia/ignis` does it for you, a connectors-only or script-only import graph does not. Loggers built before that import upgrade themselves on their next call.',\n );\n }\n\n static resolve(opts: { scopes: Array<string> }): ILogger {\n return new ResolvedLogger(opts.scopes);\n }\n\n private static hasWarnedConsoleFallback = false;\n}\n\n// Registers the real resolver with the slot `BaseHelper` reads. Importing this module - which any\n// graph carrying `LoggerFactory` does - is what upgrades every helper from the console fallback,\n// including helpers constructed before it loaded: the logger is resolved on first use, not in the\n// constructor.\nLoggerSlot.resolve = (opts) => LoggerResolver.resolve({ scopes: opts.scopes });\n"]}
|
|
@@ -2,22 +2,43 @@ import type { ILogger } from './common/types.js';
|
|
|
2
2
|
export type TLoggerResolver = (opts: {
|
|
3
3
|
scopes: Array<string>;
|
|
4
4
|
}) => ILogger;
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
resolve?: TLoggerResolver;
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
})
|
|
5
|
+
export declare class LoggerSlot {
|
|
6
|
+
/**
|
|
7
|
+
* Where the logger module installs its resolver, and the only reference `BaseHelper` holds to it.
|
|
8
|
+
*
|
|
9
|
+
* A slot rather than an import: `BaseHelper` sits under every class in the framework, so importing
|
|
10
|
+
* the resolver put 1033 B gzipped into every browser bundle that touched any helper.
|
|
11
|
+
*/
|
|
12
|
+
static resolve?: TLoggerResolver;
|
|
13
|
+
/**
|
|
14
|
+
* Installs the logger every helper writes to. A browser app calls it once at startup, because `LoggerFactory` is
|
|
15
|
+
* node-only: `LoggerSlot.use({ resolver: ({ scopes }) => ConsoleLogger.get({ scope: scopes.join('-') }) })`.
|
|
16
|
+
*
|
|
17
|
+
* Call it BEFORE the first log line. A helper that logs before a resolver exists keeps writing to the console, and
|
|
18
|
+
* the logger it resolves on its first line after one is installed is the one it keeps.
|
|
19
|
+
*/
|
|
20
|
+
static use(opts: {
|
|
21
|
+
resolver: TLoggerResolver;
|
|
22
|
+
}): void;
|
|
23
|
+
/** Writes one line to the console; `emerg` and anything unrecognised land on `error`. */
|
|
24
|
+
private static writeToConsole;
|
|
25
|
+
/** Hands a line to the level's own method, so the logger's gates apply - `debug` checks `DEBUG`. */
|
|
26
|
+
private static writeToLogger;
|
|
27
|
+
/** Node only: a browser has no `LoggerFactory` to import, so the advice would be noise there. */
|
|
28
|
+
private static warnNoResolverOnce;
|
|
29
|
+
/**
|
|
30
|
+
* Writes to the console until a resolver is installed, then hands every call to the real logger - a
|
|
31
|
+
* helper that logs before the resolver module loads would otherwise stay on the console for good.
|
|
32
|
+
*/
|
|
33
|
+
private static createDeferredLogger;
|
|
34
|
+
/** The real logger when a resolver is installed, else one that upgrades itself the moment one is. */
|
|
35
|
+
static resolveHelperLogger(opts: {
|
|
36
|
+
scopes: Array<string>;
|
|
37
|
+
}): ILogger;
|
|
38
|
+
/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. */
|
|
39
|
+
static pinHelperLogger(opts: {
|
|
40
|
+
helper: object;
|
|
41
|
+
logger: ILogger;
|
|
42
|
+
}): void;
|
|
43
|
+
}
|
|
23
44
|
//# sourceMappingURL=slot.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../../../src/modules/logger/slot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,gBAAgB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,KAAK,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../../../src/modules/logger/slot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,gBAAgB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,KAAK,OAAO,CAAC;AAQ3E,qBAAa,UAAU;IACrB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IAEjC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI;IAIrD,yFAAyF;IACzF,OAAO,CAAC,MAAM,CAAC,cAAc;IA6B7B,oGAAoG;IACpG,OAAO,CAAC,MAAM,CAAC,aAAa;IAoC5B,iGAAiG;IACjG,OAAO,CAAC,MAAM,CAAC,kBAAkB;IASjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmCnC,qGAAqG;IACrG,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO;IAOpE,iGAAiG;IACjG,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAQxE"}
|
|
@@ -1,119 +1,126 @@
|
|
|
1
1
|
import { LogLevels } from './common/types.js';
|
|
2
|
-
/**
|
|
3
|
-
* Where the logger module installs its resolver, and the only reference `BaseHelper` holds to it.
|
|
4
|
-
*
|
|
5
|
-
* A slot rather than an import: `BaseHelper` sits under every class in the framework, so importing
|
|
6
|
-
* the resolver put 1033 B gzipped into every browser bundle that touched any helper.
|
|
7
|
-
*/
|
|
8
|
-
export const loggerSlot = {};
|
|
9
|
-
/** Writes one line to the console; `emerg` and anything unrecognised land on `error`. */
|
|
10
|
-
const writeToConsole = (opts) => {
|
|
11
|
-
const { prefix, level, message, args } = opts;
|
|
12
|
-
const line = `${prefix} ${message}`;
|
|
13
|
-
switch (level) {
|
|
14
|
-
case LogLevels.DEBUG: {
|
|
15
|
-
globalThis.console.debug(line, ...args);
|
|
16
|
-
break;
|
|
17
|
-
}
|
|
18
|
-
case LogLevels.INFO: {
|
|
19
|
-
globalThis.console.info(line, ...args);
|
|
20
|
-
break;
|
|
21
|
-
}
|
|
22
|
-
case LogLevels.WARN: {
|
|
23
|
-
globalThis.console.warn(line, ...args);
|
|
24
|
-
break;
|
|
25
|
-
}
|
|
26
|
-
default: {
|
|
27
|
-
globalThis.console.error(line, ...args);
|
|
28
|
-
break;
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
};
|
|
32
|
-
/** Hands a line to the level's own method, so the logger's gates apply - `debug` checks `DEBUG`. */
|
|
33
|
-
const writeToLogger = (opts) => {
|
|
34
|
-
const { logger, level, message, args } = opts;
|
|
35
|
-
switch (level) {
|
|
36
|
-
case LogLevels.DEBUG: {
|
|
37
|
-
logger.debug(message, ...args);
|
|
38
|
-
break;
|
|
39
|
-
}
|
|
40
|
-
case LogLevels.INFO: {
|
|
41
|
-
logger.info(message, ...args);
|
|
42
|
-
break;
|
|
43
|
-
}
|
|
44
|
-
case LogLevels.WARN: {
|
|
45
|
-
logger.warn(message, ...args);
|
|
46
|
-
break;
|
|
47
|
-
}
|
|
48
|
-
case LogLevels.ERROR: {
|
|
49
|
-
logger.error(message, ...args);
|
|
50
|
-
break;
|
|
51
|
-
}
|
|
52
|
-
case LogLevels.EMERG: {
|
|
53
|
-
logger.emerg(message, ...args);
|
|
54
|
-
break;
|
|
55
|
-
}
|
|
56
|
-
default: {
|
|
57
|
-
logger.log(level, message, ...args);
|
|
58
|
-
break;
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
};
|
|
62
2
|
const NO_RESOLVER_WARNING = '[BaseHelper] Logging to the console - no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` at startup.';
|
|
63
3
|
/** Global, so a process holding both the CJS and the ESM copy of this module still warns once. */
|
|
64
4
|
const NO_RESOLVER_WARNED = Symbol.for('@venizia/ignis-helpers:no-logger-provider-warned');
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
5
|
+
export class LoggerSlot {
|
|
6
|
+
/**
|
|
7
|
+
* Installs the logger every helper writes to. A browser app calls it once at startup, because `LoggerFactory` is
|
|
8
|
+
* node-only: `LoggerSlot.use({ resolver: ({ scopes }) => ConsoleLogger.get({ scope: scopes.join('-') }) })`.
|
|
9
|
+
*
|
|
10
|
+
* Call it BEFORE the first log line. A helper that logs before a resolver exists keeps writing to the console, and
|
|
11
|
+
* the logger it resolves on its first line after one is installed is the one it keeps.
|
|
12
|
+
*/
|
|
13
|
+
static use(opts) {
|
|
14
|
+
LoggerSlot.resolve = opts.resolver;
|
|
69
15
|
}
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
};
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
16
|
+
/** Writes one line to the console; `emerg` and anything unrecognised land on `error`. */
|
|
17
|
+
static writeToConsole(opts) {
|
|
18
|
+
const { prefix, level, message, args } = opts;
|
|
19
|
+
const line = `${prefix} ${message}`;
|
|
20
|
+
switch (level) {
|
|
21
|
+
case LogLevels.DEBUG: {
|
|
22
|
+
globalThis.console.debug(line, ...args);
|
|
23
|
+
break;
|
|
24
|
+
}
|
|
25
|
+
case LogLevels.INFO: {
|
|
26
|
+
globalThis.console.info(line, ...args);
|
|
27
|
+
break;
|
|
28
|
+
}
|
|
29
|
+
case LogLevels.WARN: {
|
|
30
|
+
globalThis.console.warn(line, ...args);
|
|
31
|
+
break;
|
|
32
|
+
}
|
|
33
|
+
default: {
|
|
34
|
+
globalThis.console.error(line, ...args);
|
|
35
|
+
break;
|
|
36
|
+
}
|
|
85
37
|
}
|
|
86
|
-
|
|
87
|
-
|
|
38
|
+
}
|
|
39
|
+
/** Hands a line to the level's own method, so the logger's gates apply - `debug` checks `DEBUG`. */
|
|
40
|
+
static writeToLogger(opts) {
|
|
41
|
+
const { logger, level, message, args } = opts;
|
|
42
|
+
switch (level) {
|
|
43
|
+
case LogLevels.DEBUG: {
|
|
44
|
+
logger.debug(message, ...args);
|
|
45
|
+
break;
|
|
46
|
+
}
|
|
47
|
+
case LogLevels.INFO: {
|
|
48
|
+
logger.info(message, ...args);
|
|
49
|
+
break;
|
|
50
|
+
}
|
|
51
|
+
case LogLevels.WARN: {
|
|
52
|
+
logger.warn(message, ...args);
|
|
53
|
+
break;
|
|
54
|
+
}
|
|
55
|
+
case LogLevels.ERROR: {
|
|
56
|
+
logger.error(message, ...args);
|
|
57
|
+
break;
|
|
58
|
+
}
|
|
59
|
+
case LogLevels.EMERG: {
|
|
60
|
+
logger.emerg(message, ...args);
|
|
61
|
+
break;
|
|
62
|
+
}
|
|
63
|
+
default: {
|
|
64
|
+
logger.log(level, message, ...args);
|
|
65
|
+
break;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
/** Node only: a browser has no `LoggerFactory` to import, so the advice would be noise there. */
|
|
70
|
+
static warnNoResolverOnce() {
|
|
71
|
+
if (Reflect.get(globalThis, NO_RESOLVER_WARNED) || !globalThis.process?.versions?.node) {
|
|
88
72
|
return;
|
|
89
73
|
}
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
};
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
74
|
+
Reflect.set(globalThis, NO_RESOLVER_WARNED, true);
|
|
75
|
+
globalThis.console.warn(NO_RESOLVER_WARNING);
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Writes to the console until a resolver is installed, then hands every call to the real logger - a
|
|
79
|
+
* helper that logs before the resolver module loads would otherwise stay on the console for good.
|
|
80
|
+
*/
|
|
81
|
+
static createDeferredLogger(opts) {
|
|
82
|
+
const { scopes } = opts;
|
|
83
|
+
const prefix = `[${scopes.join('-')}]`;
|
|
84
|
+
let resolved;
|
|
85
|
+
const write = (level, message, args) => {
|
|
86
|
+
const resolve = LoggerSlot.resolve;
|
|
87
|
+
if (!resolved && resolve) {
|
|
88
|
+
resolved = resolve({ scopes });
|
|
89
|
+
}
|
|
90
|
+
if (resolved) {
|
|
91
|
+
LoggerSlot.writeToLogger({ logger: resolved, level, message, args });
|
|
92
|
+
return;
|
|
93
|
+
}
|
|
94
|
+
LoggerSlot.warnNoResolverOnce();
|
|
95
|
+
LoggerSlot.writeToConsole({ prefix, level, message, args });
|
|
96
|
+
};
|
|
97
|
+
return {
|
|
98
|
+
debug: (message, ...args) => write(LogLevels.DEBUG, message, args),
|
|
99
|
+
info: (message, ...args) => write(LogLevels.INFO, message, args),
|
|
100
|
+
warn: (message, ...args) => write(LogLevels.WARN, message, args),
|
|
101
|
+
error: (message, ...args) => write(LogLevels.ERROR, message, args),
|
|
102
|
+
emerg: (message, ...args) => write(LogLevels.EMERG, message, args),
|
|
103
|
+
log: (level, message, ...args) => write(level, message, args),
|
|
104
|
+
for: (methodName) => resolved
|
|
105
|
+
? resolved.for(methodName)
|
|
106
|
+
: LoggerSlot.createDeferredLogger({ scopes: [...scopes, methodName] }),
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
/** The real logger when a resolver is installed, else one that upgrades itself the moment one is. */
|
|
110
|
+
static resolveHelperLogger(opts) {
|
|
111
|
+
const resolve = LoggerSlot.resolve;
|
|
112
|
+
return resolve
|
|
113
|
+
? resolve({ scopes: opts.scopes })
|
|
114
|
+
: LoggerSlot.createDeferredLogger({ scopes: opts.scopes });
|
|
115
|
+
}
|
|
116
|
+
/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. */
|
|
117
|
+
static pinHelperLogger(opts) {
|
|
118
|
+
Object.defineProperty(opts.helper, 'logger', {
|
|
119
|
+
value: opts.logger,
|
|
120
|
+
writable: true,
|
|
121
|
+
configurable: true,
|
|
122
|
+
enumerable: false,
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
}
|
|
119
126
|
//# sourceMappingURL=slot.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../../../src/modules/logger/slot.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { LogLevels } from './common/types';\nimport type { ILogger, TLogLevel } from './common/types';\n\nexport type TLoggerResolver = (opts: { scopes: Array<string> }) => ILogger;\n\n/**\n * Where the logger module installs its resolver, and the only reference `BaseHelper` holds to it.\n *\n * A slot rather than an import: `BaseHelper` sits under every class in the framework, so importing\n * the resolver put 1033 B gzipped into every browser bundle that touched any helper.\n */\nexport const loggerSlot: { resolve?: TLoggerResolver } = {};\n\n/** Writes one line to the console; `emerg` and anything unrecognised land on `error`. */\nconst writeToConsole = (opts: {\n prefix: string;\n level: TLogLevel;\n message: string;\n args: Array<AnyType>;\n}): void => {\n const { prefix, level, message, args } = opts;\n const line = `${prefix} ${message}`;\n\n switch (level) {\n case LogLevels.DEBUG: {\n globalThis.console.debug(line, ...args);\n break;\n }\n case LogLevels.INFO: {\n globalThis.console.info(line, ...args);\n break;\n }\n case LogLevels.WARN: {\n globalThis.console.warn(line, ...args);\n break;\n }\n default: {\n globalThis.console.error(line, ...args);\n break;\n }\n }\n};\n\n/** Hands a line to the level's own method, so the logger's gates apply - `debug` checks `DEBUG`. */\nconst writeToLogger = (opts: {\n logger: ILogger;\n level: TLogLevel;\n message: string;\n args: Array<AnyType>;\n}): void => {\n const { logger, level, message, args } = opts;\n\n switch (level) {\n case LogLevels.DEBUG: {\n logger.debug(message, ...args);\n break;\n }\n case LogLevels.INFO: {\n logger.info(message, ...args);\n break;\n }\n case LogLevels.WARN: {\n logger.warn(message, ...args);\n break;\n }\n case LogLevels.ERROR: {\n logger.error(message, ...args);\n break;\n }\n case LogLevels.EMERG: {\n logger.emerg(message, ...args);\n break;\n }\n default: {\n logger.log(level, message, ...args);\n break;\n }\n }\n};\n\nconst NO_RESOLVER_WARNING =\n '[BaseHelper] Logging to the console - no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` at startup.';\n\n/** Global, so a process holding both the CJS and the ESM copy of this module still warns once. */\nconst NO_RESOLVER_WARNED = Symbol.for('@venizia/ignis-helpers:no-logger-provider-warned');\n\n/** Node only: a browser has no `LoggerFactory` to import, so the advice would be noise there. */\nconst warnNoResolverOnce = (): void => {\n if (Reflect.get(globalThis, NO_RESOLVER_WARNED) || !globalThis.process?.versions?.node) {\n return;\n }\n\n Reflect.set(globalThis, NO_RESOLVER_WARNED, true);\n globalThis.console.warn(NO_RESOLVER_WARNING);\n};\n\n/**\n * Writes to the console until a resolver is installed, then hands every call to the real logger - a\n * helper that logs before the resolver module loads would otherwise stay on the console for good.\n */\nconst createDeferredLogger = (opts: { scopes: Array<string> }): ILogger => {\n const { scopes } = opts;\n const prefix = `[${scopes.join('-')}]`;\n let resolved: ILogger | undefined;\n\n const write = (level: TLogLevel, message: string, args: Array<AnyType>): void => {\n const resolve = loggerSlot.resolve;\n if (!resolved && resolve) {\n resolved = resolve({ scopes });\n }\n\n if (resolved) {\n writeToLogger({ logger: resolved, level, message, args });\n return;\n }\n\n warnNoResolverOnce();\n writeToConsole({ prefix, level, message, args });\n };\n\n return {\n debug: (message: string, ...args: Array<AnyType>) => write(LogLevels.DEBUG, message, args),\n info: (message: string, ...args: Array<AnyType>) => write(LogLevels.INFO, message, args),\n warn: (message: string, ...args: Array<AnyType>) => write(LogLevels.WARN, message, args),\n error: (message: string, ...args: Array<AnyType>) => write(LogLevels.ERROR, message, args),\n emerg: (message: string, ...args: Array<AnyType>) => write(LogLevels.EMERG, message, args),\n log: (level: TLogLevel, message: string, ...args: Array<AnyType>) =>\n write(level, message, args),\n for: (methodName: string) =>\n resolved\n ? resolved.for(methodName)\n : createDeferredLogger({ scopes: [...scopes, methodName] }),\n };\n};\n\n/** The real logger when a resolver is installed, else one that upgrades itself the moment one is. */\nexport const resolveHelperLogger = (opts: { scopes: Array<string> }): ILogger => {\n const resolve = loggerSlot.resolve;\n return resolve ? resolve({ scopes: opts.scopes }) : createDeferredLogger({ scopes: opts.scopes });\n};\n\n/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. */\nexport const pinHelperLogger = (opts: { helper: object; logger: ILogger }): void => {\n Object.defineProperty(opts.helper, 'logger', {\n value: opts.logger,\n writable: true,\n configurable: true,\n enumerable: false,\n });\n};\n"]}
|
|
1
|
+
{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../../../src/modules/logger/slot.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { LogLevels } from './common/types';\nimport type { ILogger, TLogLevel } from './common/types';\n\nexport type TLoggerResolver = (opts: { scopes: Array<string> }) => ILogger;\n\nconst NO_RESOLVER_WARNING =\n '[BaseHelper] Logging to the console - no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` at startup.';\n\n/** Global, so a process holding both the CJS and the ESM copy of this module still warns once. */\nconst NO_RESOLVER_WARNED = Symbol.for('@venizia/ignis-helpers:no-logger-provider-warned');\n\nexport class LoggerSlot {\n /**\n * Where the logger module installs its resolver, and the only reference `BaseHelper` holds to it.\n *\n * A slot rather than an import: `BaseHelper` sits under every class in the framework, so importing\n * the resolver put 1033 B gzipped into every browser bundle that touched any helper.\n */\n static resolve?: TLoggerResolver;\n\n /**\n * Installs the logger every helper writes to. A browser app calls it once at startup, because `LoggerFactory` is\n * node-only: `LoggerSlot.use({ resolver: ({ scopes }) => ConsoleLogger.get({ scope: scopes.join('-') }) })`.\n *\n * Call it BEFORE the first log line. A helper that logs before a resolver exists keeps writing to the console, and\n * the logger it resolves on its first line after one is installed is the one it keeps.\n */\n static use(opts: { resolver: TLoggerResolver }): void {\n LoggerSlot.resolve = opts.resolver;\n }\n\n /** Writes one line to the console; `emerg` and anything unrecognised land on `error`. */\n private static writeToConsole(opts: {\n prefix: string;\n level: TLogLevel;\n message: string;\n args: Array<AnyType>;\n }): void {\n const { prefix, level, message, args } = opts;\n const line = `${prefix} ${message}`;\n\n switch (level) {\n case LogLevels.DEBUG: {\n globalThis.console.debug(line, ...args);\n break;\n }\n case LogLevels.INFO: {\n globalThis.console.info(line, ...args);\n break;\n }\n case LogLevels.WARN: {\n globalThis.console.warn(line, ...args);\n break;\n }\n default: {\n globalThis.console.error(line, ...args);\n break;\n }\n }\n }\n\n /** Hands a line to the level's own method, so the logger's gates apply - `debug` checks `DEBUG`. */\n private static writeToLogger(opts: {\n logger: ILogger;\n level: TLogLevel;\n message: string;\n args: Array<AnyType>;\n }): void {\n const { logger, level, message, args } = opts;\n\n switch (level) {\n case LogLevels.DEBUG: {\n logger.debug(message, ...args);\n break;\n }\n case LogLevels.INFO: {\n logger.info(message, ...args);\n break;\n }\n case LogLevels.WARN: {\n logger.warn(message, ...args);\n break;\n }\n case LogLevels.ERROR: {\n logger.error(message, ...args);\n break;\n }\n case LogLevels.EMERG: {\n logger.emerg(message, ...args);\n break;\n }\n default: {\n logger.log(level, message, ...args);\n break;\n }\n }\n }\n\n /** Node only: a browser has no `LoggerFactory` to import, so the advice would be noise there. */\n private static warnNoResolverOnce(): void {\n if (Reflect.get(globalThis, NO_RESOLVER_WARNED) || !globalThis.process?.versions?.node) {\n return;\n }\n\n Reflect.set(globalThis, NO_RESOLVER_WARNED, true);\n globalThis.console.warn(NO_RESOLVER_WARNING);\n }\n\n /**\n * Writes to the console until a resolver is installed, then hands every call to the real logger - a\n * helper that logs before the resolver module loads would otherwise stay on the console for good.\n */\n private static createDeferredLogger(opts: { scopes: Array<string> }): ILogger {\n const { scopes } = opts;\n const prefix = `[${scopes.join('-')}]`;\n let resolved: ILogger | undefined;\n\n const write = (level: TLogLevel, message: string, args: Array<AnyType>): void => {\n const resolve = LoggerSlot.resolve;\n if (!resolved && resolve) {\n resolved = resolve({ scopes });\n }\n\n if (resolved) {\n LoggerSlot.writeToLogger({ logger: resolved, level, message, args });\n return;\n }\n\n LoggerSlot.warnNoResolverOnce();\n LoggerSlot.writeToConsole({ prefix, level, message, args });\n };\n\n return {\n debug: (message: string, ...args: Array<AnyType>) => write(LogLevels.DEBUG, message, args),\n info: (message: string, ...args: Array<AnyType>) => write(LogLevels.INFO, message, args),\n warn: (message: string, ...args: Array<AnyType>) => write(LogLevels.WARN, message, args),\n error: (message: string, ...args: Array<AnyType>) => write(LogLevels.ERROR, message, args),\n emerg: (message: string, ...args: Array<AnyType>) => write(LogLevels.EMERG, message, args),\n log: (level: TLogLevel, message: string, ...args: Array<AnyType>) =>\n write(level, message, args),\n for: (methodName: string) =>\n resolved\n ? resolved.for(methodName)\n : LoggerSlot.createDeferredLogger({ scopes: [...scopes, methodName] }),\n };\n }\n\n /** The real logger when a resolver is installed, else one that upgrades itself the moment one is. */\n static resolveHelperLogger(opts: { scopes: Array<string> }): ILogger {\n const resolve = LoggerSlot.resolve;\n return resolve\n ? resolve({ scopes: opts.scopes })\n : LoggerSlot.createDeferredLogger({ scopes: opts.scopes });\n }\n\n /** Pins a logger on a helper instance: later reads are a plain property read, not its getter. */\n static pinHelperLogger(opts: { helper: object; logger: ILogger }): void {\n Object.defineProperty(opts.helper, 'logger', {\n value: opts.logger,\n writable: true,\n configurable: true,\n enumerable: false,\n });\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/constants.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,eAAO,MAAM,aAAa,QAA4B,CAAC;AACvD,eAAO,MAAM,aAAa,
|
|
1
|
+
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/constants.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,eAAO,MAAM,aAAa,QAA4B,CAAC;AACvD,eAAO,MAAM,aAAa,QAC6D,CAAC;AAExF,eAAO,MAAM,qBAAqB,QAC2D,CAAC;AAC9F,eAAO,MAAM,oBAAoB,QAC6D,CAAC;AAC/F,eAAO,MAAM,qBAAqB,QAC2D,CAAC;AAC9F,eAAO,MAAM,wBAAwB,QAEtB,CAAC"}
|
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { ParseUtility } from '../../../../utilities/parse.utility.js';
|
|
2
2
|
import { Defaults } from '../../../../common/constants/index.js';
|
|
3
3
|
/** Not re-exported from `common/index.ts` - keeps these off the `/winston` sub-path surface. */
|
|
4
4
|
export const LOGGER_PREFIX = Defaults.APPLICATION_NAME;
|
|
5
|
-
export const LOGGER_FORMAT = blankToUndefined(process.env.APP_ENV_LOGGER_FORMAT) ?? 'text';
|
|
6
|
-
export const LOGGER_FILE_FREQUENCY = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_FREQUENCY) ?? '1h';
|
|
7
|
-
export const LOGGER_FILE_MAX_SIZE = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_MAX_SIZE) ?? '100m';
|
|
8
|
-
export const LOGGER_FILE_MAX_FILES = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_MAX_FILES) ?? '5d';
|
|
9
|
-
export const LOGGER_FILE_DATE_PATTERN = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_DATE_PATTERN) ??
|
|
5
|
+
export const LOGGER_FORMAT = ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FORMAT }) ?? 'text';
|
|
6
|
+
export const LOGGER_FILE_FREQUENCY = ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_FREQUENCY }) ?? '1h';
|
|
7
|
+
export const LOGGER_FILE_MAX_SIZE = ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_MAX_SIZE }) ?? '100m';
|
|
8
|
+
export const LOGGER_FILE_MAX_FILES = ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_MAX_FILES }) ?? '5d';
|
|
9
|
+
export const LOGGER_FILE_DATE_PATTERN = ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_DATE_PATTERN }) ??
|
|
10
|
+
'YYYYMMDD_HH';
|
|
10
11
|
//# sourceMappingURL=constants.js.map
|