@venizia/ignis-helpers 0.4.7 → 0.4.8-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/README.md +2 -2
- package/dist/esm/common/constants/app.d.ts +15 -0
- package/dist/esm/common/constants/app.js +14 -0
- package/dist/esm/common/constants/app.js.map +1 -1
- package/dist/esm/common/constants/duration.d.ts +2 -0
- package/dist/esm/common/constants/duration.js.map +1 -1
- package/dist/esm/common/constants/grpc.d.ts +3 -0
- package/dist/esm/common/constants/grpc.js +1 -0
- package/dist/esm/common/constants/grpc.js.map +1 -1
- package/dist/esm/common/constants/http.d.ts +4 -0
- package/dist/esm/common/constants/http.js +1 -0
- package/dist/esm/common/constants/http.js.map +1 -1
- package/dist/esm/common/constants/mime.d.ts +4 -0
- package/dist/esm/common/constants/mime.js +1 -0
- package/dist/esm/common/constants/mime.js.map +1 -1
- package/dist/esm/common/redact.d.ts +2 -0
- package/dist/esm/common/redact.js +2 -0
- package/dist/esm/common/redact.js.map +1 -1
- package/dist/esm/common/resolvers.d.ts +1 -0
- package/dist/esm/common/resolvers.js +1 -0
- package/dist/esm/common/resolvers.js.map +1 -1
- package/dist/esm/common/types/class.d.ts +6 -0
- package/dist/esm/common/types/class.js.map +1 -1
- package/dist/esm/common/types/const-value.d.ts +3 -0
- package/dist/esm/common/types/const-value.js.map +1 -1
- package/dist/esm/common/types/field-mapping.d.ts +3 -0
- package/dist/esm/common/types/field-mapping.js.map +1 -1
- package/dist/esm/common/types/injection.d.ts +2 -0
- package/dist/esm/common/types/injection.js.map +1 -1
- package/dist/esm/common/types/utility.d.ts +9 -0
- package/dist/esm/common/types/utility.js.map +1 -1
- package/dist/esm/modules/base.d.ts +1 -0
- package/dist/esm/modules/base.js +1 -0
- package/dist/esm/modules/base.js.map +1 -1
- package/dist/esm/modules/cron/helper.d.ts +7 -0
- package/dist/esm/modules/cron/helper.js +1 -0
- package/dist/esm/modules/cron/helper.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts +2 -0
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/aes.engine.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts +1 -0
- package/dist/esm/modules/crypto/algorithms/base.algorithm.js +1 -0
- package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts +12 -4
- package/dist/esm/modules/crypto/algorithms/credential.algorithm.js +4 -4
- package/dist/esm/modules/crypto/algorithms/credential.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts +3 -0
- package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/hash.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts +1 -0
- package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
- package/dist/esm/modules/crypto/common/constants.d.ts +12 -1
- package/dist/esm/modules/crypto/common/constants.js +9 -1
- package/dist/esm/modules/crypto/common/constants.js.map +1 -1
- package/dist/esm/modules/crypto/common/types.d.ts +1 -0
- package/dist/esm/modules/crypto/common/types.js.map +1 -1
- package/dist/esm/modules/env/app-env.d.ts +3 -0
- package/dist/esm/modules/env/app-env.js +3 -0
- package/dist/esm/modules/env/app-env.js.map +1 -1
- package/dist/esm/modules/env/common/types.d.ts +1 -0
- package/dist/esm/modules/env/common/types.js.map +1 -1
- package/dist/esm/modules/logger/base/base.js.map +1 -1
- package/dist/esm/modules/logger/base/console.js.map +1 -1
- package/dist/esm/modules/logger/common/constants.d.ts +3 -0
- package/dist/esm/modules/logger/common/constants.js +2 -0
- package/dist/esm/modules/logger/common/constants.js.map +1 -1
- package/dist/esm/modules/logger/common/debug-gate.js.map +1 -1
- package/dist/esm/modules/logger/common/types.d.ts +2 -0
- package/dist/esm/modules/logger/common/types.js +1 -0
- package/dist/esm/modules/logger/common/types.js.map +1 -1
- package/dist/esm/modules/logger/factory.js.map +1 -1
- package/dist/esm/modules/logger/formatting/deep-splat.d.ts +1 -0
- package/dist/esm/modules/logger/formatting/deep-splat.js +1 -0
- package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
- package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
- package/dist/esm/modules/logger/hf/common/types.d.ts +7 -2
- package/dist/esm/modules/logger/hf/common/types.js.map +1 -1
- package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
- package/dist/esm/modules/logger/hf/logger.js.map +1 -1
- package/dist/esm/modules/logger/hf/ring.js.map +1 -1
- package/dist/esm/modules/logger/pino/backing.js.map +1 -1
- package/dist/esm/modules/logger/pino/destination.js.map +1 -1
- package/dist/esm/modules/logger/pino/logger.js.map +1 -1
- package/dist/esm/modules/logger/winston/common/types.d.ts +31 -3
- package/dist/esm/modules/logger/winston/common/types.js.map +1 -1
- package/dist/esm/modules/logger/winston/define.d.ts +1 -0
- package/dist/esm/modules/logger/winston/define.js +1 -0
- package/dist/esm/modules/logger/winston/define.js.map +1 -1
- package/dist/esm/modules/logger/winston/formats.js.map +1 -1
- package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
- package/dist/esm/modules/logger/winston/logger.d.ts +1 -0
- package/dist/esm/modules/logger/winston/logger.js +1 -0
- package/dist/esm/modules/logger/winston/logger.js.map +1 -1
- package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -0
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -0
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
- package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +1 -0
- package/dist/esm/modules/network/http-request/base-network-request.helper.js +1 -0
- package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +8 -8
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +2 -0
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -0
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +5 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +2 -0
- 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.d.ts +11 -0
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -0
- 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.d.ts +3 -0
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +1 -0
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js +1 -0
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js.map +1 -1
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts +4 -0
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +4 -0
- 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 +13 -2
- package/dist/esm/modules/network/utilities/query-string.js +2 -1
- package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +2 -1
- package/dist/esm/modules/network/utilities/url-safety/common/constants.js +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +18 -5
- package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
- package/dist/esm/modules/pool/abstract.js.map +1 -1
- package/dist/esm/modules/pool/common/types.d.ts +5 -1
- package/dist/esm/modules/pool/common/types.js.map +1 -1
- package/dist/esm/modules/queue/bullmq/helper.d.ts +13 -0
- package/dist/esm/modules/queue/bullmq/helper.js +4 -0
- package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/esm/modules/queue/common/hook.d.ts +1 -0
- package/dist/esm/modules/queue/common/hook.js +1 -0
- package/dist/esm/modules/queue/common/hook.js.map +1 -1
- package/dist/esm/modules/queue/internal/hf/helper.js.map +1 -1
- package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +8 -0
- package/dist/esm/modules/queue/internal/sequential/common/types.js +1 -0
- package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
- package/dist/esm/modules/queue/internal/sequential/helper.d.ts +4 -0
- package/dist/esm/modules/queue/internal/sequential/helper.js +4 -0
- package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
- package/dist/esm/modules/queue/kafka/base.d.ts +5 -0
- package/dist/esm/modules/queue/kafka/base.js.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts +3 -0
- package/dist/esm/modules/queue/kafka/bundler/common/constants.js +3 -0
- package/dist/esm/modules/queue/kafka/bundler/common/constants.js.map +1 -1
- package/dist/esm/modules/queue/kafka/common/constants.d.ts +8 -0
- package/dist/esm/modules/queue/kafka/common/constants.js +5 -0
- package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
- package/dist/esm/modules/queue/kafka/common/types/admin.d.ts +1 -0
- package/dist/esm/modules/queue/kafka/common/types/admin.js.map +1 -1
- package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts +12 -0
- package/dist/esm/modules/queue/kafka/common/types/callbacks.js.map +1 -1
- package/dist/esm/modules/queue/kafka/common/types/connection.d.ts +2 -0
- package/dist/esm/modules/queue/kafka/common/types/connection.js.map +1 -1
- package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts +62 -0
- package/dist/esm/modules/queue/kafka/common/types/consumer.js.map +1 -1
- package/dist/esm/modules/queue/kafka/common/types/producer.d.ts +1 -0
- package/dist/esm/modules/queue/kafka/common/types/producer.js.map +1 -1
- package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
- package/dist/esm/modules/queue/mqtt/helper.d.ts +2 -0
- package/dist/esm/modules/queue/mqtt/helper.js +1 -0
- package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
- package/dist/esm/modules/redis/base/abstract.helper.d.ts +2 -0
- package/dist/esm/modules/redis/base/abstract.helper.js +2 -0
- package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -0
- package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -0
- package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
- package/dist/esm/modules/redis/common/constants.d.ts +4 -0
- package/dist/esm/modules/redis/common/constants.js +2 -0
- package/dist/esm/modules/redis/common/constants.js.map +1 -1
- package/dist/esm/modules/redis/common/interfaces.d.ts +12 -0
- package/dist/esm/modules/redis/common/interfaces.js.map +1 -1
- package/dist/esm/modules/redis/common/types.d.ts +21 -1
- package/dist/esm/modules/redis/common/types.js.map +1 -1
- package/dist/esm/modules/redis/factory.d.ts +2 -0
- package/dist/esm/modules/redis/factory.js +1 -0
- package/dist/esm/modules/redis/factory.js.map +1 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -0
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -0
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
- package/dist/esm/modules/redis/single/single.helper.d.ts +1 -0
- package/dist/esm/modules/redis/single/single.helper.js +1 -0
- package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
- package/dist/esm/modules/redis/utility.d.ts +1 -0
- package/dist/esm/modules/redis/utility.js +1 -0
- package/dist/esm/modules/redis/utility.js.map +1 -1
- package/dist/esm/modules/retry/common/constants.d.ts +4 -0
- package/dist/esm/modules/retry/common/constants.js +2 -0
- package/dist/esm/modules/retry/common/constants.js.map +1 -1
- package/dist/esm/modules/retry/common/types.d.ts +19 -5
- package/dist/esm/modules/retry/common/types.js.map +1 -1
- package/dist/esm/modules/retry/helper.d.ts +4 -4
- package/dist/esm/modules/retry/helper.js.map +1 -1
- package/dist/esm/modules/secrets/base/abstract.helper.d.ts +1 -0
- package/dist/esm/modules/secrets/base/abstract.helper.js +1 -0
- package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/secrets/common/constants.d.ts +4 -0
- package/dist/esm/modules/secrets/common/constants.js +2 -0
- package/dist/esm/modules/secrets/common/constants.js.map +1 -1
- package/dist/esm/modules/secrets/common/types/helper.d.ts +13 -0
- package/dist/esm/modules/secrets/common/types/helper.js.map +1 -1
- package/dist/esm/modules/secrets/common/types/lease.d.ts +2 -0
- package/dist/esm/modules/secrets/common/types/lease.js.map +1 -1
- package/dist/esm/modules/secrets/common/types/registration.d.ts +13 -2
- package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
- package/dist/esm/modules/secrets/common/types/timer.d.ts +1 -0
- package/dist/esm/modules/secrets/common/types/timer.js.map +1 -1
- package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts +8 -0
- package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -0
- package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
- package/dist/esm/modules/secrets/factory.d.ts +1 -0
- package/dist/esm/modules/secrets/factory.js +1 -0
- package/dist/esm/modules/secrets/factory.js.map +1 -1
- package/dist/esm/modules/secrets/hashicorp/auth.d.ts +2 -0
- package/dist/esm/modules/secrets/hashicorp/auth.js +1 -0
- package/dist/esm/modules/secrets/hashicorp/auth.js.map +1 -1
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +2 -0
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +1 -0
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
- package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts +1 -0
- package/dist/esm/modules/secrets/system-envs/system-envs.helper.js +1 -0
- package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
- package/dist/esm/modules/slug/common/constants.d.ts +1 -0
- package/dist/esm/modules/slug/common/constants.js +1 -0
- package/dist/esm/modules/slug/common/constants.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/common/constants.d.ts +2 -0
- package/dist/esm/modules/socket/socket-io/common/constants.js +2 -0
- package/dist/esm/modules/socket/socket-io/common/constants.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +5 -0
- package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts +4 -0
- package/dist/esm/modules/socket/socket-io/common/types/hooks.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +6 -0
- package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/server/helper.d.ts +1 -0
- package/dist/esm/modules/socket/socket-io/server/helper.js +1 -0
- package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
- package/dist/esm/modules/socket/websocket/common/constants.d.ts +7 -0
- package/dist/esm/modules/socket/websocket/common/constants.js +5 -0
- package/dist/esm/modules/socket/websocket/common/constants.js.map +1 -1
- package/dist/esm/modules/socket/websocket/common/types/client.d.ts +4 -0
- package/dist/esm/modules/socket/websocket/common/types/client.js.map +1 -1
- package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts +7 -0
- package/dist/esm/modules/socket/websocket/common/types/hooks.js.map +1 -1
- package/dist/esm/modules/socket/websocket/common/types/server.d.ts +30 -0
- package/dist/esm/modules/socket/websocket/common/types/server.js.map +1 -1
- package/dist/esm/modules/socket/websocket/emitter/helper.d.ts +1 -0
- package/dist/esm/modules/socket/websocket/emitter/helper.js +1 -0
- package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/helper.d.ts +1 -0
- package/dist/esm/modules/socket/websocket/server/helper.js +1 -0
- package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
- package/dist/esm/modules/storage/base.d.ts +6 -1
- package/dist/esm/modules/storage/base.js +1 -0
- package/dist/esm/modules/storage/base.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.d.ts +9 -1
- package/dist/esm/modules/storage/bun-s3/helper.js +2 -1
- package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
- package/dist/esm/modules/storage/common/constants.d.ts +1 -0
- package/dist/esm/modules/storage/common/constants.js.map +1 -1
- package/dist/esm/modules/storage/common/types.d.ts +17 -1
- package/dist/esm/modules/storage/common/types.js.map +1 -1
- package/dist/esm/modules/storage/common/utility.d.ts +1 -0
- package/dist/esm/modules/storage/common/utility.js +1 -0
- package/dist/esm/modules/storage/common/utility.js.map +1 -1
- package/dist/esm/modules/storage/disk/helper.d.ts +2 -0
- package/dist/esm/modules/storage/disk/helper.js +1 -0
- package/dist/esm/modules/storage/disk/helper.js.map +1 -1
- package/dist/esm/modules/temporal/abstract.d.ts +5 -0
- package/dist/esm/modules/temporal/abstract.js +2 -1
- package/dist/esm/modules/temporal/abstract.js.map +1 -1
- package/dist/esm/modules/temporal/adapters/dayjs.js.map +1 -1
- package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
- package/dist/esm/modules/temporal/adapters/luxon.js.map +1 -1
- package/dist/esm/modules/temporal/adapters/native.js.map +1 -1
- package/dist/esm/modules/temporal/calendar/calendar.js.map +1 -1
- package/dist/esm/modules/temporal/common/constants.d.ts +3 -0
- package/dist/esm/modules/temporal/common/constants.js.map +1 -1
- package/dist/esm/modules/temporal/common/types.js.map +1 -1
- package/dist/esm/modules/temporal/duration/duration.js.map +1 -1
- package/dist/esm/modules/temporal/helper.js.map +1 -1
- package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
- package/dist/esm/modules/temporal/pattern/pattern.js.map +1 -1
- package/dist/esm/modules/temporal/pattern/tokens.js.map +1 -1
- package/dist/esm/modules/tree/builder.js.map +1 -1
- package/dist/esm/modules/tree/common/types.d.ts +6 -0
- package/dist/esm/modules/tree/common/types.js.map +1 -1
- package/dist/esm/modules/uid/common/constants.d.ts +1 -0
- package/dist/esm/modules/uid/common/constants.js.map +1 -1
- package/dist/esm/modules/uid/common/types.d.ts +28 -7
- package/dist/esm/modules/uid/common/types.js.map +1 -1
- package/dist/esm/modules/uid/helper.d.ts +12 -0
- package/dist/esm/modules/uid/helper.js.map +1 -1
- package/dist/esm/modules/uid/opaque.js.map +1 -1
- package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
- package/dist/esm/modules/uid/uuid/sha1.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v4.d.ts +1 -0
- package/dist/esm/modules/uid/uuid/v4.js +1 -0
- package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v5.d.ts +1 -0
- package/dist/esm/modules/uid/uuid/v5.js +1 -0
- package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v7.d.ts +1 -0
- package/dist/esm/modules/uid/uuid/v7.js +1 -0
- package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
- package/dist/esm/modules/worker-thread/bus/abstract.d.ts +1 -0
- package/dist/esm/modules/worker-thread/bus/abstract.js +1 -0
- package/dist/esm/modules/worker-thread/bus/abstract.js.map +1 -1
- package/dist/esm/modules/worker-thread/bus/base.d.ts +1 -0
- package/dist/esm/modules/worker-thread/bus/base.js +1 -0
- package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts +1 -0
- package/dist/esm/modules/worker-thread/bus/handler/abstract.js +1 -0
- package/dist/esm/modules/worker-thread/bus/handler/abstract.js.map +1 -1
- package/dist/esm/modules/worker-thread/bus/handler/base.d.ts +1 -0
- package/dist/esm/modules/worker-thread/bus/handler/base.js +1 -0
- package/dist/esm/modules/worker-thread/bus/handler/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/common/types.d.ts +4 -0
- package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
- package/dist/esm/modules/worker-thread/thread/abstract.d.ts +1 -0
- package/dist/esm/modules/worker-thread/thread/abstract.js +1 -0
- package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
- package/dist/esm/modules/worker-thread/thread/base.d.ts +1 -0
- package/dist/esm/modules/worker-thread/thread/base.js +1 -0
- package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/worker/abstract.d.ts +1 -0
- package/dist/esm/modules/worker-thread/worker/abstract.js +1 -0
- package/dist/esm/modules/worker-thread/worker/abstract.js.map +1 -1
- package/dist/esm/modules/worker-thread/worker/base.d.ts +1 -0
- package/dist/esm/modules/worker-thread/worker/base.js +1 -0
- package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -0
- package/dist/esm/modules/worker-thread/worker-pool.js +1 -0
- package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
- package/dist/esm/utilities/error.utility.d.ts +1 -0
- package/dist/esm/utilities/error.utility.js +1 -0
- package/dist/esm/utilities/error.utility.js.map +1 -1
- package/dist/esm/utilities/form-body.utility.d.ts +1 -0
- package/dist/esm/utilities/form-body.utility.js +1 -0
- package/dist/esm/utilities/form-body.utility.js.map +1 -1
- package/dist/esm/utilities/hr-time.utility.d.ts +1 -0
- package/dist/esm/utilities/hr-time.utility.js +1 -0
- package/dist/esm/utilities/hr-time.utility.js.map +1 -1
- package/dist/esm/utilities/module.utility.js.map +1 -1
- package/dist/esm/utilities/parse.utility.js.map +1 -1
- package/dist/esm/utilities/performance.utility.d.ts +1 -0
- package/dist/esm/utilities/performance.utility.js +1 -0
- package/dist/esm/utilities/performance.utility.js.map +1 -1
- package/dist/esm/utilities/promise.utility.d.ts +1 -0
- package/dist/esm/utilities/promise.utility.js.map +1 -1
- package/dist/esm/utilities/request.utility.d.ts +2 -0
- package/dist/esm/utilities/request.utility.js +1 -0
- package/dist/esm/utilities/request.utility.js.map +1 -1
- package/package.json +4 -4
- package/dist/esm/common/constants/app.d.ts.map +0 -1
- package/dist/esm/common/constants/duration.d.ts.map +0 -1
- package/dist/esm/common/constants/grpc.d.ts.map +0 -1
- package/dist/esm/common/constants/http.d.ts.map +0 -1
- package/dist/esm/common/constants/index.d.ts.map +0 -1
- package/dist/esm/common/constants/mime.d.ts.map +0 -1
- package/dist/esm/common/index.d.ts.map +0 -1
- package/dist/esm/common/jsx.d.ts.map +0 -1
- package/dist/esm/common/redact.d.ts.map +0 -1
- package/dist/esm/common/resolvers.d.ts.map +0 -1
- package/dist/esm/common/types/class.d.ts.map +0 -1
- package/dist/esm/common/types/const-value.d.ts.map +0 -1
- package/dist/esm/common/types/field-mapping.d.ts.map +0 -1
- package/dist/esm/common/types/index.d.ts.map +0 -1
- package/dist/esm/common/types/injection.d.ts.map +0 -1
- package/dist/esm/common/types/resolver.d.ts.map +0 -1
- package/dist/esm/common/types/utility.d.ts.map +0 -1
- package/dist/esm/core.d.ts.map +0 -1
- package/dist/esm/index.d.ts.map +0 -1
- package/dist/esm/modules/base.d.ts.map +0 -1
- package/dist/esm/modules/cron/helper.d.ts.map +0 -1
- package/dist/esm/modules/cron/index.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/abstract.algorithm.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/aes.constants.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/aes.engine.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/hash.algorithm.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/index.d.ts.map +0 -1
- package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts.map +0 -1
- package/dist/esm/modules/crypto/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/crypto/common/index.d.ts.map +0 -1
- package/dist/esm/modules/crypto/common/types.d.ts.map +0 -1
- package/dist/esm/modules/crypto/index.d.ts.map +0 -1
- package/dist/esm/modules/env/app-env.d.ts.map +0 -1
- package/dist/esm/modules/env/common/index.d.ts.map +0 -1
- package/dist/esm/modules/env/common/types.d.ts.map +0 -1
- package/dist/esm/modules/env/index.d.ts.map +0 -1
- package/dist/esm/modules/env/names.d.ts.map +0 -1
- package/dist/esm/modules/error/index.d.ts.map +0 -1
- package/dist/esm/modules/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/base/abstract.d.ts.map +0 -1
- package/dist/esm/modules/logger/base/base.d.ts.map +0 -1
- package/dist/esm/modules/logger/base/console.d.ts.map +0 -1
- package/dist/esm/modules/logger/base/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/logger/common/debug-gate.d.ts.map +0 -1
- package/dist/esm/modules/logger/common/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/common/types.d.ts.map +0 -1
- package/dist/esm/modules/logger/factory.d.ts.map +0 -1
- package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +0 -1
- package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +0 -1
- package/dist/esm/modules/logger/formatting/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/hf/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/logger/hf/common/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/hf/common/types.d.ts.map +0 -1
- package/dist/esm/modules/logger/hf/flusher.d.ts.map +0 -1
- package/dist/esm/modules/logger/hf/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/hf/logger.d.ts.map +0 -1
- package/dist/esm/modules/logger/hf/ring.d.ts.map +0 -1
- package/dist/esm/modules/logger/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/pino/backing.d.ts.map +0 -1
- package/dist/esm/modules/logger/pino/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/logger/pino/common/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/pino/common/types.d.ts.map +0 -1
- package/dist/esm/modules/logger/pino/destination.d.ts.map +0 -1
- package/dist/esm/modules/logger/pino/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/pino/logger.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/common/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/common/types.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/define.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/formats.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/index.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/logger-factory.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/logger.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts.map +0 -1
- package/dist/esm/modules/logger/winston/transports/index.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/common/index.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/fetcher/index.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +0 -1
- package/dist/esm/modules/network/http-request/index.d.ts.map +0 -1
- package/dist/esm/modules/network/index.d.ts.map +0 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/tcp-socket/index.d.ts.map +0 -1
- package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/udp-socket/index.d.ts.map +0 -1
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/index.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/query-string.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/common/index.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/index.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +0 -1
- package/dist/esm/modules/pool/abstract.d.ts.map +0 -1
- package/dist/esm/modules/pool/base.d.ts.map +0 -1
- package/dist/esm/modules/pool/common/index.d.ts.map +0 -1
- package/dist/esm/modules/pool/common/types.d.ts.map +0 -1
- package/dist/esm/modules/pool/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/bullmq/helper.d.ts.map +0 -1
- package/dist/esm/modules/queue/bullmq/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/queue/common/hook.d.ts.map +0 -1
- package/dist/esm/modules/queue/common/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/hf/common/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/hf/common/types.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/hf/helper.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/hf/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/sequential/common/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/sequential/common/types.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/sequential/helper.d.ts.map +0 -1
- package/dist/esm/modules/queue/internal/sequential/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/admin.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/base.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/common/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/types/admin.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/types/connection.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/types/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/common/types/producer.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/consumer.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/producer.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/schema/index.d.ts.map +0 -1
- package/dist/esm/modules/queue/kafka/schema/registry.d.ts.map +0 -1
- package/dist/esm/modules/queue/mqtt/helper.d.ts.map +0 -1
- package/dist/esm/modules/queue/mqtt/index.d.ts.map +0 -1
- package/dist/esm/modules/redis/base/abstract.helper.d.ts.map +0 -1
- package/dist/esm/modules/redis/base/index.d.ts.map +0 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.d.ts.map +0 -1
- package/dist/esm/modules/redis/cluster/index.d.ts.map +0 -1
- package/dist/esm/modules/redis/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/redis/common/index.d.ts.map +0 -1
- package/dist/esm/modules/redis/common/interfaces.d.ts.map +0 -1
- package/dist/esm/modules/redis/common/types.d.ts.map +0 -1
- package/dist/esm/modules/redis/factory.d.ts.map +0 -1
- package/dist/esm/modules/redis/index.d.ts.map +0 -1
- package/dist/esm/modules/redis/sentinel/index.d.ts.map +0 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts.map +0 -1
- package/dist/esm/modules/redis/single/index.d.ts.map +0 -1
- package/dist/esm/modules/redis/single/single.helper.d.ts.map +0 -1
- package/dist/esm/modules/redis/utility.d.ts.map +0 -1
- package/dist/esm/modules/retry/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/retry/common/index.d.ts.map +0 -1
- package/dist/esm/modules/retry/common/types.d.ts.map +0 -1
- package/dist/esm/modules/retry/helper.d.ts.map +0 -1
- package/dist/esm/modules/retry/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +0 -1
- package/dist/esm/modules/secrets/base/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/secrets/common/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/common/types/helper.d.ts.map +0 -1
- package/dist/esm/modules/secrets/common/types/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/common/types/lease.d.ts.map +0 -1
- package/dist/esm/modules/secrets/common/types/registration.d.ts.map +0 -1
- package/dist/esm/modules/secrets/common/types/timer.d.ts.map +0 -1
- package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts.map +0 -1
- package/dist/esm/modules/secrets/dotenv/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/factory.d.ts.map +0 -1
- package/dist/esm/modules/secrets/hashicorp/auth.d.ts.map +0 -1
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +0 -1
- package/dist/esm/modules/secrets/hashicorp/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/system-envs/index.d.ts.map +0 -1
- package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts.map +0 -1
- package/dist/esm/modules/slug/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/slug/common/index.d.ts.map +0 -1
- package/dist/esm/modules/slug/helper.d.ts.map +0 -1
- package/dist/esm/modules/slug/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/browser.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/client/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/common/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/common/types/client.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/common/types/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/common/types/server.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +0 -1
- package/dist/esm/modules/socket/socket-io/server/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/common/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/common/types/client.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/common/types/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/common/types/message.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/common/types/server.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/emitter/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/index.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +0 -1
- package/dist/esm/modules/socket/websocket/server/index.d.ts.map +0 -1
- package/dist/esm/modules/storage/base.d.ts.map +0 -1
- package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +0 -1
- package/dist/esm/modules/storage/bun-s3/index.d.ts.map +0 -1
- package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +0 -1
- package/dist/esm/modules/storage/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/storage/common/errors.d.ts.map +0 -1
- package/dist/esm/modules/storage/common/index.d.ts.map +0 -1
- package/dist/esm/modules/storage/common/types.d.ts.map +0 -1
- package/dist/esm/modules/storage/common/utility.d.ts.map +0 -1
- package/dist/esm/modules/storage/disk/helper.d.ts.map +0 -1
- package/dist/esm/modules/storage/disk/index.d.ts.map +0 -1
- package/dist/esm/modules/storage/in-memory/helper.d.ts.map +0 -1
- package/dist/esm/modules/storage/in-memory/index.d.ts.map +0 -1
- package/dist/esm/modules/storage/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/abstract.d.ts.map +0 -1
- package/dist/esm/modules/temporal/adapters/dayjs.d.ts.map +0 -1
- package/dist/esm/modules/temporal/adapters/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/adapters/intl.d.ts.map +0 -1
- package/dist/esm/modules/temporal/adapters/luxon.d.ts.map +0 -1
- package/dist/esm/modules/temporal/adapters/native.d.ts.map +0 -1
- package/dist/esm/modules/temporal/calendar/calendar.d.ts.map +0 -1
- package/dist/esm/modules/temporal/calendar/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/temporal/common/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/common/types.d.ts.map +0 -1
- package/dist/esm/modules/temporal/duration/duration.d.ts.map +0 -1
- package/dist/esm/modules/temporal/duration/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/helper.d.ts.map +0 -1
- package/dist/esm/modules/temporal/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/locale/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/locale/locale.d.ts.map +0 -1
- package/dist/esm/modules/temporal/pattern/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/temporal/pattern/common/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/pattern/common/types.d.ts.map +0 -1
- package/dist/esm/modules/temporal/pattern/index.d.ts.map +0 -1
- package/dist/esm/modules/temporal/pattern/pattern.d.ts.map +0 -1
- package/dist/esm/modules/temporal/pattern/tokens.d.ts.map +0 -1
- package/dist/esm/modules/tree/builder.d.ts.map +0 -1
- package/dist/esm/modules/tree/common/index.d.ts.map +0 -1
- package/dist/esm/modules/tree/common/types.d.ts.map +0 -1
- package/dist/esm/modules/tree/index.d.ts.map +0 -1
- package/dist/esm/modules/tree/walk.d.ts.map +0 -1
- package/dist/esm/modules/uid/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/uid/common/index.d.ts.map +0 -1
- package/dist/esm/modules/uid/common/types.d.ts.map +0 -1
- package/dist/esm/modules/uid/helper.d.ts.map +0 -1
- package/dist/esm/modules/uid/index.d.ts.map +0 -1
- package/dist/esm/modules/uid/opaque.d.ts.map +0 -1
- package/dist/esm/modules/uid/request-id.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/common/constants.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/common/index.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/common/types.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/helper.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/index.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/sha1.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/v4.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/v5.d.ts.map +0 -1
- package/dist/esm/modules/uid/uuid/v7.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/bus/abstract.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/bus/base.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/bus/handler/base.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/bus/handler/index.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/bus/index.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/common/index.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/common/types.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/index.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/thread/abstract.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/thread/base.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/thread/index.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/worker/abstract.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/worker/base.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/worker/index.d.ts.map +0 -1
- package/dist/esm/modules/worker-thread/worker-pool.d.ts.map +0 -1
- package/dist/esm/temporal.d.ts.map +0 -1
- package/dist/esm/utilities/build-info.utility.d.ts.map +0 -1
- package/dist/esm/utilities/error.utility.d.ts.map +0 -1
- package/dist/esm/utilities/form-body.utility.d.ts.map +0 -1
- package/dist/esm/utilities/hr-time.utility.d.ts.map +0 -1
- package/dist/esm/utilities/index.d.ts.map +0 -1
- package/dist/esm/utilities/module.utility.d.ts.map +0 -1
- package/dist/esm/utilities/parse.utility.d.ts.map +0 -1
- package/dist/esm/utilities/performance.utility.d.ts.map +0 -1
- package/dist/esm/utilities/project-root.utility.d.ts.map +0 -1
- package/dist/esm/utilities/promise.utility.d.ts.map +0 -1
- package/dist/esm/utilities/request.utility.d.ts.map +0 -1
- package/dist/esm/uuid.d.ts.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rsa.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/rsa.algorithm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"rsa.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/rsa.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { MINIMUM_RSA_MODULUS_BITS } from '../common/constants';\nimport { BaseCryptoAlgorithm } from './base.algorithm';\n\ninterface IRSAExtraOptions {\n inputEncoding?: { key: BufferEncoding; message: BufferEncoding };\n outputEncoding?: BufferEncoding;\n doThrow?: boolean;\n}\n\n/** The algorithm name `RSA` reports as its `algorithm`. */\nexport type RSAAlgorithmType = 'rsa';\n\n/**\n * OAEP with SHA-1 for both the label hash and MGF1, and the public exponent 65537: what Node's\n * `publicEncrypt`/`privateDecrypt` and `generateKeyPairSync('rsa')` used by default, so keys and\n * ciphertext written by earlier releases still work. Do not change them: every ciphertext stored under\n * them would stop decrypting.\n */\nconst OAEP = { name: 'RSA-OAEP', hash: 'SHA-1' } as const;\nconst PUBLIC_EXPONENT = new Uint8Array([0x01, 0x00, 0x01]);\n\n/** `generateDERKeyPair`, `encrypt` and `decrypt` are async: they run over `crypto.subtle`. */\nexport class RSA extends BaseCryptoAlgorithm<\n RSAAlgorithmType,\n string,\n string,\n string,\n Promise<string>,\n Promise<string>,\n IRSAExtraOptions\n> {\n constructor(opts: { algorithm: RSAAlgorithmType }) {\n super({ scope: RSA.name, ...opts });\n }\n\n static withAlgorithm() {\n return new RSA({ algorithm: 'rsa' });\n }\n\n /**\n * Rejects a modulus below `MINIMUM_RSA_MODULUS_BITS` rather than generating it - a weak key still\n * works, signs, and verifies, so this is the only point where the size is ever checked.\n */\n async generateDERKeyPair(opts?: { modulus: number }) {\n const modulus = opts?.modulus ?? MINIMUM_RSA_MODULUS_BITS;\n\n if (modulus < MINIMUM_RSA_MODULUS_BITS) {\n throw getError({\n message: `[RSA][generateDERKeyPair] Modulus ${modulus} is below the ${MINIMUM_RSA_MODULUS_BITS}-bit minimum`,\n });\n }\n\n const keys = await crypto.subtle.generateKey(\n { ...OAEP, modulusLength: modulus, publicExponent: PUBLIC_EXPONENT },\n true,\n ['encrypt', 'decrypt'],\n );\n\n const publicKey = await crypto.subtle.exportKey('spki', keys.publicKey);\n const privateKey = await crypto.subtle.exportKey('pkcs8', keys.privateKey);\n\n return { publicKey: Buffer.from(publicKey), privateKey: Buffer.from(privateKey) };\n }\n\n async encrypt(opts: {\n message: string;\n secret: string;\n opts?: IRSAExtraOptions;\n }): Promise<string> {\n const { message, secret: pubKey } = opts;\n const {\n inputEncoding = { key: 'base64', message: 'utf-8' },\n outputEncoding = 'base64',\n doThrow = true,\n } = opts.opts ?? {};\n\n try {\n const key = await crypto.subtle.importKey(\n 'spki',\n Buffer.from(pubKey, inputEncoding.key),\n OAEP,\n false,\n ['encrypt'],\n );\n const cipherBytes = await crypto.subtle.encrypt(\n { name: OAEP.name },\n key,\n Buffer.from(message, inputEncoding.message),\n );\n\n return Buffer.from(cipherBytes).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n async decrypt(opts: {\n message: string;\n secret: string;\n opts?: IRSAExtraOptions;\n }): Promise<string> {\n const { message, secret: privKey } = opts;\n const {\n inputEncoding = { key: 'base64', message: 'base64' },\n outputEncoding = 'utf-8',\n doThrow = true,\n } = opts.opts ?? {};\n\n try {\n const key = await crypto.subtle.importKey(\n 'pkcs8',\n Buffer.from(privKey, inputEncoding.key),\n OAEP,\n false,\n ['decrypt'],\n );\n const plainBytes = await crypto.subtle.decrypt(\n { name: OAEP.name },\n key,\n Buffer.from(message, inputEncoding.message),\n );\n\n return Buffer.from(plainBytes).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n}\n"]}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { TConstValue } from '../../../common/index.js';
|
|
2
|
+
/** Key size in bits assumed when an algorithm name carries no size suffix (see `getAlgorithmKeySize`). */
|
|
2
3
|
export declare const DEFAULT_CIPHER_BITS = 256;
|
|
3
4
|
/**
|
|
4
5
|
* Public and identical across every deployment, so it stops a bare dictionary attack but not a
|
|
@@ -6,12 +7,15 @@ export declare const DEFAULT_CIPHER_BITS = 256;
|
|
|
6
7
|
* change this: every ciphertext already encrypted under it becomes undecryptable.
|
|
7
8
|
*/
|
|
8
9
|
export declare const DEFAULT_KDF_SALT = "ignis-kdf-salt-v1";
|
|
10
|
+
/** PBKDF2 iteration count used when `kdfIterations` is omitted. Changing it makes ciphertext encrypted under the old count undecryptable. */
|
|
9
11
|
export declare const DEFAULT_KDF_ITERATIONS = 100000;
|
|
12
|
+
/** PBKDF2 digest for key derivation; it is not configurable per call. */
|
|
10
13
|
export declare const DEFAULT_KDF_DIGEST = "sha256";
|
|
11
14
|
/** NIST SP 800-132 minimum recommended salt size (128 bits) for a caller-supplied `kdfSalt`. */
|
|
12
15
|
export declare const MINIMUM_KDF_SALT_BYTES = 16;
|
|
13
16
|
/** NIST SP 800-57 Part 1 floor for RSA past 2030. */
|
|
14
17
|
export declare const MINIMUM_RSA_MODULUS_BITS = 2048;
|
|
18
|
+
/** Digest names the hash algorithm accepts. `isValid` narrows a string to `THashAlgorithm`. */
|
|
15
19
|
export declare class HashAlgorithms {
|
|
16
20
|
/** Cryptographically broken - kept only for wire-protocol compatibility (VNPay checksums); never use for security decisions. */
|
|
17
21
|
static readonly MD5 = "md5";
|
|
@@ -23,7 +27,9 @@ export declare class HashAlgorithms {
|
|
|
23
27
|
static readonly SCHEME_SET: Set<string>;
|
|
24
28
|
static isValid(value: string): value is THashAlgorithm;
|
|
25
29
|
}
|
|
30
|
+
/** One of the `HashAlgorithms` values. */
|
|
26
31
|
export type THashAlgorithm = TConstValue<typeof HashAlgorithms>;
|
|
32
|
+
/** Text encodings a digest can be written in. `isValid` narrows a string to `THashOutputEncoding`. */
|
|
27
33
|
export declare class HashOutputEncodings {
|
|
28
34
|
static readonly HEX = "hex";
|
|
29
35
|
static readonly BASE64 = "base64";
|
|
@@ -31,15 +37,20 @@ export declare class HashOutputEncodings {
|
|
|
31
37
|
static readonly SCHEME_SET: Set<string>;
|
|
32
38
|
static isValid(value: string): value is THashOutputEncoding;
|
|
33
39
|
}
|
|
40
|
+
/** One of the `HashOutputEncodings` values. */
|
|
34
41
|
export type THashOutputEncoding = TConstValue<typeof HashOutputEncodings>;
|
|
42
|
+
/** Encoding used when `outputEncoding` is omitted. */
|
|
35
43
|
export declare const DEFAULT_HASH_OUTPUT_ENCODING: THashOutputEncoding;
|
|
44
|
+
/** Password-hash schemes `CredentialHelper` accepts. `isValid` narrows a string to `TCredentialAlgorithm`. */
|
|
36
45
|
export declare class CredentialAlgorithms {
|
|
37
|
-
/** What `Bun.password` writes
|
|
46
|
+
/** What `Bun.password` writes with its default parameters; the scheme `hash` uses unless told otherwise. */
|
|
38
47
|
static readonly ARGON2ID = "argon2id";
|
|
39
48
|
static readonly BCRYPT = "bcrypt";
|
|
40
49
|
static readonly SCHEME_SET: Set<string>;
|
|
41
50
|
static isValid(value: string): value is TCredentialAlgorithm;
|
|
42
51
|
}
|
|
52
|
+
/** One of the `CredentialAlgorithms` values. */
|
|
43
53
|
export type TCredentialAlgorithm = TConstValue<typeof CredentialAlgorithms>;
|
|
54
|
+
/** Scheme `CredentialHelper.hash` uses when `algorithm` is omitted. */
|
|
44
55
|
export declare const DEFAULT_CREDENTIAL_ALGORITHM: TCredentialAlgorithm;
|
|
45
56
|
//# sourceMappingURL=constants.d.ts.map
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/** Key size in bits assumed when an algorithm name carries no size suffix (see `getAlgorithmKeySize`). */
|
|
1
2
|
export const DEFAULT_CIPHER_BITS = 256;
|
|
2
3
|
/**
|
|
3
4
|
* Public and identical across every deployment, so it stops a bare dictionary attack but not a
|
|
@@ -5,12 +6,15 @@ export const DEFAULT_CIPHER_BITS = 256;
|
|
|
5
6
|
* change this: every ciphertext already encrypted under it becomes undecryptable.
|
|
6
7
|
*/
|
|
7
8
|
export const DEFAULT_KDF_SALT = 'ignis-kdf-salt-v1';
|
|
9
|
+
/** PBKDF2 iteration count used when `kdfIterations` is omitted. Changing it makes ciphertext encrypted under the old count undecryptable. */
|
|
8
10
|
export const DEFAULT_KDF_ITERATIONS = 100_000;
|
|
11
|
+
/** PBKDF2 digest for key derivation; it is not configurable per call. */
|
|
9
12
|
export const DEFAULT_KDF_DIGEST = 'sha256';
|
|
10
13
|
/** NIST SP 800-132 minimum recommended salt size (128 bits) for a caller-supplied `kdfSalt`. */
|
|
11
14
|
export const MINIMUM_KDF_SALT_BYTES = 16;
|
|
12
15
|
/** NIST SP 800-57 Part 1 floor for RSA past 2030. */
|
|
13
16
|
export const MINIMUM_RSA_MODULUS_BITS = 2048;
|
|
17
|
+
/** Digest names the hash algorithm accepts. `isValid` narrows a string to `THashAlgorithm`. */
|
|
14
18
|
export class HashAlgorithms {
|
|
15
19
|
/** Cryptographically broken - kept only for wire-protocol compatibility (VNPay checksums); never use for security decisions. */
|
|
16
20
|
static { this.MD5 = 'md5'; }
|
|
@@ -30,6 +34,7 @@ export class HashAlgorithms {
|
|
|
30
34
|
return this.SCHEME_SET.has(value);
|
|
31
35
|
}
|
|
32
36
|
}
|
|
37
|
+
/** Text encodings a digest can be written in. `isValid` narrows a string to `THashOutputEncoding`. */
|
|
33
38
|
export class HashOutputEncodings {
|
|
34
39
|
static { this.HEX = 'hex'; }
|
|
35
40
|
static { this.BASE64 = 'base64'; }
|
|
@@ -39,9 +44,11 @@ export class HashOutputEncodings {
|
|
|
39
44
|
return this.SCHEME_SET.has(value);
|
|
40
45
|
}
|
|
41
46
|
}
|
|
47
|
+
/** Encoding used when `outputEncoding` is omitted. */
|
|
42
48
|
export const DEFAULT_HASH_OUTPUT_ENCODING = HashOutputEncodings.HEX;
|
|
49
|
+
/** Password-hash schemes `CredentialHelper` accepts. `isValid` narrows a string to `TCredentialAlgorithm`. */
|
|
43
50
|
export class CredentialAlgorithms {
|
|
44
|
-
/** What `Bun.password` writes
|
|
51
|
+
/** What `Bun.password` writes with its default parameters; the scheme `hash` uses unless told otherwise. */
|
|
45
52
|
static { this.ARGON2ID = 'argon2id'; }
|
|
46
53
|
static { this.BCRYPT = 'bcrypt'; }
|
|
47
54
|
static { this.SCHEME_SET = new Set([this.ARGON2ID, this.BCRYPT]); }
|
|
@@ -49,5 +56,6 @@ export class CredentialAlgorithms {
|
|
|
49
56
|
return this.SCHEME_SET.has(value);
|
|
50
57
|
}
|
|
51
58
|
}
|
|
59
|
+
/** Scheme `CredentialHelper.hash` uses when `algorithm` is omitted. */
|
|
52
60
|
export const DEFAULT_CREDENTIAL_ALGORITHM = CredentialAlgorithms.ARGON2ID;
|
|
53
61
|
//# sourceMappingURL=constants.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/common/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,gGAAgG;AAChG,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,qDAAqD;AACrD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,MAAM,OAAO,cAAc;IACzB,gIAAgI;aAChH,QAAG,GAAG,KAAK,CAAC;IAE5B,gIAAgI;aAChH,SAAI,GAAG,MAAM,CAAC;aAEd,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAElB,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,GAAG;QACR,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;KACZ,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/common/constants.ts"],"names":[],"mappings":"AAEA,0GAA0G;AAC1G,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACpD,6IAA6I;AAC7I,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,gGAAgG;AAChG,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,qDAAqD;AACrD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,+FAA+F;AAC/F,MAAM,OAAO,cAAc;IACzB,gIAAgI;aAChH,QAAG,GAAG,KAAK,CAAC;IAE5B,gIAAgI;aAChH,SAAI,GAAG,MAAM,CAAC;aAEd,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAElB,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,GAAG;QACR,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;KACZ,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAMH,sGAAsG;AACtG,MAAM,OAAO,mBAAmB;aACd,QAAG,GAAG,KAAK,CAAC;aACZ,WAAM,GAAG,QAAQ,CAAC;aAClB,cAAS,GAAG,WAAW,CAAC;aAExB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAMH,sDAAsD;AACtD,MAAM,CAAC,MAAM,4BAA4B,GAAwB,mBAAmB,CAAC,GAAG,CAAC;AAEzF,8GAA8G;AAC9G,MAAM,OAAO,oBAAoB;IAC/B,4GAA4G;aAC5F,aAAQ,GAAG,UAAU,CAAC;aACtB,WAAM,GAAG,QAAQ,CAAC;aAElB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAE3E,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAMH,uEAAuE;AACvE,MAAM,CAAC,MAAM,4BAA4B,GAAyB,oBAAoB,CAAC,QAAQ,CAAC","sourcesContent":["import type { TConstValue } from '@/common';\n\n/** Key size in bits assumed when an algorithm name carries no size suffix (see `getAlgorithmKeySize`). */\nexport const DEFAULT_CIPHER_BITS = 256;\n\n/**\n * Public and identical across every deployment, so it stops a bare dictionary attack but not a\n * table precomputed against this value - pass `kdfSalt` for per-deployment isolation. Never\n * change this: every ciphertext already encrypted under it becomes undecryptable.\n */\nexport const DEFAULT_KDF_SALT = 'ignis-kdf-salt-v1';\n/** PBKDF2 iteration count used when `kdfIterations` is omitted. Changing it makes ciphertext encrypted under the old count undecryptable. */\nexport const DEFAULT_KDF_ITERATIONS = 100_000;\n/** PBKDF2 digest for key derivation; it is not configurable per call. */\nexport const DEFAULT_KDF_DIGEST = 'sha256';\n\n/** NIST SP 800-132 minimum recommended salt size (128 bits) for a caller-supplied `kdfSalt`. */\nexport const MINIMUM_KDF_SALT_BYTES = 16;\n\n/** NIST SP 800-57 Part 1 floor for RSA past 2030. */\nexport const MINIMUM_RSA_MODULUS_BITS = 2048;\n\n/** Digest names the hash algorithm accepts. `isValid` narrows a string to `THashAlgorithm`. */\nexport class HashAlgorithms {\n /** Cryptographically broken - kept only for wire-protocol compatibility (VNPay checksums); never use for security decisions. */\n static readonly MD5 = 'md5';\n\n /** Cryptographically weak - kept for wire-protocol compatibility with legacy integrations; never use for security decisions. */\n static readonly SHA1 = 'sha1';\n\n static readonly SHA256 = 'sha256';\n static readonly SHA384 = 'sha384';\n static readonly SHA512 = 'sha512';\n\n static readonly SCHEME_SET = new Set<string>([\n this.MD5,\n this.SHA1,\n this.SHA256,\n this.SHA384,\n this.SHA512,\n ]);\n\n static isValid(value: string): value is THashAlgorithm {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** One of the `HashAlgorithms` values. */\nexport type THashAlgorithm = TConstValue<typeof HashAlgorithms>;\n\n/** Text encodings a digest can be written in. `isValid` narrows a string to `THashOutputEncoding`. */\nexport class HashOutputEncodings {\n static readonly HEX = 'hex';\n static readonly BASE64 = 'base64';\n static readonly BASE64URL = 'base64url';\n\n static readonly SCHEME_SET = new Set<string>([this.HEX, this.BASE64, this.BASE64URL]);\n\n static isValid(value: string): value is THashOutputEncoding {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** One of the `HashOutputEncodings` values. */\nexport type THashOutputEncoding = TConstValue<typeof HashOutputEncodings>;\n\n/** Encoding used when `outputEncoding` is omitted. */\nexport const DEFAULT_HASH_OUTPUT_ENCODING: THashOutputEncoding = HashOutputEncodings.HEX;\n\n/** Password-hash schemes `CredentialHelper` accepts. `isValid` narrows a string to `TCredentialAlgorithm`. */\nexport class CredentialAlgorithms {\n /** What `Bun.password` writes with its default parameters; the scheme `hash` uses unless told otherwise. */\n static readonly ARGON2ID = 'argon2id';\n static readonly BCRYPT = 'bcrypt';\n\n static readonly SCHEME_SET = new Set<string>([this.ARGON2ID, this.BCRYPT]);\n\n static isValid(value: string): value is TCredentialAlgorithm {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** One of the `CredentialAlgorithms` values. */\nexport type TCredentialAlgorithm = TConstValue<typeof CredentialAlgorithms>;\n\n/** Scheme `CredentialHelper.hash` uses when `algorithm` is omitted. */\nexport const DEFAULT_CREDENTIAL_ALGORITHM: TCredentialAlgorithm = CredentialAlgorithms.ARGON2ID;\n"]}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/** Contract of an encryption algorithm: `encrypt` and `decrypt` take one options object holding `message`, `secret` and optional algorithm-specific `opts`. The type parameters set the input, secret and return types of each side. */
|
|
1
2
|
export interface ICryptoAlgorithm<AlgorithmNameType extends string, EncryptInputType = unknown, DecryptInputType = unknown, SecretKeyType = unknown, EncryptReturnType = unknown, DecryptReturnType = unknown, ExtraOptions = unknown> {
|
|
2
3
|
algorithm: AlgorithmNameType;
|
|
3
4
|
encrypt(opts: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/common/types.ts"],"names":[],"mappings":"","sourcesContent":["
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/common/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Contract of an encryption algorithm: `encrypt` and `decrypt` take one options object holding `message`, `secret` and optional algorithm-specific `opts`. The type parameters set the input, secret and return types of each side. */\nexport interface ICryptoAlgorithm<\n AlgorithmNameType extends string,\n EncryptInputType = unknown,\n DecryptInputType = unknown,\n SecretKeyType = unknown,\n EncryptReturnType = unknown,\n DecryptReturnType = unknown,\n ExtraOptions = unknown,\n> {\n algorithm: AlgorithmNameType;\n\n encrypt(opts: {\n message: EncryptInputType;\n secret: SecretKeyType;\n opts?: ExtraOptions;\n }): EncryptReturnType;\n decrypt(opts: {\n message: DecryptInputType;\n secret: SecretKeyType;\n opts?: ExtraOptions;\n }): DecryptReturnType;\n}\n"]}
|
|
@@ -10,6 +10,7 @@ export declare class Environment extends EnvironmentNames {
|
|
|
10
10
|
name: string;
|
|
11
11
|
}): boolean;
|
|
12
12
|
}
|
|
13
|
+
/** Key-value store of the environment entries whose key starts with `prefix`; other keys are dropped at construction. `get` applies a default and an optional transform. Use the shared `applicationEnvironment` instance rather than constructing one. */
|
|
13
14
|
export declare class ApplicationEnvironment extends BaseHelper implements IApplicationEnvironment {
|
|
14
15
|
private prefix;
|
|
15
16
|
private arguments;
|
|
@@ -39,6 +40,8 @@ export declare class ApplicationEnvironment extends BaseHelper implements IAppli
|
|
|
39
40
|
isDevelopment(): boolean;
|
|
40
41
|
keys(): string[];
|
|
41
42
|
}
|
|
43
|
+
/** The process-wide environment store, built from `process.env` with the prefix in `APPLICATION_ENV_PREFIX` (`APP_ENV` when unset). One instance is shared by every copy of this module in the process. */
|
|
42
44
|
export declare const applicationEnvironment: ApplicationEnvironment;
|
|
45
|
+
/** Alias of `applicationEnvironment`. */
|
|
43
46
|
export declare const AppEnvs: ApplicationEnvironment;
|
|
44
47
|
//# sourceMappingURL=app-env.d.ts.map
|
|
@@ -15,6 +15,7 @@ export class Environment extends EnvironmentNames {
|
|
|
15
15
|
return this.current === opts.name;
|
|
16
16
|
}
|
|
17
17
|
}
|
|
18
|
+
/** Key-value store of the environment entries whose key starts with `prefix`; other keys are dropped at construction. `get` applies a default and an optional transform. Use the shared `applicationEnvironment` instance rather than constructing one. */
|
|
18
19
|
export class ApplicationEnvironment extends BaseHelper {
|
|
19
20
|
constructor(opts) {
|
|
20
21
|
super({ scope: ApplicationEnvironment.name });
|
|
@@ -78,6 +79,8 @@ const resolveApplicationEnvironment = () => {
|
|
|
78
79
|
Reflect.set(globalThis, INSTANCE_SLOT, created);
|
|
79
80
|
return created;
|
|
80
81
|
};
|
|
82
|
+
/** The process-wide environment store, built from `process.env` with the prefix in `APPLICATION_ENV_PREFIX` (`APP_ENV` when unset). One instance is shared by every copy of this module in the process. */
|
|
81
83
|
export const applicationEnvironment = resolveApplicationEnvironment();
|
|
84
|
+
/** Alias of `applicationEnvironment`. */
|
|
82
85
|
export const AppEnvs = applicationEnvironment;
|
|
83
86
|
//# sourceMappingURL=app-env.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"app-env.js","sourceRoot":"","sources":["../../../../src/modules/env/app-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,sPAAsP;AACtP,MAAM,OAAO,WAAY,SAAQ,gBAAgB;IAC/C,gNAAgN;IAChN,MAAM,KAAK,OAAO;QAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;
|
|
1
|
+
{"version":3,"file":"app-env.js","sourceRoot":"","sources":["../../../../src/modules/env/app-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,sPAAsP;AACtP,MAAM,OAAO,WAAY,SAAQ,gBAAgB;IAC/C,gNAAgN;IAChN,MAAM,KAAK,OAAO;QAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;QAEjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,OAAO;QAChB,OAAO,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,IAAsB;QAC9B,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC;IACpC,CAAC;CACF;AAED,2PAA2P;AAC3P,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAIpD,YAAY,IAA2E;QACrF,KAAK,CAAC,EAAE,KAAK,EAAE,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;QAHxC,cAAS,GAAwB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAK3D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE1B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CACD,GAAW,EACX,IAGC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAEhC,MAAM,OAAO,GAAG,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9F,MAAM,EAAE,GAAG,IAAI,EAAE,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QAEzE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,YAAY,CAAe,CAAC;QAClD,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAEvC,OAAO,CAAC,WAAW,IAAI,IAAI,EAAE,YAAY,CAAe,CAAC;IAC3D,CAAC;IAED,GAAG,CAAY,GAAW,EAAE,KAAgB;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAsC;QAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,WAAW,CAAC,OAAO,KAAK,aAAa,CAAC;IAC/C,CAAC;IAED,IAAI;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;CACF;AAED,iNAAiN;AACjN,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAElE,MAAM,6BAA6B,GAAG,GAA2B,EAAE;IACjE,MAAM,MAAM,GAAuC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAE1F,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC;QACzC,MAAM,EACJ,YAAY,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,IAAI,SAAS;QAC3F,IAAI,EAAE,OAAO,CAAC,GAAG;KAClB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IAEhD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,2MAA2M;AAC3M,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,EAAE,CAAC;AAEtE,yCAAyC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,sBAAsB,CAAC","sourcesContent":["import { ParseUtility } from '@/utilities/parse.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { EnvironmentNames } from './names';\nimport { type IApplicationEnvironment } from './common';\n\n/** Adds the `NODE_ENV` reads to {@link EnvironmentNames}. Every name and set is inherited, so `Environment.PRODUCTION`, `Environment.COMMON_ENVS` and `Environment.DEVELOPMENT_ENVS` keep resolving here; only these two members need a `process`. */\nexport class Environment extends EnvironmentNames {\n /** `NODE_ENV` exactly as the host has it, `undefined` when unset. Destructured on purpose: `bun build` rewrites `process.env.NODE_ENV` to a literal at build time, a destructured read stays a runtime read. */\n static get ambient(): string | undefined {\n const { NODE_ENV } = process.env;\n\n return NODE_ENV;\n }\n\n static get current(): string {\n return Environment.ambient ?? Environment.DEVELOPMENT;\n }\n\n static is(opts: { name: string }) {\n return this.current === opts.name;\n }\n}\n\n/** Key-value store of the environment entries whose key starts with `prefix`; other keys are dropped at construction. `get` applies a default and an optional transform. Use the shared `applicationEnvironment` instance rather than constructing one. */\nexport class ApplicationEnvironment extends BaseHelper implements IApplicationEnvironment {\n private prefix: string;\n private arguments: Record<string, any> = Object.create(null);\n\n constructor(opts: { prefix: string; envs: Record<string, string | number | undefined> }) {\n super({ scope: ApplicationEnvironment.name });\n\n this.prefix = opts.prefix;\n\n for (const key in opts.envs) {\n if (!key.startsWith(this.prefix)) {\n continue;\n }\n\n this.arguments[key] = opts.envs[key];\n }\n }\n\n /**\n * Reads one name. A line that is present but empty - `KEY=`, or padded to `KEY= ` by a hand\n * edit - is a pipeline that forgot to export the value, not a value: it is normalised to\n * `undefined` so `defaultValue` applies, and `transform` is handed that `undefined` rather than\n * the empty string.\n *\n * The normalisation runs ONLY when the caller supplied a `defaultValue`, because that call site\n * has already declared what it wants when the name carries nothing. A caller without one still\n * receives `''` unchanged, so no existing read changes shape. `'0'` and `'false'` are values and\n * are never normalised.\n */\n get<ReturnType, BeforeTransformType = unknown>(\n key: string,\n opts?: {\n defaultValue?: ReturnType;\n transform?: (value: BeforeTransformType) => ReturnType;\n },\n ): ReturnType {\n const raw = this.arguments[key];\n\n const isBlank = raw === undefined || raw === null || (typeof raw === 'string' && !raw.trim());\n const rs = opts?.defaultValue !== undefined && isBlank ? undefined : raw;\n\n if (!opts?.transform) {\n return (rs ?? opts?.defaultValue) as ReturnType;\n }\n\n const transformed = opts.transform(rs);\n\n return (transformed ?? opts?.defaultValue) as ReturnType;\n }\n\n set<ValueType>(key: string, value: ValueType) {\n this.arguments[key] = value;\n }\n\n merge(opts: { envs: Record<string, string> }) {\n const envsEntries = Object.entries(opts.envs);\n\n for (const [key, value] of envsEntries) {\n this.arguments[key] = value;\n }\n }\n\n isDevelopment() {\n return Environment.ambient === 'development';\n }\n\n keys() {\n return Object.keys(this.arguments);\n }\n}\n\n/** A process can carry two copies of this module - an application's ESM import beside a CommonJS require. The instance lives in this globalThis slot so a `set()` through one copy is read through the other. */\nconst INSTANCE_SLOT = Symbol.for('ignis:application-environment');\n\nconst resolveApplicationEnvironment = (): ApplicationEnvironment => {\n const shared: ApplicationEnvironment | undefined = Reflect.get(globalThis, INSTANCE_SLOT);\n\n if (shared) {\n return shared;\n }\n\n const created = new ApplicationEnvironment({\n prefix:\n ParseUtility.blankToUndefined({ input: process.env.APPLICATION_ENV_PREFIX }) ?? 'APP_ENV',\n envs: process.env,\n });\n Reflect.set(globalThis, INSTANCE_SLOT, created);\n\n return created;\n};\n\n/** The process-wide environment store, built from `process.env` with the prefix in `APPLICATION_ENV_PREFIX` (`APP_ENV` when unset). One instance is shared by every copy of this module in the process. */\nexport const applicationEnvironment = resolveApplicationEnvironment();\n\n/** Alias of `applicationEnvironment`. */\nexport const AppEnvs = applicationEnvironment;\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/env/common/types.ts"],"names":[],"mappings":"","sourcesContent":["
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/env/common/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Read and write contract of the application environment store; `get` returns `defaultValue` when the key is absent. */\nexport interface IApplicationEnvironment {\n get<ReturnType, BeforeTransformType = unknown>(\n key: string,\n opts?: {\n defaultValue?: ReturnType;\n transform?: (value: BeforeTransformType) => ReturnType;\n },\n ): ReturnType;\n set<ValueType>(key: string, value: ValueType): any;\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,SAAS,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,0LAA0L;AAC1L,MAAM,OAAgB,UAAW,SAAQ,cAAc;IAIrD,YAAY,IAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IAMD,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;
|
|
1
|
+
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,SAAS,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,0LAA0L;AAC1L,MAAM,OAAgB,UAAW,SAAQ,cAAc;IAIrD,YAAY,IAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IAMD,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,GAAG,IAAe;QACvD,IAAI,KAAK,KAAK,SAAS,CAAC,KAAK,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,qHAAqH;QACrH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACjG,CAAC;CACF","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { type ILogger, LogLevels, LoggerDebugGate, type TLogLevel } from '../common';\nimport { AbstractLogger } from './abstract';\n\n/** Provider-independent plumbing: scope, prefix, DEBUG gate, for(). Every level method funnels into ONE abstract write() sink; child() lets each provider keep its own caching policy. */\nexport abstract class BaseLogger extends AbstractLogger {\n protected readonly _scope: string;\n protected readonly _formattedPrefix: string;\n\n constructor(opts: { scope: string }) {\n super();\n this._scope = opts.scope;\n this._formattedPrefix = opts.scope !== '' ? `[${opts.scope}] ` : '';\n }\n\n protected abstract write(opts: { level: TLogLevel; message: string; args: Array<AnyType> }): void;\n\n protected abstract child(opts: { scope: string }): ILogger;\n\n debug(message: string, ...args: AnyType[]) {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.write({ level: LogLevels.DEBUG, message, args });\n }\n\n info(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.INFO, message, args });\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.WARN, message, args });\n }\n\n error(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.ERROR, message, args });\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.EMERG, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.write({ level, message, args });\n }\n\n for(methodName: string): ILogger {\n // An empty parent scope must not produce a leading dash - the child simply takes the method name as its whole scope.\n return this.child({ scope: this._scope !== '' ? `${this._scope}-${methodName}` : methodName });\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/console.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAgB,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAG/C,YAAqC,KAAa;QAChD,KAAK,EAAE,CAAC;QAD2B,UAAK,GAAL,KAAK,CAAQ;QAEhD,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAEO,IAAI,CAAC,IAIZ;QACC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,GAAG,IAAe;QACvD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/console.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { LoggerDebugGate } from '../common/debug-gate';\nimport { type ILogger, LogLevels, type TLogLevel } from '../common/types';\nimport { AbstractLogger } from './abstract';\n\n/**\n * The default logger provider: it writes to the console, and it is the only provider a browser bundle reaches. It\n * satisfies `ILoggerProvider` (`ConsoleLogger.get(scope)`), so it is registered like Winston and Pino.\n *\n * Extends AbstractLogger rather than BaseLogger because BaseLogger's module graph reads `process.env` at load.\n * `debug` follows the rule of the other providers (`LoggerDebugGate`): off unless `DEBUG` is truthy and the\n * environment is allowed, and off in a browser, which has no `process`; `LoggerFactory.use({ level })` overrides it.\n */\nexport class ConsoleLogger extends AbstractLogger {\n private readonly prefix: string;\n\n private constructor(private readonly scope: string) {\n super();\n this.prefix = scope !== '' ? `[${scope}] ` : '';\n }\n\n static get(scope: string): ConsoleLogger {\n return new ConsoleLogger(scope);\n }\n\n private emit(opts: {\n sink: (message: string, ...args: AnyType[]) => void;\n message: string;\n args: AnyType[];\n }) {\n opts.sink(`${this.prefix}${opts.message}`, ...opts.args);\n }\n\n debug(message: string, ...args: AnyType[]) {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.emit({ sink: console.debug, message, args });\n }\n\n info(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.log, message, args });\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.warn, message, args });\n }\n\n error(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.error, message, args });\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.error, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n switch (level) {\n case LogLevels.DEBUG: {\n this.debug(message, ...args);\n\n return;\n }\n case LogLevels.WARN: {\n this.warn(message, ...args);\n\n return;\n }\n case LogLevels.ERROR:\n case LogLevels.EMERG: {\n this.error(message, ...args);\n\n return;\n }\n default: {\n this.info(message, ...args);\n }\n }\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n\n return ConsoleLogger.get(childScope);\n }\n}\n"]}
|
|
@@ -1,12 +1,15 @@
|
|
|
1
1
|
import { type TConstValue } from '../../../common/types/index.js';
|
|
2
2
|
import { type TLogLevel } from './types.js';
|
|
3
|
+
/** Output shapes of a log line. `isValid` narrows a string to `TLoggerFormat`. */
|
|
3
4
|
export declare class LoggerFormats {
|
|
4
5
|
static readonly JSON = "json";
|
|
5
6
|
static readonly TEXT = "text";
|
|
6
7
|
static readonly SCHEME_SET: Set<string>;
|
|
7
8
|
static isValid(input: string): input is TLoggerFormat;
|
|
8
9
|
}
|
|
10
|
+
/** One of the `LoggerFormats` values. */
|
|
9
11
|
export type TLoggerFormat = TConstValue<typeof LoggerFormats>;
|
|
12
|
+
/** Resolves logger settings (level, color) from configured values and the environment. */
|
|
10
13
|
export declare class LoggerConfigUtility {
|
|
11
14
|
/** The logger's own level, below which a line never reaches ANY transport. Defaults to `debug` - level gating belongs to the wrapper and each transport, and a stricter default here would silently drop lines the wrapper already let through. */
|
|
12
15
|
static resolveLevel(opts: {
|
|
@@ -2,6 +2,7 @@ import { Environment } from '../../env/index.js';
|
|
|
2
2
|
import { ParseUtility } from '../../../utilities/parse.utility.js';
|
|
3
3
|
import { LogLevels } from './types.js';
|
|
4
4
|
// -------------------------------------------------------------
|
|
5
|
+
/** Output shapes of a log line. `isValid` narrows a string to `TLoggerFormat`. */
|
|
5
6
|
export class LoggerFormats {
|
|
6
7
|
static { this.JSON = 'json'; }
|
|
7
8
|
static { this.TEXT = 'text'; }
|
|
@@ -11,6 +12,7 @@ export class LoggerFormats {
|
|
|
11
12
|
}
|
|
12
13
|
}
|
|
13
14
|
// -------------------------------------------------------------
|
|
15
|
+
/** Resolves logger settings (level, color) from configured values and the environment. */
|
|
14
16
|
export class LoggerConfigUtility {
|
|
15
17
|
/** The logger's own level, below which a line never reaches ANY transport. Defaults to `debug` - level gating belongs to the wrapper and each transport, and a stricter default here would silently drop lines the wrapper already let through. */
|
|
16
18
|
static resolveLevel(opts) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAC;AAEpD,gEAAgE;AAChE,MAAM,OAAO,aAAa;aACR,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7D,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAC;AAEpD,gEAAgE;AAChE,kFAAkF;AAClF,MAAM,OAAO,aAAa;aACR,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7D,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAMH,gEAAgE;AAChE,0FAA0F;AAC1F,MAAM,OAAO,mBAAmB;IAC9B,mPAAmP;IACnP,MAAM,CAAC,YAAY,CAAC,IAA6B;QAC/C,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEnD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,gJAAgJ;YAChJ,OAAO,CAAC,IAAI,CACV,mFAAmF,EACnF,UAAU,EACV,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,EACzB,SAAS,CAAC,KAAK,CAChB,CAAC;YAEF,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,OAAO,UAAuB,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,eAAe,CAAC,IAGtB;QACC,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAExE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACzD,OAAO,YAAY,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAErC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,WAAW,CAAC,OAAO,CAAC;QAE7D,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF","sourcesContent":["import { type TConstValue } from '@/common/types';\nimport { Environment } from '@/modules/env';\nimport { ParseUtility } from '@/utilities/parse.utility';\nimport { LogLevels, type TLogLevel } from './types';\n\n// -------------------------------------------------------------\n/** Output shapes of a log line. `isValid` narrows a string to `TLoggerFormat`. */\nexport class LoggerFormats {\n static readonly JSON = 'json';\n static readonly TEXT = 'text';\n\n static readonly SCHEME_SET = new Set([this.JSON, this.TEXT]);\n\n static isValid(input: string): input is TLoggerFormat {\n return this.SCHEME_SET.has(input);\n }\n}\n\n/** One of the `LoggerFormats` values. */\nexport type TLoggerFormat = TConstValue<typeof LoggerFormats>;\n\n// -------------------------------------------------------------\n/** Resolves logger settings (level, color) from configured values and the environment. */\nexport class LoggerConfigUtility {\n /** The logger's own level, below which a line never reaches ANY transport. Defaults to `debug` - level gating belongs to the wrapper and each transport, and a stricter default here would silently drop lines the wrapper already let through. */\n static resolveLevel(opts: { configured?: string }): TLogLevel {\n const { configured } = opts;\n\n if (!configured || configured.trim() === '') {\n return LogLevels.DEBUG;\n }\n\n const normalized = configured.trim().toLowerCase();\n\n if (!LogLevels.isValid(normalized)) {\n // console, not Logger: the logger is being built - routing this warning through it would re-enter the very pipeline that is not configured yet.\n console.warn(\n '[resolveLoggerLevel] Invalid logger level | value: %s | valids: %s | fallback: %s',\n configured,\n [...LogLevels.SCHEME_SET],\n LogLevels.DEBUG,\n );\n\n return LogLevels.DEBUG;\n }\n\n return normalized as TLogLevel;\n }\n\n /**\n * Whether log lines may carry ANSI color, resolved at CALL time. First match wins:\n *\n * 1. `APP_ENV_LOGGER_COLOR` - an explicit yes or no from the operator.\n * 2. `NO_COLOR`, set to anything non-empty - the no-color.org convention.\n * 3. `NODE_ENV` outside {@link Environment.DEVELOPMENT_ENVS} - production, staging, uat and any\n * unrecognized name. Fail-closed, the same boundary the error sanitizer draws: colors are a\n * terminal affordance, and in a deployed environment the same bytes land in a file or an\n * aggregator as escape noise every grep then has to strip.\n *\n * `undefined` means the framework has no opinion, so a provider that detects a terminal itself\n * keeps deciding - which is why the pino path forwards nothing in that case.\n */\n static resolveColorize(opts?: {\n configured?: string;\n environment?: string;\n }): boolean | undefined {\n const configured = opts?.configured ?? process.env.APP_ENV_LOGGER_COLOR;\n\n if (configured !== undefined && configured.trim() !== '') {\n return ParseUtility.toBoolean({ input: configured.trim().toLowerCase() });\n }\n\n const noColor = process.env.NO_COLOR;\n\n if (noColor !== undefined && noColor !== '') {\n return false;\n }\n\n const environment = opts?.environment ?? Environment.current;\n\n if (!Environment.DEVELOPMENT_ENVS.has(environment)) {\n return false;\n }\n\n return undefined;\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"debug-gate.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/debug-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAC1B,0HAA0H;aAClG,gBAAW,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAG9E,sEAAsE;IACtE,MAAM,CAAC,eAAe;QACpB,OAAO,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,QAAQ,CAAC,IAAmC;QACzD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"debug-gate.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/debug-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAC1B,0HAA0H;aAClG,gBAAW,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAG9E,sEAAsE;IACtE,MAAM,CAAC,eAAe;QACpB,OAAO,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,QAAQ,CAAC,IAAmC;QACzD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,GAAG,CAAC;IACnF,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,QAAQ,CAAC,IAA2B;QACzC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,GAAG,GAAG,CAAC;QACxD,MAAM,KAAK,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;QAEjF,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,2HAA2H;IAC3H,MAAM,CAAC,MAAM;QACX,MAAM,MAAM,GAAwB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAE9E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAEjE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,sHAAsH;IACtH,MAAM,CAAC,KAAK,CAAC,IAAqC;QAChD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YAErD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC","sourcesContent":["import { EnvironmentNames } from '@/modules/env/names';\n\ntype TEnvironment = Record<string, string | undefined>;\n\n/**\n * The rule that decides whether `debug` lines are written: off unless `DEBUG` is truthy and the environment is allowed\n * (`NODE_ENV` unset, or one of the common names, or one `APP_ENV_EXTRA_LOG_ENVS` adds). Every provider shares it, so a\n * console, a winston and a pino logger agree.\n *\n * Pure: it takes the environment as an argument and reads `process` only through a guarded `globalThis` read, because a\n * browser has none and there the default is off. `LoggerFactory.use({ level })` overrides it.\n */\nexport class LoggerDebugGate {\n /** The override lives on globalThis, so `use({ level })` in one copy of the module opens or closes debug in the other. */\n private static readonly FORCED_SLOT = Symbol.for('ignis:logger-debug-forced');\n private static resolved?: boolean;\n\n /** The environment the host has, `{}` where there is no `process`. */\n static readEnvironment(): TEnvironment {\n return globalThis.process?.env ?? {};\n }\n\n /**\n * The truthiness `ParseUtility.toBoolean` has, repeated here on purpose: `ParseUtility` imports the error module, and\n * this file is in the graph of `BaseHelper`, which must stay a few hundred bytes in a browser bundle.\n */\n private static isTruthy(opts: { input: string | undefined }): boolean {\n const { input } = opts;\n\n return input !== undefined && input !== '' && input !== 'false' && input !== '0';\n }\n\n /** The rule itself, for any environment: a pure function of `env`. */\n static evaluate(opts: { env: TEnvironment }): boolean {\n const { env } = opts;\n const { DEBUG, NODE_ENV, APP_ENV_EXTRA_LOG_ENVS } = env;\n const extra = (APP_ENV_EXTRA_LOG_ENVS ?? '').split(',').map((name) => name.trim());\n const allowed = new Set([...Array.from(EnvironmentNames.COMMON_ENVS), ...extra]);\n\n return this.isTruthy({ input: DEBUG }) && (!NODE_ENV || allowed.has(NODE_ENV));\n }\n\n /** Whether `debug` is written now: the override when `use` set one, else the rule on the host's environment, read once. */\n static isOpen(): boolean {\n const forced: boolean | undefined = Reflect.get(globalThis, this.FORCED_SLOT);\n\n if (forced !== undefined) {\n return forced;\n }\n\n this.resolved ??= this.evaluate({ env: this.readEnvironment() });\n\n return this.resolved;\n }\n\n /** `LoggerFactory.use({ level })` calls it: an explicit level turns debug on or off whatever the environment says. */\n static force(opts: { isOpen: boolean | undefined }): void {\n if (opts.isOpen === undefined) {\n Reflect.deleteProperty(globalThis, this.FORCED_SLOT);\n\n return;\n }\n\n Reflect.set(globalThis, this.FORCED_SLOT, opts.isOpen);\n }\n}\n"]}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { type AnyType, type TConstValue } from '../../../common/types/index.js';
|
|
2
|
+
/** Log severities. `ORDER` runs from most to least severe, and `isEnabled` tests a level against a threshold. */
|
|
2
3
|
export declare class LogLevels {
|
|
3
4
|
static readonly ERROR = "error";
|
|
4
5
|
static readonly EMERG = "emerg";
|
|
@@ -15,6 +16,7 @@ export declare class LogLevels {
|
|
|
15
16
|
threshold: string;
|
|
16
17
|
}): boolean;
|
|
17
18
|
}
|
|
19
|
+
/** One of the `LogLevels` values. */
|
|
18
20
|
export type TLogLevel = TConstValue<typeof LogLevels>;
|
|
19
21
|
/** The logging contract every consumer types against; which provider produced the logger is invisible behind it - only `factory.ts` and a provider's back-compat aliases may name a concrete logger class. */
|
|
20
22
|
export interface ILogger {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/types.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,SAAS;aACJ,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aACd,UAAK,GAAG,OAAO,CAAC;aAEhB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjG,2GAA2G;aAC3F,UAAK,GAA0B;QAC7C,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,KAAK;KACX,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,yHAAyH;IACzH,MAAM,CAAC,SAAS,CAAC,IAA0C;QACzD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEpD,gFAAgF;QAChF,OAAO,SAAS,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,SAAS,IAAI,aAAa,CAAC;IAC1E,CAAC","sourcesContent":["import { type AnyType, type TConstValue } from '@/common/types';\n\nexport class LogLevels {\n static readonly ERROR = 'error';\n static readonly EMERG = 'emerg';\n static readonly WARN = 'warn';\n static readonly INFO = 'info';\n static readonly DEBUG = 'debug';\n\n static readonly SCHEME_SET = new Set([this.ERROR, this.EMERG, this.WARN, this.INFO, this.DEBUG]);\n\n /** From the most to the least severe: a threshold lets through its own level and every level before it. */\n static readonly ORDER: ReadonlyArray<string> = [\n this.EMERG,\n this.ERROR,\n this.WARN,\n this.INFO,\n this.DEBUG,\n ];\n\n static isValid(input: string): boolean {\n return this.SCHEME_SET.has(input);\n }\n\n /** Whether a line of `level` passes a `threshold`: `debug` lets everything through, `error` only `error` and `emerg`. */\n static isEnabled(opts: { level: string; threshold: string }): boolean {\n const { level, threshold } = opts;\n const levelRank = this.ORDER.indexOf(level);\n const thresholdRank = this.ORDER.indexOf(threshold);\n\n // An unknown level or threshold is never silenced: a typo must not hide a line.\n return levelRank < 0 || thresholdRank < 0 || levelRank <= thresholdRank;\n }\n}\n\nexport type TLogLevel = TConstValue<typeof LogLevels>;\n\n/** The logging contract every consumer types against; which provider produced the logger is invisible behind it - only `factory.ts` and a provider's back-compat aliases may name a concrete logger class. */\nexport interface ILogger {\n debug(message: string, ...args: AnyType[]): void;\n info(message: string, ...args: AnyType[]): void;\n warn(message: string, ...args: AnyType[]): void;\n error(message: string, ...args: AnyType[]): void;\n emerg(message: string, ...args: AnyType[]): void;\n log(level: TLogLevel, message: string, ...args: AnyType[]): void;\n for(methodName: string): ILogger;\n}\n\n/** Static-side contract a provider class satisfies - WinstonLogger and PinoLogger both do. */\nexport interface ILoggerProvider {\n get(scope: string): ILogger;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/types.ts"],"names":[],"mappings":"AAEA,iHAAiH;AACjH,MAAM,OAAO,SAAS;aACJ,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aACd,UAAK,GAAG,OAAO,CAAC;aAEhB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjG,2GAA2G;aAC3F,UAAK,GAA0B;QAC7C,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,KAAK;KACX,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,yHAAyH;IACzH,MAAM,CAAC,SAAS,CAAC,IAA0C;QACzD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEpD,gFAAgF;QAChF,OAAO,SAAS,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,SAAS,IAAI,aAAa,CAAC;IAC1E,CAAC","sourcesContent":["import { type AnyType, type TConstValue } from '@/common/types';\n\n/** Log severities. `ORDER` runs from most to least severe, and `isEnabled` tests a level against a threshold. */\nexport class LogLevels {\n static readonly ERROR = 'error';\n static readonly EMERG = 'emerg';\n static readonly WARN = 'warn';\n static readonly INFO = 'info';\n static readonly DEBUG = 'debug';\n\n static readonly SCHEME_SET = new Set([this.ERROR, this.EMERG, this.WARN, this.INFO, this.DEBUG]);\n\n /** From the most to the least severe: a threshold lets through its own level and every level before it. */\n static readonly ORDER: ReadonlyArray<string> = [\n this.EMERG,\n this.ERROR,\n this.WARN,\n this.INFO,\n this.DEBUG,\n ];\n\n static isValid(input: string): boolean {\n return this.SCHEME_SET.has(input);\n }\n\n /** Whether a line of `level` passes a `threshold`: `debug` lets everything through, `error` only `error` and `emerg`. */\n static isEnabled(opts: { level: string; threshold: string }): boolean {\n const { level, threshold } = opts;\n const levelRank = this.ORDER.indexOf(level);\n const thresholdRank = this.ORDER.indexOf(threshold);\n\n // An unknown level or threshold is never silenced: a typo must not hide a line.\n return levelRank < 0 || thresholdRank < 0 || levelRank <= thresholdRank;\n }\n}\n\n/** One of the `LogLevels` values. */\nexport type TLogLevel = TConstValue<typeof LogLevels>;\n\n/** The logging contract every consumer types against; which provider produced the logger is invisible behind it - only `factory.ts` and a provider's back-compat aliases may name a concrete logger class. */\nexport interface ILogger {\n debug(message: string, ...args: AnyType[]): void;\n info(message: string, ...args: AnyType[]): void;\n warn(message: string, ...args: AnyType[]): void;\n error(message: string, ...args: AnyType[]): void;\n emerg(message: string, ...args: AnyType[]): void;\n log(level: TLogLevel, message: string, ...args: AnyType[]): void;\n for(methodName: string): ILogger;\n}\n\n/** Static-side contract a provider class satisfies - WinstonLogger and PinoLogger both do. */\nexport interface ILoggerProvider {\n get(scope: string): ILogger;\n}\n"]}
|
|
@@ -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 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 // 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 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 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 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 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 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 { 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,4 +1,5 @@
|
|
|
1
1
|
import util from 'node:util';
|
|
2
|
+
/** Renders a log message and its arguments to one string, redacting secret keys and inspecting objects to a bounded depth (`APP_ENV_LOGGER_INSPECT_DEPTH`, default 5). */
|
|
2
3
|
export declare class LogFormatUtility {
|
|
3
4
|
private static resolveDepth;
|
|
4
5
|
private static buildInspectOptions;
|
|
@@ -5,6 +5,7 @@ import { ErrorPrettier } from './error-prettier.js';
|
|
|
5
5
|
const PLACEHOLDER_PATTERN = /%[sjdifoOc%]/g;
|
|
6
6
|
/** How deep an object is inspected before it collapses to `[Object]`: Node's default of 2 hides nested data (e.g. wrapped `cause`), 5 reaches it while staying bounded. `APP_ENV_LOGGER_INSPECT_DEPTH` overrides with a NON-NEGATIVE number - no unlimited setting. */
|
|
7
7
|
const DEFAULT_INSPECT_DEPTH = 5;
|
|
8
|
+
/** Renders a log message and its arguments to one string, redacting secret keys and inspecting objects to a bounded depth (`APP_ENV_LOGGER_INSPECT_DEPTH`, default 5). */
|
|
8
9
|
export class LogFormatUtility {
|
|
9
10
|
static resolveDepth() {
|
|
10
11
|
const configured = process.env.APP_ENV_LOGGER_INSPECT_DEPTH;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"deep-splat.js","sourceRoot":"","sources":["../../../../../src/modules/logger/formatting/deep-splat.ts"],"names":[],"mappings":"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","sourcesContent":["import { RedactUtility } from '@/common/redact';\nimport util from 'node:util';\nimport { ErrorPrettier } from './error-prettier';\n\n/** The placeholders `util.format` understands. `%%` is an escape, not a placeholder. */\nconst PLACEHOLDER_PATTERN = /%[sjdifoOc%]/g;\n\n/** How deep an object is inspected before it collapses to `[Object]`: Node's default of 2 hides nested data (e.g. wrapped `cause`), 5 reaches it while staying bounded. `APP_ENV_LOGGER_INSPECT_DEPTH` overrides with a NON-NEGATIVE number - no unlimited setting. */\nconst DEFAULT_INSPECT_DEPTH = 5;\n\nexport class LogFormatUtility {\n private static resolveDepth(): number {\n const configured = process.env.APP_ENV_LOGGER_INSPECT_DEPTH;\n\n // Not `ParseUtility.toInt()`: it answers 0 for an ABSENT value, which would silently mean \"depth 0\" - the one setting that hides everything.\n if (configured === undefined || configured.trim() === '') {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n const parsed = Number.parseInt(configured, 10);\n\n // A negative or unparseable value is a misconfiguration, not a request: fall back rather than hand `util.inspect` a depth it reads as \"unlimited\".\n if (Number.isNaN(parsed) || parsed < 0) {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n return parsed;\n }\n\n private static buildInspectOptions(): util.InspectOptions {\n return {\n depth: LogFormatUtility.resolveDepth(),\n maxArrayLength: null,\n maxStringLength: null,\n breakLength: Infinity,\n };\n }\n\n /** Formats like `util.format`, but `%s` inspects to configured depth instead of Node's hard-coded `depth: 0` (no inspect option overrides that), and `%j` is projected into a JSON-safe shape first. Per-placeholder only - handing `%j` the widened STRING would emit a JSON-quoted inspect dump instead of an object. */\n static formatMessage(opts: {\n message: string;\n args: Array<unknown>;\n inspectOptions?: util.InspectOptions;\n }): string {\n const { message, args, inspectOptions = LogFormatUtility.buildInspectOptions() } = opts;\n\n const placeholders = (message.match(PLACEHOLDER_PATTERN) ?? []).filter(\n (token) => token !== '%%',\n );\n\n const widened = args.map((arg, index) => {\n const placeholder = placeholders[index];\n const isInspectable = typeof arg === 'object' && arg !== null;\n\n if (!isInspectable) {\n return arg;\n }\n\n // `%j` runs JSON.stringify, which answers `[Circular]` for the WHOLE argument when one cycle sits anywhere inside it - a transaction handle in the payload wipes out every other field. It also has no notion of secret keys, and no depth limit of its own. Project the value first, under the same depth cap `%s` gets.\n if (placeholder === '%j') {\n return RedactUtility.toJsonSafe({\n value: arg,\n depth: inspectOptions.depth ?? LogFormatUtility.resolveDepth(),\n });\n }\n\n // `%o`, `%O` and arguments with NO placeholder (`util.format` appends those) are redacted but\n // left as objects, so `util.formatWithOptions` still renders them the way that placeholder\n // means. Pre-inspecting them into a string here would make `%o` print a quoted, escaped string\n // instead of an object. Only the redaction is added; the rendering is unchanged.\n //\n // Before this, `logger.info('login failed', { password })` printed the password verbatim: the\n // redactor only ever saw `%s`, while the reference docs recommend `%o` for data objects.\n //\n // Bounded like the `%s` path below, and for the same reason: an unbounded walk on a very deep\n // graph is work whose result the renderer discards, and deep enough it is a `RangeError` on a\n // call that could not throw before. `%o` renders at `depth`, so `+2` covers what is shown.\n if (placeholder === undefined || placeholder === '%o' || placeholder === '%O') {\n return RedactUtility.redactSecrets({\n value: arg,\n depth: (inspectOptions.depth ?? LogFormatUtility.resolveDepth()) + 2,\n });\n }\n\n if (placeholder !== '%s') {\n return arg;\n }\n\n // Inspecting an Error dumps every own property - a `jose` failure carries the whole JWT payload, a driver failure the whole query. Project it instead, onto its own line so it never trails off the end of the caller's sentence.\n if (arg instanceof Error) {\n return `\\n${ErrorPrettier.format({ error: arg, inspectOptions })}`;\n }\n\n // Bounded to just past what `util.inspect` will actually render. `+2`, not `+1`: at exactly\n // `depth + 1` the redactor replaces the last level with a string, and inspect then prints a\n // QUOTED `'[Object]'` instead of its own bare `[Object]`.\n return util.inspect(\n RedactUtility.redactSecrets({\n value: arg,\n depth: (inspectOptions.depth ?? LogFormatUtility.resolveDepth()) + 2,\n }),\n inspectOptions,\n );\n });\n\n return util.formatWithOptions(inspectOptions, message, ...widened);\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"deep-splat.js","sourceRoot":"","sources":["../../../../../src/modules/logger/formatting/deep-splat.ts"],"names":[],"mappings":"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","sourcesContent":["import { RedactUtility } from '@/common/redact';\nimport util from 'node:util';\nimport { ErrorPrettier } from './error-prettier';\n\n/** The placeholders `util.format` understands. `%%` is an escape, not a placeholder. */\nconst PLACEHOLDER_PATTERN = /%[sjdifoOc%]/g;\n\n/** How deep an object is inspected before it collapses to `[Object]`: Node's default of 2 hides nested data (e.g. wrapped `cause`), 5 reaches it while staying bounded. `APP_ENV_LOGGER_INSPECT_DEPTH` overrides with a NON-NEGATIVE number - no unlimited setting. */\nconst DEFAULT_INSPECT_DEPTH = 5;\n\n/** Renders a log message and its arguments to one string, redacting secret keys and inspecting objects to a bounded depth (`APP_ENV_LOGGER_INSPECT_DEPTH`, default 5). */\nexport class LogFormatUtility {\n private static resolveDepth(): number {\n const configured = process.env.APP_ENV_LOGGER_INSPECT_DEPTH;\n\n // Not `ParseUtility.toInt()`: it answers 0 for an ABSENT value, which would silently mean \"depth 0\" - the one setting that hides everything.\n if (configured === undefined || configured.trim() === '') {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n const parsed = Number.parseInt(configured, 10);\n\n // A negative or unparseable value is a misconfiguration, not a request: fall back rather than hand `util.inspect` a depth it reads as \"unlimited\".\n if (Number.isNaN(parsed) || parsed < 0) {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n return parsed;\n }\n\n private static buildInspectOptions(): util.InspectOptions {\n return {\n depth: LogFormatUtility.resolveDepth(),\n maxArrayLength: null,\n maxStringLength: null,\n breakLength: Infinity,\n };\n }\n\n /** Formats like `util.format`, but `%s` inspects to configured depth instead of Node's hard-coded `depth: 0` (no inspect option overrides that), and `%j` is projected into a JSON-safe shape first. Per-placeholder only - handing `%j` the widened STRING would emit a JSON-quoted inspect dump instead of an object. */\n static formatMessage(opts: {\n message: string;\n args: Array<unknown>;\n inspectOptions?: util.InspectOptions;\n }): string {\n const { message, args, inspectOptions = LogFormatUtility.buildInspectOptions() } = opts;\n\n const placeholders = (message.match(PLACEHOLDER_PATTERN) ?? []).filter(\n (token) => token !== '%%',\n );\n\n const widened = args.map((arg, index) => {\n const placeholder = placeholders[index];\n const isInspectable = typeof arg === 'object' && arg !== null;\n\n if (!isInspectable) {\n return arg;\n }\n\n // `%j` runs JSON.stringify, which answers `[Circular]` for the WHOLE argument when one cycle sits anywhere inside it - a transaction handle in the payload wipes out every other field. It also has no notion of secret keys, and no depth limit of its own. Project the value first, under the same depth cap `%s` gets.\n if (placeholder === '%j') {\n return RedactUtility.toJsonSafe({\n value: arg,\n depth: inspectOptions.depth ?? LogFormatUtility.resolveDepth(),\n });\n }\n\n // `%o`, `%O` and arguments with NO placeholder (`util.format` appends those) are redacted but\n // left as objects, so `util.formatWithOptions` still renders them the way that placeholder\n // means. Pre-inspecting them into a string here would make `%o` print a quoted, escaped string\n // instead of an object. Only the redaction is added; the rendering is unchanged.\n //\n // Before this, `logger.info('login failed', { password })` printed the password verbatim: the\n // redactor only ever saw `%s`, while the reference docs recommend `%o` for data objects.\n //\n // Bounded like the `%s` path below, and for the same reason: an unbounded walk on a very deep\n // graph is work whose result the renderer discards, and deep enough it is a `RangeError` on a\n // call that could not throw before. `%o` renders at `depth`, so `+2` covers what is shown.\n if (placeholder === undefined || placeholder === '%o' || placeholder === '%O') {\n return RedactUtility.redactSecrets({\n value: arg,\n depth: (inspectOptions.depth ?? LogFormatUtility.resolveDepth()) + 2,\n });\n }\n\n if (placeholder !== '%s') {\n return arg;\n }\n\n // Inspecting an Error dumps every own property - a `jose` failure carries the whole JWT payload, a driver failure the whole query. Project it instead, onto its own line so it never trails off the end of the caller's sentence.\n if (arg instanceof Error) {\n return `\\n${ErrorPrettier.format({ error: arg, inspectOptions })}`;\n }\n\n // Bounded to just past what `util.inspect` will actually render. `+2`, not `+1`: at exactly\n // `depth + 1` the redactor replaces the last level with a string, and inspect then prints a\n // QUOTED `'[Object]'` instead of its own bare `[Object]`.\n return util.inspect(\n RedactUtility.redactSecrets({\n value: arg,\n depth: (inspectOptions.depth ?? LogFormatUtility.resolveDepth()) + 2,\n }),\n inspectOptions,\n );\n });\n\n return util.formatWithOptions(inspectOptions, message, ...widened);\n }\n}\n"]}
|