@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":"abstract.js","sourceRoot":"","sources":["../../../../../../src/modules/worker-thread/bus/handler/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,OAAgB,qCACpB,SAAQ,UAAU;CAOnB","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { type IWorkerMessageBusHandler } from '../../common';\n\nexport abstract class AbstractWorkerMessageBusHandlerHelper<IConsumePayload>\n extends BaseHelper\n implements IWorkerMessageBusHandler<IConsumePayload>\n{\n onMessage: (opts: { message: IConsumePayload }) => ValueOrPromise<void>;\n onClose: () => ValueOrPromise<void>;\n onError: (opts: { error: Error }) => ValueOrPromise<void>;\n onExit: (opts: { exitCode: number | string }) => ValueOrPromise<void>;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../../src/modules/worker-thread/bus/handler/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,mGAAmG;AACnG,MAAM,OAAgB,qCACpB,SAAQ,UAAU;CAOnB","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { type IWorkerMessageBusHandler } from '../../common';\n\n/** Base for the callbacks a worker bus invokes: `onMessage`, `onClose`, `onError` and `onExit`. */\nexport abstract class AbstractWorkerMessageBusHandlerHelper<IConsumePayload>\n extends BaseHelper\n implements IWorkerMessageBusHandler<IConsumePayload>\n{\n onMessage: (opts: { message: IConsumePayload }) => ValueOrPromise<void>;\n onClose: () => ValueOrPromise<void>;\n onError: (opts: { error: Error }) => ValueOrPromise<void>;\n onExit: (opts: { exitCode: number | string }) => ValueOrPromise<void>;\n}\n"]}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type ValueOrPromise } from '../../../../common/types/index.js';
|
|
2
2
|
import { AbstractWorkerMessageBusHandlerHelper } from './abstract.js';
|
|
3
|
+
/** Bus handler built from callbacks. Only `onMessage` is required; a missing `onClose` does nothing, a missing `onExit` or `onError` logs. */
|
|
3
4
|
export declare class BaseWorkerMessageBusHandlerHelper<IConsumePayload> extends AbstractWorkerMessageBusHandlerHelper<IConsumePayload> {
|
|
4
5
|
constructor(opts: {
|
|
5
6
|
scope: string;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { AbstractWorkerMessageBusHandlerHelper } from './abstract.js';
|
|
2
|
+
/** Bus handler built from callbacks. Only `onMessage` is required; a missing `onClose` does nothing, a missing `onExit` or `onError` logs. */
|
|
2
3
|
export class BaseWorkerMessageBusHandlerHelper extends AbstractWorkerMessageBusHandlerHelper {
|
|
3
4
|
constructor(opts) {
|
|
4
5
|
super({ scope: opts.scope, identifier: opts.scope });
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../../src/modules/worker-thread/bus/handler/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,OAAO,iCAEX,SAAQ,qCAAsD;IAC9D,YAAY,IAMX;QACC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAErD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM;YACT,IAAI,EAAE,MAAM;gBACZ,CAAC,CAAC,KAAoC,EAAE,EAAE;oBACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,8BAA8B,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACzF,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO;YACV,IAAI,EAAE,OAAO;gBACb,CAAC,CAAC,KAAuB,EAAE,EAAE;oBAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC5E,CAAC,CAAC,CAAC;IACP,CAAC;CACF","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { AbstractWorkerMessageBusHandlerHelper } from './abstract';\n\nexport class BaseWorkerMessageBusHandlerHelper<\n IConsumePayload,\n> extends AbstractWorkerMessageBusHandlerHelper<IConsumePayload> {\n constructor(opts: {\n scope: string;\n onMessage: (opts: { message: IConsumePayload }) => ValueOrPromise<void>;\n onClose?: () => ValueOrPromise<void>;\n onError?: (opts: { error: Error }) => ValueOrPromise<void>;\n onExit?: (opts: { exitCode: number | string }) => ValueOrPromise<void>;\n }) {\n super({ scope: opts.scope, identifier: opts.scope });\n\n this.onMessage = opts.onMessage;\n\n this.onClose = opts?.onClose ?? (() => {});\n\n this.onExit =\n opts?.onExit ??\n ((_opts: { exitCode: string | number }) => {\n this.logger.for(this.onExit.name).warn('worker EXITED | exitCode: %s', _opts.exitCode);\n });\n\n this.onError =\n opts?.onError ??\n ((_opts: { error: Error }) => {\n this.logger.for(this.onError.name).error('worker error: %s', _opts.error);\n });\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../../src/modules/worker-thread/bus/handler/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AAEnE,8IAA8I;AAC9I,MAAM,OAAO,iCAEX,SAAQ,qCAAsD;IAC9D,YAAY,IAMX;QACC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAErD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM;YACT,IAAI,EAAE,MAAM;gBACZ,CAAC,CAAC,KAAoC,EAAE,EAAE;oBACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,8BAA8B,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACzF,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO;YACV,IAAI,EAAE,OAAO;gBACb,CAAC,CAAC,KAAuB,EAAE,EAAE;oBAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC5E,CAAC,CAAC,CAAC;IACP,CAAC;CACF","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { AbstractWorkerMessageBusHandlerHelper } from './abstract';\n\n/** Bus handler built from callbacks. Only `onMessage` is required; a missing `onClose` does nothing, a missing `onExit` or `onError` logs. */\nexport class BaseWorkerMessageBusHandlerHelper<\n IConsumePayload,\n> extends AbstractWorkerMessageBusHandlerHelper<IConsumePayload> {\n constructor(opts: {\n scope: string;\n onMessage: (opts: { message: IConsumePayload }) => ValueOrPromise<void>;\n onClose?: () => ValueOrPromise<void>;\n onError?: (opts: { error: Error }) => ValueOrPromise<void>;\n onExit?: (opts: { exitCode: number | string }) => ValueOrPromise<void>;\n }) {\n super({ scope: opts.scope, identifier: opts.scope });\n\n this.onMessage = opts.onMessage;\n\n this.onClose = opts?.onClose ?? (() => {});\n\n this.onExit =\n opts?.onExit ??\n ((_opts: { exitCode: string | number }) => {\n this.logger.for(this.onExit.name).warn('worker EXITED | exitCode: %s', _opts.exitCode);\n });\n\n this.onError =\n opts?.onError ??\n ((_opts: { error: Error }) => {\n this.logger.for(this.onError.name).error('worker error: %s', _opts.error);\n });\n }\n}\n"]}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type AnyType, type ValueOrPromise } from '../../../common/types/index.js';
|
|
2
2
|
import { type MessagePort, type Transferable, type Worker, type WorkerOptions } from 'node:worker_threads';
|
|
3
|
+
/** A managed `Worker` and the hooks fired for its lifecycle events. */
|
|
3
4
|
export interface IWorker<MessageType> {
|
|
4
5
|
worker: Worker;
|
|
5
6
|
options: WorkerOptions;
|
|
@@ -17,11 +18,13 @@ export interface IWorker<MessageType> {
|
|
|
17
18
|
error: Error;
|
|
18
19
|
}): ValueOrPromise<void>;
|
|
19
20
|
}
|
|
21
|
+
/** Message buses held by a worker thread, keyed by name. */
|
|
20
22
|
export interface IWorkerThread {
|
|
21
23
|
buses: {
|
|
22
24
|
[workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;
|
|
23
25
|
};
|
|
24
26
|
}
|
|
27
|
+
/** The callbacks a bus invokes for the events of its port. */
|
|
25
28
|
export interface IWorkerMessageBusHandler<IConsumePayload> {
|
|
26
29
|
onMessage: (opts: {
|
|
27
30
|
message: IConsumePayload;
|
|
@@ -34,6 +37,7 @@ export interface IWorkerMessageBusHandler<IConsumePayload> {
|
|
|
34
37
|
exitCode: number | string;
|
|
35
38
|
}) => ValueOrPromise<void>;
|
|
36
39
|
}
|
|
40
|
+
/** A message channel over a `MessagePort`: `handler` receives incoming messages, `postMessage` sends outgoing ones, with optional hooks around each send. */
|
|
37
41
|
export interface IWorkerBus<IConsumePayload, IPublishPayload> {
|
|
38
42
|
port: MessagePort;
|
|
39
43
|
handler: IWorkerMessageBusHandler<IConsumePayload>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import { type AnyType, type ValueOrPromise } from '@/common/types';\nimport {\n type MessagePort,\n type Transferable,\n type Worker,\n type WorkerOptions,\n} from 'node:worker_threads';\n\nexport interface IWorker<MessageType> {\n worker: Worker;\n options: WorkerOptions;\n\n onOnline(): ValueOrPromise<void>;\n onExit(opts: { code: string | number }): ValueOrPromise<void>;\n onError(opts: { error: Error }): ValueOrPromise<void>;\n onMessage(opts: { message: MessageType }): ValueOrPromise<void>;\n onMessageError(opts: { error: Error }): ValueOrPromise<void>;\n}\n\nexport interface IWorkerThread {\n buses: {\n [workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;\n };\n}\n\nexport interface IWorkerMessageBusHandler<IConsumePayload> {\n onMessage: (opts: { message: IConsumePayload }) => ValueOrPromise<void>;\n\n onClose: () => ValueOrPromise<void>;\n onError: (opts: { error: Error }) => ValueOrPromise<void>;\n onExit: (opts: { exitCode: number | string }) => ValueOrPromise<void>;\n}\n\nexport interface IWorkerBus<IConsumePayload, IPublishPayload> {\n port: MessagePort;\n handler: IWorkerMessageBusHandler<IConsumePayload>;\n\n onBeforePostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n onAfterPostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n postMessage(opts: {\n message: IPublishPayload;\n transferList: readonly Transferable[] | undefined;\n }): ValueOrPromise<void>;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import { type AnyType, type ValueOrPromise } from '@/common/types';\nimport {\n type MessagePort,\n type Transferable,\n type Worker,\n type WorkerOptions,\n} from 'node:worker_threads';\n\n/** A managed `Worker` and the hooks fired for its lifecycle events. */\nexport interface IWorker<MessageType> {\n worker: Worker;\n options: WorkerOptions;\n\n onOnline(): ValueOrPromise<void>;\n onExit(opts: { code: string | number }): ValueOrPromise<void>;\n onError(opts: { error: Error }): ValueOrPromise<void>;\n onMessage(opts: { message: MessageType }): ValueOrPromise<void>;\n onMessageError(opts: { error: Error }): ValueOrPromise<void>;\n}\n\n/** Message buses held by a worker thread, keyed by name. */\nexport interface IWorkerThread {\n buses: {\n [workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;\n };\n}\n\n/** The callbacks a bus invokes for the events of its port. */\nexport interface IWorkerMessageBusHandler<IConsumePayload> {\n onMessage: (opts: { message: IConsumePayload }) => ValueOrPromise<void>;\n\n onClose: () => ValueOrPromise<void>;\n onError: (opts: { error: Error }) => ValueOrPromise<void>;\n onExit: (opts: { exitCode: number | string }) => ValueOrPromise<void>;\n}\n\n/** A message channel over a `MessagePort`: `handler` receives incoming messages, `postMessage` sends outgoing ones, with optional hooks around each send. */\nexport interface IWorkerBus<IConsumePayload, IPublishPayload> {\n port: MessagePort;\n handler: IWorkerMessageBusHandler<IConsumePayload>;\n\n onBeforePostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n onAfterPostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n postMessage(opts: {\n message: IPublishPayload;\n transferList: readonly Transferable[] | undefined;\n }): ValueOrPromise<void>;\n}\n"]}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { type AnyType, type ValueOrPromise } from '../../../common/types/index.js';
|
|
2
2
|
import { BaseHelper } from '../../base.js';
|
|
3
3
|
import { type IWorkerBus, type IWorkerThread } from '../common/index.js';
|
|
4
|
+
/** Base for the worker-side helper that holds message buses by key. */
|
|
4
5
|
export declare abstract class AbstractWorkerThreadHelper extends BaseHelper implements IWorkerThread {
|
|
5
6
|
buses: {
|
|
6
7
|
[workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/thread/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,OAAgB,0BAA2B,SAAQ,UAAU;CAWlE","sourcesContent":["import { type AnyType, type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { type IWorkerBus, type IWorkerThread } from '../common';\n\nexport abstract class AbstractWorkerThreadHelper extends BaseHelper implements IWorkerThread {\n buses: {\n [workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;\n };\n\n abstract bindWorkerBus<IC, IP>(opts: {\n key: string;\n bus: IWorkerBus<IC, IP>;\n }): ValueOrPromise<void>;\n\n abstract getWorkerBus<IC, IP>(opts: { key: string }): IWorkerBus<IC, IP>;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/thread/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,uEAAuE;AACvE,MAAM,OAAgB,0BAA2B,SAAQ,UAAU;CAWlE","sourcesContent":["import { type AnyType, type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { type IWorkerBus, type IWorkerThread } from '../common';\n\n/** Base for the worker-side helper that holds message buses by key. */\nexport abstract class AbstractWorkerThreadHelper extends BaseHelper implements IWorkerThread {\n buses: {\n [workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;\n };\n\n abstract bindWorkerBus<IC, IP>(opts: {\n key: string;\n bus: IWorkerBus<IC, IP>;\n }): ValueOrPromise<void>;\n\n abstract getWorkerBus<IC, IP>(opts: { key: string }): IWorkerBus<IC, IP>;\n}\n"]}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type IWorkerBus } from '../common/index.js';
|
|
2
2
|
import { AbstractWorkerThreadHelper } from './abstract.js';
|
|
3
|
+
/** Holds the message buses of a worker thread by key. Throws when constructed on the main thread. */
|
|
3
4
|
export declare class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {
|
|
4
5
|
constructor(opts: {
|
|
5
6
|
scope: string;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { getError } from '../../error/index.js';
|
|
2
2
|
import { isMainThread } from 'node:worker_threads';
|
|
3
3
|
import { AbstractWorkerThreadHelper } from './abstract.js';
|
|
4
|
+
/** Holds the message buses of a worker thread by key. Throws when constructed on the main thread. */
|
|
4
5
|
export class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {
|
|
5
6
|
constructor(opts) {
|
|
6
7
|
const { scope } = opts;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/thread/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,OAAO,sBAAuB,SAAQ,0BAA0B;IACpE,YAAY,IAAuB;QACjC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAEpC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,aAAa,CAAS,IAA8C;QAClE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/thread/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,qGAAqG;AACrG,MAAM,OAAO,sBAAuB,SAAQ,0BAA0B;IACpE,YAAY,IAAuB;QACjC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAEpC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,aAAa,CAAS,IAA8C;QAClE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAE1B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;YAEnF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,eAAe,CAAC,IAAqB;QACnC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAErB,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YAEzF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,YAAY,CAAS,IAAqB;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,8CAA8C,IAAI,CAAC,GAAG,EAAE;aAClE,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAwB,CAAC;IAClC,CAAC;CACF","sourcesContent":["import { getError } from '@/modules/error';\nimport { isMainThread } from 'node:worker_threads';\nimport { type IWorkerBus } from '../common';\nimport { AbstractWorkerThreadHelper } from './abstract';\n\n/** Holds the message buses of a worker thread by key. Throws when constructed on the main thread. */\nexport class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {\n constructor(opts: { scope: string }) {\n const { scope } = opts;\n super({ scope, identifier: scope });\n\n if (isMainThread) {\n throw getError({\n message: '[BaseWorker] Cannot start worker in MAIN_THREAD',\n });\n }\n\n this.buses = Object.create(null);\n }\n\n bindWorkerBus<IC, IP>(opts: { key: string; bus: IWorkerBus<IC, IP> }) {\n if (!this.buses) {\n this.buses = Object.create(null);\n }\n\n const { key, bus } = opts;\n\n if (this.buses[key]) {\n this.logger.for(this.bindWorkerBus.name).warn('Worker Bus existed | key: %s', key);\n\n return;\n }\n\n this.buses[key] = bus;\n }\n\n unbindWorkerBus(opts: { key: string }) {\n if (!this.buses) {\n return;\n }\n\n const { key } = opts;\n\n if (!(key in this.buses)) {\n this.logger.for(this.unbindWorkerBus.name).warn('Worker Bus not existed | key: %s', key);\n\n return;\n }\n\n this.buses[key]?.port?.removeAllListeners();\n delete this.buses[key];\n }\n\n getWorkerBus<IC, IP>(opts: { key: string }) {\n const rs = this.buses[opts.key];\n\n if (!rs) {\n throw getError({\n message: `[getWorkerBus] Not found worker bus | key: ${opts.key}`,\n });\n }\n\n return rs as IWorkerBus<IC, IP>;\n }\n}\n"]}
|
|
@@ -2,6 +2,7 @@ import { type ValueOrPromise } from '../../../common/types/index.js';
|
|
|
2
2
|
import { BaseHelper } from '../../base.js';
|
|
3
3
|
import { type Worker, type WorkerOptions } from 'node:worker_threads';
|
|
4
4
|
import { type IWorker } from '../common/index.js';
|
|
5
|
+
/** Base for a helper that owns a `Worker` and reacts to its lifecycle events. */
|
|
5
6
|
export declare abstract class AbstractWorkerHelper<MessageType> extends BaseHelper implements IWorker<MessageType> {
|
|
6
7
|
worker: Worker;
|
|
7
8
|
options: WorkerOptions;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C,MAAM,OAAgB,oBACpB,SAAQ,UAAU;CAWnB","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { type Worker, type WorkerOptions } from 'node:worker_threads';\nimport { type IWorker } from '../common';\n\nexport abstract class AbstractWorkerHelper<MessageType>\n extends BaseHelper\n implements IWorker<MessageType>\n{\n worker: Worker;\n options: WorkerOptions;\n\n abstract onOnline(): ValueOrPromise<void>;\n abstract onExit(opts: { code: string | number }): ValueOrPromise<void>;\n abstract onError(opts: { error: Error }): ValueOrPromise<void>;\n abstract onMessage(opts: { message: MessageType }): ValueOrPromise<void>;\n abstract onMessageError(opts: { error: Error }): ValueOrPromise<void>;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C,iFAAiF;AACjF,MAAM,OAAgB,oBACpB,SAAQ,UAAU;CAWnB","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { type Worker, type WorkerOptions } from 'node:worker_threads';\nimport { type IWorker } from '../common';\n\n/** Base for a helper that owns a `Worker` and reacts to its lifecycle events. */\nexport abstract class AbstractWorkerHelper<MessageType>\n extends BaseHelper\n implements IWorker<MessageType>\n{\n worker: Worker;\n options: WorkerOptions;\n\n abstract onOnline(): ValueOrPromise<void>;\n abstract onExit(opts: { code: string | number }): ValueOrPromise<void>;\n abstract onError(opts: { error: Error }): ValueOrPromise<void>;\n abstract onMessage(opts: { message: MessageType }): ValueOrPromise<void>;\n abstract onMessageError(opts: { error: Error }): ValueOrPromise<void>;\n}\n"]}
|
|
@@ -2,6 +2,7 @@ import { type WorkerOptions } from 'node:worker_threads';
|
|
|
2
2
|
import { type ValueOrPromise } from '../../../common/types/index.js';
|
|
3
3
|
import { type IWorker } from '../common/index.js';
|
|
4
4
|
import { AbstractWorkerHelper } from './abstract.js';
|
|
5
|
+
/** Starts a `Worker` from `path` and routes its events to `eventHandlers`, or logs them when no handler is given. A throwing handler is logged, not rethrown. */
|
|
5
6
|
export declare class BaseWorkerHelper<MessageType> extends AbstractWorkerHelper<MessageType> {
|
|
6
7
|
protected eventHandlers?: Partial<Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>>;
|
|
7
8
|
constructor(opts: {
|
|
@@ -3,6 +3,7 @@ import { PromiseUtility } from '../../../utilities/promise.utility.js';
|
|
|
3
3
|
import { Worker } from 'node:worker_threads';
|
|
4
4
|
import { getError } from '../../error/index.js';
|
|
5
5
|
import { AbstractWorkerHelper } from './abstract.js';
|
|
6
|
+
/** Starts a `Worker` from `path` and routes its events to `eventHandlers`, or logs them when no handler is given. A throwing handler is logged, not rethrown. */
|
|
6
7
|
export class BaseWorkerHelper extends AbstractWorkerHelper {
|
|
7
8
|
constructor(opts) {
|
|
8
9
|
super({ scope: BaseWorkerHelper.name, identifier: opts.identifier });
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAsB,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,OAAO,gBAA8B,SAAQ,oBAAiC;IAKlF,YAAY,IAQX;QACC,KAAK,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QAExC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,0LAA0L;IAChL,UAAU,CAAC,IAA8D;QACjF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElC,IAAI,CAAC;YACH,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAEQ,QAAQ;QACf,IAAI,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;gBACzB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,EAAE;aAClD,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { ErrorUtility } from '@/utilities/error.utility';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { Worker, type WorkerOptions } from 'node:worker_threads';\n\nimport { type ValueOrPromise } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { type IWorker } from '../common';\nimport { AbstractWorkerHelper } from './abstract';\n\n/** Starts a `Worker` from `path` and routes its events to `eventHandlers`, or logs them when no handler is given. A throwing handler is logged, not rethrown. */\nexport class BaseWorkerHelper<MessageType> extends AbstractWorkerHelper<MessageType> {\n protected eventHandlers?: Partial<\n Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>\n >;\n\n constructor(opts: {\n scope?: string;\n identifier: string;\n path: string | URL;\n options: WorkerOptions;\n eventHandlers?: Partial<\n Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>\n >;\n }) {\n super({ scope: BaseWorkerHelper.name, identifier: opts.identifier });\n this.worker = new Worker(opts.path, opts.options);\n this.eventHandlers = opts.eventHandlers;\n\n this.binding();\n }\n\n /** User handlers run inside worker listeners; a sync throw there is uncaught and kills the process, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n PromiseUtility.voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n override onOnline(): ValueOrPromise<void> {\n if (this.eventHandlers?.onOnline) {\n this.invokeHook({\n scope: this.onOnline.name,\n execution: () => this.eventHandlers?.onOnline?.(),\n });\n\n return;\n }\n\n this.logger.for(this.onOnline.name).info('Worker ONLINE');\n }\n\n override onExit(opts: { code: string | number }): ValueOrPromise<void> {\n if (this.eventHandlers?.onExit) {\n this.invokeHook({\n scope: this.onExit.name,\n execution: () => this.eventHandlers?.onExit?.({ code: opts.code }),\n });\n\n return;\n }\n\n this.logger.for(this.onExit.name).warn('Worker EXIT | Code: %s', opts.code);\n }\n\n override onError(opts: { error: Error }): ValueOrPromise<void> {\n if (this.eventHandlers?.onError) {\n this.invokeHook({\n scope: this.onError.name,\n execution: () => this.eventHandlers?.onError?.({ error: opts.error }),\n });\n\n return;\n }\n\n this.logger.for(this.onError.name).error('Worker ERROR | Error: %s', opts.error);\n }\n\n override onMessage(opts: { message: MessageType }): ValueOrPromise<void> {\n if (this.eventHandlers?.onMessage) {\n this.invokeHook({\n scope: this.onMessage.name,\n execution: () => this.eventHandlers?.onMessage?.({ message: opts.message }),\n });\n\n return;\n }\n\n this.logger.for(this.onMessage.name).error('Worker MESSAGE | message: %j', opts.message);\n }\n\n override onMessageError(opts: { error: Error }): ValueOrPromise<void> {\n if (this.eventHandlers?.onMessageError) {\n this.invokeHook({\n scope: this.onMessageError.name,\n execution: () => this.eventHandlers?.onMessageError?.({ error: opts.error }),\n });\n\n return;\n }\n\n this.logger.for(this.onMessageError.name).error('Worker MESSAGE_ERROR | Error: %s', opts.error);\n }\n\n binding() {\n if (!this.worker) {\n throw getError({ message: '[binding] Invalid worker instance to bind event handlers' });\n }\n\n this.worker.on('online', () => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onOnline() });\n });\n\n this.worker.on('exit', (code) => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onExit({ code }) });\n });\n\n this.worker.on('error', (error) => {\n this.invokeHook({\n scope: this.binding.name,\n execution: () => this.onError({ error: ErrorUtility.toError({ error }) }),\n });\n });\n\n this.worker.on('message', (message) => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onMessage({ message }) });\n });\n\n this.worker.on('messageerror', (error) => {\n this.invokeHook({\n scope: this.binding.name,\n execution: () => this.onMessageError({ error }),\n });\n });\n }\n}\n"]}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { BaseHelper } from '../base.js';
|
|
2
2
|
import { type IWorker } from './common/index.js';
|
|
3
|
+
/** Registry of workers by key. `register` refuses a worker once the pool holds one per CPU core, unless `ignoreMaxWarning` is set, and refuses a duplicate key; `getInstance()` returns the shared pool. */
|
|
3
4
|
export declare class WorkerPoolHelper extends BaseHelper {
|
|
4
5
|
private static instance;
|
|
5
6
|
protected registry: Map<string | symbol, IWorker<any>>;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { BaseHelper } from '../base.js';
|
|
2
2
|
import { getError } from '../error/index.js';
|
|
3
3
|
import os from 'node:os';
|
|
4
|
+
/** Registry of workers by key. `register` refuses a worker once the pool holds one per CPU core, unless `ignoreMaxWarning` is set, and refuses a duplicate key; `getInstance()` returns the shared pool. */
|
|
4
5
|
export class WorkerPoolHelper extends BaseHelper {
|
|
5
6
|
constructor(opts) {
|
|
6
7
|
super({ scope: WorkerPoolHelper.name });
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"worker-pool.js","sourceRoot":"","sources":["../../../../src/modules/worker-thread/worker-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAO9C,YAAY,IAAqC;QAC/C,KAAK,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QAE5B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,EAAE,gBAAgB,IAAI,KAAK,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;YAC/B,gBAAgB,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,GAAG,CAAc,IAAqB;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAqC,CAAC;IACzE,CAAC;IAED,GAAG,CAAC,IAAqB;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ,CAAc,IAAmD;QACvE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,QAAQ,CAAC;gBACb,OAAO,EACL,gGAAgG;aACnG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;iBACvB,IAAI,CACH,oGAAoG,EACpG,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,gBAAgB,CACtB,CAAC;
|
|
1
|
+
{"version":3,"file":"worker-pool.js","sourceRoot":"","sources":["../../../../src/modules/worker-thread/worker-pool.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport os from 'node:os';\nimport { type IWorker } from './common';\n\n/** Registry of workers by key. `register` refuses a worker once the pool holds one per CPU core, unless `ignoreMaxWarning` is set, and refuses a duplicate key; `getInstance()` returns the shared pool. */\nexport class WorkerPoolHelper extends BaseHelper {\n private static instance: WorkerPoolHelper;\n protected registry: Map<string | symbol, IWorker<any>>;\n\n private numberOfCPUs: number;\n private ignoreMaxWarning: boolean;\n\n constructor(opts?: { ignoreMaxWarning?: boolean }) {\n super({ scope: WorkerPoolHelper.name });\n this.registry = new Map([]);\n\n const cpus = os.cpus();\n this.numberOfCPUs = cpus.length;\n this.ignoreMaxWarning = opts?.ignoreMaxWarning ?? false;\n }\n\n static getInstance(): WorkerPoolHelper {\n if (!WorkerPoolHelper.instance) {\n WorkerPoolHelper.instance = new WorkerPoolHelper({ ignoreMaxWarning: false });\n }\n\n return WorkerPoolHelper.instance;\n }\n\n size() {\n return this.registry.size;\n }\n\n get<MessageType>(opts: { key: string }) {\n return this.registry.get(opts.key) as IWorker<MessageType> | undefined;\n }\n\n has(opts: { key: string }) {\n return this.registry.has(opts.key);\n }\n\n register<MessageType>(opts: { key: string; worker: IWorker<MessageType> }) {\n if (!this.registry) {\n throw getError({\n message:\n '[register] Invalid worker registry instance | please init registry before register new worker!',\n });\n }\n\n if (this.registry.size >= this.numberOfCPUs && !this.ignoreMaxWarning) {\n this.logger\n .for(this.register.name)\n .warn(\n 'SKIP register worker | Pool size reached maximum number of cores | CPUs: %s | ignoreMaxWarning: %s',\n this.numberOfCPUs,\n this.ignoreMaxWarning,\n );\n\n return false;\n }\n\n const { key, worker } = opts;\n\n if (this.registry.has(key)) {\n this.logger\n .for(this.register.name)\n .error('SKIP register worker | Worker key existed in pool | key: %s', key);\n\n return false;\n }\n\n this.registry.set(key, worker);\n this.logger\n .for(this.register.name)\n .info('Successfully register worker | key: %s | poolSize: %s', key, this.registry.size);\n\n return true;\n }\n\n async unregister(opts: { key: string }) {\n const { key } = opts;\n\n if (!this.has({ key })) {\n this.logger\n .for(this.unregister.name)\n .warn('SKIP unregister worker | Worker not existed | key: %s', key);\n\n return;\n }\n\n const registered = this.get({ key });\n\n // The registry entry must go even if the thread refuses to die, otherwise the key is unusable forever and the pool never drops back below its max-workers bound\n try {\n await registered?.worker?.terminate();\n } catch (error) {\n this.logger\n .for(this.unregister.name)\n .error('Failed to terminate worker | key: %s | error: %s', key, error);\n }\n\n this.registry.delete(key);\n this.logger\n .for(this.unregister.name)\n .info('Successfully unregister worker | key: %s | poolSize: %s', key, this.registry.size);\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"error.utility.js","sourceRoot":"","sources":["../../../src/utilities/error.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,OAAO,YAAY;IACvB,0GAA0G;IAC1G,MAAM,CAAC,OAAO,CAAC,IAAwB;QACrC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"error.utility.js","sourceRoot":"","sources":["../../../src/utilities/error.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,mDAAmD;AACnD,MAAM,OAAO,YAAY;IACvB,0GAA0G;IAC1G,MAAM,CAAC,OAAO,CAAC,IAAwB;QACrC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF","sourcesContent":["import { getError } from '@/modules/error';\n\n/** Helpers for values caught in `catch` blocks. */\nexport class ErrorUtility {\n /** Normalize an unknown thrown value into an Error instance - an ApplicationError when it was not one. */\n static toError(opts: { error: unknown }): Error {\n const { error } = opts;\n\n return error instanceof Error ? error : getError({ message: String(error) });\n }\n}\n"]}
|
|
@@ -9,6 +9,7 @@ export declare const RequestBodyErrors: {
|
|
|
9
9
|
readonly category: "validation";
|
|
10
10
|
};
|
|
11
11
|
};
|
|
12
|
+
/** Reads request form bodies so that a malformed body is a 400. */
|
|
12
13
|
export declare class FormBodyUtility {
|
|
13
14
|
/**
|
|
14
15
|
* Reads a form body through the request's own cache, so every later reader gets the same
|
|
@@ -8,6 +8,7 @@ export const RequestBodyErrors = {
|
|
|
8
8
|
category: ErrorScopes.VALIDATION,
|
|
9
9
|
},
|
|
10
10
|
};
|
|
11
|
+
/** Reads request form bodies so that a malformed body is a 400. */
|
|
11
12
|
export class FormBodyUtility {
|
|
12
13
|
/**
|
|
13
14
|
* Reads a form body through the request's own cache, so every later reader gets the same
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"form-body.utility.js","sourceRoot":"","sources":["../../../src/utilities/form-body.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAyB,MAAM,iBAAiB,CAAC;AAE/E,yHAAyH;AACzH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,cAAc,EAAE;QACd,OAAO,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,6BAA6B,EAAE;QAChF,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,WAAW,CAAC,UAAU;KACjC;CACkD,CAAC;AAEtD,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAEzB;QACC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"form-body.utility.js","sourceRoot":"","sources":["../../../src/utilities/form-body.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAyB,MAAM,iBAAiB,CAAC;AAE/E,yHAAyH;AACzH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,cAAc,EAAE;QACd,OAAO,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,6BAA6B,EAAE;QAChF,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,WAAW,CAAC,UAAU;KACjC;CACkD,CAAC;AAEtD,mEAAmE;AACnE,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAEzB;QACC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAEzC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,iBAAiB,CAAC,cAAc;gBACvC,OAAO,EAAE,wBAAwB;gBACjC,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF","sourcesContent":["import { HTTP } from '@/common/constants';\nimport { ErrorScopes, getError, type TErrorDefinition } from '@/modules/error';\n\n/** The one definition of a body the runtime cannot parse; the kernel's `RequestErrors.BODY_MALFORMED` is this object. */\nexport const RequestBodyErrors = {\n BODY_MALFORMED: {\n message: { text: 'Malformed body payload', code: 'core.request.body_malformed' },\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n category: ErrorScopes.VALIDATION,\n },\n} as const satisfies Record<string, TErrorDefinition>;\n\n/** Reads request form bodies so that a malformed body is a 400. */\nexport class FormBodyUtility {\n /**\n * Reads a form body through the request's own cache, so every later reader gets the same\n * `FormData`. A body the runtime cannot parse is the caller's fault: it becomes a 400 here, where\n * the runtime's own error would be a 500 - Bun's carries only a code, Node's carries nothing.\n */\n static async readFormBody(opts: {\n req: { formData: () => Promise<FormData> };\n }): Promise<FormData> {\n try {\n const result = await opts.req.formData();\n\n return result;\n } catch (error) {\n throw getError({\n error: RequestBodyErrors.BODY_MALFORMED,\n message: 'Malformed Body Payload',\n cause: error,\n });\n }\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hr-time.utility.js","sourceRoot":"","sources":["../../../src/utilities/hr-time.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,OAAO,aAAa;IACxB;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"hr-time.utility.js","sourceRoot":"","sources":["../../../src/utilities/hr-time.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,oEAAoE;AACpE,MAAM,OAAO,aAAa;IACxB;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAEjC,OAAO,YAAY,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;CACF","sourcesContent":["import { ParseUtility } from './parse.utility';\n\n/** Elapsed-time measurement from the Node high-resolution clock. */\nexport class HrTimeUtility {\n /**\n * Seconds from the process's high-resolution clock, to nine decimals - for measuring, not for dates.\n * A file of its own: `process.hrtime` is Node-only, and `performance.utility` ships on `/core`.\n */\n static getSeconds() {\n const current = process.hrtime();\n\n return ParseUtility.toFloat({ input: current[0] + current[1] / 10 ** 9, digit: 9 });\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"module.utility.js","sourceRoot":"","sources":["../../../src/utilities/module.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from 'node:module';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { AnyType } from '@/common/types';\nimport { LoggerFactory } from '@/modules/logger';\nimport { getError } from '@/modules/error';\nimport { ProjectRootRegistry } from './project-root.utility';\n\nconst logger = LoggerFactory.getLogger(['ModuleUtility']);\n\n/** Loads an optional peer without letting `Bun.build` see it: every specifier stays a parameter, so there is no literal (nor a `minify.syntax`-folded const) for the bundler to resolve. */\nexport class ModuleUtility {\n /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. The map lives in a globalThis slot because a process (or a compiled bundle) can carry two copies of this module, and a peer registered through one copy must be found by the other. */\n private static readonly registered: Map<string, AnyType> = ModuleUtility.sharedRegistry();\n\n private static sharedRegistry(): Map<string, AnyType> {\n const slot = Symbol.for('ignis:module-registry');\n const shared: Map<string, AnyType> | undefined = Reflect.get(globalThis, slot);\n if (shared) {\n return shared;\n }\n\n const created = new Map<string, AnyType>();\n Reflect.set(globalThis, slot, created);\n\n return created;\n }\n\n /** Called by the application once it knows its root (`configs.projectRoot` or the cwd); every peer lookup below follows it. Delegates to `ProjectRootRegistry`, which a browser Worker host reaches too through `/core` - the two must share ONE slot. */\n static setProjectRoot(opts: { projectRoot: string }): void {\n ProjectRootRegistry.set(opts);\n }\n\n static getProjectRoot(): string {\n return ProjectRootRegistry.getShared() ?? process.cwd();\n }\n\n /** Resolves peers against the APP's node_modules (under the project root), not this package's own `dist/` location. */\n private static appRequire() {\n return createRequire(path.join(this.getProjectRoot(), 'node_modules'));\n }\n\n private static fail(opts: { method: string; module: string; error: unknown; scope?: string }) {\n const { method, module, error, scope } = opts;\n const reason = error instanceof Error ? error.message : String(error);\n\n logger.for(method).error(\"Failed to load '%s' | Error: %s\", module, reason);\n\n return getError({\n message: `[ModuleUtility.${method}] ${module} is required, resolved from ${this.getProjectRoot()}${\n scope ? ` for ${scope}` : ''\n }. Please install '${module}' | Error: ${reason}`,\n });\n }\n\n /**\n * Hands the framework a peer the application already holds, so no filesystem lookup is needed.\n * A `bun build --compile` binary ships without `node_modules`, which leaves runtime resolution\n * nothing to resolve against: the application imports such a peer statically - that import is\n * what gets it into the binary - and registers it here before the consuming component boots.\n *\n * Deliberately does not log. It runs at the entrypoint of exactly the deployment that has no\n * logger provider yet, where `LoggerFactory` throws - and a throw mid-loop would drop every\n * module after the first.\n */\n static register(opts: { modules: Record<string, AnyType> }): void {\n const modulesEntries = Object.entries(opts.modules);\n for (const [module, value] of modulesEntries) {\n this.registered.set(module, value);\n }\n }\n\n /**\n * The file `module` resolves to from the project root under the ES module conditions (`import`), so\n * the peer is the very instance an application's own `import` of it gets. `undefined` when it does not\n * resolve there or the runtime has no resolver: the caller falls back to a plain `import()`.\n */\n private static resolveEsmFile(opts: { module: string }): string | undefined {\n if (typeof Bun === 'undefined') {\n return undefined;\n }\n\n try {\n const file = Bun.resolveSync(opts.module, this.getProjectRoot());\n return path.isAbsolute(file) ? file : undefined;\n // eslint-disable-next-line venizia/no-silent-catch -- documented contract: an unresolvable module is `undefined` and the caller falls back to a plain `import()`\n } catch {\n return undefined;\n }\n }\n\n /**\n * Loads the module as an ES module, resolved from the project root: a peer that ships both builds\n * (`bullmq`, `socket.io-client`) is loaded as the copy the application's own `import` gets, not a second\n * one. A module handed over with {@link register} wins; one that does not resolve from the project root is\n * imported by name as before. Use this everywhere except a constructor, which cannot await - see {@link preload}.\n */\n static async load<T = AnyType>(opts: { module: string }): Promise<T> {\n const { module } = opts;\n\n if (this.registered.has(module)) {\n return this.registered.get(module) as T;\n }\n\n try {\n const file = this.resolveEsmFile({ module });\n const result = await import(file === undefined ? module : pathToFileURL(file).href);\n return result as T;\n } catch (error) {\n throw this.fail({ method: 'load', module, error });\n }\n }\n\n /**\n * The explicit register path for what a constructor needs: loads each module with {@link load} and\n * registers it, so the synchronous {@link loadSync} returns that ES module copy afterwards. Call it once\n * at the entrypoint, before the helpers are constructed. A module already registered is kept; every module\n * is loaded before any is registered, so one that is missing registers nothing.\n */\n static async preload(opts: { modules: Array<string> }): Promise<void> {\n const loaded: Record<string, AnyType> = {};\n\n for (const module of opts.modules) {\n // `load` answers from the registry first, so a module the application handed over comes back as itself.\n const result = await this.load({ module });\n loaded[module] = result;\n }\n\n this.register({ modules: loaded });\n }\n\n /**\n * Sync twin of {@link load}, for a constructor or any path that cannot await. It resolves with\n * `require`, so a peer that ships both builds comes back as its CommonJS copy - a second instance next to\n * the one an application's `import` holds, and `instanceof` across the two fails. `await preload(...)` at the\n * entrypoint registers the ES module copy first, and this returns that.\n */\n static loadSync<T = AnyType>(opts: { module: string }): T {\n const { module } = opts;\n\n if (this.registered.has(module)) {\n return this.registered.get(module) as T;\n }\n\n try {\n return this.appRequire()(module) as T;\n } catch (error) {\n throw this.fail({ method: 'loadSync', module, error });\n }\n }\n\n /**\n * Presence check only - throws naming what to install, without executing the module.\n *\n * `allowRegistered` must be set only where {@link load} or {@link loadSync} is what finally loads\n * the module. Where the consumer resolves the specifier itself - `pino.transport()` inside a\n * worker thread, or any caller with its own `createRequire` - the registry cannot reach it, and\n * counting a registration as installed would replace this precise error with an opaque one.\n */\n static assertInstalled(opts: {\n modules: Array<string>;\n scope?: string;\n allowRegistered?: boolean;\n }): void {\n const { modules, scope, allowRegistered = false } = opts;\n const appRequire = this.appRequire();\n\n for (const module of modules) {\n if (allowRegistered && this.registered.has(module)) {\n continue;\n }\n\n try {\n appRequire.resolve(module);\n } catch (error) {\n throw this.fail({ method: 'assertInstalled', module, error, scope });\n }\n }\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"module.utility.js","sourceRoot":"","sources":["../../../src/utilities/module.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from 'node:module';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { AnyType } from '@/common/types';\nimport { LoggerFactory } from '@/modules/logger';\nimport { getError } from '@/modules/error';\nimport { ProjectRootRegistry } from './project-root.utility';\n\nconst logger = LoggerFactory.getLogger(['ModuleUtility']);\n\n/** Loads an optional peer without letting `Bun.build` see it: every specifier stays a parameter, so there is no literal (nor a `minify.syntax`-folded const) for the bundler to resolve. */\nexport class ModuleUtility {\n /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. The map lives in a globalThis slot because a process (or a compiled bundle) can carry two copies of this module, and a peer registered through one copy must be found by the other. */\n private static readonly registered: Map<string, AnyType> = ModuleUtility.sharedRegistry();\n\n private static sharedRegistry(): Map<string, AnyType> {\n const slot = Symbol.for('ignis:module-registry');\n const shared: Map<string, AnyType> | undefined = Reflect.get(globalThis, slot);\n\n if (shared) {\n return shared;\n }\n\n const created = new Map<string, AnyType>();\n Reflect.set(globalThis, slot, created);\n\n return created;\n }\n\n /** Called by the application once it knows its root (`configs.projectRoot` or the cwd); every peer lookup below follows it. Delegates to `ProjectRootRegistry`, which a browser Worker host reaches too through `/core` - the two must share ONE slot. */\n static setProjectRoot(opts: { projectRoot: string }): void {\n ProjectRootRegistry.set(opts);\n }\n\n static getProjectRoot(): string {\n return ProjectRootRegistry.getShared() ?? process.cwd();\n }\n\n /** Resolves peers against the APP's node_modules (under the project root), not this package's own `dist/` location. */\n private static appRequire() {\n return createRequire(path.join(this.getProjectRoot(), 'node_modules'));\n }\n\n private static fail(opts: { method: string; module: string; error: unknown; scope?: string }) {\n const { method, module, error, scope } = opts;\n const reason = error instanceof Error ? error.message : String(error);\n\n logger.for(method).error(\"Failed to load '%s' | Error: %s\", module, reason);\n\n return getError({\n message: `[ModuleUtility.${method}] ${module} is required, resolved from ${this.getProjectRoot()}${\n scope ? ` for ${scope}` : ''\n }. Please install '${module}' | Error: ${reason}`,\n });\n }\n\n /**\n * Hands the framework a peer the application already holds, so no filesystem lookup is needed.\n * A `bun build --compile` binary ships without `node_modules`, which leaves runtime resolution\n * nothing to resolve against: the application imports such a peer statically - that import is\n * what gets it into the binary - and registers it here before the consuming component boots.\n *\n * Deliberately does not log. It runs at the entrypoint of exactly the deployment that has no\n * logger provider yet, where `LoggerFactory` throws - and a throw mid-loop would drop every\n * module after the first.\n */\n static register(opts: { modules: Record<string, AnyType> }): void {\n const modulesEntries = Object.entries(opts.modules);\n\n for (const [module, value] of modulesEntries) {\n this.registered.set(module, value);\n }\n }\n\n /**\n * The file `module` resolves to from the project root under the ES module conditions (`import`), so\n * the peer is the very instance an application's own `import` of it gets. `undefined` when it does not\n * resolve there or the runtime has no resolver: the caller falls back to a plain `import()`.\n */\n private static resolveEsmFile(opts: { module: string }): string | undefined {\n if (typeof Bun === 'undefined') {\n return undefined;\n }\n\n try {\n const file = Bun.resolveSync(opts.module, this.getProjectRoot());\n\n return path.isAbsolute(file) ? file : undefined;\n // eslint-disable-next-line venizia/no-silent-catch -- documented contract: an unresolvable module is `undefined` and the caller falls back to a plain `import()`\n } catch {\n return undefined;\n }\n }\n\n /**\n * Loads the module as an ES module, resolved from the project root: a peer that ships both builds\n * (`bullmq`, `socket.io-client`) is loaded as the copy the application's own `import` gets, not a second\n * one. A module handed over with {@link register} wins; one that does not resolve from the project root is\n * imported by name as before. Use this everywhere except a constructor, which cannot await - see {@link preload}.\n */\n static async load<T = AnyType>(opts: { module: string }): Promise<T> {\n const { module } = opts;\n\n if (this.registered.has(module)) {\n return this.registered.get(module) as T;\n }\n\n try {\n const file = this.resolveEsmFile({ module });\n const result = await import(file === undefined ? module : pathToFileURL(file).href);\n\n return result as T;\n } catch (error) {\n throw this.fail({ method: 'load', module, error });\n }\n }\n\n /**\n * The explicit register path for what a constructor needs: loads each module with {@link load} and\n * registers it, so the synchronous {@link loadSync} returns that ES module copy afterwards. Call it once\n * at the entrypoint, before the helpers are constructed. A module already registered is kept; every module\n * is loaded before any is registered, so one that is missing registers nothing.\n */\n static async preload(opts: { modules: Array<string> }): Promise<void> {\n const loaded: Record<string, AnyType> = {};\n\n for (const module of opts.modules) {\n // `load` answers from the registry first, so a module the application handed over comes back as itself.\n const result = await this.load({ module });\n loaded[module] = result;\n }\n\n this.register({ modules: loaded });\n }\n\n /**\n * Sync twin of {@link load}, for a constructor or any path that cannot await. It resolves with\n * `require`, so a peer that ships both builds comes back as its CommonJS copy - a second instance next to\n * the one an application's `import` holds, and `instanceof` across the two fails. `await preload(...)` at the\n * entrypoint registers the ES module copy first, and this returns that.\n */\n static loadSync<T = AnyType>(opts: { module: string }): T {\n const { module } = opts;\n\n if (this.registered.has(module)) {\n return this.registered.get(module) as T;\n }\n\n try {\n return this.appRequire()(module) as T;\n } catch (error) {\n throw this.fail({ method: 'loadSync', module, error });\n }\n }\n\n /**\n * Presence check only - throws naming what to install, without executing the module.\n *\n * `allowRegistered` must be set only where {@link load} or {@link loadSync} is what finally loads\n * the module. Where the consumer resolves the specifier itself - `pino.transport()` inside a\n * worker thread, or any caller with its own `createRequire` - the registry cannot reach it, and\n * counting a registration as installed would replace this precise error with an opaque one.\n */\n static assertInstalled(opts: {\n modules: Array<string>;\n scope?: string;\n allowRegistered?: boolean;\n }): void {\n const { modules, scope, allowRegistered = false } = opts;\n const appRequire = this.appRequire();\n\n for (const module of modules) {\n if (allowRegistered && this.registered.has(module)) {\n continue;\n }\n\n try {\n appRequire.resolve(module);\n } catch (error) {\n throw this.fail({ method: 'assertInstalled', module, error, scope });\n }\n }\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"parse.utility.js","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\n\n/** Number, string and key conversions that tolerate bad input; no node import, so it ships on `/core`. */\nexport class ParseUtility {\n /**\n * Rounds at a decimal precision, shifting the exponent rather than multiplying: `1.005` at 2 is\n * `1.01` here, where `Math.round(1.005 * 100) / 100` gives `1`.\n *\n * Hand-written to keep lodash out of a browser bundle. One deliberate difference from `lodash/round`:\n * a result of negative zero is normalised to `0`. They compare equal, stringify the same and\n * serialise the same, so nothing downstream can tell - checked across 114 value/precision pairs, and\n * the sign of zero was the only disagreement.\n */\n private static round(opts: { value: number; precision?: number }): number {\n const { value, precision = 0 } = opts;\n\n if (!Number.isFinite(value) || precision === 0) {\n return Math.round(value) + 0;\n }\n\n const [mantissa, exponent] = `${value}e`.split('e');\n const shifted = Math.round(Number(`${mantissa}e${Number(exponent) + precision}`));\n const [shiftedMantissa, shiftedExponent] = `${shifted}e`.split('e');\n\n return Number(`${shiftedMantissa}e${Number(shiftedExponent) - precision}`) + 0;\n }\n\n /** Arrays stay arrays - mapping one through the object branch would turn it into an index-keyed object - but their object elements still need their keys camelized. Dates are opaque values. */\n private static camelizeValue(opts: { value: unknown }): unknown {\n const { value } = opts;\n\n if (Array.isArray(value)) {\n return value.map((element) => ParseUtility.camelizeValue({ value: element }));\n }\n\n if (!value || typeof value !== 'object' || value instanceof Date) {\n return value;\n }\n\n const camelized: any = {};\n const valueKeys = Object.keys(value);\n for (const key of valueKeys) {\n camelized[ParseUtility.toCamel({ input: key })] = ParseUtility.camelizeValue({\n value: (value as Record<string, unknown>)[key],\n });\n }\n\n return camelized;\n }\n\n static getUID() {\n return Math.random().toString(36).slice(2).toUpperCase();\n }\n\n static toCamel(opts: { input: string }) {\n return opts.input.replace(/([-_][a-z])/gi, (sub: string) => {\n return sub.toUpperCase().replace('-', '').replace('_', '');\n });\n }\n\n static keysToCamel(opts: { source: object }) {\n const { source } = opts;\n const n: any = {};\n const keys = Object.keys(source);\n\n for (const key of keys) {\n n[ParseUtility.toCamel({ input: key })] = ParseUtility.camelizeValue({\n value: (source as Record<string, unknown>)[key],\n });\n }\n\n return n;\n }\n\n static isInt(opts: { input: any }) {\n const { input } = opts;\n if (isNaN(input)) {\n return false;\n }\n\n return (\n Number.isInteger(input) || Math.floor(Number(input)) === input || Number(input) % 1 === 0\n );\n }\n\n static isFloat(opts: { input: any }) {\n const { input } = opts;\n if (isNaN(input)) {\n return false;\n }\n\n return Number(input) === input || Number(input) % 1 !== 0;\n }\n\n /**\n * Parses an integer, TOTAL by design: it always answers a number, and answers `0` for anything it\n * cannot parse - `undefined`, `''`, `'abc'`.\n *\n * That makes `ParseUtility.toInt({ input }) ?? fallback` dead code, because the left side is never\n * nullish. The fallback belongs INSIDE the call, and for an environment read it belongs in the read\n * itself:\n *\n * ```ts\n * ParseUtility.toInt({ input: applicationEnvironment.get(KEY, { defaultValue: '6379' }) }) // correct\n * ParseUtility.toInt({ input: applicationEnvironment.get(KEY) }) ?? 6379 // always 0 when KEY is unset\n * ```\n *\n * The second form is silent: a missing port reads `0` and a missing retry budget reads `0`, which\n * through `AbstractRedisHelper.buildRetryStrategy` means \"give up after the first failure\".\n */\n static toInt(opts: { input: any }) {\n const { input } = opts;\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = Number.parseInt(normalized, 10);\n return Number.isNaN(parsed) ? 0 : parsed;\n }\n\n static toFloat(opts: { input: any; digit?: number }) {\n const { input, digit = 2 } = opts;\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = ParseUtility.round({ value: Number.parseFloat(normalized), precision: digit });\n return Number.isNaN(parsed) ? 0 : parsed;\n }\n\n static toBoolean(opts: { input: any }): boolean {\n const { input } = opts;\n return (\n input !== '' &&\n input !== 'false' &&\n input !== '0' &&\n input !== false &&\n input !== 0 &&\n input !== null &&\n input !== undefined\n );\n }\n\n /** Converts an array to a Map keyed by `key`. Last element wins on duplicate keys. */\n static parseArrayToMapWithKey<T extends Record<K, PropertyKey>, K extends keyof T>(opts: {\n items: T[];\n key: K;\n }): Map<T[K], T> {\n const { items, key } = opts;\n const resultMap = new Map<T[K], T>();\n\n if (!items.length) {\n return resultMap;\n }\n\n items.forEach((element) => {\n if (!(key in element)) {\n throw getError({\n message: 'Invalid keyMap',\n });\n }\n resultMap.set(element[key], element);\n });\n\n return resultMap;\n }\n\n /** Splits a delimited string into trimmed, non-empty entries - the transform for list-shaped env values (e.g. `applicationEnvironment.get(KEY, { transform: (input) => ParseUtility.toDelimitedArray({ input }) })`). */\n static toDelimitedArray(opts: { input: unknown; separator?: string }): string[] {\n const { input, separator = ',' } = opts;\n if (input == null) {\n return [];\n }\n\n return String(input)\n .split(separator)\n .map((entry) => entry.trim())\n .filter((entry) => entry.length > 0);\n }\n\n /**\n * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.\n *\n * Written for environment reads. `KEY=` in a deployment file is a pipeline that forgot to export the\n * value, but `process.env.KEY` answers `''` for it, and `''` walks straight past `??`:\n *\n * ```ts\n * process.env.APP_ENV_LOGGER_FORMAT ?? 'text' // '' when the line is blank\n * ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FORMAT }) ?? 'text' // 'text'\n * ```\n *\n * Reach for this rather than `||`, which reads `'0'` as blank as well.\n */\n static blankToUndefined(opts: { input: string | undefined }): string | undefined {\n const trimmed = opts.input?.trim();\n return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;\n }\n\n /** Trims a possibly-undefined env value to a clean string ('' when absent). */\n static toTrimmed(opts: { input: unknown }): string {\n const { input } = opts;\n if (input == null) {\n return '';\n }\n\n return String(input).trim();\n }\n\n /** Traverse a dotted property path on an object. */\n static getDeepProperty<T, V>(opts: { source: T; path: string }): V {\n const keys = opts.path.split('.');\n let result: any = opts.source;\n\n for (const key of keys) {\n if (result == null) {\n throw getError({ message: `Cannot read property '${key}' of ${result}` });\n }\n result = result[key];\n }\n\n return result as V;\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"parse.utility.js","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\n\n/** Number, string and key conversions that tolerate bad input; no node import, so it ships on `/core`. */\nexport class ParseUtility {\n /**\n * Rounds at a decimal precision, shifting the exponent rather than multiplying: `1.005` at 2 is\n * `1.01` here, where `Math.round(1.005 * 100) / 100` gives `1`.\n *\n * Hand-written to keep lodash out of a browser bundle. One deliberate difference from `lodash/round`:\n * a result of negative zero is normalised to `0`. They compare equal, stringify the same and\n * serialise the same, so nothing downstream can tell - checked across 114 value/precision pairs, and\n * the sign of zero was the only disagreement.\n */\n private static round(opts: { value: number; precision?: number }): number {\n const { value, precision = 0 } = opts;\n\n if (!Number.isFinite(value) || precision === 0) {\n return Math.round(value) + 0;\n }\n\n const [mantissa, exponent] = `${value}e`.split('e');\n const shifted = Math.round(Number(`${mantissa}e${Number(exponent) + precision}`));\n const [shiftedMantissa, shiftedExponent] = `${shifted}e`.split('e');\n\n return Number(`${shiftedMantissa}e${Number(shiftedExponent) - precision}`) + 0;\n }\n\n /** Arrays stay arrays - mapping one through the object branch would turn it into an index-keyed object - but their object elements still need their keys camelized. Dates are opaque values. */\n private static camelizeValue(opts: { value: unknown }): unknown {\n const { value } = opts;\n\n if (Array.isArray(value)) {\n return value.map((element) => ParseUtility.camelizeValue({ value: element }));\n }\n\n if (!value || typeof value !== 'object' || value instanceof Date) {\n return value;\n }\n\n const camelized: any = {};\n const valueKeys = Object.keys(value);\n\n for (const key of valueKeys) {\n camelized[ParseUtility.toCamel({ input: key })] = ParseUtility.camelizeValue({\n value: (value as Record<string, unknown>)[key],\n });\n }\n\n return camelized;\n }\n\n static getUID() {\n return Math.random().toString(36).slice(2).toUpperCase();\n }\n\n static toCamel(opts: { input: string }) {\n return opts.input.replace(/([-_][a-z])/gi, (sub: string) => {\n return sub.toUpperCase().replace('-', '').replace('_', '');\n });\n }\n\n static keysToCamel(opts: { source: object }) {\n const { source } = opts;\n const n: any = {};\n const keys = Object.keys(source);\n\n for (const key of keys) {\n n[ParseUtility.toCamel({ input: key })] = ParseUtility.camelizeValue({\n value: (source as Record<string, unknown>)[key],\n });\n }\n\n return n;\n }\n\n static isInt(opts: { input: any }) {\n const { input } = opts;\n\n if (isNaN(input)) {\n return false;\n }\n\n return (\n Number.isInteger(input) || Math.floor(Number(input)) === input || Number(input) % 1 === 0\n );\n }\n\n static isFloat(opts: { input: any }) {\n const { input } = opts;\n\n if (isNaN(input)) {\n return false;\n }\n\n return Number(input) === input || Number(input) % 1 !== 0;\n }\n\n /**\n * Parses an integer, TOTAL by design: it always answers a number, and answers `0` for anything it\n * cannot parse - `undefined`, `''`, `'abc'`.\n *\n * That makes `ParseUtility.toInt({ input }) ?? fallback` dead code, because the left side is never\n * nullish. The fallback belongs INSIDE the call, and for an environment read it belongs in the read\n * itself:\n *\n * ```ts\n * ParseUtility.toInt({ input: applicationEnvironment.get(KEY, { defaultValue: '6379' }) }) // correct\n * ParseUtility.toInt({ input: applicationEnvironment.get(KEY) }) ?? 6379 // always 0 when KEY is unset\n * ```\n *\n * The second form is silent: a missing port reads `0` and a missing retry budget reads `0`, which\n * through `AbstractRedisHelper.buildRetryStrategy` means \"give up after the first failure\".\n */\n static toInt(opts: { input: any }) {\n const { input } = opts;\n\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = Number.parseInt(normalized, 10);\n\n return Number.isNaN(parsed) ? 0 : parsed;\n }\n\n static toFloat(opts: { input: any; digit?: number }) {\n const { input, digit = 2 } = opts;\n\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = ParseUtility.round({ value: Number.parseFloat(normalized), precision: digit });\n\n return Number.isNaN(parsed) ? 0 : parsed;\n }\n\n static toBoolean(opts: { input: any }): boolean {\n const { input } = opts;\n\n return (\n input !== '' &&\n input !== 'false' &&\n input !== '0' &&\n input !== false &&\n input !== 0 &&\n input !== null &&\n input !== undefined\n );\n }\n\n /** Converts an array to a Map keyed by `key`. Last element wins on duplicate keys. */\n static parseArrayToMapWithKey<T extends Record<K, PropertyKey>, K extends keyof T>(opts: {\n items: T[];\n key: K;\n }): Map<T[K], T> {\n const { items, key } = opts;\n const resultMap = new Map<T[K], T>();\n\n if (!items.length) {\n return resultMap;\n }\n\n items.forEach((element) => {\n if (!(key in element)) {\n throw getError({\n message: 'Invalid keyMap',\n });\n }\n\n resultMap.set(element[key], element);\n });\n\n return resultMap;\n }\n\n /** Splits a delimited string into trimmed, non-empty entries - the transform for list-shaped env values (e.g. `applicationEnvironment.get(KEY, { transform: (input) => ParseUtility.toDelimitedArray({ input }) })`). */\n static toDelimitedArray(opts: { input: unknown; separator?: string }): string[] {\n const { input, separator = ',' } = opts;\n\n if (input == null) {\n return [];\n }\n\n return String(input)\n .split(separator)\n .map((entry) => entry.trim())\n .filter((entry) => entry.length > 0);\n }\n\n /**\n * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.\n *\n * Written for environment reads. `KEY=` in a deployment file is a pipeline that forgot to export the\n * value, but `process.env.KEY` answers `''` for it, and `''` walks straight past `??`:\n *\n * ```ts\n * process.env.APP_ENV_LOGGER_FORMAT ?? 'text' // '' when the line is blank\n * ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FORMAT }) ?? 'text' // 'text'\n * ```\n *\n * Reach for this rather than `||`, which reads `'0'` as blank as well.\n */\n static blankToUndefined(opts: { input: string | undefined }): string | undefined {\n const trimmed = opts.input?.trim();\n\n return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;\n }\n\n /** Trims a possibly-undefined env value to a clean string ('' when absent). */\n static toTrimmed(opts: { input: unknown }): string {\n const { input } = opts;\n\n if (input == null) {\n return '';\n }\n\n return String(input).trim();\n }\n\n /** Traverse a dotted property path on an object. */\n static getDeepProperty<T, V>(opts: { source: T; path: string }): V {\n const keys = opts.path.split('.');\n let result: any = opts.source;\n\n for (const key of keys) {\n if (result == null) {\n throw getError({ message: `Cannot read property '${key}' of ${result}` });\n }\n\n result = result[key];\n }\n\n return result as V;\n }\n}\n"]}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { type ILogger } from '../modules/logger/index.js';
|
|
2
|
+
/** Timing helpers on `performance.now()`: checkpoints, elapsed milliseconds and a measured task runner. */
|
|
2
3
|
export declare class PerformanceUtility {
|
|
3
4
|
static getCheckpoint(): number;
|
|
4
5
|
static getExecuted(opts: {
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { ParseUtility } from './parse.utility.js';
|
|
2
2
|
const DEFAULT_PERFORMANCE_DECIMAL = 6;
|
|
3
|
+
/** Timing helpers on `performance.now()`: checkpoints, elapsed milliseconds and a measured task runner. */
|
|
3
4
|
export class PerformanceUtility {
|
|
4
5
|
static getCheckpoint() {
|
|
5
6
|
return performance.now();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"performance.utility.js","sourceRoot":"","sources":["../../../src/utilities/performance.utility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAItC,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAC,aAAa;QAClB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAsC;QACvD,OAAO,YAAY,CAAC,OAAO,CAAC;YAC1B,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,2BAA2B;SACjD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAU,IAOlC;QACC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAC5B,MAAM,EACJ,MAAM,GAAG,OAAO,EAChB,KAAK,GAAG,OAAO,EACf,KAAK,EACL,WAAW,GAAG,WAAW,EACzB,IAAI,EACJ,IAAI,GACL,GAAG,IAAI,CAAC;YAET,sIAAsI;YACtI,MAAM,MAAM,GAAe,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,GAAG,MAAsB,EAAE,EAAE,CACzD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;YAE1C,IAAI,IAAI,EAAE,CAAC;gBACT,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;iBACpB,IAAI,CAAC,OAAO,CAAC;iBACb,KAAK,CAAC,MAAM,CAAC;iBACb,OAAO,CAAC,GAAG,EAAE;gBACZ,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"performance.utility.js","sourceRoot":"","sources":["../../../src/utilities/performance.utility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAItC,2GAA2G;AAC3G,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAC,aAAa;QAClB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAsC;QACvD,OAAO,YAAY,CAAC,OAAO,CAAC;YAC1B,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,2BAA2B;SACjD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAU,IAOlC;QACC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAC5B,MAAM,EACJ,MAAM,GAAG,OAAO,EAChB,KAAK,GAAG,OAAO,EACf,KAAK,EACL,WAAW,GAAG,WAAW,EACzB,IAAI,EACJ,IAAI,GACL,GAAG,IAAI,CAAC;YAET,sIAAsI;YACtI,MAAM,MAAM,GAAe,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,GAAG,MAAsB,EAAE,EAAE,CACzD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;YAE1C,IAAI,IAAI,EAAE,CAAC;gBACT,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;iBACpB,IAAI,CAAC,OAAO,CAAC;iBACb,KAAK,CAAC,MAAM,CAAC;iBACb,OAAO,CAAC,GAAG,EAAE;gBACZ,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAEnC,IAAI,IAAI,EAAE,CAAC;oBACT,GAAG,CAAC,2CAA2C,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;gBACnF,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,gCAAgC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { type ILogger } from '@/modules/logger';\nimport { ParseUtility } from './parse.utility';\n\nconst DEFAULT_PERFORMANCE_DECIMAL = 6;\n\ntype TLogMethod = (message: string, ...args: Array<AnyType>) => void;\n\n/** Timing helpers on `performance.now()`: checkpoints, elapsed milliseconds and a measured task runner. */\nexport class PerformanceUtility {\n static getCheckpoint() {\n return performance.now();\n }\n\n static getExecuted(opts: { from: number; digit?: number }) {\n return ParseUtility.toFloat({\n input: performance.now() - opts.from,\n digit: opts.digit ?? DEFAULT_PERFORMANCE_DECIMAL,\n });\n }\n\n static executeWithMeasure<R = any>(opts: {\n logger?: ILogger;\n level?: string;\n description?: string;\n args?: any;\n scope: string;\n task: Function;\n }) {\n return new Promise<R>((resolve, reject) => {\n const t = performance.now();\n const {\n logger = console,\n level = 'debug',\n scope,\n description = 'Executing',\n args,\n task,\n } = opts;\n\n // `level` names a method on whichever logger was passed, so it is looked up, not indexed; the call keeps `this` bound to that logger.\n const method: TLogMethod = Reflect.get(logger, level);\n const log = (message: string, ...params: Array<AnyType>) =>\n method.call(logger, message, ...params);\n\n if (args) {\n log('[%s] START | %s... | Args: %j', scope, description, args);\n } else {\n log('[%s] START | %s ...', scope, description);\n }\n\n Promise.resolve(task())\n .then(resolve)\n .catch(reject)\n .finally(() => {\n const took = performance.now() - t;\n\n if (args) {\n log('[%s] DONE | %s | Args: %j | Took: %s (ms)', scope, description, args, took);\n } else {\n log('[%s] DONE | %s | Took: %s (ms)', scope, description, took);\n }\n });\n });\n }\n}\n"]}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type ValueOrPromise } from '../common/index.js';
|
|
2
2
|
import type { ILogger } from '../modules/logger/index.js';
|
|
3
|
+
/** An async task as `executeWithLimit` takes it. */
|
|
3
4
|
export type TTask<T> = (...args: any[]) => Promise<T>;
|
|
4
5
|
/** Check if a value is a promise. */
|
|
5
6
|
export declare const isPromiseLike: <T>(value: T | PromiseLike<T>) => value is PromiseLike<T>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"promise.utility.js","sourceRoot":"","sources":["../../../src/utilities/promise.utility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"promise.utility.js","sourceRoot":"","sources":["../../../src/utilities/promise.utility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAM3C,qCAAqC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,KAAyB,EAA2B,EAAE;IACrF,OAAO,CACL,CAAC,CAAC,KAAK;QACP,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,OAAQ,KAAwB,CAAC,IAAI,KAAK,UAAU,CACrD,CAAC;AACJ,CAAC,CAAC;AAEF,gRAAgR;AAChR,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,KAAK,CAAC,IAAoB;QAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,oDAAoD;IACpD,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAI,IAIhC;QACC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,0EAA0E,KAAK,EAAE;aAC3F,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBACrC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE1B,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,SAAS,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC3C,MAAM,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7B,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,+GAA+G;IAC/G,MAAM,CAAC,aAAa,CAAC,IAIpB;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAClD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,0DAA0D,EAAE,KAAK,CAAC,CAAC;gBAE3F,OAAO;YACT,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { type ValueOrPromise } from '@/common';\nimport { getError } from '@/modules/error';\nimport type { ILogger } from '@/modules/logger';\n\n/** An async task as `executeWithLimit` takes it. */\nexport type TTask<T> = (...args: any[]) => Promise<T>;\n\n/** Check if a value is a promise. */\nexport const isPromiseLike = <T>(value: T | PromiseLike<T>): value is PromiseLike<T> => {\n return (\n !!value &&\n (typeof value === 'object' || typeof value === 'function') &&\n typeof (value as PromiseLike<T>).then === 'function'\n );\n};\n\n/** Waiting, bounded concurrency and fire-and-forget. `voidExecution` is not a `BaseHelper` member: TS cannot emit protected members on an exported ANONYMOUS class (TS4094), which is what factory-built controllers return; a static on a separate class has no such limit. */\nexport class PromiseUtility {\n static sleep(opts: { ms: number }): Promise<unknown> {\n return new Promise((resolve) => setTimeout(resolve, opts.ms));\n }\n\n /** Execute async tasks with bounded concurrency. */\n static async executeWithLimit<T>(opts: {\n tasks: Array<TTask<T>>;\n limit: number;\n onTaskDone?: <R>(opts: { result: R }) => ValueOrPromise<void>;\n }) {\n const { tasks, limit, onTaskDone } = opts;\n\n if (!Number.isInteger(limit) || limit < 1) {\n throw getError({\n message: `[executePromiseWithLimit] limit must be a positive integer | received: ${limit}`,\n });\n }\n\n const results: Promise<T>[] = [];\n const executing = new Set();\n\n for (const task of tasks) {\n const promise = task().then((result) => {\n executing.delete(promise);\n\n return result;\n });\n\n executing.add(promise);\n results.push(promise);\n\n if (executing.size >= limit) {\n const done = await Promise.race(executing);\n await onTaskDone?.({ result: done });\n }\n }\n\n await Promise.all(executing);\n\n return Promise.all(results);\n }\n\n /** Fire-and-forget: routes rejection to `logger` (or console.error), passes sync results through untouched. */\n static voidExecution(opts: {\n logger?: ILogger;\n scope: string;\n execution: ValueOrPromise<unknown>;\n }): void {\n const { logger, scope, execution } = opts;\n\n if (!isPromiseLike(execution)) {\n return;\n }\n\n Promise.resolve(execution).catch((error: unknown) => {\n if (logger) {\n logger.for(scope).error('Unhandled error in fire-and-forget execution | Error: %s', error);\n\n return;\n }\n\n console.error('[%s] Unhandled error in fire-and-forget execution', scope, error);\n });\n }\n}\n"]}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { TConstValue } from '../common/types/index.js';
|
|
2
|
+
/** A request remark: `id`, `url` and `method`, plus any extra keys. */
|
|
2
3
|
export interface IRequestedRemark {
|
|
3
4
|
id: string;
|
|
4
5
|
url: string;
|
|
@@ -47,6 +48,7 @@ export declare class ContentDispositionTypes {
|
|
|
47
48
|
}
|
|
48
49
|
/** Valid Content-Disposition type values. */
|
|
49
50
|
export type TContentDispositionType = TConstValue<typeof ContentDispositionTypes>;
|
|
51
|
+
/** Multipart body parsing and `Content-Disposition` header building and parsing for requests and uploads. */
|
|
50
52
|
export declare class RequestUtility {
|
|
51
53
|
static parseMultipartBody<C extends {
|
|
52
54
|
req: any;
|
|
@@ -23,6 +23,7 @@ export class ContentDispositionTypes {
|
|
|
23
23
|
return this.SCHEME_SET.has(value);
|
|
24
24
|
}
|
|
25
25
|
}
|
|
26
|
+
/** Multipart body parsing and `Content-Disposition` header building and parsing for requests and uploads. */
|
|
26
27
|
export class RequestUtility {
|
|
27
28
|
static async parseMultipartBody(opts) {
|
|
28
29
|
const { storage = MultipartStorages.MEMORY, uploadDir = './uploads', context } = opts;
|