@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":"policy.js","sourceRoot":"","sources":["../../../../../../src/modules/network/utilities/url-safety/policy.ts"],"names":[],"mappings":"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","sourcesContent":["// The browser-pure half of the guard: a url and a literal address are decided with string and\n// number work alone. Resolving a hostname needs `node:dns` and lives in `ingest.ts`, which this\n// file must never import - `policy.ts` is re-exported from the `./core` subpath and is gated by\n// `make purity`.\n\nimport { getError } from '@/modules/error';\nimport { UrlSafetyDefaults, UrlSchemes } from './common/constants';\nimport { UrlSafetyErrors } from './common/errors';\nimport type { IUrlSafetyPolicy } from './common/types';\n\n/** Everything about a url that can be decided without touching the network. */\nexport class UrlPolicy {\n /** A dotted-quad that is not routable on the public internet. An unparseable input counts as non-public. */\n private static isNonPublicIPv4(opts: { address: string }): boolean {\n const parts = opts.address.split('.').map(Number);\n\n if (\n parts.length !== 4 ||\n parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)\n ) {\n return true;\n }\n\n const [first, second] = parts;\n\n return (\n first === 0 || // this host\n first === 10 || // private\n first === 127 || // loopback\n (first === 100 && second >= 64 && second <= 127) || // carrier-grade NAT\n (first === 169 && second === 254) || // link-local, and the cloud metadata address\n (first === 172 && second >= 16 && second <= 31) || // private\n (first === 192 && second === 0) || // IETF protocol assignments\n (first === 192 && second === 168) || // private\n (first === 198 && (second === 18 || second === 19)) || // benchmarking\n first >= 224 // multicast and reserved\n );\n }\n\n /**\n * An address that must never be reached with an untrusted url. Anything unrecognised answers\n * `true`: a guard that fails open on a string it cannot parse is not a guard.\n */\n static isNonPublicAddress(opts: { address: string }): boolean {\n const normalized = opts.address.toLowerCase().split('%')[0];\n\n if (!normalized.includes(':')) {\n return UrlPolicy.isNonPublicIPv4({ address: normalized });\n }\n\n // An IPv4 address wearing an IPv6 coat walks past every naive v6 check. Both spellings must be\n // unwrapped: `new URL` rewrites `::ffff:169.254.169.254` into the hex form `::ffff:a9fe:a9fe`,\n // so a dotted-quad-only check is green on a value the parser never actually produces.\n const dottedMapped = /^::ffff:(\\d+\\.\\d+\\.\\d+\\.\\d+)$/.exec(normalized)?.[1];\n if (dottedMapped) {\n return UrlPolicy.isNonPublicIPv4({ address: dottedMapped });\n }\n\n const hexMapped = /^::ffff:([\\da-f]{1,4}):([\\da-f]{1,4})$/.exec(normalized);\n if (hexMapped) {\n const high = Number.parseInt(hexMapped[1], 16);\n const low = Number.parseInt(hexMapped[2], 16);\n const dotted = [high >> 8, high & 0xff, low >> 8, low & 0xff].join('.');\n\n return UrlPolicy.isNonPublicIPv4({ address: dotted });\n }\n\n return (\n normalized === '::' ||\n normalized === '::1' ||\n normalized.startsWith('fc') || // unique local\n normalized.startsWith('fd') ||\n normalized.startsWith('fe8') || // link-local\n normalized.startsWith('fe9') ||\n normalized.startsWith('fea') ||\n normalized.startsWith('feb')\n );\n }\n\n /** A bracketed IPv6 literal arrives as `[::1]`; the brackets are not part of the address. */\n static readHostAddress(opts: { hostname: string }): string {\n const { hostname } = opts;\n return hostname.startsWith('[') && hostname.endsWith(']') ? hostname.slice(1, -1) : hostname;\n }\n\n /**\n * A hostname that RESOLVES to a private address passes here on purpose - `UrlIngest` catches that,\n * and this half runs where `node:dns` does not exist.\n */\n static assertSafeUrl(opts: { url: string; policy?: IUrlSafetyPolicy }): URL {\n const { url, policy } = opts;\n const allowedSchemes = policy?.allowedSchemes ?? UrlSafetyDefaults.ALLOWED_SCHEMES;\n const allowPrivateAddress =\n policy?.allowPrivateAddress ?? UrlSafetyDefaults.ALLOW_PRIVATE_ADDRESS;\n\n let parsed: URL;\n try {\n parsed = new URL(url);\n } catch {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Malformed url | url: ${url}`,\n });\n }\n\n if (!allowedSchemes.includes(parsed.protocol)) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Disallowed scheme | scheme: ${parsed.protocol} | allowed: ${allowedSchemes.join(', ')}`,\n });\n }\n\n if (policy?.allowedHosts && !policy.allowedHosts.includes(parsed.hostname)) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Host is not in the allow-list | host: ${parsed.hostname}`,\n });\n }\n\n const address = UrlPolicy.readHostAddress({ hostname: parsed.hostname });\n const isLiteralAddress = /^[\\d.]+$/.test(address) || address.includes(':');\n\n if (!allowPrivateAddress && isLiteralAddress && UrlPolicy.isNonPublicAddress({ address })) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Url points at a non-public address | address: ${address}`,\n });\n }\n\n return parsed;\n }\n\n /**\n * True when the url will never be allowed, whatever happens next: a bad scheme, a non-public\n * address, a host outside the allow-list, a malformed url, or too many hops. Retrying any of those\n * repeats the same rejection - drop the work instead.\n *\n * A timeout, a DNS failure or a 5xx answers `false`: those are worth another attempt.\n */\n static isRefusedError(opts: { error: unknown }): boolean {\n const source = opts.error as { normalized?: { code?: string } };\n return source?.normalized?.code === UrlSafetyErrors.URL_REFUSED.message.code;\n }\n}\n\nexport { UrlSafetyDefaults, UrlSchemes };\nexport type { IUrlSafetyPolicy };\n"]}
|
|
1
|
+
{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../../../../src/modules/network/utilities/url-safety/policy.ts"],"names":[],"mappings":"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","sourcesContent":["// The browser-pure half of the guard: a url and a literal address are decided with string and\n// number work alone. Resolving a hostname needs `node:dns` and lives in `ingest.ts`, which this\n// file must never import - `policy.ts` is re-exported from the `./core` subpath and is gated by\n// `make purity`.\n\nimport { getError } from '@/modules/error';\nimport { UrlSafetyDefaults, UrlSchemes } from './common/constants';\nimport { UrlSafetyErrors } from './common/errors';\nimport type { IUrlSafetyPolicy } from './common/types';\n\n/** Everything about a url that can be decided without touching the network. */\nexport class UrlPolicy {\n /** A dotted-quad that is not routable on the public internet. An unparseable input counts as non-public. */\n private static isNonPublicIPv4(opts: { address: string }): boolean {\n const parts = opts.address.split('.').map(Number);\n\n if (\n parts.length !== 4 ||\n parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)\n ) {\n return true;\n }\n\n const [first, second] = parts;\n\n return (\n first === 0 || // this host\n first === 10 || // private\n first === 127 || // loopback\n (first === 100 && second >= 64 && second <= 127) || // carrier-grade NAT\n (first === 169 && second === 254) || // link-local, and the cloud metadata address\n (first === 172 && second >= 16 && second <= 31) || // private\n (first === 192 && second === 0) || // IETF protocol assignments\n (first === 192 && second === 168) || // private\n (first === 198 && (second === 18 || second === 19)) || // benchmarking\n first >= 224 // multicast and reserved\n );\n }\n\n /**\n * An address that must never be reached with an untrusted url. Anything unrecognised answers\n * `true`: a guard that fails open on a string it cannot parse is not a guard.\n */\n static isNonPublicAddress(opts: { address: string }): boolean {\n const normalized = opts.address.toLowerCase().split('%')[0];\n\n if (!normalized.includes(':')) {\n return UrlPolicy.isNonPublicIPv4({ address: normalized });\n }\n\n // An IPv4 address wearing an IPv6 coat walks past every naive v6 check. Both spellings must be\n // unwrapped: `new URL` rewrites `::ffff:169.254.169.254` into the hex form `::ffff:a9fe:a9fe`,\n // so a dotted-quad-only check is green on a value the parser never actually produces.\n const dottedMapped = /^::ffff:(\\d+\\.\\d+\\.\\d+\\.\\d+)$/.exec(normalized)?.[1];\n\n if (dottedMapped) {\n return UrlPolicy.isNonPublicIPv4({ address: dottedMapped });\n }\n\n const hexMapped = /^::ffff:([\\da-f]{1,4}):([\\da-f]{1,4})$/.exec(normalized);\n\n if (hexMapped) {\n const high = Number.parseInt(hexMapped[1], 16);\n const low = Number.parseInt(hexMapped[2], 16);\n const dotted = [high >> 8, high & 0xff, low >> 8, low & 0xff].join('.');\n\n return UrlPolicy.isNonPublicIPv4({ address: dotted });\n }\n\n return (\n normalized === '::' ||\n normalized === '::1' ||\n normalized.startsWith('fc') || // unique local\n normalized.startsWith('fd') ||\n normalized.startsWith('fe8') || // link-local\n normalized.startsWith('fe9') ||\n normalized.startsWith('fea') ||\n normalized.startsWith('feb')\n );\n }\n\n /** A bracketed IPv6 literal arrives as `[::1]`; the brackets are not part of the address. */\n static readHostAddress(opts: { hostname: string }): string {\n const { hostname } = opts;\n\n return hostname.startsWith('[') && hostname.endsWith(']') ? hostname.slice(1, -1) : hostname;\n }\n\n /**\n * A hostname that RESOLVES to a private address passes here on purpose - `UrlIngest` catches that,\n * and this half runs where `node:dns` does not exist.\n */\n static assertSafeUrl(opts: { url: string; policy?: IUrlSafetyPolicy }): URL {\n const { url, policy } = opts;\n const allowedSchemes = policy?.allowedSchemes ?? UrlSafetyDefaults.ALLOWED_SCHEMES;\n const allowPrivateAddress =\n policy?.allowPrivateAddress ?? UrlSafetyDefaults.ALLOW_PRIVATE_ADDRESS;\n\n let parsed: URL;\n\n try {\n parsed = new URL(url);\n } catch {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Malformed url | url: ${url}`,\n });\n }\n\n if (!allowedSchemes.includes(parsed.protocol)) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Disallowed scheme | scheme: ${parsed.protocol} | allowed: ${allowedSchemes.join(', ')}`,\n });\n }\n\n if (policy?.allowedHosts && !policy.allowedHosts.includes(parsed.hostname)) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Host is not in the allow-list | host: ${parsed.hostname}`,\n });\n }\n\n const address = UrlPolicy.readHostAddress({ hostname: parsed.hostname });\n const isLiteralAddress = /^[\\d.]+$/.test(address) || address.includes(':');\n\n if (!allowPrivateAddress && isLiteralAddress && UrlPolicy.isNonPublicAddress({ address })) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertSafeUrl] Url points at a non-public address | address: ${address}`,\n });\n }\n\n return parsed;\n }\n\n /**\n * True when the url will never be allowed, whatever happens next: a bad scheme, a non-public\n * address, a host outside the allow-list, a malformed url, or too many hops. Retrying any of those\n * repeats the same rejection - drop the work instead.\n *\n * A timeout, a DNS failure or a 5xx answers `false`: those are worth another attempt.\n */\n static isRefusedError(opts: { error: unknown }): boolean {\n const source = opts.error as { normalized?: { code?: string } };\n\n return source?.normalized?.code === UrlSafetyErrors.URL_REFUSED.message.code;\n }\n}\n\nexport { UrlSafetyDefaults, UrlSchemes };\nexport type { IUrlSafetyPolicy };\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/modules/pool/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TNullable, type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { HfQueueHelper } from '@/modules/queue/internal/hf';\nimport { type IPool, type IPoolControlOptions, type IPoolStats, type IPoolWaiter } from './common';\n\n/** Single-borrower pool skeleton: subclasses override {@link create} (required) and optionally validateResource/resetResource/onDestroyResource. All resource-waiter pairing flows through ONE re-entrancy-guarded `dispatch()` loop; the waiter queue is {@link HfQueueHelper} - O(1), no shift/splice. */\nexport abstract class AbstractPoolHelper<T> extends BaseHelper implements IPool<T> {\n protected readonly size: number;\n protected readonly acquireTimeoutMs?: number;\n protected readonly maxWaitingClients?: number;\n\n private readonly idle: T[] = [];\n private readonly borrowed = new Set<T>();\n private readonly waiterQueue = new HfQueueHelper<IPoolWaiter<T>>();\n\n private total = 0; // live or being-created resources\n private isDispatching = false;\n private isDestroyed = false;\n\n constructor(opts: IPoolControlOptions) {\n super({ scope: opts.scope ?? 'BasePoolHelper' });\n this.size = opts.size;\n this.acquireTimeoutMs = opts.acquireTimeoutMs;\n this.maxWaitingClients = opts.maxWaitingClients;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Create one resource. Required. */\n protected abstract create(): ValueOrPromise<T>;\n\n /** Validate an idle resource just before hand-out; false → destroyed + replaced. Default: always valid. */\n protected validateResource(_opts: { resource: T }): ValueOrPromise<boolean> {\n return true;\n }\n\n /** Reset an idle resource before hand-out (e.g. clear state). Throw → resource discarded. Default: no-op. */\n protected resetResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n /** Tear down a resource being removed from the pool. Default: no-op. */\n protected onDestroyResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n getStats(): IPoolStats {\n return {\n size: this.size,\n available: this.idle.length,\n borrowed: this.borrowed.size,\n pending: this.waiterQueue.size,\n };\n }\n\n async acquire(): Promise<T> {\n if (this.isDestroyed) {\n throw getError({ message: '[acquire] Pool has been destroyed.' });\n }\n\n if (this.maxWaitingClients !== undefined && this.maxWaitingClients >= 0) {\n // Only reject when this acquire would actually have to WAIT: no idle resource and the pool at capacity. With a free/creatable resource the caller is served, so maxWaitingClients:0 means \"serve if available, never queue\" rather than \"reject everything\".\n const isWaitRequired = !this.idle.length && this.total >= this.size;\n\n if (isWaitRequired && this.waiterQueue.size >= this.maxWaitingClients) {\n throw getError({\n message: `[acquire] Too many waiting clients (>= ${this.maxWaitingClients}).`,\n });\n }\n }\n\n const promise = new Promise<T>((resolve, reject) => {\n const waiter: IPoolWaiter<T> = { resolve, reject, timer: null };\n const node = this.waiterQueue.enqueue({ value: waiter });\n\n if (this.acquireTimeoutMs !== undefined && this.acquireTimeoutMs >= 0) {\n waiter.timer = setTimeout(() => {\n this.waiterQueue.cancel({ node }); // O(1) — dispatch skips it when reached\n\n reject(\n getError({\n message: `[acquire] Acquire timed out after ${this.acquireTimeoutMs}ms.`,\n }),\n );\n }, this.acquireTimeoutMs);\n }\n });\n\n this.safeDispatch({ action: 'acquire' });\n return promise;\n }\n\n release(opts: { resource: T }): void {\n const { resource } = opts;\n const logger = this.logger.for(this.release.name);\n\n if (!this.borrowed.has(resource)) {\n logger.warn('Called with a foreign/already-released resource; ignoring.');\n return;\n }\n this.borrowed.delete(resource);\n\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch((error) => {\n logger.warn('destroyResource error on release: %s', error);\n });\n return;\n }\n\n this.idle.push(resource);\n this.safeDispatch({ action: 'release' });\n }\n\n async warmup(): Promise<void> {\n if (this.isDestroyed) {\n throw getError({ message: '[warmup] Pool has been destroyed.' });\n }\n\n // Create sequentially, re-checking the live `total` before each create so the `size` cap holds under concurrent warmup()/acquire(); createResource() bumps `total` synchronously, before its await, so a re-check observes in-flight creations from other callers - no overshoot.\n while (this.total < this.size) {\n const resource = await this.createResource();\n this.idle.push(resource);\n }\n\n this.safeDispatch({ action: 'warmup' });\n }\n\n async use<R>(opts: { execution: (resource: T) => ValueOrPromise<R> }): Promise<R> {\n const resource = await this.acquire();\n\n try {\n const result = await opts.execution(resource);\n this.release({ resource });\n return result;\n } catch (error) {\n this.logger\n .for(this.use.name)\n .error('execution threw → release skipped, force DISCARD | Error: %s', error);\n await this.discard({ resource });\n throw error;\n }\n }\n\n async discard(opts: { resource: T }): Promise<void> {\n const { resource } = opts;\n\n if (!this.borrowed.delete(resource)) {\n this.logger.for(this.discard.name).warn('Called with a non-borrowed resource; ignoring.');\n return;\n }\n\n await this.destroyResource({ resource });\n this.safeDispatch({ action: 'discard' });\n }\n\n async destroy(): Promise<void> {\n this.isDestroyed = true;\n\n const error = getError({ message: '[destroy] Pool destroyed while awaiting a resource.' });\n const draineds = this.waiterQueue.drain();\n for (const waiter of draineds) {\n this.clearWaiterTimer({ waiter });\n waiter.reject(error);\n }\n\n const toDestroy = this.idle.splice(0);\n await Promise.all(toDestroy.map((resource) => this.destroyResource({ resource })));\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n private async createResource(): Promise<T> {\n this.total += 1; // bump BEFORE await so concurrent dispatch/warmup see the in-flight create (no overshoot)\n\n try {\n const resource = await this.create();\n return resource;\n } catch (error) {\n this.total -= 1;\n this.logger\n .for(this.createResource.name)\n .error('Error creating pool resource | Error: %s', error);\n throw error;\n }\n }\n\n private async destroyResource(opts: { resource: T }): Promise<void> {\n this.total -= 1;\n\n try {\n await this.onDestroyResource(opts);\n } catch (error) {\n this.logger.for(this.destroyResource.name).warn('destroy hook threw: %s', error);\n }\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Fire-and-forget dispatch with logged rejection; shared by all dispatch call sites. */\n private safeDispatch(opts: { action: string }): void {\n this.dispatch().catch((error) => {\n this.logger\n .for(this.dispatch.name)\n .warn('dispatch error | action: %s | Error: %s', opts.action, error);\n });\n }\n\n /** Pair servable resources with waiting acquirers until the queue drains or the pool is exhausted. Re-entrancy-guarded so only one loop runs at a time. */\n private async dispatch() {\n if (this.isDispatching) {\n return;\n }\n\n this.isDispatching = true;\n\n try {\n while (this.waiterQueue.size > 0) {\n // Prefer a warm idle resource (LIFO) over creating a new one.\n if (this.idle.length > 0) {\n const resource = await this.takeIdleResource();\n if (resource === null) {\n continue; // bad idle resource was discarded → try the next one\n }\n\n if (!this.handToWaiter({ resource })) {\n return;\n }\n continue;\n }\n\n if (this.total < this.size) {\n await this.createAndHand();\n continue;\n }\n\n return;\n }\n } catch (error) {\n this.logger\n .for(this.dispatch.name)\n .error('[dispatch] Error while dispatching pool element | Error: %s', error);\n } finally {\n this.isDispatching = false;\n }\n }\n\n /** Pop an idle resource and validate+reset it; on ANY failure destroy it and return null (caller retries). */\n private async takeIdleResource(): Promise<T | null> {\n const resource = this.idle.pop() as T;\n const logger = this.logger.for(this.takeIdleResource.name);\n\n let isValid: boolean;\n try {\n const result = await this.validateResource({ resource });\n isValid = result;\n } catch (error) {\n // A throwing validate must NOT leak the popped candidate (it would corrupt `total` and can permanently starve the pool); treat it like an invalid resource - discard and retry.\n logger.warn('validate hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n return null;\n }\n\n if (!isValid) {\n await this.destroyResource({ resource });\n return null;\n }\n\n try {\n await this.resetResource({ resource });\n } catch (error) {\n logger.warn('reset hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n return null;\n }\n\n return resource;\n }\n\n /** Create a fresh resource and hand it to the next waiter; on create failure, reject that waiter. */\n private async createAndHand(): Promise<void> {\n let resource: T;\n try {\n const result = await this.createResource();\n resource = result;\n } catch (error) {\n this.takeNextWaiter()?.reject(error);\n return;\n }\n\n this.handToWaiter({ resource });\n }\n\n /** Give a ready resource to the next live waiter; returns false and parks it in idle if the waiter raced away (e.g. timed out during an await). */\n private handToWaiter(opts: { resource: T }): boolean {\n const { resource } = opts;\n\n // `destroy()` tears down what it can SEE - the waiter queue and the idle list. A resource whose create() was still in flight is in neither, so parking it in idle now would leave it alive with nothing left to reclaim it.\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch((error) => {\n this.logger\n .for(this.handToWaiter.name)\n .warn('destroyResource error on a resource created after destroy(): %s', error);\n });\n return false;\n }\n\n const waiter = this.takeNextWaiter();\n if (!waiter) {\n this.idle.push(resource);\n return false;\n }\n\n this.borrowed.add(resource);\n waiter.resolve(resource);\n return true;\n }\n\n /** Dequeue the next live waiter and disarm its acquire-timeout so it cannot fire after settlement. */\n private takeNextWaiter(): TNullable<IPoolWaiter<T>> {\n const waiter = this.waiterQueue.dequeue();\n if (waiter) {\n this.clearWaiterTimer({ waiter });\n }\n return waiter;\n }\n\n private clearWaiterTimer(opts: { waiter: IPoolWaiter<T> }): void {\n const { waiter } = opts;\n if (waiter.timer) {\n clearTimeout(waiter.timer);\n waiter.timer = null;\n }\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/modules/pool/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TNullable, type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { HfQueueHelper } from '@/modules/queue/internal/hf';\nimport { type IPool, type IPoolControlOptions, type IPoolStats, type IPoolWaiter } from './common';\n\n/** Single-borrower pool skeleton: subclasses override {@link create} (required) and optionally validateResource/resetResource/onDestroyResource. All resource-waiter pairing flows through ONE re-entrancy-guarded `dispatch()` loop; the waiter queue is {@link HfQueueHelper} - O(1), no shift/splice. */\nexport abstract class AbstractPoolHelper<T> extends BaseHelper implements IPool<T> {\n protected readonly size: number;\n protected readonly acquireTimeoutMs?: number;\n protected readonly maxWaitingClients?: number;\n\n private readonly idle: T[] = [];\n private readonly borrowed = new Set<T>();\n private readonly waiterQueue = new HfQueueHelper<IPoolWaiter<T>>();\n\n private total = 0; // live or being-created resources\n private isDispatching = false;\n private isDestroyed = false;\n\n constructor(opts: IPoolControlOptions) {\n super({ scope: opts.scope ?? 'BasePoolHelper' });\n this.size = opts.size;\n this.acquireTimeoutMs = opts.acquireTimeoutMs;\n this.maxWaitingClients = opts.maxWaitingClients;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Create one resource. Required. */\n protected abstract create(): ValueOrPromise<T>;\n\n /** Validate an idle resource just before hand-out; false → destroyed + replaced. Default: always valid. */\n protected validateResource(_opts: { resource: T }): ValueOrPromise<boolean> {\n return true;\n }\n\n /** Reset an idle resource before hand-out (e.g. clear state). Throw → resource discarded. Default: no-op. */\n protected resetResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n /** Tear down a resource being removed from the pool. Default: no-op. */\n protected onDestroyResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n getStats(): IPoolStats {\n return {\n size: this.size,\n available: this.idle.length,\n borrowed: this.borrowed.size,\n pending: this.waiterQueue.size,\n };\n }\n\n async acquire(): Promise<T> {\n if (this.isDestroyed) {\n throw getError({ message: '[acquire] Pool has been destroyed.' });\n }\n\n if (this.maxWaitingClients !== undefined && this.maxWaitingClients >= 0) {\n // Only reject when this acquire would actually have to WAIT: no idle resource and the pool at capacity. With a free/creatable resource the caller is served, so maxWaitingClients:0 means \"serve if available, never queue\" rather than \"reject everything\".\n const isWaitRequired = !this.idle.length && this.total >= this.size;\n\n if (isWaitRequired && this.waiterQueue.size >= this.maxWaitingClients) {\n throw getError({\n message: `[acquire] Too many waiting clients (>= ${this.maxWaitingClients}).`,\n });\n }\n }\n\n const promise = new Promise<T>((resolve, reject) => {\n const waiter: IPoolWaiter<T> = { resolve, reject, timer: null };\n const node = this.waiterQueue.enqueue({ value: waiter });\n\n if (this.acquireTimeoutMs !== undefined && this.acquireTimeoutMs >= 0) {\n waiter.timer = setTimeout(() => {\n this.waiterQueue.cancel({ node }); // O(1) — dispatch skips it when reached\n\n reject(\n getError({\n message: `[acquire] Acquire timed out after ${this.acquireTimeoutMs}ms.`,\n }),\n );\n }, this.acquireTimeoutMs);\n }\n });\n\n this.safeDispatch({ action: 'acquire' });\n\n return promise;\n }\n\n release(opts: { resource: T }): void {\n const { resource } = opts;\n const logger = this.logger.for(this.release.name);\n\n if (!this.borrowed.has(resource)) {\n logger.warn('Called with a foreign/already-released resource; ignoring.');\n\n return;\n }\n\n this.borrowed.delete(resource);\n\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch((error) => {\n logger.warn('destroyResource error on release: %s', error);\n });\n\n return;\n }\n\n this.idle.push(resource);\n this.safeDispatch({ action: 'release' });\n }\n\n async warmup(): Promise<void> {\n if (this.isDestroyed) {\n throw getError({ message: '[warmup] Pool has been destroyed.' });\n }\n\n // Create sequentially, re-checking the live `total` before each create so the `size` cap holds under concurrent warmup()/acquire(); createResource() bumps `total` synchronously, before its await, so a re-check observes in-flight creations from other callers - no overshoot.\n while (this.total < this.size) {\n const resource = await this.createResource();\n this.idle.push(resource);\n }\n\n this.safeDispatch({ action: 'warmup' });\n }\n\n async use<R>(opts: { execution: (resource: T) => ValueOrPromise<R> }): Promise<R> {\n const resource = await this.acquire();\n\n try {\n const result = await opts.execution(resource);\n this.release({ resource });\n\n return result;\n } catch (error) {\n this.logger\n .for(this.use.name)\n .error('execution threw → release skipped, force DISCARD | Error: %s', error);\n await this.discard({ resource });\n throw error;\n }\n }\n\n async discard(opts: { resource: T }): Promise<void> {\n const { resource } = opts;\n\n if (!this.borrowed.delete(resource)) {\n this.logger.for(this.discard.name).warn('Called with a non-borrowed resource; ignoring.');\n\n return;\n }\n\n await this.destroyResource({ resource });\n this.safeDispatch({ action: 'discard' });\n }\n\n async destroy(): Promise<void> {\n this.isDestroyed = true;\n\n const error = getError({ message: '[destroy] Pool destroyed while awaiting a resource.' });\n const draineds = this.waiterQueue.drain();\n\n for (const waiter of draineds) {\n this.clearWaiterTimer({ waiter });\n waiter.reject(error);\n }\n\n const toDestroy = this.idle.splice(0);\n await Promise.all(toDestroy.map((resource) => this.destroyResource({ resource })));\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n private async createResource(): Promise<T> {\n this.total += 1; // bump BEFORE await so concurrent dispatch/warmup see the in-flight create (no overshoot)\n\n try {\n const resource = await this.create();\n\n return resource;\n } catch (error) {\n this.total -= 1;\n this.logger\n .for(this.createResource.name)\n .error('Error creating pool resource | Error: %s', error);\n throw error;\n }\n }\n\n private async destroyResource(opts: { resource: T }): Promise<void> {\n this.total -= 1;\n\n try {\n await this.onDestroyResource(opts);\n } catch (error) {\n this.logger.for(this.destroyResource.name).warn('destroy hook threw: %s', error);\n }\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Fire-and-forget dispatch with logged rejection; shared by all dispatch call sites. */\n private safeDispatch(opts: { action: string }): void {\n this.dispatch().catch((error) => {\n this.logger\n .for(this.dispatch.name)\n .warn('dispatch error | action: %s | Error: %s', opts.action, error);\n });\n }\n\n /** Pair servable resources with waiting acquirers until the queue drains or the pool is exhausted. Re-entrancy-guarded so only one loop runs at a time. */\n private async dispatch() {\n if (this.isDispatching) {\n return;\n }\n\n this.isDispatching = true;\n\n try {\n while (this.waiterQueue.size > 0) {\n // Prefer a warm idle resource (LIFO) over creating a new one.\n if (this.idle.length > 0) {\n const resource = await this.takeIdleResource();\n\n if (resource === null) {\n continue; // bad idle resource was discarded → try the next one\n }\n\n if (!this.handToWaiter({ resource })) {\n return;\n }\n\n continue;\n }\n\n if (this.total < this.size) {\n await this.createAndHand();\n continue;\n }\n\n return;\n }\n } catch (error) {\n this.logger\n .for(this.dispatch.name)\n .error('[dispatch] Error while dispatching pool element | Error: %s', error);\n } finally {\n this.isDispatching = false;\n }\n }\n\n /** Pop an idle resource and validate+reset it; on ANY failure destroy it and return null (caller retries). */\n private async takeIdleResource(): Promise<T | null> {\n const resource = this.idle.pop() as T;\n const logger = this.logger.for(this.takeIdleResource.name);\n\n let isValid: boolean;\n\n try {\n const result = await this.validateResource({ resource });\n isValid = result;\n } catch (error) {\n // A throwing validate must NOT leak the popped candidate (it would corrupt `total` and can permanently starve the pool); treat it like an invalid resource - discard and retry.\n logger.warn('validate hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n\n return null;\n }\n\n if (!isValid) {\n await this.destroyResource({ resource });\n\n return null;\n }\n\n try {\n await this.resetResource({ resource });\n } catch (error) {\n logger.warn('reset hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n\n return null;\n }\n\n return resource;\n }\n\n /** Create a fresh resource and hand it to the next waiter; on create failure, reject that waiter. */\n private async createAndHand(): Promise<void> {\n let resource: T;\n\n try {\n const result = await this.createResource();\n resource = result;\n } catch (error) {\n this.takeNextWaiter()?.reject(error);\n\n return;\n }\n\n this.handToWaiter({ resource });\n }\n\n /** Give a ready resource to the next live waiter; returns false and parks it in idle if the waiter raced away (e.g. timed out during an await). */\n private handToWaiter(opts: { resource: T }): boolean {\n const { resource } = opts;\n\n // `destroy()` tears down what it can SEE - the waiter queue and the idle list. A resource whose create() was still in flight is in neither, so parking it in idle now would leave it alive with nothing left to reclaim it.\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch((error) => {\n this.logger\n .for(this.handToWaiter.name)\n .warn('destroyResource error on a resource created after destroy(): %s', error);\n });\n\n return false;\n }\n\n const waiter = this.takeNextWaiter();\n\n if (!waiter) {\n this.idle.push(resource);\n\n return false;\n }\n\n this.borrowed.add(resource);\n waiter.resolve(resource);\n\n return true;\n }\n\n /** Dequeue the next live waiter and disarm its acquire-timeout so it cannot fire after settlement. */\n private takeNextWaiter(): TNullable<IPoolWaiter<T>> {\n const waiter = this.waiterQueue.dequeue();\n\n if (waiter) {\n this.clearWaiterTimer({ waiter });\n }\n\n return waiter;\n }\n\n private clearWaiterTimer(opts: { waiter: IPoolWaiter<T> }): void {\n const { waiter } = opts;\n\n if (waiter.timer) {\n clearTimeout(waiter.timer);\n waiter.timer = null;\n }\n }\n}\n"]}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { type TNullable, type ValueOrPromise } from '../../../common/types/index.js';
|
|
2
|
+
/** Snapshot of a pool: `size` is its configured cap, `available` counts idle resources, `borrowed` those handed out, `pending` the queued acquirers. */
|
|
2
3
|
export interface IPoolStats {
|
|
3
4
|
size: number;
|
|
4
5
|
available: number;
|
|
@@ -35,7 +36,10 @@ export interface IPoolControlOptions {
|
|
|
35
36
|
acquireTimeoutMs?: number;
|
|
36
37
|
/** Max queued acquirers; omitted → unlimited. Exceeded → acquire() rejects (load-shed). */
|
|
37
38
|
maxWaitingClients?: number;
|
|
38
|
-
/**
|
|
39
|
+
/**
|
|
40
|
+
* Logger scope.
|
|
41
|
+
* @default 'BasePoolHelper'
|
|
42
|
+
*/
|
|
39
43
|
scope?: string;
|
|
40
44
|
}
|
|
41
45
|
/** Options for the callback-configured {@link BasePoolHelper}: control knobs plus resource lifecycle as callbacks (AbstractPoolHelper subclasses may instead override the protected hooks directly). */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/pool/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import { type TNullable, type ValueOrPromise } from '@/common/types';\n\nexport interface IPoolStats {\n size: number;\n available: number;\n borrowed: number;\n pending: number;\n}\n\n/** Public contract of an object pool (implemented by AbstractPoolHelper). */\nexport interface IPool<T> {\n /** Borrow a resource (creating/waiting as needed). Single-borrower until released/discarded. */\n acquire(): Promise<T>;\n\n /** Return a borrowed resource to the pool (or destroy it if the pool is being torn down). */\n release(opts: { resource: T }): void;\n\n /** acquire → run execution → release on success; on ANY error DISCARD (destroy) the resource + rethrow. */\n use<R>(opts: { execution: (resource: T) => ValueOrPromise<R> }): Promise<R>;\n\n /** Remove a borrowed resource from the pool and destroy it. */\n discard(opts: { resource: T }): Promise<void>;\n\n /** Pre-create resources up to `size` and place them idle. */\n warmup(): Promise<void>;\n\n /** Drain the pool: reject waiters, destroy idle resources, block new acquires. */\n destroy(): Promise<void>;\n getStats(): IPoolStats;\n}\n\n/** Sizing/timeout knobs shared by every pool (no resource-lifecycle callbacks). */\nexport interface IPoolControlOptions {\n /** Max number of resources the pool will hold/create. */\n size: number;\n /** Max ms to wait for a free resource; omitted → wait forever. */\n acquireTimeoutMs?: number;\n /** Max queued acquirers; omitted → unlimited. Exceeded → acquire() rejects (load-shed). */\n maxWaitingClients?: number;\n
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/pool/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import { type TNullable, type ValueOrPromise } from '@/common/types';\n\n/** Snapshot of a pool: `size` is its configured cap, `available` counts idle resources, `borrowed` those handed out, `pending` the queued acquirers. */\nexport interface IPoolStats {\n size: number;\n available: number;\n borrowed: number;\n pending: number;\n}\n\n/** Public contract of an object pool (implemented by AbstractPoolHelper). */\nexport interface IPool<T> {\n /** Borrow a resource (creating/waiting as needed). Single-borrower until released/discarded. */\n acquire(): Promise<T>;\n\n /** Return a borrowed resource to the pool (or destroy it if the pool is being torn down). */\n release(opts: { resource: T }): void;\n\n /** acquire → run execution → release on success; on ANY error DISCARD (destroy) the resource + rethrow. */\n use<R>(opts: { execution: (resource: T) => ValueOrPromise<R> }): Promise<R>;\n\n /** Remove a borrowed resource from the pool and destroy it. */\n discard(opts: { resource: T }): Promise<void>;\n\n /** Pre-create resources up to `size` and place them idle. */\n warmup(): Promise<void>;\n\n /** Drain the pool: reject waiters, destroy idle resources, block new acquires. */\n destroy(): Promise<void>;\n getStats(): IPoolStats;\n}\n\n/** Sizing/timeout knobs shared by every pool (no resource-lifecycle callbacks). */\nexport interface IPoolControlOptions {\n /** Max number of resources the pool will hold/create. */\n size: number;\n /** Max ms to wait for a free resource; omitted → wait forever. */\n acquireTimeoutMs?: number;\n /** Max queued acquirers; omitted → unlimited. Exceeded → acquire() rejects (load-shed). */\n maxWaitingClients?: number;\n /**\n * Logger scope.\n * @default 'BasePoolHelper'\n */\n scope?: string;\n}\n\n/** Options for the callback-configured {@link BasePoolHelper}: control knobs plus resource lifecycle as callbacks (AbstractPoolHelper subclasses may instead override the protected hooks directly). */\nexport interface IPoolOptions<T> extends IPoolControlOptions {\n /** Factory to create one resource. */\n create: () => ValueOrPromise<T>;\n\n /** Teardown on destroy()/discard()/validate-fail/reset-fail. */\n destroy?: (resource: T) => ValueOrPromise<void>;\n\n /** Checked when an idle resource is about to be handed out; false → destroyed + replaced. */\n validate?: (resource: T) => ValueOrPromise<boolean>;\n\n /** Run on an idle resource just before hand-out (e.g. clear state). Throw → resource discarded. */\n reset?: (resource: T) => ValueOrPromise<void>;\n}\n\n/** One queued acquirer. Cancellation/skip is owned by the FifoQueue; this only carries the settlers. */\nexport interface IPoolWaiter<T> {\n resolve: (resource: T) => void;\n reject: (error: unknown) => void;\n timer: TNullable<ReturnType<typeof setTimeout>>;\n}\n"]}
|
|
@@ -2,6 +2,7 @@ import { BaseHelper } from '../../base.js';
|
|
|
2
2
|
import { type IRedisHelper } from '../../redis/index.js';
|
|
3
3
|
import type { Job, Processor, Queue, QueueOptions, Worker, WorkerOptions } from 'bullmq';
|
|
4
4
|
import { type TBullQueueRole } from '../common/index.js';
|
|
5
|
+
/** Options for {@link BullMQHelper}. `role` decides whether a `Queue` or a `Worker` is built. */
|
|
5
6
|
export interface IBullMQOptions<TQueueElement = any, TQueueResult = any> {
|
|
6
7
|
queueName: string;
|
|
7
8
|
identifier: string;
|
|
@@ -9,7 +10,15 @@ export interface IBullMQOptions<TQueueElement = any, TQueueResult = any> {
|
|
|
9
10
|
redisConnection: IRedisHelper;
|
|
10
11
|
/** `bullmq` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. Omitted, it is loaded when a queue or worker is built. */
|
|
11
12
|
module?: typeof import('bullmq');
|
|
13
|
+
/**
|
|
14
|
+
* Worker concurrency.
|
|
15
|
+
* @default 1
|
|
16
|
+
*/
|
|
12
17
|
numberOfWorker?: number;
|
|
18
|
+
/**
|
|
19
|
+
* How long a worker holds a job's lock, in milliseconds.
|
|
20
|
+
* @default 90 * 60 * 1000
|
|
21
|
+
*/
|
|
13
22
|
lockDuration?: number;
|
|
14
23
|
/** Merged over the framework defaults, under the fields the helper owns (`connection`) - see `queueOptionsFor`. */
|
|
15
24
|
queueOptions?: Omit<QueueOptions, 'connection'>;
|
|
@@ -19,6 +28,10 @@ export interface IBullMQOptions<TQueueElement = any, TQueueResult = any> {
|
|
|
19
28
|
onWorkerDataCompleted?: (job: Job<TQueueElement, TQueueResult>, result: any) => Promise<void>;
|
|
20
29
|
onWorkerDataFail?: (job: Job<TQueueElement, TQueueResult> | undefined, error: Error) => Promise<void>;
|
|
21
30
|
}
|
|
31
|
+
/**
|
|
32
|
+
* Wraps a BullMQ `Queue` or `Worker` (per `role`) on one Redis connection.
|
|
33
|
+
* Worker concurrency is `numberOfWorker`; `lockDuration` is in milliseconds.
|
|
34
|
+
*/
|
|
22
35
|
export declare class BullMQHelper<TQueueElement = any, TQueueResult = any> extends BaseHelper {
|
|
23
36
|
protected queueName: string;
|
|
24
37
|
protected role: TBullQueueRole;
|
|
@@ -3,6 +3,10 @@ import { getError } from '../../error/index.js';
|
|
|
3
3
|
import { ErrorUtility } from '../../../utilities/error.utility.js';
|
|
4
4
|
import { ModuleUtility } from '../../../utilities/module.utility.js';
|
|
5
5
|
import { HookUtility } from '../common/index.js';
|
|
6
|
+
/**
|
|
7
|
+
* Wraps a BullMQ `Queue` or `Worker` (per `role`) on one Redis connection.
|
|
8
|
+
* Worker concurrency is `numberOfWorker`; `lockDuration` is in milliseconds.
|
|
9
|
+
*/
|
|
6
10
|
export class BullMQHelper extends BaseHelper {
|
|
7
11
|
constructor(options) {
|
|
8
12
|
super({ scope: BullMQHelper.name, identifier: options.identifier });
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/bullmq/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { type IRedisHelper } from '@/modules/redis';\nimport { ErrorUtility } from '@/utilities/error.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Job, Processor, Queue, QueueOptions, Worker, WorkerOptions } from 'bullmq';\nimport { HookUtility, type TBullQueueRole } from '../common';\n\nexport interface IBullMQOptions<TQueueElement = any, TQueueResult = any> {\n queueName: string;\n identifier: string;\n role: TBullQueueRole;\n redisConnection: IRedisHelper;\n\n /** `bullmq` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. Omitted, it is loaded when a queue or worker is built. */\n module?: typeof import('bullmq');\n\n numberOfWorker?: number;\n lockDuration?: number;\n\n /** Merged over the framework defaults, under the fields the helper owns (`connection`) - see `queueOptionsFor`. */\n queueOptions?: Omit<QueueOptions, 'connection'>;\n /** Merged under the fields the helper owns (`connection`, `concurrency`, `lockDuration`) - see `workerOptionsFor`. */\n workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n onWorkerDataCompleted?: (job: Job<TQueueElement, TQueueResult>, result: any) => Promise<void>;\n onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n}\n\nexport class BullMQHelper<TQueueElement = any, TQueueResult = any> extends BaseHelper {\n protected queueName: string;\n protected role: TBullQueueRole;\n protected redisConnection: IRedisHelper;\n\n queue: Queue<TQueueElement, TQueueResult>;\n worker: Worker<TQueueElement, TQueueResult>;\n\n protected numberOfWorker = 1;\n protected lockDuration = 90 * 60 * 1000;\n\n protected queueOptions?: Omit<QueueOptions, 'connection'>;\n protected workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n protected onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n protected onWorkerDataCompleted?: (\n job: Job<TQueueElement, TQueueResult>,\n result: any,\n ) => Promise<void>;\n protected onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n\n private readonly bullmqModule?: typeof import('bullmq');\n\n constructor(options: IBullMQOptions<TQueueElement, TQueueResult>) {\n super({ scope: BullMQHelper.name, identifier: options.identifier });\n const {\n queueName,\n redisConnection,\n role,\n numberOfWorker = 1,\n lockDuration = 90 * 60 * 1000,\n queueOptions,\n workerOptions,\n onWorkerData,\n onWorkerDataCompleted,\n onWorkerDataFail,\n module,\n } = options;\n\n this.bullmqModule = module;\n\n this.queueName = queueName;\n this.role = role;\n this.redisConnection = redisConnection;\n\n this.numberOfWorker = numberOfWorker;\n this.lockDuration = lockDuration;\n\n this.queueOptions = queueOptions;\n this.workerOptions = workerOptions;\n\n this.onWorkerData = onWorkerData;\n this.onWorkerDataCompleted = onWorkerDataCompleted;\n this.onWorkerDataFail = onWorkerDataFail;\n\n this.configure();\n }\n\n static newInstance<T = any, R = any>(opts: IBullMQOptions<T, R>) {\n return new BullMQHelper<T, R>(opts);\n }\n\n /** Structural, never `instanceof`: ioredis is an optional peer, and a second copy fails `instanceof` anyway. */\n protected isClusterClient(): boolean {\n const client = Object(this.redisConnection.getClient());\n\n if (Reflect.get(client, 'isCluster') === true) {\n return true;\n }\n\n return typeof Reflect.get(client, 'nodes') === 'function';\n }\n\n protected resolveQueueName(): string {\n if (this.isClusterClient() && !this.queueName.startsWith('{')) {\n return `{${this.queueName}}`;\n }\n\n return this.queueName;\n }\n\n configureQueue() {\n if (!this.queueName) {\n this.logger\n .for(this.configureQueue.name)\n .error('Invalid queue name | ID: %s', this.identifier);\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.queue = this.buildQueue({ queueName });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.queue.on('error', (error) => {\n this.logger\n .for('queue-error')\n .error(\n 'queue: %s | Queue error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n /** Full `Queue` options: framework defaults, then `this.queueOptions`, then the connection the helper owns - in that precedence order. */\n protected queueOptionsFor(opts: { queueName: string }): QueueOptions {\n this.logger\n .for(this.queueOptionsFor.name)\n .debug('Building queue options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n defaultJobOptions: {\n removeOnComplete: true,\n removeOnFail: true,\n },\n ...this.queueOptions,\n connection: this.redisConnection.duplicateClient(),\n };\n }\n\n /** Full `Worker` options: `this.workerOptions`, then the connection/concurrency/lock fields the helper owns - in that precedence order. */\n protected workerOptionsFor(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): WorkerOptions {\n this.logger\n .for(this.workerOptionsFor.name)\n .debug('Building worker options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n ...this.workerOptions,\n connection: this.redisConnection.duplicateClient(),\n concurrency: this.numberOfWorker,\n lockDuration: this.lockDuration,\n };\n }\n\n /** `bullmq` is an optional peer: loaded when a queue or worker is built, not when this module is. */\n private loadBullMQ(): typeof import('bullmq') {\n return (\n this.bullmqModule ?? ModuleUtility.loadSync<typeof import('bullmq')>({ module: 'bullmq' })\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildQueue(opts: { queueName: string }): Queue<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n return new bullmq.Queue<TQueueElement, TQueueResult>(\n opts.queueName,\n this.queueOptionsFor(opts),\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildWorker(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): Worker<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n return new bullmq.Worker<TQueueElement, TQueueResult>(\n opts.queueName,\n opts.processor,\n this.workerOptionsFor(opts),\n );\n }\n\n configureWorker() {\n if (!this.queueName) {\n this.logger\n .for(this.configureWorker.name)\n .error('Invalid worker name | ID: %s', this.identifier);\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.worker = this.buildWorker({\n queueName,\n processor: async (job) => {\n if (this.onWorkerData) {\n const result = await this.onWorkerData(job);\n return result;\n }\n\n const { id, name, data } = job;\n this.logger\n .for('onWorkerData')\n .info(\n 'queue: %s | id: %s | name: %s | data: %j | ID: %s',\n this.queueName,\n id,\n name,\n data,\n this.identifier,\n );\n\n return undefined as TQueueResult;\n },\n });\n\n this.worker.on('completed', (job, result) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'worker-completed',\n execution: () => this.onWorkerDataCompleted?.(job, result),\n });\n });\n\n this.worker.on('failed', (job, reason) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'worker-failed',\n execution: () => this.onWorkerDataFail?.(job, reason),\n });\n });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.worker.on('error', (error) => {\n this.logger\n .for('worker-error')\n .error(\n 'queue: %s | Worker error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n configure() {\n if (!this.role) {\n this.logger\n .for(this.configure.name)\n .error(\n 'Invalid client role to configure | Valid roles: [queue|worker] | ID: %s',\n this.identifier,\n );\n return;\n }\n\n switch (this.role) {\n case 'queue': {\n this.configureQueue();\n break;\n }\n case 'worker': {\n this.configureWorker();\n break;\n }\n }\n }\n\n async close() {\n const failures: string[] = [];\n\n // Both connections must be released even when the first close fails - otherwise a failing worker close silently leaks the queue's Redis connection forever.\n try {\n await this.worker?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ worker: %s | ID: %s', error, this.identifier);\n failures.push(ErrorUtility.toError({ error }).message);\n }\n\n try {\n await this.queue?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ queue: %s | ID: %s', error, this.identifier);\n failures.push(ErrorUtility.toError({ error }).message);\n }\n\n if (failures.length) {\n throw getError({\n message: `[close][${this.identifier}] Failed to close BullMQ helper | Errors: ${failures.join(' | ')}`,\n });\n }\n\n this.logger\n .for(this.close.name)\n .info('BullMQ helper closed successfully | ID: %s', this.identifier);\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/bullmq/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { type IRedisHelper } from '@/modules/redis';\nimport { ErrorUtility } from '@/utilities/error.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Job, Processor, Queue, QueueOptions, Worker, WorkerOptions } from 'bullmq';\nimport { HookUtility, type TBullQueueRole } from '../common';\n\n/** Options for {@link BullMQHelper}. `role` decides whether a `Queue` or a `Worker` is built. */\nexport interface IBullMQOptions<TQueueElement = any, TQueueResult = any> {\n queueName: string;\n identifier: string;\n role: TBullQueueRole;\n redisConnection: IRedisHelper;\n\n /** `bullmq` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. Omitted, it is loaded when a queue or worker is built. */\n module?: typeof import('bullmq');\n\n /**\n * Worker concurrency.\n * @default 1\n */\n numberOfWorker?: number;\n /**\n * How long a worker holds a job's lock, in milliseconds.\n * @default 90 * 60 * 1000\n */\n lockDuration?: number;\n\n /** Merged over the framework defaults, under the fields the helper owns (`connection`) - see `queueOptionsFor`. */\n queueOptions?: Omit<QueueOptions, 'connection'>;\n /** Merged under the fields the helper owns (`connection`, `concurrency`, `lockDuration`) - see `workerOptionsFor`. */\n workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n onWorkerDataCompleted?: (job: Job<TQueueElement, TQueueResult>, result: any) => Promise<void>;\n onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n}\n\n/**\n * Wraps a BullMQ `Queue` or `Worker` (per `role`) on one Redis connection.\n * Worker concurrency is `numberOfWorker`; `lockDuration` is in milliseconds.\n */\nexport class BullMQHelper<TQueueElement = any, TQueueResult = any> extends BaseHelper {\n protected queueName: string;\n protected role: TBullQueueRole;\n protected redisConnection: IRedisHelper;\n\n queue: Queue<TQueueElement, TQueueResult>;\n worker: Worker<TQueueElement, TQueueResult>;\n\n protected numberOfWorker = 1;\n protected lockDuration = 90 * 60 * 1000;\n\n protected queueOptions?: Omit<QueueOptions, 'connection'>;\n protected workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n protected onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n protected onWorkerDataCompleted?: (\n job: Job<TQueueElement, TQueueResult>,\n result: any,\n ) => Promise<void>;\n\n protected onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n\n private readonly bullmqModule?: typeof import('bullmq');\n\n constructor(options: IBullMQOptions<TQueueElement, TQueueResult>) {\n super({ scope: BullMQHelper.name, identifier: options.identifier });\n const {\n queueName,\n redisConnection,\n role,\n numberOfWorker = 1,\n lockDuration = 90 * 60 * 1000,\n queueOptions,\n workerOptions,\n onWorkerData,\n onWorkerDataCompleted,\n onWorkerDataFail,\n module,\n } = options;\n\n this.bullmqModule = module;\n\n this.queueName = queueName;\n this.role = role;\n this.redisConnection = redisConnection;\n\n this.numberOfWorker = numberOfWorker;\n this.lockDuration = lockDuration;\n\n this.queueOptions = queueOptions;\n this.workerOptions = workerOptions;\n\n this.onWorkerData = onWorkerData;\n this.onWorkerDataCompleted = onWorkerDataCompleted;\n this.onWorkerDataFail = onWorkerDataFail;\n\n this.configure();\n }\n\n static newInstance<T = any, R = any>(opts: IBullMQOptions<T, R>) {\n return new BullMQHelper<T, R>(opts);\n }\n\n /** Structural, never `instanceof`: ioredis is an optional peer, and a second copy fails `instanceof` anyway. */\n protected isClusterClient(): boolean {\n const client = Object(this.redisConnection.getClient());\n\n if (Reflect.get(client, 'isCluster') === true) {\n return true;\n }\n\n return typeof Reflect.get(client, 'nodes') === 'function';\n }\n\n protected resolveQueueName(): string {\n if (this.isClusterClient() && !this.queueName.startsWith('{')) {\n return `{${this.queueName}}`;\n }\n\n return this.queueName;\n }\n\n configureQueue() {\n if (!this.queueName) {\n this.logger\n .for(this.configureQueue.name)\n .error('Invalid queue name | ID: %s', this.identifier);\n\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.queue = this.buildQueue({ queueName });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.queue.on('error', (error) => {\n this.logger\n .for('queue-error')\n .error(\n 'queue: %s | Queue error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n /** Full `Queue` options: framework defaults, then `this.queueOptions`, then the connection the helper owns - in that precedence order. */\n protected queueOptionsFor(opts: { queueName: string }): QueueOptions {\n this.logger\n .for(this.queueOptionsFor.name)\n .debug('Building queue options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n defaultJobOptions: {\n removeOnComplete: true,\n removeOnFail: true,\n },\n ...this.queueOptions,\n connection: this.redisConnection.duplicateClient(),\n };\n }\n\n /** Full `Worker` options: `this.workerOptions`, then the connection/concurrency/lock fields the helper owns - in that precedence order. */\n protected workerOptionsFor(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): WorkerOptions {\n this.logger\n .for(this.workerOptionsFor.name)\n .debug('Building worker options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n ...this.workerOptions,\n connection: this.redisConnection.duplicateClient(),\n concurrency: this.numberOfWorker,\n lockDuration: this.lockDuration,\n };\n }\n\n /** `bullmq` is an optional peer: loaded when a queue or worker is built, not when this module is. */\n private loadBullMQ(): typeof import('bullmq') {\n return (\n this.bullmqModule ?? ModuleUtility.loadSync<typeof import('bullmq')>({ module: 'bullmq' })\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildQueue(opts: { queueName: string }): Queue<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n\n return new bullmq.Queue<TQueueElement, TQueueResult>(\n opts.queueName,\n this.queueOptionsFor(opts),\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildWorker(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): Worker<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n\n return new bullmq.Worker<TQueueElement, TQueueResult>(\n opts.queueName,\n opts.processor,\n this.workerOptionsFor(opts),\n );\n }\n\n configureWorker() {\n if (!this.queueName) {\n this.logger\n .for(this.configureWorker.name)\n .error('Invalid worker name | ID: %s', this.identifier);\n\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.worker = this.buildWorker({\n queueName,\n processor: async (job) => {\n if (this.onWorkerData) {\n const result = await this.onWorkerData(job);\n\n return result;\n }\n\n const { id, name, data } = job;\n this.logger\n .for('onWorkerData')\n .info(\n 'queue: %s | id: %s | name: %s | data: %j | ID: %s',\n this.queueName,\n id,\n name,\n data,\n this.identifier,\n );\n\n return undefined as TQueueResult;\n },\n });\n\n this.worker.on('completed', (job, result) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'worker-completed',\n execution: () => this.onWorkerDataCompleted?.(job, result),\n });\n });\n\n this.worker.on('failed', (job, reason) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'worker-failed',\n execution: () => this.onWorkerDataFail?.(job, reason),\n });\n });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.worker.on('error', (error) => {\n this.logger\n .for('worker-error')\n .error(\n 'queue: %s | Worker error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n configure() {\n if (!this.role) {\n this.logger\n .for(this.configure.name)\n .error(\n 'Invalid client role to configure | Valid roles: [queue|worker] | ID: %s',\n this.identifier,\n );\n\n return;\n }\n\n switch (this.role) {\n case 'queue': {\n this.configureQueue();\n break;\n }\n case 'worker': {\n this.configureWorker();\n break;\n }\n }\n }\n\n async close() {\n const failures: string[] = [];\n\n // Both connections must be released even when the first close fails - otherwise a failing worker close silently leaks the queue's Redis connection forever.\n try {\n await this.worker?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ worker: %s | ID: %s', error, this.identifier);\n failures.push(ErrorUtility.toError({ error }).message);\n }\n\n try {\n await this.queue?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ queue: %s | ID: %s', error, this.identifier);\n failures.push(ErrorUtility.toError({ error }).message);\n }\n\n if (failures.length) {\n throw getError({\n message: `[close][${this.identifier}] Failed to close BullMQ helper | Errors: ${failures.join(' | ')}`,\n });\n }\n\n this.logger\n .for(this.close.name)\n .info('BullMQ helper closed successfully | ID: %s', this.identifier);\n }\n}\n"]}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type ValueOrPromise } from '../../../common/types/index.js';
|
|
2
2
|
import type { ILogger } from '../../logger/index.js';
|
|
3
|
+
/** Runs user-supplied hooks so a throw or rejection is logged and never breaks the caller. */
|
|
3
4
|
export declare class HookUtility {
|
|
4
5
|
/** Fire-and-forget a hook from inside an event listener. Takes a thunk because `PromiseUtility.voidExecution` takes a VALUE - a synchronous throw would escape the guard and, inside an emitter callback, take the process down. Rejections still route to the logger. */
|
|
5
6
|
static invoke(opts: {
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { PromiseUtility } from '../../../utilities/promise.utility.js';
|
|
2
|
+
/** Runs user-supplied hooks so a throw or rejection is logged and never breaks the caller. */
|
|
2
3
|
export class HookUtility {
|
|
3
4
|
/** Fire-and-forget a hook from inside an event listener. Takes a thunk because `PromiseUtility.voidExecution` takes a VALUE - a synchronous throw would escape the guard and, inside an emitter callback, take the process down. Rejections still route to the logger. */
|
|
4
5
|
static invoke(opts) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../../../src/modules/queue/common/hook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,OAAO,WAAW;IACtB,0QAA0Q;IAC1Q,MAAM,CAAC,MAAM,CAAC,IAIb;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC;YACH,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,oHAAoH;IACpH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAIpB;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,SAAS,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;CACF","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport type { ILogger } from '@/modules/logger';\nimport { PromiseUtility } from '@/utilities/promise.utility';\n\nexport class HookUtility {\n /** Fire-and-forget a hook from inside an event listener. Takes a thunk because `PromiseUtility.voidExecution` takes a VALUE - a synchronous throw would escape the guard and, inside an emitter callback, take the process down. Rejections still route to the logger. */\n static invoke(opts: {\n logger: ILogger;\n scope: string;\n execution: () => ValueOrPromise<unknown>;\n }): void {\n const { logger, scope, execution } = opts;\n\n try {\n PromiseUtility.voidExecution({ logger, scope, execution: execution() });\n } catch (error) {\n logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n /** Await a user-supplied hook, absorbing sync throws and rejections without breaking the caller's state machine. */\n static async execute(opts: {\n logger: ILogger;\n scope: string;\n execution: () => ValueOrPromise<unknown>;\n }): Promise<void> {\n const { logger, scope, execution } = opts;\n\n try {\n await execution();\n } catch (error) {\n logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../../../src/modules/queue/common/hook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,8FAA8F;AAC9F,MAAM,OAAO,WAAW;IACtB,0QAA0Q;IAC1Q,MAAM,CAAC,MAAM,CAAC,IAIb;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC;YACH,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,oHAAoH;IACpH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAIpB;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,SAAS,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;CACF","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport type { ILogger } from '@/modules/logger';\nimport { PromiseUtility } from '@/utilities/promise.utility';\n\n/** Runs user-supplied hooks so a throw or rejection is logged and never breaks the caller. */\nexport class HookUtility {\n /** Fire-and-forget a hook from inside an event listener. Takes a thunk because `PromiseUtility.voidExecution` takes a VALUE - a synchronous throw would escape the guard and, inside an emitter callback, take the process down. Rejections still route to the logger. */\n static invoke(opts: {\n logger: ILogger;\n scope: string;\n execution: () => ValueOrPromise<unknown>;\n }): void {\n const { logger, scope, execution } = opts;\n\n try {\n PromiseUtility.voidExecution({ logger, scope, execution: execution() });\n } catch (error) {\n logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n /** Await a user-supplied hook, absorbing sync throws and rejections without breaking the caller's state machine. */\n static async execute(opts: {\n logger: ILogger;\n scope: string;\n execution: () => ValueOrPromise<unknown>;\n }): Promise<void> {\n const { logger, scope, execution } = opts;\n\n try {\n await execution();\n } catch (error) {\n logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/internal/hf/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,oRAAoR;AACpR,MAAM,OAAO,aAAiB,SAAQ,UAAU;IAM9C,mEAAmE;aAC3C,sBAAiB,GAAG,GAAG,AAAN,CAAO;IAEhD,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;QATrC,UAAK,GAAsB,EAAE,CAAC;QAEvC,SAAI,GAAG,CAAC,CAAC,CAAC,qCAAqC;QAC/C,cAAS,GAAG,CAAC,CAAC,CAAC,oCAAoC;IAO3D,CAAC;IAED,wEAAwE;IACxE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,+EAA+E;IAC/E,OAAO,CAAC,IAAkB;QACxB,MAAM,IAAI,GAAoB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QACxE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/internal/hf/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TNullable } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { type IHfQueueNode } from './common';\n\n/** High-frequency, single-consumer FIFO queue with O(1) enqueue/dequeue/cancel: an array plus a moving head index (no `Array.shift()`, which is O(n)), cancellation flags the node instead of splicing, and the consumed prefix is compacted only occasionally. Not thread-safe. */\nexport class HfQueueHelper<T> extends BaseHelper {\n private readonly nodes: IHfQueueNode<T>[] = [];\n\n private head = 0; // index of the next node to consider\n private liveCount = 0; // enqueued − (dequeued + cancelled)\n\n // Reclaim the consumed prefix once it dominates the backing array.\n private static readonly COMPACT_THRESHOLD = 256;\n\n constructor(opts?: { scope?: string }) {\n super({ scope: opts?.scope ?? HfQueueHelper.name });\n }\n\n /** Number of live entries (enqueued, not yet dequeued or cancelled). */\n get size(): number {\n return this.liveCount;\n }\n\n /** Append a value and return a node handle usable to cancel it later. O(1). */\n enqueue(opts: { value: T }): IHfQueueNode<T> {\n const node: IHfQueueNode<T> = { value: opts.value, isCancelled: false };\n this.nodes.push(node);\n\n this.liveCount += 1;\n\n return node;\n }\n\n /** Remove + return the next live value in FIFO order, skipping cancelled nodes. Null when empty. */\n dequeue(): TNullable<T> {\n while (this.head < this.nodes.length && this.nodes[this.head].isCancelled) {\n this.head += 1;\n }\n\n if (this.head >= this.nodes.length) {\n // fully drained → cheap reset\n this.reset();\n\n return null;\n }\n\n const node = this.nodes[this.head];\n\n this.head += 1;\n this.liveCount -= 1;\n node.isCancelled = true; // mark consumed so a late cancel() of this node is a no-op\n\n if (this.head > HfQueueHelper.COMPACT_THRESHOLD && this.head * 2 >= this.nodes.length) {\n this.nodes.splice(0, this.head);\n this.head = 0;\n }\n\n return node.value;\n }\n\n /** Mark a still-queued node cancelled so {@link dequeue} and {@link size} skip it. Idempotent. O(1). */\n cancel(opts: { node: IHfQueueNode<T> }): void {\n if (opts.node.isCancelled) {\n return;\n }\n\n opts.node.isCancelled = true;\n this.liveCount -= 1;\n }\n\n /** Remove and return every remaining LIVE value in FIFO order (e.g. on shutdown), emptying the queue. */\n drain(): T[] {\n const values: T[] = [];\n\n for (let index = this.head; index < this.nodes.length; index += 1) {\n const node = this.nodes[index];\n\n if (!node.isCancelled) {\n values.push(node.value);\n node.isCancelled = true; // mark consumed so a late cancel() of this node is a no-op, as in dequeue()\n }\n }\n\n this.reset();\n\n return values;\n }\n\n private reset(): void {\n this.nodes.length = 0;\n this.head = 0;\n this.liveCount = 0;\n }\n}\n"]}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { type ValueOf, type ValueOrPromise } from '../../../../../common/types/index.js';
|
|
2
|
+
/** Lifecycle states of a sequential queue; the numeric prefix orders them. */
|
|
2
3
|
export declare class QueueStatuses {
|
|
3
4
|
static readonly WAITING = "000_WAITING";
|
|
4
5
|
static readonly PROCESSING = "100_PROCESSING";
|
|
@@ -7,12 +8,19 @@ export declare class QueueStatuses {
|
|
|
7
8
|
static readonly SCHEME_SET: Set<string>;
|
|
8
9
|
static isValid(scheme: string): boolean;
|
|
9
10
|
}
|
|
11
|
+
/** A {@link QueueStatuses} value. */
|
|
10
12
|
export type TQueueStatus = ValueOf<Omit<typeof QueueStatuses, 'isValid' | 'SCHEME_SET'>>;
|
|
13
|
+
/** One queued item: `payload`, plus `isLocked` while a handler holds it. */
|
|
11
14
|
export type TQueueElement<T> = {
|
|
12
15
|
isLocked: boolean;
|
|
13
16
|
payload: T;
|
|
14
17
|
};
|
|
18
|
+
/** Hooks of a sequential queue. */
|
|
15
19
|
export interface IQueueCallback<TElementPayload> {
|
|
20
|
+
/**
|
|
21
|
+
* Whether {@link SequentialQueueHelper} dispatches an element on its own.
|
|
22
|
+
* @default true
|
|
23
|
+
*/
|
|
16
24
|
autoDispatch?: boolean;
|
|
17
25
|
onMessage?: (opts: {
|
|
18
26
|
identifier: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/internal/sequential/common/types.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;aACR,YAAO,GAAG,aAAa,CAAC;aACxB,eAAU,GAAG,gBAAgB,CAAC;aAC9B,WAAM,GAAG,YAAY,CAAC;aACtB,YAAO,GAAG,aAAa,CAAC;aAExB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjG,MAAM,CAAC,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC","sourcesContent":["import { type ValueOf, type ValueOrPromise } from '@/common/types';\n\nexport class QueueStatuses {\n static readonly WAITING = '000_WAITING';\n static readonly PROCESSING = '100_PROCESSING';\n static readonly LOCKED = '200_LOCKED';\n static readonly SETTLED = '300_SETTLED';\n\n static readonly SCHEME_SET = new Set([this.WAITING, this.PROCESSING, this.LOCKED, this.SETTLED]);\n\n static isValid(scheme: string): boolean {\n return this.SCHEME_SET.has(scheme);\n }\n}\n\nexport type TQueueStatus = ValueOf<Omit<typeof QueueStatuses, 'isValid' | 'SCHEME_SET'>>;\nexport type TQueueElement<T> = { isLocked: boolean; payload: T };\n\nexport interface IQueueCallback<TElementPayload> {\n autoDispatch?: boolean;\n\n onMessage?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n onDataEnqueue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n onDataDequeue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n onStateChange?: (opts: {\n identifier: string;\n from: TQueueStatus;\n to: TQueueStatus;\n }) => ValueOrPromise<void>;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/internal/sequential/common/types.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,OAAO,aAAa;aACR,YAAO,GAAG,aAAa,CAAC;aACxB,eAAU,GAAG,gBAAgB,CAAC;aAC9B,WAAM,GAAG,YAAY,CAAC;aACtB,YAAO,GAAG,aAAa,CAAC;aAExB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjG,MAAM,CAAC,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC","sourcesContent":["import { type ValueOf, type ValueOrPromise } from '@/common/types';\n\n/** Lifecycle states of a sequential queue; the numeric prefix orders them. */\nexport class QueueStatuses {\n static readonly WAITING = '000_WAITING';\n static readonly PROCESSING = '100_PROCESSING';\n static readonly LOCKED = '200_LOCKED';\n static readonly SETTLED = '300_SETTLED';\n\n static readonly SCHEME_SET = new Set([this.WAITING, this.PROCESSING, this.LOCKED, this.SETTLED]);\n\n static isValid(scheme: string): boolean {\n return this.SCHEME_SET.has(scheme);\n }\n}\n\n/** A {@link QueueStatuses} value. */\nexport type TQueueStatus = ValueOf<Omit<typeof QueueStatuses, 'isValid' | 'SCHEME_SET'>>;\n/** One queued item: `payload`, plus `isLocked` while a handler holds it. */\nexport type TQueueElement<T> = { isLocked: boolean; payload: T };\n\n/** Hooks of a sequential queue. */\nexport interface IQueueCallback<TElementPayload> {\n /**\n * Whether {@link SequentialQueueHelper} dispatches an element on its own.\n * @default true\n */\n autoDispatch?: boolean;\n\n onMessage?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n onDataEnqueue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n onDataDequeue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n onStateChange?: (opts: {\n identifier: string;\n from: TQueueStatus;\n to: TQueueStatus;\n }) => ValueOrPromise<void>;\n}\n"]}
|
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
import { BaseHelper } from '../../../base.js';
|
|
2
2
|
import { type IQueueCallback, type TQueueElement, type TQueueStatus } from './common/index.js';
|
|
3
|
+
/**
|
|
4
|
+
* In-memory FIFO queue that hands one element at a time to `onMessage`.
|
|
5
|
+
* A throwing handler is logged and its element dropped, so the queue keeps moving.
|
|
6
|
+
*/
|
|
3
7
|
export declare class SequentialQueueHelper<TElementPayload> extends BaseHelper {
|
|
4
8
|
storage: Array<TQueueElement<TElementPayload>>;
|
|
5
9
|
protected processingEvents: Set<TQueueElement<TElementPayload>>;
|
|
@@ -2,6 +2,10 @@ import { ObjectUtility } from '@venizia/ignis-inversion';
|
|
|
2
2
|
import { BaseHelper } from '../../../base.js';
|
|
3
3
|
import { HookUtility } from '../../common/index.js';
|
|
4
4
|
import { QueueStatuses, } from './common/index.js';
|
|
5
|
+
/**
|
|
6
|
+
* In-memory FIFO queue that hands one element at a time to `onMessage`.
|
|
7
|
+
* A throwing handler is logged and its element dropped, so the queue keeps moving.
|
|
8
|
+
*/
|
|
5
9
|
export class SequentialQueueHelper extends BaseHelper {
|
|
6
10
|
constructor(opts) {
|
|
7
11
|
super({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/internal/sequential/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { HookUtility } from '../../common';\nimport {\n type IQueueCallback,\n QueueStatuses,\n type TQueueElement,\n type TQueueStatus,\n} from './common';\n\nexport class SequentialQueueHelper<TElementPayload> extends BaseHelper {\n public storage: Array<TQueueElement<TElementPayload>>;\n protected processingEvents: Set<TQueueElement<TElementPayload>>;\n protected generator: Generator;\n\n protected totalEvent: number;\n protected autoDispatch: boolean = true;\n protected state: TQueueStatus = QueueStatuses.WAITING;\n protected isSettleRequested: boolean;\n\n private onMessage?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n\n private onDataEnqueue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n\n private onDataDequeue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n\n private onStateChange?: (opts: {\n identifier: string;\n from: TQueueStatus;\n to: TQueueStatus;\n }) => ValueOrPromise<void>;\n\n constructor(opts: IQueueCallback<TElementPayload> & { identifier: string }) {\n super({\n scope: `${SequentialQueueHelper.name}_${opts.identifier}`,\n identifier: opts.identifier,\n });\n\n this.identifier = opts.identifier;\n this.storage = [];\n this.processingEvents = new Set([]);\n this.generator = this._messageListener();\n\n this.totalEvent = 0;\n this.autoDispatch = opts.autoDispatch ?? true;\n this.state = QueueStatuses.WAITING;\n this.isSettleRequested = false;\n\n this.onMessage = opts.onMessage;\n this.onDataEnqueue = opts.onDataEnqueue;\n this.onDataDequeue = opts.onDataDequeue;\n this.onStateChange = opts.onStateChange;\n }\n\n /** Announce a state transition, awaiting the hook but never letting it break the caller. */\n protected notifyStateChange(opts: { scope: string; from: TQueueStatus }): Promise<void> {\n const { scope, from } = opts;\n\n return HookUtility.execute({\n logger: this.logger,\n scope,\n execution: () => this.onStateChange?.({ identifier: this.identifier, from, to: this.state }),\n });\n }\n\n /** Announce a state transition from a synchronous caller (lock/unlock/settle) - fire-and-forget. */\n protected notifyStateChangeAsync(opts: { scope: string; from: TQueueStatus }): void {\n const { scope, from } = opts;\n\n HookUtility.invoke({\n logger: this.logger,\n scope,\n execution: () => this.onStateChange?.({ identifier: this.identifier, from, to: this.state }),\n });\n }\n\n protected async handleMessage() {\n const current = this.getElementAt(0);\n if (!current) {\n this.logger\n .for(this.handleMessage.name)\n .warn('current: %j | Invalid current message to handle!', current);\n return;\n }\n\n const { isLocked, payload } = current;\n if (isLocked) {\n this.logger.for('handle').info('Skip LOCKED message | Payload: %j', payload);\n return;\n }\n\n if (this.state !== QueueStatuses.LOCKED && this.state !== QueueStatuses.SETTLED) {\n const snap = this.state;\n this.state = QueueStatuses.PROCESSING;\n await this.notifyStateChange({ scope: this.handleMessage.name, from: snap });\n }\n\n this.getElementAt(0).isLocked = true;\n\n this.processingEvents.add(this.getElementAt(0));\n\n // A failing handler must never leave the queue PROCESSING forever: the element would stay LOCKED at the head, nextMessage() would refuse every dispatch and storage would grow without bound. The handler owns its retry policy - here the element is logged, dropped, and the queue moves on.\n await HookUtility.execute({\n logger: this.logger,\n scope: this.handleMessage.name,\n execution: () =>\n this.onMessage?.({ identifier: this.identifier, queueElement: this.getElementAt(0) }),\n });\n\n const doneElement = this.dequeue();\n if (doneElement) {\n this.processingEvents.delete(doneElement);\n }\n\n if (this.state !== QueueStatuses.LOCKED && this.state !== QueueStatuses.SETTLED) {\n const snap = this.state;\n this.state = QueueStatuses.WAITING;\n await this.notifyStateChange({ scope: this.handleMessage.name, from: snap });\n }\n\n if (!this.storage.length) {\n if (this.isSettleRequested) {\n const snap = this.state;\n this.state = QueueStatuses.SETTLED;\n await this.notifyStateChange({ scope: this.handleMessage.name, from: snap });\n }\n\n return;\n }\n\n this.nextMessage();\n }\n\n private *_messageListener() {\n if (!this.onMessage) {\n this.logger\n .for('_messageListener')\n .warn('Queue has no onMessage listener | Skip initializing message iterator!');\n return;\n }\n\n while (true) {\n yield this.handleMessage();\n }\n }\n\n nextMessage() {\n if (this.state !== QueueStatuses.WAITING) {\n this.logger\n .for(this.nextMessage.name)\n .warn(\n 'SKIP request next message | Invalid queue state to request next message | currentState: %s',\n this.state,\n );\n return;\n }\n\n this.generator.next();\n }\n\n async enqueue(payload: TElementPayload) {\n if (this.isSettleRequested || this.state === QueueStatuses.SETTLED) {\n this.logger\n .for(this.enqueue.name)\n .error(\n 'isSettled: %s | currentState: %s | Queue was SETTLED | No more element acceptable',\n this.isSettleRequested,\n this.state,\n );\n return;\n }\n\n if (!this.storage) {\n this.storage = [];\n }\n\n if (!payload) {\n return;\n }\n\n const queueElement: TQueueElement<TElementPayload> = { isLocked: false, payload };\n this.storage.push(queueElement);\n this.totalEvent++;\n await HookUtility.execute({\n logger: this.logger,\n scope: this.enqueue.name,\n execution: () => this.onDataEnqueue?.({ identifier: this.identifier, queueElement }),\n });\n\n if (this.autoDispatch) {\n this.nextMessage();\n }\n }\n\n dequeue() {\n const value = this.storage.shift();\n\n if (value && !ObjectUtility.isEmpty({ value: value })) {\n HookUtility.invoke({\n logger: this.logger,\n scope: this.dequeue.name,\n execution: () => this.onDataDequeue?.({ identifier: this.identifier, queueElement: value }),\n });\n }\n\n return value;\n }\n\n lock() {\n if (this.state >= QueueStatuses.LOCKED) {\n this.logger\n .for(this.lock.name)\n .error(\n 'isSettled | currentState: %s | Invalid queue state to request lock queue!',\n this.isSettleRequested,\n this.state,\n );\n return;\n }\n\n const snap = this.state;\n this.state = QueueStatuses.LOCKED;\n this.notifyStateChangeAsync({ scope: this.lock.name, from: snap });\n }\n\n unlock(opts: { shouldProcessNextElement?: boolean }) {\n if (this.state > QueueStatuses.LOCKED) {\n this.logger\n .for(this.unlock.name)\n .error(\n 'isSettled | currentState: %s | Invalid queue state to request unlock queue!',\n this.isSettleRequested,\n this.state,\n );\n return;\n }\n\n const { shouldProcessNextElement = true } = opts;\n\n const snap = this.state;\n this.state = QueueStatuses.WAITING;\n this.notifyStateChangeAsync({ scope: this.unlock.name, from: snap });\n\n if (!shouldProcessNextElement) {\n return;\n }\n\n this.nextMessage();\n }\n\n settle() {\n this.isSettleRequested = true;\n\n if (this.state !== QueueStatuses.PROCESSING) {\n const snap = this.state;\n this.state = QueueStatuses.SETTLED;\n this.notifyStateChangeAsync({ scope: this.settle.name, from: snap });\n }\n }\n\n isSettled() {\n return this.state === QueueStatuses.SETTLED && !this.storage.length;\n }\n\n close() {\n this.settle();\n this.generator.return({\n state: this.state,\n totalEvent: this.totalEvent,\n });\n }\n\n getElementAt(position: number) {\n return this.storage[position];\n }\n\n getState() {\n return this.state;\n }\n\n getTotalEvent() {\n return this.totalEvent;\n }\n\n getProcessingEvents() {\n return this.processingEvents;\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/internal/sequential/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { HookUtility } from '../../common';\nimport {\n type IQueueCallback,\n QueueStatuses,\n type TQueueElement,\n type TQueueStatus,\n} from './common';\n\n/**\n * In-memory FIFO queue that hands one element at a time to `onMessage`.\n * A throwing handler is logged and its element dropped, so the queue keeps moving.\n */\nexport class SequentialQueueHelper<TElementPayload> extends BaseHelper {\n public storage: Array<TQueueElement<TElementPayload>>;\n protected processingEvents: Set<TQueueElement<TElementPayload>>;\n protected generator: Generator;\n\n protected totalEvent: number;\n protected autoDispatch: boolean = true;\n protected state: TQueueStatus = QueueStatuses.WAITING;\n protected isSettleRequested: boolean;\n\n private onMessage?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n\n private onDataEnqueue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n\n private onDataDequeue?: (opts: {\n identifier: string;\n queueElement: TQueueElement<TElementPayload>;\n }) => ValueOrPromise<void>;\n\n private onStateChange?: (opts: {\n identifier: string;\n from: TQueueStatus;\n to: TQueueStatus;\n }) => ValueOrPromise<void>;\n\n constructor(opts: IQueueCallback<TElementPayload> & { identifier: string }) {\n super({\n scope: `${SequentialQueueHelper.name}_${opts.identifier}`,\n identifier: opts.identifier,\n });\n\n this.identifier = opts.identifier;\n this.storage = [];\n this.processingEvents = new Set([]);\n this.generator = this._messageListener();\n\n this.totalEvent = 0;\n this.autoDispatch = opts.autoDispatch ?? true;\n this.state = QueueStatuses.WAITING;\n this.isSettleRequested = false;\n\n this.onMessage = opts.onMessage;\n this.onDataEnqueue = opts.onDataEnqueue;\n this.onDataDequeue = opts.onDataDequeue;\n this.onStateChange = opts.onStateChange;\n }\n\n /** Announce a state transition, awaiting the hook but never letting it break the caller. */\n protected notifyStateChange(opts: { scope: string; from: TQueueStatus }): Promise<void> {\n const { scope, from } = opts;\n\n return HookUtility.execute({\n logger: this.logger,\n scope,\n execution: () => this.onStateChange?.({ identifier: this.identifier, from, to: this.state }),\n });\n }\n\n /** Announce a state transition from a synchronous caller (lock/unlock/settle) - fire-and-forget. */\n protected notifyStateChangeAsync(opts: { scope: string; from: TQueueStatus }): void {\n const { scope, from } = opts;\n\n HookUtility.invoke({\n logger: this.logger,\n scope,\n execution: () => this.onStateChange?.({ identifier: this.identifier, from, to: this.state }),\n });\n }\n\n protected async handleMessage() {\n const current = this.getElementAt(0);\n\n if (!current) {\n this.logger\n .for(this.handleMessage.name)\n .warn('current: %j | Invalid current message to handle!', current);\n\n return;\n }\n\n const { isLocked, payload } = current;\n\n if (isLocked) {\n this.logger.for('handle').info('Skip LOCKED message | Payload: %j', payload);\n\n return;\n }\n\n if (this.state !== QueueStatuses.LOCKED && this.state !== QueueStatuses.SETTLED) {\n const snap = this.state;\n this.state = QueueStatuses.PROCESSING;\n await this.notifyStateChange({ scope: this.handleMessage.name, from: snap });\n }\n\n this.getElementAt(0).isLocked = true;\n\n this.processingEvents.add(this.getElementAt(0));\n\n // A failing handler must never leave the queue PROCESSING forever: the element would stay LOCKED at the head, nextMessage() would refuse every dispatch and storage would grow without bound. The handler owns its retry policy - here the element is logged, dropped, and the queue moves on.\n await HookUtility.execute({\n logger: this.logger,\n scope: this.handleMessage.name,\n execution: () =>\n this.onMessage?.({ identifier: this.identifier, queueElement: this.getElementAt(0) }),\n });\n\n const doneElement = this.dequeue();\n\n if (doneElement) {\n this.processingEvents.delete(doneElement);\n }\n\n if (this.state !== QueueStatuses.LOCKED && this.state !== QueueStatuses.SETTLED) {\n const snap = this.state;\n this.state = QueueStatuses.WAITING;\n await this.notifyStateChange({ scope: this.handleMessage.name, from: snap });\n }\n\n if (!this.storage.length) {\n if (this.isSettleRequested) {\n const snap = this.state;\n this.state = QueueStatuses.SETTLED;\n await this.notifyStateChange({ scope: this.handleMessage.name, from: snap });\n }\n\n return;\n }\n\n this.nextMessage();\n }\n\n private *_messageListener() {\n if (!this.onMessage) {\n this.logger\n .for('_messageListener')\n .warn('Queue has no onMessage listener | Skip initializing message iterator!');\n\n return;\n }\n\n while (true) {\n yield this.handleMessage();\n }\n }\n\n nextMessage() {\n if (this.state !== QueueStatuses.WAITING) {\n this.logger\n .for(this.nextMessage.name)\n .warn(\n 'SKIP request next message | Invalid queue state to request next message | currentState: %s',\n this.state,\n );\n\n return;\n }\n\n this.generator.next();\n }\n\n async enqueue(payload: TElementPayload) {\n if (this.isSettleRequested || this.state === QueueStatuses.SETTLED) {\n this.logger\n .for(this.enqueue.name)\n .error(\n 'isSettled: %s | currentState: %s | Queue was SETTLED | No more element acceptable',\n this.isSettleRequested,\n this.state,\n );\n\n return;\n }\n\n if (!this.storage) {\n this.storage = [];\n }\n\n if (!payload) {\n return;\n }\n\n const queueElement: TQueueElement<TElementPayload> = { isLocked: false, payload };\n this.storage.push(queueElement);\n this.totalEvent++;\n await HookUtility.execute({\n logger: this.logger,\n scope: this.enqueue.name,\n execution: () => this.onDataEnqueue?.({ identifier: this.identifier, queueElement }),\n });\n\n if (this.autoDispatch) {\n this.nextMessage();\n }\n }\n\n dequeue() {\n const value = this.storage.shift();\n\n if (value && !ObjectUtility.isEmpty({ value: value })) {\n HookUtility.invoke({\n logger: this.logger,\n scope: this.dequeue.name,\n execution: () => this.onDataDequeue?.({ identifier: this.identifier, queueElement: value }),\n });\n }\n\n return value;\n }\n\n lock() {\n if (this.state >= QueueStatuses.LOCKED) {\n this.logger\n .for(this.lock.name)\n .error(\n 'isSettled | currentState: %s | Invalid queue state to request lock queue!',\n this.isSettleRequested,\n this.state,\n );\n\n return;\n }\n\n const snap = this.state;\n this.state = QueueStatuses.LOCKED;\n this.notifyStateChangeAsync({ scope: this.lock.name, from: snap });\n }\n\n unlock(opts: { shouldProcessNextElement?: boolean }) {\n if (this.state > QueueStatuses.LOCKED) {\n this.logger\n .for(this.unlock.name)\n .error(\n 'isSettled | currentState: %s | Invalid queue state to request unlock queue!',\n this.isSettleRequested,\n this.state,\n );\n\n return;\n }\n\n const { shouldProcessNextElement = true } = opts;\n\n const snap = this.state;\n this.state = QueueStatuses.WAITING;\n this.notifyStateChangeAsync({ scope: this.unlock.name, from: snap });\n\n if (!shouldProcessNextElement) {\n return;\n }\n\n this.nextMessage();\n }\n\n settle() {\n this.isSettleRequested = true;\n\n if (this.state !== QueueStatuses.PROCESSING) {\n const snap = this.state;\n this.state = QueueStatuses.SETTLED;\n this.notifyStateChangeAsync({ scope: this.settle.name, from: snap });\n }\n }\n\n isSettled() {\n return this.state === QueueStatuses.SETTLED && !this.storage.length;\n }\n\n close() {\n this.settle();\n this.generator.return({\n state: this.state,\n totalEvent: this.totalEvent,\n });\n }\n\n getElementAt(position: number) {\n return this.storage[position];\n }\n\n getState() {\n return this.state;\n }\n\n getTotalEvent() {\n return this.totalEvent;\n }\n\n getProcessingEvents() {\n return this.processingEvents;\n }\n}\n"]}
|
|
@@ -2,10 +2,15 @@ import { BaseHelper } from '../../base.js';
|
|
|
2
2
|
import type { Base, BaseOptions } from '@platformatic/kafka';
|
|
3
3
|
import { type TKafkaHealthStatus } from './common/constants.js';
|
|
4
4
|
import type { TKafkaBrokerEventCallback } from './common/types/index.js';
|
|
5
|
+
/** Options shared by the Kafka helpers. */
|
|
5
6
|
export interface IKafkaBaseOptions<TClient extends Base<BaseOptions>> {
|
|
6
7
|
scope: string;
|
|
7
8
|
identifier: string;
|
|
8
9
|
client: TClient;
|
|
10
|
+
/**
|
|
11
|
+
* Milliseconds the helper waits for in-flight work on shutdown.
|
|
12
|
+
* @default KafkaDefaults.SHUTDOWN_TIMEOUT
|
|
13
|
+
*/
|
|
9
14
|
shutdownTimeout?: number;
|
|
10
15
|
onBrokerConnect?: TKafkaBrokerEventCallback;
|
|
11
16
|
onBrokerDisconnect?: TKafkaBrokerEventCallback;
|