@venizia/ignis-helpers 0.3.6 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +1 -1
- package/dist/cjs/common/redact.js +1 -1
- package/dist/cjs/common/redact.js.map +1 -1
- package/dist/cjs/modules/base.js +1 -1
- package/dist/cjs/modules/base.js.map +1 -1
- package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js +1 -1
- package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
- package/dist/cjs/modules/logger/common/constants.js +1 -1
- package/dist/cjs/modules/logger/common/constants.js.map +1 -1
- package/dist/cjs/modules/logger/factory.js +1 -1
- package/dist/cjs/modules/logger/factory.js.map +1 -1
- package/dist/cjs/modules/logger/formatting/deep-splat.js +1 -1
- package/dist/cjs/modules/logger/formatting/deep-splat.js.map +1 -1
- package/dist/cjs/modules/logger/formatting/error-prettier.js +4 -4
- package/dist/cjs/modules/logger/formatting/error-prettier.js.map +1 -1
- package/dist/cjs/modules/logger/hf/flusher.js +3 -3
- package/dist/cjs/modules/logger/hf/flusher.js.map +1 -1
- package/dist/cjs/modules/logger/resolver.js +3 -3
- package/dist/cjs/modules/logger/resolver.js.map +1 -1
- package/dist/cjs/modules/logger/winston/formatters/deep-splat.js +1 -1
- package/dist/cjs/modules/logger/winston/formatters/deep-splat.js.map +1 -1
- package/dist/cjs/modules/logger/winston/logger-factory.js +1 -1
- package/dist/cjs/modules/logger/winston/logger-factory.js.map +1 -1
- package/dist/cjs/modules/logger/winston/transports/dgram.transport.js +2 -2
- package/dist/cjs/modules/logger/winston/transports/dgram.transport.js.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js +3 -0
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js +34 -11
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
- package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
- package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
- package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
- package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
- package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js +1 -1
- package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
- package/dist/cjs/modules/network/utilities/query-string.d.ts +27 -2
- package/dist/cjs/modules/network/utilities/query-string.d.ts.map +1 -1
- package/dist/cjs/modules/network/utilities/query-string.js +34 -2
- package/dist/cjs/modules/network/utilities/query-string.js.map +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/ingest.js +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/ingest.js.map +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/policy.js +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/policy.js.map +1 -1
- package/dist/cjs/modules/pool/abstract.js +4 -4
- package/dist/cjs/modules/pool/abstract.js.map +1 -1
- package/dist/cjs/modules/queue/bullmq/helper.js +2 -2
- package/dist/cjs/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
- package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
- package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
- package/dist/cjs/modules/queue/kafka/consumer.js +2 -2
- package/dist/cjs/modules/queue/kafka/consumer.js.map +1 -1
- package/dist/cjs/modules/queue/mqtt/helper.js +4 -4
- package/dist/cjs/modules/queue/mqtt/helper.js.map +1 -1
- package/dist/cjs/modules/redis/base/abstract.helper.js +4 -4
- package/dist/cjs/modules/redis/base/abstract.helper.js.map +1 -1
- package/dist/cjs/modules/redis/cluster/cluster.helper.js +1 -1
- package/dist/cjs/modules/redis/cluster/cluster.helper.js.map +1 -1
- package/dist/cjs/modules/redis/sentinel/sentinel.helper.js +1 -1
- package/dist/cjs/modules/redis/sentinel/sentinel.helper.js.map +1 -1
- package/dist/cjs/modules/secrets/base/abstract.helper.js +2 -2
- package/dist/cjs/modules/secrets/base/abstract.helper.js.map +1 -1
- package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
- package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
- package/dist/cjs/modules/socket/socket-io/browser.d.ts +5 -0
- package/dist/cjs/modules/socket/socket-io/browser.d.ts.map +1 -0
- package/dist/cjs/modules/socket/socket-io/browser.js +21 -0
- package/dist/cjs/modules/socket/socket-io/browser.js.map +1 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.js +250 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.js.map +1 -0
- package/dist/cjs/modules/socket/socket-io/client/helper.d.ts +8 -51
- package/dist/cjs/modules/socket/socket-io/client/helper.d.ts.map +1 -1
- package/dist/cjs/modules/socket/socket-io/client/helper.js +12 -230
- package/dist/cjs/modules/socket/socket-io/client/helper.js.map +1 -1
- package/dist/cjs/modules/socket/socket-io/server/helper.js +5 -5
- package/dist/cjs/modules/socket/socket-io/server/helper.js.map +1 -1
- package/dist/cjs/modules/socket/websocket/server/delivery.js +2 -2
- package/dist/cjs/modules/socket/websocket/server/delivery.js.map +1 -1
- package/dist/cjs/modules/socket/websocket/server/helper.js +4 -4
- package/dist/cjs/modules/socket/websocket/server/helper.js.map +1 -1
- package/dist/cjs/modules/storage/base.js +3 -3
- package/dist/cjs/modules/storage/base.js.map +1 -1
- package/dist/cjs/modules/storage/bun-s3/helper.js +1 -1
- package/dist/cjs/modules/storage/bun-s3/helper.js.map +1 -1
- package/dist/cjs/modules/storage/bun-s3/utility.js +6 -6
- package/dist/cjs/modules/storage/bun-s3/utility.js.map +1 -1
- package/dist/cjs/modules/storage/common/errors.js +1 -1
- package/dist/cjs/modules/storage/common/errors.js.map +1 -1
- package/dist/cjs/modules/storage/minio/helper.js +4 -4
- package/dist/cjs/modules/storage/minio/helper.js.map +1 -1
- package/dist/cjs/modules/temporal/abstract.js +5 -5
- package/dist/cjs/modules/temporal/abstract.js.map +1 -1
- package/dist/cjs/modules/temporal/adapters/intl.d.ts.map +1 -1
- package/dist/cjs/modules/temporal/adapters/intl.js +3 -1
- package/dist/cjs/modules/temporal/adapters/intl.js.map +1 -1
- package/dist/cjs/modules/temporal/locale/locale.js +4 -4
- package/dist/cjs/modules/temporal/locale/locale.js.map +1 -1
- package/dist/cjs/modules/tree/builder.js +2 -2
- package/dist/cjs/modules/tree/builder.js.map +1 -1
- package/dist/cjs/modules/uid/opaque.js +2 -2
- package/dist/cjs/modules/uid/opaque.js.map +1 -1
- package/dist/cjs/modules/uid/uuid/v5.js +1 -1
- package/dist/cjs/modules/uid/uuid/v5.js.map +1 -1
- package/dist/cjs/modules/worker-thread/bus/base.js +4 -4
- package/dist/cjs/modules/worker-thread/bus/base.js.map +1 -1
- package/dist/cjs/modules/worker-thread/worker/base.js +4 -4
- package/dist/cjs/modules/worker-thread/worker/base.js.map +1 -1
- package/dist/cjs/utilities/parse.utility.js +4 -4
- package/dist/cjs/utilities/parse.utility.js.map +1 -1
- package/dist/cjs/utilities/promise.utility.js +1 -1
- package/dist/cjs/utilities/promise.utility.js.map +1 -1
- package/dist/cjs/utilities/request.utility.js +1 -1
- package/dist/cjs/utilities/request.utility.js.map +1 -1
- package/dist/cjs/utilities/sleep.utility.js +1 -1
- package/dist/cjs/utilities/sleep.utility.js.map +1 -1
- package/dist/esm/common/redact.js +1 -1
- package/dist/esm/common/redact.js.map +1 -1
- package/dist/esm/modules/base.js +1 -1
- package/dist/esm/modules/base.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +1 -1
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
- package/dist/esm/modules/logger/common/constants.js +1 -1
- package/dist/esm/modules/logger/common/constants.js.map +1 -1
- package/dist/esm/modules/logger/factory.js +1 -1
- package/dist/esm/modules/logger/factory.js.map +1 -1
- package/dist/esm/modules/logger/formatting/deep-splat.js +1 -1
- package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
- package/dist/esm/modules/logger/formatting/error-prettier.js +4 -4
- package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
- package/dist/esm/modules/logger/hf/flusher.js +3 -3
- package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
- package/dist/esm/modules/logger/resolver.js +3 -3
- package/dist/esm/modules/logger/resolver.js.map +1 -1
- package/dist/esm/modules/logger/winston/formatters/deep-splat.js +1 -1
- package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +1 -1
- package/dist/esm/modules/logger/winston/logger-factory.js +1 -1
- package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js +2 -2
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
- 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 +17 -14
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +3 -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 +13 -4
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +36 -13
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +1 -1
- 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 +27 -2
- package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
- package/dist/esm/modules/network/utilities/query-string.js +31 -1
- package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.js +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 +1 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
- package/dist/esm/modules/pool/abstract.js +4 -4
- package/dist/esm/modules/pool/abstract.js.map +1 -1
- package/dist/esm/modules/queue/bullmq/helper.js +2 -2
- package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
- package/dist/esm/modules/queue/kafka/consumer.js +2 -2
- package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
- package/dist/esm/modules/queue/mqtt/helper.js +4 -4
- package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
- package/dist/esm/modules/redis/base/abstract.helper.js +4 -4
- package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
- package/dist/esm/modules/secrets/base/abstract.helper.js +2 -2
- package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/browser.d.ts +5 -0
- package/dist/esm/modules/socket/socket-io/browser.d.ts.map +1 -0
- package/dist/esm/modules/socket/socket-io/browser.js +5 -0
- package/dist/esm/modules/socket/socket-io/browser.js.map +1 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.js +246 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -0
- package/dist/esm/modules/socket/socket-io/client/helper.d.ts +8 -51
- package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +1 -1
- package/dist/esm/modules/socket/socket-io/client/helper.js +12 -230
- package/dist/esm/modules/socket/socket-io/client/helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/server/helper.js +5 -5
- package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/delivery.js +2 -2
- package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/helper.js +4 -4
- package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
- package/dist/esm/modules/storage/base.js +3 -3
- package/dist/esm/modules/storage/base.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.js +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/utility.js +6 -6
- package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
- package/dist/esm/modules/storage/common/errors.js +1 -1
- package/dist/esm/modules/storage/common/errors.js.map +1 -1
- package/dist/esm/modules/storage/minio/helper.js +4 -4
- package/dist/esm/modules/storage/minio/helper.js.map +1 -1
- package/dist/esm/modules/temporal/abstract.js +5 -5
- package/dist/esm/modules/temporal/abstract.js.map +1 -1
- package/dist/esm/modules/temporal/adapters/intl.d.ts.map +1 -1
- package/dist/esm/modules/temporal/adapters/intl.js +3 -1
- package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
- package/dist/esm/modules/temporal/locale/locale.js +4 -4
- package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
- package/dist/esm/modules/tree/builder.js +2 -2
- package/dist/esm/modules/tree/builder.js.map +1 -1
- package/dist/esm/modules/uid/opaque.js +2 -2
- package/dist/esm/modules/uid/opaque.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v5.js +1 -1
- package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
- package/dist/esm/modules/worker-thread/bus/base.js +4 -4
- package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/worker/base.js +4 -4
- package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
- package/dist/esm/utilities/parse.utility.js +4 -4
- package/dist/esm/utilities/parse.utility.js.map +1 -1
- package/dist/esm/utilities/promise.utility.js +1 -1
- package/dist/esm/utilities/promise.utility.js.map +1 -1
- package/dist/esm/utilities/request.utility.js +1 -1
- package/dist/esm/utilities/request.utility.js.map +1 -1
- package/dist/esm/utilities/sleep.utility.js +1 -1
- package/dist/esm/utilities/sleep.utility.js.map +1 -1
- package/package.json +69 -64
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { executePromiseWithLimit } from '@/utilities';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport {\n type IBunServer,\n type IWebSocketClient,\n type IWebSocketMessage,\n type TWebSocketOutboundTransformer,\n WebSocketClientStates,\n WebSocketDefaults,\n} from '../common';\n\nexport interface IWebSocketDeliveryHelperOptions<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n server: IBunServer;\n /** Shared by reference with WebSocketServerHelper - never copy, both sides must see the same live maps. */\n clients: Map<string, IWebSocketClient<MetadataType>>;\n users: Map<string, Set<string>>;\n rooms: Map<string, Set<string>>;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n encryptedBatchLimit: number;\n}\n\n/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */\nexport class WebSocketDeliveryHelper<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n private server: IBunServer;\n private clients: Map<string, IWebSocketClient<MetadataType>>;\n private users: Map<string, Set<string>>;\n private rooms: Map<string, Set<string>>;\n private outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n private encryptedBatchLimit: number;\n\n constructor(opts: IWebSocketDeliveryHelperOptions<MetadataType>) {\n super({ scope: WebSocketDeliveryHelper.name });\n\n this.server = opts.server;\n this.clients = opts.clients;\n this.users = opts.users;\n this.rooms = opts.rooms;\n this.outboundTransformer = opts.outboundTransformer;\n this.encryptedBatchLimit = opts.encryptedBatchLimit;\n }\n\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n const logger = this.logger.for(this.sendToClient.name);\n const { clientId, event, data, doLog } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n // Async path - transformer intercepts before socket.send()\n const outboundTransformer = this.outboundTransformer;\n if (outboundTransformer && client.encrypted) {\n Promise.resolve()\n .then(() => outboundTransformer({ client, event, data }))\n .then(transformed => {\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({\n client,\n payload: JSON.stringify(outboundMessage),\n doLog,\n event,\n data,\n });\n })\n .catch(error => {\n logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);\n });\n return;\n }\n\n // Sync path (unchanged, zero overhead when no transformer)\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });\n }\n\n private async sendToClientAsync(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return Promise.resolve();\n }\n\n if (!this.outboundTransformer || !client.encrypted) {\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });\n return Promise.resolve();\n }\n\n try {\n const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });\n } catch (error) {\n this.logger\n .for(this.sendToClientAsync.name)\n .error('Outbound transformer error | id: %s | error: %s', clientId, error);\n }\n }\n\n private deliverToSocket(opts: {\n client: IWebSocketClient<MetadataType>;\n payload: string;\n doLog?: boolean;\n event?: string;\n data?: unknown;\n }) {\n const logger = this.logger.for(this.deliverToSocket.name);\n const { client, payload, doLog, event, data } = opts;\n\n try {\n const result = client.socket.send(payload);\n\n if (result === 0) {\n logger.warn('Message dropped (socket closed) | id: %s', client.id);\n }\n\n if (result === -1) {\n client.backpressured = true;\n logger.warn('Backpressure detected | id: %s', client.id);\n }\n } catch (error) {\n logger.error('Failed to send | id: %s | error: %s', client.id, error);\n }\n\n if (doLog) {\n logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);\n }\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n const clientIds = this.users.get(userId);\n if (!clientIds) {\n return;\n }\n\n for (const clientId of clientIds) {\n this.sendToClient({ clientId, event, data });\n }\n }\n\n private sendToRoomExcluding(opts: {\n room: string;\n event: string;\n data: unknown;\n exclude: string[];\n }) {\n const { room, event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n // Serialised ONCE when there is no transformer, because the payload is then identical for every\n // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that\n // never differs. With a transformer each client's payload really is different, so that path\n // still goes through `sendToClient`. The non-excluding fan-out already works this way.\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data });\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n const client = this.clients.get(clientId);\n if (client) {\n this.deliverToSocket({ client, payload, event, data });\n }\n }\n\n return;\n }\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n this.sendToClient({ clientId, event, data });\n }\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.sendToRoomExcluding({ room, event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(room, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n const tasks: Array<() => Promise<void>> = [];\n for (const clientId of roomClientIds) {\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.sendToRoom.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n\n private broadcastExcluding(opts: { event: string; data: unknown; exclude: string[] }) {\n const { event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n for (const [clientId, client] of this.clients) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n\n this.sendToClient({ clientId, event, data });\n }\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n const { event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.broadcastExcluding({ event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(WebSocketDefaults.BROADCAST_TOPIC, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const tasks: Array<() => Promise<void>> = [];\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.broadcast.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { executePromiseWithLimit } from '@/utilities';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport {\n type IBunServer,\n type IWebSocketClient,\n type IWebSocketMessage,\n type TWebSocketOutboundTransformer,\n WebSocketClientStates,\n WebSocketDefaults,\n} from '../common';\n\nexport interface IWebSocketDeliveryHelperOptions<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n server: IBunServer;\n /** Shared by reference with WebSocketServerHelper - never copy, both sides must see the same live maps. */\n clients: Map<string, IWebSocketClient<MetadataType>>;\n users: Map<string, Set<string>>;\n rooms: Map<string, Set<string>>;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n encryptedBatchLimit: number;\n}\n\n/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */\nexport class WebSocketDeliveryHelper<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n private server: IBunServer;\n private clients: Map<string, IWebSocketClient<MetadataType>>;\n private users: Map<string, Set<string>>;\n private rooms: Map<string, Set<string>>;\n private outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n private encryptedBatchLimit: number;\n\n constructor(opts: IWebSocketDeliveryHelperOptions<MetadataType>) {\n super({ scope: WebSocketDeliveryHelper.name });\n\n this.server = opts.server;\n this.clients = opts.clients;\n this.users = opts.users;\n this.rooms = opts.rooms;\n this.outboundTransformer = opts.outboundTransformer;\n this.encryptedBatchLimit = opts.encryptedBatchLimit;\n }\n\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n const logger = this.logger.for(this.sendToClient.name);\n const { clientId, event, data, doLog } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n // Async path - transformer intercepts before socket.send()\n const outboundTransformer = this.outboundTransformer;\n if (outboundTransformer && client.encrypted) {\n Promise.resolve()\n .then(() => outboundTransformer({ client, event, data }))\n .then((transformed) => {\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({\n client,\n payload: JSON.stringify(outboundMessage),\n doLog,\n event,\n data,\n });\n })\n .catch((error) => {\n logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);\n });\n return;\n }\n\n // Sync path (unchanged, zero overhead when no transformer)\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });\n }\n\n private async sendToClientAsync(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return Promise.resolve();\n }\n\n if (!this.outboundTransformer || !client.encrypted) {\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });\n return Promise.resolve();\n }\n\n try {\n const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });\n } catch (error) {\n this.logger\n .for(this.sendToClientAsync.name)\n .error('Outbound transformer error | id: %s | error: %s', clientId, error);\n }\n }\n\n private deliverToSocket(opts: {\n client: IWebSocketClient<MetadataType>;\n payload: string;\n doLog?: boolean;\n event?: string;\n data?: unknown;\n }) {\n const logger = this.logger.for(this.deliverToSocket.name);\n const { client, payload, doLog, event, data } = opts;\n\n try {\n const result = client.socket.send(payload);\n\n if (result === 0) {\n logger.warn('Message dropped (socket closed) | id: %s', client.id);\n }\n\n if (result === -1) {\n client.backpressured = true;\n logger.warn('Backpressure detected | id: %s', client.id);\n }\n } catch (error) {\n logger.error('Failed to send | id: %s | error: %s', client.id, error);\n }\n\n if (doLog) {\n logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);\n }\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n const clientIds = this.users.get(userId);\n if (!clientIds) {\n return;\n }\n\n for (const clientId of clientIds) {\n this.sendToClient({ clientId, event, data });\n }\n }\n\n private sendToRoomExcluding(opts: {\n room: string;\n event: string;\n data: unknown;\n exclude: string[];\n }) {\n const { room, event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n // Serialised ONCE when there is no transformer, because the payload is then identical for every\n // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that\n // never differs. With a transformer each client's payload really is different, so that path\n // still goes through `sendToClient`. The non-excluding fan-out already works this way.\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data });\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n const client = this.clients.get(clientId);\n if (client) {\n this.deliverToSocket({ client, payload, event, data });\n }\n }\n\n return;\n }\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n this.sendToClient({ clientId, event, data });\n }\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.sendToRoomExcluding({ room, event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(room, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n const tasks: Array<() => Promise<void>> = [];\n for (const clientId of roomClientIds) {\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.sendToRoom.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n\n private broadcastExcluding(opts: { event: string; data: unknown; exclude: string[] }) {\n const { event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n for (const [clientId, client] of this.clients) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n\n this.sendToClient({ clientId, event, data });\n }\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n const { event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.broadcastExcluding({ event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(WebSocketDefaults.BROADCAST_TOPIC, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const tasks: Array<() => Promise<void>> = [];\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.broadcast.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n}\n"]}
|
|
@@ -571,7 +571,7 @@ export class WebSocketServerHelper extends BaseHelper {
|
|
|
571
571
|
}),
|
|
572
572
|
});
|
|
573
573
|
})
|
|
574
|
-
.catch(error => {
|
|
574
|
+
.catch((error) => {
|
|
575
575
|
logger.error('Authentication error | id: %s | error: %s', clientId, error);
|
|
576
576
|
this.sendToClient({
|
|
577
577
|
clientId,
|
|
@@ -594,7 +594,7 @@ export class WebSocketServerHelper extends BaseHelper {
|
|
|
594
594
|
}
|
|
595
595
|
const INTERNAL_PREFIX = 'ws:';
|
|
596
596
|
const MAX_ROOM_NAME_LENGTH = 256;
|
|
597
|
-
const sanitizedRooms = rooms.filter(r => {
|
|
597
|
+
const sanitizedRooms = rooms.filter((r) => {
|
|
598
598
|
return (typeof r === 'string' &&
|
|
599
599
|
r.length > 0 &&
|
|
600
600
|
r.length <= MAX_ROOM_NAME_LENGTH &&
|
|
@@ -621,7 +621,7 @@ export class WebSocketServerHelper extends BaseHelper {
|
|
|
621
621
|
}
|
|
622
622
|
logger.info('Joined rooms | id: %s | rooms: %j', clientId, allowedRooms);
|
|
623
623
|
})
|
|
624
|
-
.catch(error => {
|
|
624
|
+
.catch((error) => {
|
|
625
625
|
logger.error('Failed to join rooms | id: %s | rooms: %j | error: %s', clientId, sanitizedRooms, error);
|
|
626
626
|
});
|
|
627
627
|
}
|
|
@@ -637,7 +637,7 @@ export class WebSocketServerHelper extends BaseHelper {
|
|
|
637
637
|
return;
|
|
638
638
|
}
|
|
639
639
|
// Only leave rooms the client has actually joined - prevents unsubscribing from internal topics
|
|
640
|
-
const validRooms = rooms.filter(r => client.rooms.has(r));
|
|
640
|
+
const validRooms = rooms.filter((r) => client.rooms.has(r));
|
|
641
641
|
if (!validRooms.length) {
|
|
642
642
|
return;
|
|
643
643
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EACL,4BAA4B,EAE5B,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAeL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,OAAO,qBAGX,SAAQ,UAAU;IAClB;;;;;;;OAOG;IACK,MAAM,CAAC,UAAU,CAAC,OAAgB;QACxC,MAAM,KAAK,GAAI,OAAkD,EAAE,KAAK,CAAC;QACzE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;YAClE,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IA8BD,YAAY,IAAyD;QACnE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAzB5B,YAAO,GAAgD,IAAI,GAAG,EAAE,CAAC;QACjE,UAAK,GAA6B,IAAI,GAAG,EAAE,CAAC,CAAC,0BAA0B;QACvE,UAAK,GAA6B,IAAI,GAAG,EAAE,CAAC,CAAC,wBAAwB;QAmBrE,mBAAc,GAA0C,IAAI,CAAC;QAMnE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QAE9C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACtD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI;YACvC,iBAAiB,CAAC,IAAI;YACtB,iBAAiB,CAAC,iBAAiB;SACpC,CAAC;QACF,IAAI,CAAC,aAAa,GAAG;YACnB,SAAS,EAAE,iBAAiB,CAAC,UAAU;YACvC,WAAW,EAAE,iBAAiB,CAAC,YAAY;YAC3C,gBAAgB,EAAE,iBAAiB,CAAC,kBAAkB;YACtD,GAAG,IAAI,CAAC,aAAa;SACtB,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,iBAAiB,CAAC,YAAY,CAAC;QACtE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,kBAAkB,CAAC;QACxF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,iBAAiB,CAAC,iBAAiB,CAAC;QACrF,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,KAAK,CAAC;QAEzD,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAuB,CAAe;YACxD,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,IAAI,iBAAiB,CAAC,qBAAqB;SACzF,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC;IAEO,gBAAgB,CACtB,eAAuF;QAEvF,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,QAAQ,CAAC;gBACb,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;gBACrD,OAAO,EAAE,mDAAmD;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,eAAe,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,eAAe,EAAE,CAAC;IACpD,CAAC;IAED,UAAU,CAAC,IAEV;QACC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,EAAE,EAAE,CAAC;YACP,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,gBAAgB,CAAC,IAAwB;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAqC,EAAE,CAAC;QACrD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gBAAgB,CAAC,IAAsB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAqC,EAAE,CAAC;QACrD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,4LAA4L;IAClL,UAAU,CAAC,IAA8D;QACjF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElC,IAAI,CAAC;YACH,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAErE,IAAI,CAAC,QAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAC3D,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACF,IAAI,CAAC,QAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAC3D,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,4BAA4B,CAAC;YAC3B,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;SAC3B,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5C,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;SAC7C,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAE3C,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAErC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAE3B,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAElE,yFAAyF;QACzF,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC,cAAc,EAAE,CAAC;YAC5D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;YAC9D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC,cAAc,EAAE,CAAC;SAC7D,CAAC,CAAC;QAEF,IAAI,CAAC,QAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAe,EAAE,GAAW,EAAE,EAAE;YAC7E,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEF,IAAI,CAAC,QAAyB,CAAC,EAAE,CAChC,UAAU,EACV,CAAC,QAAgB,EAAE,OAAe,EAAE,GAAW,EAAE,EAAE;YACjD,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACxC,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAChD,CAAC;IAEO,cAAc,CAAC,IAAsC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAE9B,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,6CAA6C,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,IACE,CAAC,MAAM;YACP,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAQ,MAA8B,CAAC,QAAQ,KAAK,QAAQ;YAC5D,OAAQ,MAA8B,CAAC,KAAK,KAAK,QAAQ,EACzD,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,OAAO,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAA6B,CAAC;QAE9C,kDAAkD;QAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,OAAO;QACT,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAEvD,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;gBACrC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzC,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChC,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC1D,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAClC,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChC,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,IAMtB;QACC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEpD,MAAM,OAAO,GAAwB;YACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI;YACJ,MAAM;YACN,KAAK;YACL,IAAI;YACJ,OAAO;SACR,CAAC;QAEF,IAAI,OAAe,CAAC;QACpB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;gBACrC,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC;gBACtC,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChC,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAO,EAAE,CAAC,CAAC;gBACvD,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAClC,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAO,EAAE,CAAC,CAAC;gBAC7D,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChC,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAO,EAAE,CAAC,CAAC;gBACzD,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO;YACT,CAAC;QACH,CAAC;QAED,aAAa,CAAC;YACZ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI;YAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;SACnE,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;QAElC,OAAO;YACL,IAAI,EAAE,CAAC,MAAkB,EAAE,EAAE;gBAC3B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAsB,CAAC;gBACnD,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,EAAE,CAAC,MAAkB,EAAE,OAAwB,EAAE,EAAE;gBACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAsB,CAAC;gBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAE1C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACnC,CAAC;gBAED,IAAI,CAAC,eAAe,CAAC;oBACnB,QAAQ;oBACR,GAAG,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;iBAChE,CAAC,CAAC;YACL,CAAC;YACD,KAAK,EAAE,CAAC,MAAkB,EAAE,EAAE;gBAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAsB,CAAC;gBACnD,IAAI,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,EAAE,CAAC,MAAkB,EAAE,EAAE;gBAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAsB,CAAC;gBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC1C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC;oBAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;YACD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;YACzD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,IAA8C;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAElC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,QAAQ,CAAC,CAAC;QAEhE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAmC;YAC7C,EAAE,EAAE,QAAQ;YACZ,MAAM;YACN,KAAK,EAAE,qBAAqB,CAAC,YAAY;YACzC,KAAK,EAAE,IAAI,GAAG,EAAE;YAChB,aAAa,EAAE,KAAK;YACpB,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,GAAG;SAClB,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEnC,kEAAkE;QAClE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE3B,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,EAAE,KAAK,KAAK,qBAAqB,CAAC,YAAY,EAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;gBAC/C,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC;IAED,eAAe,CAAC,IAAuC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAE/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,OAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,YAAY,CAAC;gBAChB,QAAQ;gBACR,KAAK,EAAE,eAAe,CAAC,KAAK;gBAC5B,IAAI,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE;aAC5C,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,mDAAmD,EAAE,GAAG,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,eAAe,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,eAAe,CAAC,YAAY,EAAE,CAAC;YACnD,IAAI,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,KAAK,qBAAqB,CAAC,aAAa,EAAE,CAAC;YACzD,IAAI,CAAC,YAAY,CAAC;gBAChB,QAAQ;gBACR,KAAK,EAAE,eAAe,CAAC,KAAK;gBAC5B,IAAI,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE;aACvC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,KAAK,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrD,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3B,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtD,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;oBACzB,MAAM,CAAC,KAAK,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAC;oBACjE,MAAM;gBACR,CAAC;gBAED,IAAI,CAAC,UAAU,CAAC;oBACd,KAAK,EAAE,gBAAgB;oBACvB,SAAS,EAAE,GAAG,EAAE,CACd,IAAI,CAAC,cAAc,EAAE,CAAC;wBACpB,QAAQ;wBACR,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,OAAO;qBACR,CAAC;iBACL,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,IAA0B;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClD,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,IAAI,WAAW,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,IAAI,WAAW,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE9B,MAAM,CAAC,IAAI,CACT,2CAA2C,EAC3C,QAAQ,EACR,MAAM,CAAC,MAAM,IAAI,WAAW,CAC7B,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC;YACd,KAAK,EAAE,sBAAsB;YAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;SAClF,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAwC;QAC/C,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEvB,+FAA+F;QAC/F,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAwC;QAChD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,WAAW,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE1B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,8JAA8J;IAC9J,sBAAsB,CAAC,IAA0B;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QAExB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,IAA4C;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACrD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,KAAK,qBAAqB,CAAC,YAAY,EAAE,CAAC;YACxD,IAAI,CAAC,YAAY,CAAC;gBAChB,QAAQ;gBACR,KAAK,EAAE,eAAe,CAAC,KAAK;gBAC5B,IAAI,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE;aAC3C,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,GAAG,qBAAqB,CAAC,cAAc,CAAC;QAEpD,wFAAwF;QACxF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,EAAE,KAAK,KAAK,qBAAqB,CAAC,cAAc,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,QAAQ,CAAC,CAAC;gBAC3D,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAEzB,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,IAAI,EAAE,CAAiB,CAAC,CAAC;aAChE,IAAI,CAAC,KAAK,EAAC,MAAM,EAAC,EAAE;YACnB,4EAA4E;YAC5E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,oDAAoD,EAAE,QAAQ,CAAC,CAAC;gBAC5E,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,QAAQ,CAAC,CAAC;gBAC1D,IAAI,CAAC,YAAY,CAAC;oBAChB,QAAQ;oBACR,KAAK,EAAE,eAAe,CAAC,KAAK;oBAC5B,IAAI,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE;iBAC3C,CAAC,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAClC,MAAM,CAAC,KAAK,GAAG,qBAAqB,CAAC,aAAa,CAAC;YAEnD,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBACtB,MAAM,CAAC,KAAK,CACV,kEAAkE,EAClE,QAAQ,CACT,CAAC;oBACF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;oBACjD,OAAO;gBACT,CAAC;gBAED,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,OAAO,CAC3C,IAAI,CAAC,WAAW,CAAC;oBACf,QAAQ;oBACR,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAiB;iBACtC,CAAC,CACH,CAAC;gBAEF,iFAAiF;gBACjF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,QAAQ,CAAC,CAAC;oBACvE,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,eAAe,EAAE,CAAC;oBACrB,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC;oBACrD,IAAI,CAAC,YAAY,CAAC;wBAChB,QAAQ;wBACR,KAAK,EAAE,eAAe,CAAC,KAAK;wBAC5B,IAAI,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE;qBACjD,CAAC,CAAC;oBACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;oBACjD,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC1C,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC,eAAe,CAAC;gBACzD,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;YACrC,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;gBACnD,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC/C,CAAC;YAED,sGAAsG;YACtG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,aAAa,GAA4B;gBAC7C,EAAE,EAAE,QAAQ;gBACZ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC/B,CAAC;YACF,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC/C,aAAa,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;gBACvD,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,YAAY,CAAC;gBAChB,QAAQ;gBACR,KAAK,EAAE,eAAe,CAAC,SAAS;gBAChC,IAAI,EAAE,aAAa;aACpB,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CACT,qDAAqD,EACrD,QAAQ,EACR,MAAM,CAAC,MAAM,IAAI,WAAW,EAC5B,MAAM,CAAC,SAAS,CACjB,CAAC;YAEF,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,mBAAmB;gBAC1B,SAAS,EAAE,GAAG,EAAE,CACd,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,QAAQ;oBACR,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC1B,CAAC;aACL,CAAC,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,KAAK,CAAC,EAAE;YACb,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC3E,IAAI,CAAC,YAAY,CAAC;gBAChB,QAAQ;gBACR,KAAK,EAAE,eAAe,CAAC,KAAK;gBAC5B,IAAI,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE;aAC1C,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,UAAU,CAAC,IAA4C;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC;QAC9B,MAAM,oBAAoB,GAAG,GAAG,CAAC;QACjC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACtC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;gBACrB,CAAC,CAAC,MAAM,GAAG,CAAC;gBACZ,CAAC,CAAC,MAAM,IAAI,oBAAoB;gBAChC,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,CAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CACT,qEAAqE,EACrE,QAAQ,EACR,KAAK,CACN,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CACT,2EAA2E,EAC3E,QAAQ,EACR,cAAc,CACf,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;aACtF,IAAI,CAAC,CAAC,YAAsB,EAAE,EAAE;YAC/B,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CACT,+DAA+D,EAC/D,QAAQ,EACR,cAAc,CACf,CAAC;gBACF,OAAO;YACT,CAAC;YAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC3E,CAAC,CAAC;aACD,KAAK,CAAC,KAAK,CAAC,EAAE;YACb,MAAM,CAAC,KAAK,CACV,uDAAuD,EACvD,QAAQ,EACR,cAAc,EACd,KAAK,CACN,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,WAAW,CAAC,IAA4C;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,gGAAgG;QAChG,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAExE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IAED,mGAAmG;IACnG,YAAY,CAAC,IAAyE;QACpF,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,UAAU,CAAC,IAAsD;QAC/D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,UAAU,CAAC,IAAwE;QACjF,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,IAA0D;QAClE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAc,IAKjB;QACC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAChC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,cAAc,CAAC;gBAClB,IAAI,EAAE,qBAAqB,CAAC,MAAM;gBAClC,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,KAAK;gBACZ,IAAI;aACL,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,cAAc,CAAC;gBAClB,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,KAAK;gBACZ,IAAI;aACL,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,IAAI,CAAC,cAAc,CAAC;gBAClB,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,KAAK;gBACZ,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CACT,0DAA0D,EAC1D,WAAW,IAAI,KAAK,EACpB,KAAK,EACL,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7B,CAAC;IAEO,YAAY;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAEtC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9C,IAAI,MAAM,CAAC,KAAK,KAAK,qBAAqB,CAAC,aAAa,EAAE,CAAC;gBACzD,SAAS,CAAC,uDAAuD;YACnE,CAAC;YAED,IAAI,GAAG,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC;gBACzC,SAAS;YACX,CAAC;YAED,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;iBAC3B,IAAI,CACH,+CAA+C,EAC/C,QAAQ,EACR,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAC5C,CAAC;YAEJ,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;YAC/C,+DAA+D;QACjE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAEjD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,gFAAgF;QAChF,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,KAAK,CAAC,mDAAmD,EAAE,QAAQ,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,iGAAiG;QACjG,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEnB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAElE,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;CACF","sourcesContent":["import { HTTP } from '@/common';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport {\n ensureRedisClientsConnecting,\n type TRedisClient,\n waitForRedisReady,\n} from '@/modules/redis';\nimport { UuidHelper } from '@/modules/uid';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport { type EventEmitter } from 'node:events';\nimport {\n type IBunWebSocketConfig,\n type IBunWebSocketHandler,\n type IRedisSocketMessage,\n type IWebSocket,\n type IWebSocketClient,\n type IWebSocketData,\n type IWebSocketMessage,\n type IWebSocketServerOptions,\n type TWebSocketAuthenticateFn,\n type TWebSocketClientConnectedFn,\n type TWebSocketClientDisconnectedFn,\n type TWebSocketHandshakeFn,\n type TWebSocketMessageHandler,\n type TWebSocketValidateRoomFn,\n WebSocketChannels,\n WebSocketClientStates,\n WebSocketDefaults,\n WebSocketEvents,\n WebSocketMessageTypes,\n} from '../common';\nimport { WebSocketDeliveryHelper } from './delivery';\n\nexport class WebSocketServerHelper<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n /**\n * Narrows an untrusted room payload to the strings it actually contains.\n *\n * `payload as { rooms?: string[] }` is a claim, not a check: the value comes off the wire, so\n * `{\"rooms\":\"lobby\"}` satisfied the `rooms?.length` test (a string has one) and the next line\n * called `rooms.filter`, which a string does not have. Under `Bun.serve` that TypeError is thrown\n * inside the message callback and exits the process.\n */\n private static toRoomList(payload: unknown): string[] {\n const rooms = (payload as { rooms?: unknown } | null | undefined)?.rooms;\n return Array.isArray(rooms)\n ? rooms.filter((room): room is string => typeof room === 'string')\n : [];\n }\n\n private path: string;\n\n private serverId: string;\n\n private clients: Map<string, IWebSocketClient<MetadataType>> = new Map();\n private users: Map<string, Set<string>> = new Map(); // userId -> Set<clientId>\n private rooms: Map<string, Set<string>> = new Map(); // room -> Set<clientId>\n\n private delivery: WebSocketDeliveryHelper<MetadataType>;\n\n private redisPub: TRedisClient;\n private redisSub: TRedisClient;\n\n private authenticateFn: TWebSocketAuthenticateFn<AuthDataType, MetadataType>;\n private validateRoomFn?: TWebSocketValidateRoomFn;\n private onClientConnected?: TWebSocketClientConnectedFn<MetadataType>;\n private onClientDisconnected?: TWebSocketClientDisconnectedFn;\n private messageHandler?: TWebSocketMessageHandler;\n private handshakeFn?: TWebSocketHandshakeFn<AuthDataType>;\n\n private defaultRooms: string[];\n private serverOptions: IBunWebSocketConfig;\n private authTimeout: number;\n private heartbeatInterval: number;\n private heartbeatTimeout: number;\n private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n private requireEncryption: boolean;\n\n constructor(opts: IWebSocketServerOptions<AuthDataType, MetadataType>) {\n super({ scope: opts.identifier });\n\n this.identifier = opts.identifier;\n this.path = opts.path ?? WebSocketDefaults.PATH;\n this.serverId = UuidHelper.getInstance().v4();\n\n this.authenticateFn = opts.authenticateFn;\n this.validateRoomFn = opts.validateRoomFn;\n this.onClientConnected = opts.clientConnectedFn;\n this.onClientDisconnected = opts.clientDisconnectedFn;\n this.messageHandler = opts.messageHandler;\n this.handshakeFn = opts.handshakeFn;\n\n this.defaultRooms = opts.defaultRooms ?? [\n WebSocketDefaults.ROOM,\n WebSocketDefaults.NOTIFICATION_ROOM,\n ];\n this.serverOptions = {\n sendPings: WebSocketDefaults.SEND_PINGS,\n idleTimeout: WebSocketDefaults.IDLE_TIMEOUT,\n maxPayloadLength: WebSocketDefaults.MAX_PAYLOAD_LENGTH,\n ...opts.serverOptions,\n };\n this.authTimeout = opts.authTimeout ?? WebSocketDefaults.AUTH_TIMEOUT;\n this.heartbeatInterval = opts.heartbeatInterval ?? WebSocketDefaults.HEARTBEAT_INTERVAL;\n this.heartbeatTimeout = opts.heartbeatTimeout ?? WebSocketDefaults.HEARTBEAT_TIMEOUT;\n this.requireEncryption = opts.requireEncryption ?? false;\n\n this.delivery = new WebSocketDeliveryHelper<MetadataType>({\n server: opts.server,\n clients: this.clients,\n users: this.users,\n rooms: this.rooms,\n outboundTransformer: opts.outboundTransformer,\n encryptedBatchLimit: opts.encryptedBatchLimit ?? WebSocketDefaults.ENCRYPTED_BATCH_LIMIT,\n });\n\n this.initRedisClients(opts.redisConnection);\n }\n\n private initRedisClients(\n redisConnection: IWebSocketServerOptions<AuthDataType, MetadataType>['redisConnection'],\n ) {\n if (!redisConnection) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[WebSocketServerHelper] Invalid redis connection!',\n });\n }\n\n this.redisPub = redisConnection.duplicateClient();\n this.redisSub = redisConnection.duplicateClient();\n }\n\n getClients(opts?: {\n id?: string;\n }): IWebSocketClient<MetadataType> | Map<string, IWebSocketClient<MetadataType>> | undefined {\n const { id } = opts ?? {};\n if (id) {\n return this.clients.get(id);\n }\n return this.clients;\n }\n\n getClientsByUser(opts: { userId: string }): IWebSocketClient<MetadataType>[] {\n const clientIds = this.users.get(opts.userId);\n if (!clientIds) {\n return [];\n }\n\n const clients: IWebSocketClient<MetadataType>[] = [];\n for (const clientId of clientIds) {\n const client = this.clients.get(clientId);\n if (client) {\n clients.push(client);\n }\n }\n return clients;\n }\n\n getClientsByRoom(opts: { room: string }): IWebSocketClient<MetadataType>[] {\n const clientIds = this.rooms.get(opts.room);\n if (!clientIds) {\n return [];\n }\n\n const clients: IWebSocketClient<MetadataType>[] = [];\n for (const clientId of clientIds) {\n const client = this.clients.get(clientId);\n if (client) {\n clients.push(client);\n }\n }\n return clients;\n }\n\n getPath(): string {\n return this.path;\n }\n\n /** Hooks run inside Bun socket handlers - a sync throw there kills the process; voidExecution only catches promise rejections since its argument is evaluated before the try/catch runs. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring WebSocket Server | id: %s', this.identifier);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis pub error | error: %s', error);\n });\n (this.redisSub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis sub error | error: %s', error);\n });\n\n ensureRedisClientsConnecting({\n clients: [this.redisPub, this.redisSub],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await Promise.all([\n waitForRedisReady({ client: this.redisPub }),\n waitForRedisReady({ client: this.redisSub }),\n ]);\n logger.info('All Redis connections ready');\n\n await this.setupRedisSubscriptions();\n\n this.startHeartbeatTimer();\n\n logger.info('WebSocket Server READY | path: %s', this.path);\n }\n\n private async setupRedisSubscriptions() {\n const logger = this.logger.for(this.setupRedisSubscriptions.name);\n\n // Subscribe to all channels - await to ensure subscriptions are active before proceeding\n await Promise.all([\n this.redisSub.subscribe(WebSocketChannels.BROADCAST),\n this.redisSub.psubscribe(WebSocketChannels.forRoomPattern()),\n this.redisSub.psubscribe(WebSocketChannels.forClientPattern()),\n this.redisSub.psubscribe(WebSocketChannels.forUserPattern()),\n ]);\n\n (this.redisSub as EventEmitter).on('message', (channel: string, raw: string) => {\n this.onRedisMessage({ channel, raw });\n });\n\n (this.redisSub as EventEmitter).on(\n 'pmessage',\n (_pattern: string, channel: string, raw: string) => {\n this.onRedisMessage({ channel, raw });\n },\n );\n\n logger.info('Redis subscriptions configured');\n }\n\n private onRedisMessage(opts: { channel: string; raw: string }) {\n const logger = this.logger.for(this.onRedisMessage.name);\n const { channel, raw } = opts;\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(raw);\n } catch {\n logger.error('Failed to parse Redis message | channel: %s', channel);\n return;\n }\n\n if (\n !parsed ||\n typeof parsed !== 'object' ||\n typeof (parsed as IRedisSocketMessage).serverId !== 'string' ||\n typeof (parsed as IRedisSocketMessage).event !== 'string'\n ) {\n logger.error('Invalid Redis message shape | channel: %s', channel);\n return;\n }\n\n const message = parsed as IRedisSocketMessage;\n\n // Skip messages from this server instance (dedup)\n if (message.serverId === this.serverId) {\n return;\n }\n\n const { type, target, event, data, exclude } = message;\n\n switch (type) {\n case WebSocketMessageTypes.BROADCAST: {\n this.broadcast({ event, data, exclude });\n break;\n }\n case WebSocketMessageTypes.ROOM: {\n if (target) {\n this.sendToRoom({ room: target, event, data, exclude });\n }\n break;\n }\n case WebSocketMessageTypes.CLIENT: {\n if (target) {\n this.sendToClient({ clientId: target, event, data });\n }\n break;\n }\n case WebSocketMessageTypes.USER: {\n if (target) {\n this.sendToUser({ userId: target, event, data });\n }\n break;\n }\n default: {\n break;\n }\n }\n }\n\n private publishToRedis(opts: {\n type: IRedisSocketMessage['type'];\n target?: string;\n event: string;\n data: unknown;\n exclude?: string[];\n }) {\n const { type, target, event, data, exclude } = opts;\n\n const message: IRedisSocketMessage = {\n serverId: this.serverId,\n type,\n target,\n event,\n data,\n exclude,\n };\n\n let channel: string;\n switch (type) {\n case WebSocketMessageTypes.BROADCAST: {\n channel = WebSocketChannels.BROADCAST;\n break;\n }\n case WebSocketMessageTypes.ROOM: {\n channel = WebSocketChannels.forRoom({ room: target! });\n break;\n }\n case WebSocketMessageTypes.CLIENT: {\n channel = WebSocketChannels.forClient({ clientId: target! });\n break;\n }\n case WebSocketMessageTypes.USER: {\n channel = WebSocketChannels.forUser({ userId: target! });\n break;\n }\n default: {\n return;\n }\n }\n\n voidExecution({\n logger: this.logger,\n scope: this.publishToRedis.name,\n execution: this.redisPub.publish(channel, JSON.stringify(message)),\n });\n }\n\n getBunWebSocketHandler(): IBunWebSocketHandler {\n const config = this.serverOptions;\n\n return {\n open: (socket: IWebSocket) => {\n const { clientId } = socket.data as IWebSocketData;\n this.onClientConnect({ clientId, socket });\n },\n message: (socket: IWebSocket, message: string | Buffer) => {\n const { clientId } = socket.data as IWebSocketData;\n const client = this.clients.get(clientId);\n\n if (client) {\n client.lastActivity = Date.now();\n }\n\n this.onClientMessage({\n clientId,\n raw: typeof message === 'string' ? message : message.toString(),\n });\n },\n close: (socket: IWebSocket) => {\n const { clientId } = socket.data as IWebSocketData;\n this.onClientDisconnect({ clientId });\n },\n drain: (socket: IWebSocket) => {\n const { clientId } = socket.data as IWebSocketData;\n const client = this.clients.get(clientId);\n if (client) {\n client.backpressured = false;\n this.logger.for('drain').debug('Backpressure cleared | id: %s', clientId);\n }\n },\n perMessageDeflate: config.perMessageDeflate,\n maxPayloadLength: config.maxPayloadLength,\n idleTimeout: config.idleTimeout,\n backpressureLimit: config.backpressureLimit,\n closeOnBackpressureLimit: config.closeOnBackpressureLimit,\n sendPings: config.sendPings,\n publishToSelf: config.publishToSelf,\n };\n }\n\n onClientConnect(opts: { clientId: string; socket: IWebSocket }) {\n const logger = this.logger.for(this.onClientConnect.name);\n const { clientId, socket } = opts;\n\n if (this.clients.has(clientId)) {\n logger.info('Client already existed | id: %s', clientId);\n return;\n }\n\n logger.info('New connection (unauthorized) | id: %s', clientId);\n\n const now = Date.now();\n\n const client: IWebSocketClient<MetadataType> = {\n id: clientId,\n socket,\n state: WebSocketClientStates.UNAUTHORIZED,\n rooms: new Set(),\n backpressured: false,\n encrypted: false,\n connectedAt: now,\n lastActivity: now,\n };\n this.clients.set(clientId, client);\n\n // Auto-join client's own room (same as Socket.IO: socket.id room)\n socket.subscribe(clientId);\n\n client.authTimer = setTimeout(() => {\n const c = this.clients.get(clientId);\n if (c?.state === WebSocketClientStates.UNAUTHORIZED) {\n logger.warn('Auth timeout | id: %s', clientId);\n c.socket.close(4001, 'Authentication timeout');\n }\n }, this.authTimeout);\n }\n\n onClientMessage(opts: { clientId: string; raw: string }) {\n const logger = this.logger.for(this.onClientMessage.name);\n const { clientId, raw } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n let message: IWebSocketMessage;\n try {\n message = JSON.parse(raw);\n } catch {\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Invalid message format' },\n });\n return;\n }\n\n if (!message.event) {\n logger.error('Invalid message payload | Missing event | raw: %s', raw);\n return;\n }\n\n if (message.event === WebSocketEvents.HEARTBEAT) {\n return;\n }\n\n if (message.event === WebSocketEvents.AUTHENTICATE) {\n this.handleAuthenticate({ clientId, payload: message.data ?? {} });\n return;\n }\n\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Not authenticated' },\n });\n return;\n }\n\n switch (message.event) {\n case WebSocketEvents.JOIN: {\n this.handleJoin({ clientId, payload: message.data });\n break;\n }\n case WebSocketEvents.LEAVE: {\n this.handleLeave({ clientId, payload: message.data });\n break;\n }\n default: {\n if (!this.messageHandler) {\n logger.debug('No messageHandler for extra event | raw: %s', raw);\n break;\n }\n\n this.invokeHook({\n scope: 'messageHandler',\n execution: () =>\n this.messageHandler?.({\n clientId,\n userId: client.userId,\n message,\n }),\n });\n break;\n }\n }\n }\n\n onClientDisconnect(opts: { clientId: string }) {\n const logger = this.logger.for(this.onClientDisconnect.name);\n const { clientId } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n if (client.authTimer) {\n clearTimeout(client.authTimer);\n client.authTimer = undefined;\n }\n\n if (client.userId) {\n const userClients = this.users.get(client.userId);\n userClients?.delete(clientId);\n if (userClients?.size === 0) {\n this.users.delete(client.userId);\n }\n }\n\n for (const room of client.rooms) {\n const roomClients = this.rooms.get(room);\n roomClients?.delete(clientId);\n if (roomClients?.size === 0) {\n this.rooms.delete(room);\n }\n }\n\n this.clients.delete(clientId);\n\n logger.info(\n 'Client disconnected | id: %s | userId: %s',\n clientId,\n client.userId ?? 'anonymous',\n );\n\n this.invokeHook({\n scope: 'clientDisconnectedFn',\n execution: () => this.onClientDisconnected?.({ clientId, userId: client.userId }),\n });\n }\n\n joinRoom(opts: { clientId: string; room: string }) {\n const { clientId, room } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n if (!this.rooms.has(room)) {\n this.rooms.set(room, new Set<string>());\n }\n this.rooms.get(room)!.add(clientId);\n client.rooms.add(room);\n\n // Bun native pub/sub - encrypted clients are unsubscribed (delivered manually via transformer)\n if (!client.encrypted) {\n client.socket.subscribe(room);\n }\n }\n\n leaveRoom(opts: { clientId: string; room: string }) {\n const { clientId, room } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n const roomClients = this.rooms.get(room);\n roomClients?.delete(clientId);\n if (roomClients?.size === 0) {\n this.rooms.delete(room);\n }\n\n client.rooms.delete(room);\n\n client.socket.unsubscribe(room);\n }\n\n /** Unsubscribes the client from Bun native topics so `server.publish()` can't reach it - encrypted clients get messages only via the outbound transformer. */\n enableClientEncryption(opts: { clientId: string }) {\n const client = this.clients.get(opts.clientId);\n if (!client || client.encrypted) {\n return;\n }\n\n client.encrypted = true;\n\n client.socket.unsubscribe(WebSocketDefaults.BROADCAST_TOPIC);\n for (const room of client.rooms) {\n client.socket.unsubscribe(room);\n }\n }\n\n private handleAuthenticate(opts: { clientId: string; payload: unknown }) {\n const logger = this.logger.for('handleAuthenticate');\n const { clientId, payload } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n if (client.state !== WebSocketClientStates.UNAUTHORIZED) {\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Already authenticated' },\n });\n return;\n }\n\n client.state = WebSocketClientStates.AUTHENTICATING;\n\n // Replace with a longer in-progress timeout - prevents DoS via a hanging authenticateFn\n if (client.authTimer) {\n clearTimeout(client.authTimer);\n }\n client.authTimer = setTimeout(() => {\n const c = this.clients.get(clientId);\n if (c?.state === WebSocketClientStates.AUTHENTICATING) {\n logger.warn('Auth in-progress timeout | id: %s', clientId);\n c.socket.close(4001, 'Authentication timeout');\n }\n }, this.authTimeout * 3);\n\n Promise.resolve()\n .then(() => this.authenticateFn((payload ?? {}) as AuthDataType))\n .then(async result => {\n // Re-validate client still exists (may have disconnected during async auth)\n if (!this.clients.has(clientId)) {\n logger.warn('Client disconnected during authentication | id: %s', clientId);\n return;\n }\n\n if (!result) {\n logger.info('Authentication rejected | id: %s', clientId);\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Authentication failed' },\n });\n client.socket.close(4003, 'Authentication failed');\n return;\n }\n\n client.userId = result.userId;\n client.metadata = result.metadata;\n client.state = WebSocketClientStates.AUTHENTICATED;\n\n if (this.requireEncryption) {\n if (!this.handshakeFn) {\n logger.error(\n 'requireEncryption is true but no handshakeFn configured | id: %s',\n clientId,\n );\n client.socket.close(4004, 'Encryption required');\n return;\n }\n\n const handshakeResult = await Promise.resolve(\n this.handshakeFn({\n clientId,\n userId: client.userId,\n data: (payload ?? {}) as AuthDataType,\n }),\n );\n\n // Re-validate client still exists (may have disconnected during async handshake)\n if (!this.clients.has(clientId)) {\n logger.warn('Client disconnected during handshake | id: %s', clientId);\n return;\n }\n\n if (!handshakeResult) {\n logger.info('Handshake rejected | id: %s', clientId);\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Encryption handshake failed' },\n });\n client.socket.close(4004, 'Encryption required');\n return;\n }\n\n this.enableClientEncryption({ clientId });\n client.serverPublicKey = handshakeResult.serverPublicKey;\n client.salt = handshakeResult.salt;\n }\n\n if (client.userId) {\n if (!this.users.has(client.userId)) {\n this.users.set(client.userId, new Set<string>());\n }\n this.users.get(client.userId)!.add(clientId);\n }\n\n // Subscribe to broadcast topic (skipped if already encrypted - enableClientEncryption handles topics)\n if (!client.encrypted) {\n client.socket.subscribe(WebSocketDefaults.BROADCAST_TOPIC);\n }\n\n this.joinRoom({ clientId, room: clientId });\n for (const room of this.defaultRooms) {\n this.joinRoom({ clientId, room });\n }\n\n const connectedData: Record<string, unknown> = {\n id: clientId,\n userId: client.userId,\n time: new Date().toISOString(),\n };\n if (client.encrypted && client.serverPublicKey) {\n connectedData.serverPublicKey = client.serverPublicKey;\n connectedData.salt = client.salt;\n }\n this.sendToClient({\n clientId,\n event: WebSocketEvents.CONNECTED,\n data: connectedData,\n });\n\n logger.info(\n 'Authenticated | id: %s | userId: %s | encrypted: %s',\n clientId,\n client.userId ?? 'anonymous',\n client.encrypted,\n );\n\n this.invokeHook({\n scope: 'clientConnectedFn',\n execution: () =>\n this.onClientConnected?.({\n clientId,\n userId: client.userId,\n metadata: client.metadata,\n }),\n });\n })\n .catch(error => {\n logger.error('Authentication error | id: %s | error: %s', clientId, error);\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Authentication error' },\n });\n client.socket.close(4003, 'Authentication failed');\n });\n }\n\n private handleJoin(opts: { clientId: string; payload: unknown }) {\n const logger = this.logger.for('handleJoin');\n const { clientId, payload } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n const rooms = WebSocketServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n const INTERNAL_PREFIX = 'ws:';\n const MAX_ROOM_NAME_LENGTH = 256;\n const sanitizedRooms = rooms.filter(r => {\n return (\n typeof r === 'string' &&\n r.length > 0 &&\n r.length <= MAX_ROOM_NAME_LENGTH &&\n !r.startsWith(INTERNAL_PREFIX)\n );\n });\n\n if (!sanitizedRooms.length) {\n logger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: all rooms filtered out',\n clientId,\n rooms,\n );\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n if (!validateRoomFn) {\n logger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n clientId,\n sanitizedRooms,\n );\n return;\n }\n\n Promise.resolve()\n .then(() => validateRoomFn({ clientId, userId: client.userId, rooms: sanitizedRooms }))\n .then((allowedRooms: string[]) => {\n if (!allowedRooms?.length) {\n logger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no rooms allowed',\n clientId,\n sanitizedRooms,\n );\n return;\n }\n\n for (const room of allowedRooms) {\n this.joinRoom({ clientId, room });\n }\n\n logger.info('Joined rooms | id: %s | rooms: %j', clientId, allowedRooms);\n })\n .catch(error => {\n logger.error(\n 'Failed to join rooms | id: %s | rooms: %j | error: %s',\n clientId,\n sanitizedRooms,\n error,\n );\n });\n }\n\n private handleLeave(opts: { clientId: string; payload: unknown }) {\n const logger = this.logger.for('handleLeave');\n const { clientId, payload } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n const rooms = WebSocketServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n // Only leave rooms the client has actually joined - prevents unsubscribing from internal topics\n const validRooms = rooms.filter(r => client.rooms.has(r));\n if (!validRooms.length) {\n return;\n }\n\n logger.info('Leaving rooms | id: %s | rooms: %j', clientId, validRooms);\n\n for (const room of validRooms) {\n this.leaveRoom({ clientId, room });\n }\n\n logger.info('Left rooms | id: %s | rooms: %j', clientId, validRooms);\n }\n\n /** Local delivery and fan-out live in WebSocketDeliveryHelper - kept public here by delegation. */\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n this.delivery.sendToClient(opts);\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n this.delivery.sendToUser(opts);\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n this.delivery.sendToRoom(opts);\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n this.delivery.broadcast(opts);\n }\n\n send<T = unknown>(opts: {\n destination?: string;\n payload: { topic: string; data: T };\n doLog?: boolean;\n callback?: () => void;\n }) {\n const logger = this.logger.for(this.send.name);\n const { destination, payload, doLog, callback } = opts;\n\n if (!payload) {\n return;\n }\n\n const { topic, data } = payload;\n if (!topic || data === undefined) {\n return;\n }\n\n if (!destination) {\n this.broadcast({ event: topic, data });\n this.publishToRedis({ type: WebSocketMessageTypes.BROADCAST, event: topic, data });\n } else if (this.clients.has(destination)) {\n this.sendToClient({ clientId: destination, event: topic, data, doLog });\n this.publishToRedis({\n type: WebSocketMessageTypes.CLIENT,\n target: destination,\n event: topic,\n data,\n });\n } else if (this.rooms.has(destination)) {\n this.sendToRoom({ room: destination, event: topic, data });\n this.publishToRedis({\n type: WebSocketMessageTypes.ROOM,\n target: destination,\n event: topic,\n data,\n });\n } else {\n // Could be a client or room on another instance - publish to Redis\n this.publishToRedis({\n type: WebSocketMessageTypes.ROOM,\n target: destination,\n event: topic,\n data,\n });\n }\n\n if (callback) {\n setTimeout(callback, 0);\n }\n\n if (doLog) {\n logger.info(\n 'Message emitted | destination: %s | topic: %s | data: %j',\n destination ?? 'all',\n topic,\n data,\n );\n }\n }\n\n private startHeartbeatTimer() {\n this.heartbeatTimer = setInterval(() => {\n this.heartbeatAll();\n }, this.heartbeatInterval);\n }\n\n private heartbeatAll() {\n const now = Date.now();\n const timeout = this.heartbeatTimeout;\n\n if (!this.clients.size) {\n return;\n }\n\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue; // Auth timeout handles unauthorized clients separately\n }\n\n if (now - client.lastActivity <= timeout) {\n continue;\n }\n\n this.logger\n .for(this.heartbeatAll.name)\n .warn(\n 'Heartbeat timeout | id: %s | lastActivity: %s',\n clientId,\n new Date(client.lastActivity).toISOString(),\n );\n\n client.socket.close(4002, 'Heartbeat timeout');\n // Bun fires close handler → onClientDisconnect handles cleanup\n }\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down WebSocket server...');\n\n if (this.heartbeatTimer) {\n clearInterval(this.heartbeatTimer);\n this.heartbeatTimer = null;\n }\n\n // Close all sockets first (before onClientDisconnect removes them from the map)\n for (const [clientId, client] of this.clients) {\n try {\n client.socket.close(1001, 'Server shutting down');\n } catch {\n logger.error('Client may already be disconnected | clientId: %s', clientId);\n }\n }\n\n // Trigger disconnect callbacks (clears auth timers, removes from indexes, invokes user callback)\n const clientIds = [...this.clients.keys()];\n for (const clientId of clientIds) {\n this.onClientDisconnect({ clientId });\n }\n\n this.clients.clear();\n this.users.clear();\n this.rooms.clear();\n\n await Promise.all([this.redisPub?.quit(), this.redisSub?.quit()]);\n\n logger.info('WebSocket server shutdown complete');\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport {\n ensureRedisClientsConnecting,\n type TRedisClient,\n waitForRedisReady,\n} from '@/modules/redis';\nimport { UuidHelper } from '@/modules/uid';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport { type EventEmitter } from 'node:events';\nimport {\n type IBunWebSocketConfig,\n type IBunWebSocketHandler,\n type IRedisSocketMessage,\n type IWebSocket,\n type IWebSocketClient,\n type IWebSocketData,\n type IWebSocketMessage,\n type IWebSocketServerOptions,\n type TWebSocketAuthenticateFn,\n type TWebSocketClientConnectedFn,\n type TWebSocketClientDisconnectedFn,\n type TWebSocketHandshakeFn,\n type TWebSocketMessageHandler,\n type TWebSocketValidateRoomFn,\n WebSocketChannels,\n WebSocketClientStates,\n WebSocketDefaults,\n WebSocketEvents,\n WebSocketMessageTypes,\n} from '../common';\nimport { WebSocketDeliveryHelper } from './delivery';\n\nexport class WebSocketServerHelper<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n /**\n * Narrows an untrusted room payload to the strings it actually contains.\n *\n * `payload as { rooms?: string[] }` is a claim, not a check: the value comes off the wire, so\n * `{\"rooms\":\"lobby\"}` satisfied the `rooms?.length` test (a string has one) and the next line\n * called `rooms.filter`, which a string does not have. Under `Bun.serve` that TypeError is thrown\n * inside the message callback and exits the process.\n */\n private static toRoomList(payload: unknown): string[] {\n const rooms = (payload as { rooms?: unknown } | null | undefined)?.rooms;\n return Array.isArray(rooms)\n ? rooms.filter((room): room is string => typeof room === 'string')\n : [];\n }\n\n private path: string;\n\n private serverId: string;\n\n private clients: Map<string, IWebSocketClient<MetadataType>> = new Map();\n private users: Map<string, Set<string>> = new Map(); // userId -> Set<clientId>\n private rooms: Map<string, Set<string>> = new Map(); // room -> Set<clientId>\n\n private delivery: WebSocketDeliveryHelper<MetadataType>;\n\n private redisPub: TRedisClient;\n private redisSub: TRedisClient;\n\n private authenticateFn: TWebSocketAuthenticateFn<AuthDataType, MetadataType>;\n private validateRoomFn?: TWebSocketValidateRoomFn;\n private onClientConnected?: TWebSocketClientConnectedFn<MetadataType>;\n private onClientDisconnected?: TWebSocketClientDisconnectedFn;\n private messageHandler?: TWebSocketMessageHandler;\n private handshakeFn?: TWebSocketHandshakeFn<AuthDataType>;\n\n private defaultRooms: string[];\n private serverOptions: IBunWebSocketConfig;\n private authTimeout: number;\n private heartbeatInterval: number;\n private heartbeatTimeout: number;\n private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n private requireEncryption: boolean;\n\n constructor(opts: IWebSocketServerOptions<AuthDataType, MetadataType>) {\n super({ scope: opts.identifier });\n\n this.identifier = opts.identifier;\n this.path = opts.path ?? WebSocketDefaults.PATH;\n this.serverId = UuidHelper.getInstance().v4();\n\n this.authenticateFn = opts.authenticateFn;\n this.validateRoomFn = opts.validateRoomFn;\n this.onClientConnected = opts.clientConnectedFn;\n this.onClientDisconnected = opts.clientDisconnectedFn;\n this.messageHandler = opts.messageHandler;\n this.handshakeFn = opts.handshakeFn;\n\n this.defaultRooms = opts.defaultRooms ?? [\n WebSocketDefaults.ROOM,\n WebSocketDefaults.NOTIFICATION_ROOM,\n ];\n this.serverOptions = {\n sendPings: WebSocketDefaults.SEND_PINGS,\n idleTimeout: WebSocketDefaults.IDLE_TIMEOUT,\n maxPayloadLength: WebSocketDefaults.MAX_PAYLOAD_LENGTH,\n ...opts.serverOptions,\n };\n this.authTimeout = opts.authTimeout ?? WebSocketDefaults.AUTH_TIMEOUT;\n this.heartbeatInterval = opts.heartbeatInterval ?? WebSocketDefaults.HEARTBEAT_INTERVAL;\n this.heartbeatTimeout = opts.heartbeatTimeout ?? WebSocketDefaults.HEARTBEAT_TIMEOUT;\n this.requireEncryption = opts.requireEncryption ?? false;\n\n this.delivery = new WebSocketDeliveryHelper<MetadataType>({\n server: opts.server,\n clients: this.clients,\n users: this.users,\n rooms: this.rooms,\n outboundTransformer: opts.outboundTransformer,\n encryptedBatchLimit: opts.encryptedBatchLimit ?? WebSocketDefaults.ENCRYPTED_BATCH_LIMIT,\n });\n\n this.initRedisClients(opts.redisConnection);\n }\n\n private initRedisClients(\n redisConnection: IWebSocketServerOptions<AuthDataType, MetadataType>['redisConnection'],\n ) {\n if (!redisConnection) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[WebSocketServerHelper] Invalid redis connection!',\n });\n }\n\n this.redisPub = redisConnection.duplicateClient();\n this.redisSub = redisConnection.duplicateClient();\n }\n\n getClients(opts?: {\n id?: string;\n }): IWebSocketClient<MetadataType> | Map<string, IWebSocketClient<MetadataType>> | undefined {\n const { id } = opts ?? {};\n if (id) {\n return this.clients.get(id);\n }\n return this.clients;\n }\n\n getClientsByUser(opts: { userId: string }): IWebSocketClient<MetadataType>[] {\n const clientIds = this.users.get(opts.userId);\n if (!clientIds) {\n return [];\n }\n\n const clients: IWebSocketClient<MetadataType>[] = [];\n for (const clientId of clientIds) {\n const client = this.clients.get(clientId);\n if (client) {\n clients.push(client);\n }\n }\n return clients;\n }\n\n getClientsByRoom(opts: { room: string }): IWebSocketClient<MetadataType>[] {\n const clientIds = this.rooms.get(opts.room);\n if (!clientIds) {\n return [];\n }\n\n const clients: IWebSocketClient<MetadataType>[] = [];\n for (const clientId of clientIds) {\n const client = this.clients.get(clientId);\n if (client) {\n clients.push(client);\n }\n }\n return clients;\n }\n\n getPath(): string {\n return this.path;\n }\n\n /** Hooks run inside Bun socket handlers - a sync throw there kills the process; voidExecution only catches promise rejections since its argument is evaluated before the try/catch runs. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring WebSocket Server | id: %s', this.identifier);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis pub error | error: %s', error);\n });\n (this.redisSub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis sub error | error: %s', error);\n });\n\n ensureRedisClientsConnecting({\n clients: [this.redisPub, this.redisSub],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await Promise.all([\n waitForRedisReady({ client: this.redisPub }),\n waitForRedisReady({ client: this.redisSub }),\n ]);\n logger.info('All Redis connections ready');\n\n await this.setupRedisSubscriptions();\n\n this.startHeartbeatTimer();\n\n logger.info('WebSocket Server READY | path: %s', this.path);\n }\n\n private async setupRedisSubscriptions() {\n const logger = this.logger.for(this.setupRedisSubscriptions.name);\n\n // Subscribe to all channels - await to ensure subscriptions are active before proceeding\n await Promise.all([\n this.redisSub.subscribe(WebSocketChannels.BROADCAST),\n this.redisSub.psubscribe(WebSocketChannels.forRoomPattern()),\n this.redisSub.psubscribe(WebSocketChannels.forClientPattern()),\n this.redisSub.psubscribe(WebSocketChannels.forUserPattern()),\n ]);\n\n (this.redisSub as EventEmitter).on('message', (channel: string, raw: string) => {\n this.onRedisMessage({ channel, raw });\n });\n\n (this.redisSub as EventEmitter).on(\n 'pmessage',\n (_pattern: string, channel: string, raw: string) => {\n this.onRedisMessage({ channel, raw });\n },\n );\n\n logger.info('Redis subscriptions configured');\n }\n\n private onRedisMessage(opts: { channel: string; raw: string }) {\n const logger = this.logger.for(this.onRedisMessage.name);\n const { channel, raw } = opts;\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(raw);\n } catch {\n logger.error('Failed to parse Redis message | channel: %s', channel);\n return;\n }\n\n if (\n !parsed ||\n typeof parsed !== 'object' ||\n typeof (parsed as IRedisSocketMessage).serverId !== 'string' ||\n typeof (parsed as IRedisSocketMessage).event !== 'string'\n ) {\n logger.error('Invalid Redis message shape | channel: %s', channel);\n return;\n }\n\n const message = parsed as IRedisSocketMessage;\n\n // Skip messages from this server instance (dedup)\n if (message.serverId === this.serverId) {\n return;\n }\n\n const { type, target, event, data, exclude } = message;\n\n switch (type) {\n case WebSocketMessageTypes.BROADCAST: {\n this.broadcast({ event, data, exclude });\n break;\n }\n case WebSocketMessageTypes.ROOM: {\n if (target) {\n this.sendToRoom({ room: target, event, data, exclude });\n }\n break;\n }\n case WebSocketMessageTypes.CLIENT: {\n if (target) {\n this.sendToClient({ clientId: target, event, data });\n }\n break;\n }\n case WebSocketMessageTypes.USER: {\n if (target) {\n this.sendToUser({ userId: target, event, data });\n }\n break;\n }\n default: {\n break;\n }\n }\n }\n\n private publishToRedis(opts: {\n type: IRedisSocketMessage['type'];\n target?: string;\n event: string;\n data: unknown;\n exclude?: string[];\n }) {\n const { type, target, event, data, exclude } = opts;\n\n const message: IRedisSocketMessage = {\n serverId: this.serverId,\n type,\n target,\n event,\n data,\n exclude,\n };\n\n let channel: string;\n switch (type) {\n case WebSocketMessageTypes.BROADCAST: {\n channel = WebSocketChannels.BROADCAST;\n break;\n }\n case WebSocketMessageTypes.ROOM: {\n channel = WebSocketChannels.forRoom({ room: target! });\n break;\n }\n case WebSocketMessageTypes.CLIENT: {\n channel = WebSocketChannels.forClient({ clientId: target! });\n break;\n }\n case WebSocketMessageTypes.USER: {\n channel = WebSocketChannels.forUser({ userId: target! });\n break;\n }\n default: {\n return;\n }\n }\n\n voidExecution({\n logger: this.logger,\n scope: this.publishToRedis.name,\n execution: this.redisPub.publish(channel, JSON.stringify(message)),\n });\n }\n\n getBunWebSocketHandler(): IBunWebSocketHandler {\n const config = this.serverOptions;\n\n return {\n open: (socket: IWebSocket) => {\n const { clientId } = socket.data as IWebSocketData;\n this.onClientConnect({ clientId, socket });\n },\n message: (socket: IWebSocket, message: string | Buffer) => {\n const { clientId } = socket.data as IWebSocketData;\n const client = this.clients.get(clientId);\n\n if (client) {\n client.lastActivity = Date.now();\n }\n\n this.onClientMessage({\n clientId,\n raw: typeof message === 'string' ? message : message.toString(),\n });\n },\n close: (socket: IWebSocket) => {\n const { clientId } = socket.data as IWebSocketData;\n this.onClientDisconnect({ clientId });\n },\n drain: (socket: IWebSocket) => {\n const { clientId } = socket.data as IWebSocketData;\n const client = this.clients.get(clientId);\n if (client) {\n client.backpressured = false;\n this.logger.for('drain').debug('Backpressure cleared | id: %s', clientId);\n }\n },\n perMessageDeflate: config.perMessageDeflate,\n maxPayloadLength: config.maxPayloadLength,\n idleTimeout: config.idleTimeout,\n backpressureLimit: config.backpressureLimit,\n closeOnBackpressureLimit: config.closeOnBackpressureLimit,\n sendPings: config.sendPings,\n publishToSelf: config.publishToSelf,\n };\n }\n\n onClientConnect(opts: { clientId: string; socket: IWebSocket }) {\n const logger = this.logger.for(this.onClientConnect.name);\n const { clientId, socket } = opts;\n\n if (this.clients.has(clientId)) {\n logger.info('Client already existed | id: %s', clientId);\n return;\n }\n\n logger.info('New connection (unauthorized) | id: %s', clientId);\n\n const now = Date.now();\n\n const client: IWebSocketClient<MetadataType> = {\n id: clientId,\n socket,\n state: WebSocketClientStates.UNAUTHORIZED,\n rooms: new Set(),\n backpressured: false,\n encrypted: false,\n connectedAt: now,\n lastActivity: now,\n };\n this.clients.set(clientId, client);\n\n // Auto-join client's own room (same as Socket.IO: socket.id room)\n socket.subscribe(clientId);\n\n client.authTimer = setTimeout(() => {\n const c = this.clients.get(clientId);\n if (c?.state === WebSocketClientStates.UNAUTHORIZED) {\n logger.warn('Auth timeout | id: %s', clientId);\n c.socket.close(4001, 'Authentication timeout');\n }\n }, this.authTimeout);\n }\n\n onClientMessage(opts: { clientId: string; raw: string }) {\n const logger = this.logger.for(this.onClientMessage.name);\n const { clientId, raw } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n let message: IWebSocketMessage;\n try {\n message = JSON.parse(raw);\n } catch {\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Invalid message format' },\n });\n return;\n }\n\n if (!message.event) {\n logger.error('Invalid message payload | Missing event | raw: %s', raw);\n return;\n }\n\n if (message.event === WebSocketEvents.HEARTBEAT) {\n return;\n }\n\n if (message.event === WebSocketEvents.AUTHENTICATE) {\n this.handleAuthenticate({ clientId, payload: message.data ?? {} });\n return;\n }\n\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Not authenticated' },\n });\n return;\n }\n\n switch (message.event) {\n case WebSocketEvents.JOIN: {\n this.handleJoin({ clientId, payload: message.data });\n break;\n }\n case WebSocketEvents.LEAVE: {\n this.handleLeave({ clientId, payload: message.data });\n break;\n }\n default: {\n if (!this.messageHandler) {\n logger.debug('No messageHandler for extra event | raw: %s', raw);\n break;\n }\n\n this.invokeHook({\n scope: 'messageHandler',\n execution: () =>\n this.messageHandler?.({\n clientId,\n userId: client.userId,\n message,\n }),\n });\n break;\n }\n }\n }\n\n onClientDisconnect(opts: { clientId: string }) {\n const logger = this.logger.for(this.onClientDisconnect.name);\n const { clientId } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n if (client.authTimer) {\n clearTimeout(client.authTimer);\n client.authTimer = undefined;\n }\n\n if (client.userId) {\n const userClients = this.users.get(client.userId);\n userClients?.delete(clientId);\n if (userClients?.size === 0) {\n this.users.delete(client.userId);\n }\n }\n\n for (const room of client.rooms) {\n const roomClients = this.rooms.get(room);\n roomClients?.delete(clientId);\n if (roomClients?.size === 0) {\n this.rooms.delete(room);\n }\n }\n\n this.clients.delete(clientId);\n\n logger.info(\n 'Client disconnected | id: %s | userId: %s',\n clientId,\n client.userId ?? 'anonymous',\n );\n\n this.invokeHook({\n scope: 'clientDisconnectedFn',\n execution: () => this.onClientDisconnected?.({ clientId, userId: client.userId }),\n });\n }\n\n joinRoom(opts: { clientId: string; room: string }) {\n const { clientId, room } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n if (!this.rooms.has(room)) {\n this.rooms.set(room, new Set<string>());\n }\n this.rooms.get(room)!.add(clientId);\n client.rooms.add(room);\n\n // Bun native pub/sub - encrypted clients are unsubscribed (delivered manually via transformer)\n if (!client.encrypted) {\n client.socket.subscribe(room);\n }\n }\n\n leaveRoom(opts: { clientId: string; room: string }) {\n const { clientId, room } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n const roomClients = this.rooms.get(room);\n roomClients?.delete(clientId);\n if (roomClients?.size === 0) {\n this.rooms.delete(room);\n }\n\n client.rooms.delete(room);\n\n client.socket.unsubscribe(room);\n }\n\n /** Unsubscribes the client from Bun native topics so `server.publish()` can't reach it - encrypted clients get messages only via the outbound transformer. */\n enableClientEncryption(opts: { clientId: string }) {\n const client = this.clients.get(opts.clientId);\n if (!client || client.encrypted) {\n return;\n }\n\n client.encrypted = true;\n\n client.socket.unsubscribe(WebSocketDefaults.BROADCAST_TOPIC);\n for (const room of client.rooms) {\n client.socket.unsubscribe(room);\n }\n }\n\n private handleAuthenticate(opts: { clientId: string; payload: unknown }) {\n const logger = this.logger.for('handleAuthenticate');\n const { clientId, payload } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n if (client.state !== WebSocketClientStates.UNAUTHORIZED) {\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Already authenticated' },\n });\n return;\n }\n\n client.state = WebSocketClientStates.AUTHENTICATING;\n\n // Replace with a longer in-progress timeout - prevents DoS via a hanging authenticateFn\n if (client.authTimer) {\n clearTimeout(client.authTimer);\n }\n client.authTimer = setTimeout(() => {\n const c = this.clients.get(clientId);\n if (c?.state === WebSocketClientStates.AUTHENTICATING) {\n logger.warn('Auth in-progress timeout | id: %s', clientId);\n c.socket.close(4001, 'Authentication timeout');\n }\n }, this.authTimeout * 3);\n\n Promise.resolve()\n .then(() => this.authenticateFn((payload ?? {}) as AuthDataType))\n .then(async (result) => {\n // Re-validate client still exists (may have disconnected during async auth)\n if (!this.clients.has(clientId)) {\n logger.warn('Client disconnected during authentication | id: %s', clientId);\n return;\n }\n\n if (!result) {\n logger.info('Authentication rejected | id: %s', clientId);\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Authentication failed' },\n });\n client.socket.close(4003, 'Authentication failed');\n return;\n }\n\n client.userId = result.userId;\n client.metadata = result.metadata;\n client.state = WebSocketClientStates.AUTHENTICATED;\n\n if (this.requireEncryption) {\n if (!this.handshakeFn) {\n logger.error(\n 'requireEncryption is true but no handshakeFn configured | id: %s',\n clientId,\n );\n client.socket.close(4004, 'Encryption required');\n return;\n }\n\n const handshakeResult = await Promise.resolve(\n this.handshakeFn({\n clientId,\n userId: client.userId,\n data: (payload ?? {}) as AuthDataType,\n }),\n );\n\n // Re-validate client still exists (may have disconnected during async handshake)\n if (!this.clients.has(clientId)) {\n logger.warn('Client disconnected during handshake | id: %s', clientId);\n return;\n }\n\n if (!handshakeResult) {\n logger.info('Handshake rejected | id: %s', clientId);\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Encryption handshake failed' },\n });\n client.socket.close(4004, 'Encryption required');\n return;\n }\n\n this.enableClientEncryption({ clientId });\n client.serverPublicKey = handshakeResult.serverPublicKey;\n client.salt = handshakeResult.salt;\n }\n\n if (client.userId) {\n if (!this.users.has(client.userId)) {\n this.users.set(client.userId, new Set<string>());\n }\n this.users.get(client.userId)!.add(clientId);\n }\n\n // Subscribe to broadcast topic (skipped if already encrypted - enableClientEncryption handles topics)\n if (!client.encrypted) {\n client.socket.subscribe(WebSocketDefaults.BROADCAST_TOPIC);\n }\n\n this.joinRoom({ clientId, room: clientId });\n for (const room of this.defaultRooms) {\n this.joinRoom({ clientId, room });\n }\n\n const connectedData: Record<string, unknown> = {\n id: clientId,\n userId: client.userId,\n time: new Date().toISOString(),\n };\n if (client.encrypted && client.serverPublicKey) {\n connectedData.serverPublicKey = client.serverPublicKey;\n connectedData.salt = client.salt;\n }\n this.sendToClient({\n clientId,\n event: WebSocketEvents.CONNECTED,\n data: connectedData,\n });\n\n logger.info(\n 'Authenticated | id: %s | userId: %s | encrypted: %s',\n clientId,\n client.userId ?? 'anonymous',\n client.encrypted,\n );\n\n this.invokeHook({\n scope: 'clientConnectedFn',\n execution: () =>\n this.onClientConnected?.({\n clientId,\n userId: client.userId,\n metadata: client.metadata,\n }),\n });\n })\n .catch((error) => {\n logger.error('Authentication error | id: %s | error: %s', clientId, error);\n this.sendToClient({\n clientId,\n event: WebSocketEvents.ERROR,\n data: { message: 'Authentication error' },\n });\n client.socket.close(4003, 'Authentication failed');\n });\n }\n\n private handleJoin(opts: { clientId: string; payload: unknown }) {\n const logger = this.logger.for('handleJoin');\n const { clientId, payload } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n const rooms = WebSocketServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n const INTERNAL_PREFIX = 'ws:';\n const MAX_ROOM_NAME_LENGTH = 256;\n const sanitizedRooms = rooms.filter((r) => {\n return (\n typeof r === 'string' &&\n r.length > 0 &&\n r.length <= MAX_ROOM_NAME_LENGTH &&\n !r.startsWith(INTERNAL_PREFIX)\n );\n });\n\n if (!sanitizedRooms.length) {\n logger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: all rooms filtered out',\n clientId,\n rooms,\n );\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n if (!validateRoomFn) {\n logger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n clientId,\n sanitizedRooms,\n );\n return;\n }\n\n Promise.resolve()\n .then(() => validateRoomFn({ clientId, userId: client.userId, rooms: sanitizedRooms }))\n .then((allowedRooms: string[]) => {\n if (!allowedRooms?.length) {\n logger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no rooms allowed',\n clientId,\n sanitizedRooms,\n );\n return;\n }\n\n for (const room of allowedRooms) {\n this.joinRoom({ clientId, room });\n }\n\n logger.info('Joined rooms | id: %s | rooms: %j', clientId, allowedRooms);\n })\n .catch((error) => {\n logger.error(\n 'Failed to join rooms | id: %s | rooms: %j | error: %s',\n clientId,\n sanitizedRooms,\n error,\n );\n });\n }\n\n private handleLeave(opts: { clientId: string; payload: unknown }) {\n const logger = this.logger.for('handleLeave');\n const { clientId, payload } = opts;\n\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n const rooms = WebSocketServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n // Only leave rooms the client has actually joined - prevents unsubscribing from internal topics\n const validRooms = rooms.filter((r) => client.rooms.has(r));\n if (!validRooms.length) {\n return;\n }\n\n logger.info('Leaving rooms | id: %s | rooms: %j', clientId, validRooms);\n\n for (const room of validRooms) {\n this.leaveRoom({ clientId, room });\n }\n\n logger.info('Left rooms | id: %s | rooms: %j', clientId, validRooms);\n }\n\n /** Local delivery and fan-out live in WebSocketDeliveryHelper - kept public here by delegation. */\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n this.delivery.sendToClient(opts);\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n this.delivery.sendToUser(opts);\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n this.delivery.sendToRoom(opts);\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n this.delivery.broadcast(opts);\n }\n\n send<T = unknown>(opts: {\n destination?: string;\n payload: { topic: string; data: T };\n doLog?: boolean;\n callback?: () => void;\n }) {\n const logger = this.logger.for(this.send.name);\n const { destination, payload, doLog, callback } = opts;\n\n if (!payload) {\n return;\n }\n\n const { topic, data } = payload;\n if (!topic || data === undefined) {\n return;\n }\n\n if (!destination) {\n this.broadcast({ event: topic, data });\n this.publishToRedis({ type: WebSocketMessageTypes.BROADCAST, event: topic, data });\n } else if (this.clients.has(destination)) {\n this.sendToClient({ clientId: destination, event: topic, data, doLog });\n this.publishToRedis({\n type: WebSocketMessageTypes.CLIENT,\n target: destination,\n event: topic,\n data,\n });\n } else if (this.rooms.has(destination)) {\n this.sendToRoom({ room: destination, event: topic, data });\n this.publishToRedis({\n type: WebSocketMessageTypes.ROOM,\n target: destination,\n event: topic,\n data,\n });\n } else {\n // Could be a client or room on another instance - publish to Redis\n this.publishToRedis({\n type: WebSocketMessageTypes.ROOM,\n target: destination,\n event: topic,\n data,\n });\n }\n\n if (callback) {\n setTimeout(callback, 0);\n }\n\n if (doLog) {\n logger.info(\n 'Message emitted | destination: %s | topic: %s | data: %j',\n destination ?? 'all',\n topic,\n data,\n );\n }\n }\n\n private startHeartbeatTimer() {\n this.heartbeatTimer = setInterval(() => {\n this.heartbeatAll();\n }, this.heartbeatInterval);\n }\n\n private heartbeatAll() {\n const now = Date.now();\n const timeout = this.heartbeatTimeout;\n\n if (!this.clients.size) {\n return;\n }\n\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue; // Auth timeout handles unauthorized clients separately\n }\n\n if (now - client.lastActivity <= timeout) {\n continue;\n }\n\n this.logger\n .for(this.heartbeatAll.name)\n .warn(\n 'Heartbeat timeout | id: %s | lastActivity: %s',\n clientId,\n new Date(client.lastActivity).toISOString(),\n );\n\n client.socket.close(4002, 'Heartbeat timeout');\n // Bun fires close handler → onClientDisconnect handles cleanup\n }\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down WebSocket server...');\n\n if (this.heartbeatTimer) {\n clearInterval(this.heartbeatTimer);\n this.heartbeatTimer = null;\n }\n\n // Close all sockets first (before onClientDisconnect removes them from the map)\n for (const [clientId, client] of this.clients) {\n try {\n client.socket.close(1001, 'Server shutting down');\n } catch {\n logger.error('Client may already be disconnected | clientId: %s', clientId);\n }\n }\n\n // Trigger disconnect callbacks (clears auth timers, removes from indexes, invokes user callback)\n const clientIds = [...this.clients.keys()];\n for (const clientId of clientIds) {\n this.onClientDisconnect({ clientId });\n }\n\n this.clients.clear();\n this.users.clear();\n this.rooms.clear();\n\n await Promise.all([this.redisPub?.quit(), this.redisSub?.quit()]);\n\n logger.info('WebSocket server shutdown complete');\n }\n}\n"]}
|
|
@@ -87,7 +87,7 @@ export class BaseStorageHelper extends BaseHelper {
|
|
|
87
87
|
return false;
|
|
88
88
|
}
|
|
89
89
|
const segments = normalized.split('/');
|
|
90
|
-
if (segments.some(s => s.length === 0)) {
|
|
90
|
+
if (segments.some((s) => s.length === 0)) {
|
|
91
91
|
this.logger
|
|
92
92
|
.for(this.isValidKeyPath.name)
|
|
93
93
|
.error('Path contains empty segments (double slashes): %s', pathStr);
|
|
@@ -142,7 +142,7 @@ export class BaseStorageHelper extends BaseHelper {
|
|
|
142
142
|
const bucketName = opts.bucket.name;
|
|
143
143
|
const encodedName = opts.object.key
|
|
144
144
|
.split('/')
|
|
145
|
-
.map(segment => encodeURIComponent(segment))
|
|
145
|
+
.map((segment) => encodeURIComponent(segment))
|
|
146
146
|
.join('/');
|
|
147
147
|
return `${this.defaultLinkPrefix}${bucketName}/${encodedName}`;
|
|
148
148
|
}
|
|
@@ -213,7 +213,7 @@ export class BaseStorageHelper extends BaseHelper {
|
|
|
213
213
|
isKeyResolvedByCaller: normalizeNameFn !== undefined,
|
|
214
214
|
});
|
|
215
215
|
// Every key is resolved and validated before the first write, so one bad key stores nothing.
|
|
216
|
-
const keys = files.map(file => {
|
|
216
|
+
const keys = files.map((file) => {
|
|
217
217
|
const naming = {
|
|
218
218
|
originalName: file.originalName,
|
|
219
219
|
folderPath: file.folderPath,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/modules/storage/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport { ContentTypeTable, type IDuration, MimeTypes } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { executePromiseWithLimit } from '@/utilities/promise.utility';\nimport { Readable } from 'node:stream';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IPostPolicy,\n type IObjectRef,\n type IStorageHelper,\n type IUploadFile,\n type IUploadResult,\n type TUploadNaming,\n} from './common';\nimport { isNotFoundError, StorageConcurrency, StorageErrors } from './common';\n\nexport abstract class BaseStorageHelper extends BaseHelper implements IStorageHelper {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n getMimeType(opts: { filename: string }): string {\n return ContentTypeTable.resolve(opts);\n }\n\n /** One path segment or file name: no separator, no traversal, no control or shell character. */\n isValidSegment(opts: { segment: string }): boolean {\n const name = opts.segment;\n\n if (typeof name !== 'string') {\n this.logger.for(this.isValidSegment.name).error('Invalid name provided: %j', name);\n return false;\n }\n\n if (!name || isEmpty({ value: name })) {\n this.logger.for(this.isValidSegment.name).error('Empty name provided');\n return false;\n }\n\n if (name.includes('..') || name.includes('/') || name.includes('\\\\')) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains invalid path characters: %s', name);\n return false;\n }\n\n if (name.startsWith('.')) {\n this.logger.for(this.isValidSegment.name).error('Name cannot start with a dot: %s', name);\n return false;\n }\n\n const dangerousChars = /[;|&$`<>{}[\\]!#]/;\n if (dangerousChars.test(name)) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains dangerous characters: %s', name);\n return false;\n }\n\n if (name.includes('\\n') || name.includes('\\r') || name.includes('\\0')) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains invalid control characters: %s', name);\n return false;\n }\n\n if (name.length > 255) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name is too long (%d characters): %s', name.length, name);\n return false;\n }\n\n if (name.trim().length === 0) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name cannot be empty or whitespace only: \"%s\"', name);\n return false;\n }\n\n return true;\n }\n\n static readonly DEFAULT_MAX_FOLDER_DEPTH = 2;\n\n /** Control characters and lone surrogates: never part of a file name, and not encodable into a header. */\n private static readonly UNSAFE_NAME_CHARACTERS = /[\\p{Cc}\\p{Cs}]/u;\n\n /** A bucket name is one segment; a separator in it would silently address a different bucket. */\n isValidBucketName(opts: { bucket: IBucketRef }): boolean {\n return this.isValidSegment({ segment: opts.bucket.name });\n }\n\n /** A whole object key: every segment valid, and no deeper than `maxDepth` folders. */\n isValidObjectKey(opts: { object: IObjectRef; maxDepth?: number }): boolean {\n return this.isValidKeyPath({ path: opts.object.key, maxDepth: opts.maxDepth });\n }\n\n /** The shared rule behind `isValidObjectKey` and the folder check inside `upload`. */\n protected isValidKeyPath(opts: { path: string; maxDepth?: number }): boolean {\n const { path: pathStr } = opts;\n const maxDepth = opts.maxDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n\n if (typeof pathStr !== 'string' || !pathStr || isEmpty({ value: pathStr })) {\n this.logger.for(this.isValidKeyPath.name).error('Empty or invalid path provided');\n return false;\n }\n\n const normalized = pathStr.replace(/^\\/+|\\/+$/g, '');\n if (!normalized) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path resolved to empty after trimming slashes');\n return false;\n }\n\n const segments = normalized.split('/');\n\n if (segments.some(s => s.length === 0)) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path contains empty segments (double slashes): %s', pathStr);\n return false;\n }\n\n // segments include the filename, so depth is one less.\n const folderDepth = segments.length - 1;\n if (folderDepth > maxDepth) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path exceeds max folder depth (%d): %s (depth: %d)',\n maxDepth,\n pathStr,\n folderDepth,\n );\n return false;\n }\n\n for (const segment of segments) {\n if (!this.isValidSegment({ segment })) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path segment failed validation: %s (in path: %s)', segment, pathStr);\n return false;\n }\n }\n\n if (normalized.length > 1024) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path is too long (%d characters): %s', normalized.length, pathStr);\n return false;\n }\n\n return true;\n }\n\n getMediaType(opts: { mimeType: string }): string {\n const { mimeType } = opts;\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.IMAGE)) {\n return MimeTypes.IMAGE;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.VIDEO)) {\n return MimeTypes.VIDEO;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.TEXT)) {\n return MimeTypes.TEXT;\n }\n\n return MimeTypes.UNKNOWN;\n }\n\n /** Public URL prefix; keeps its trailing slash. */\n protected abstract get defaultLinkPrefix(): string;\n\n /** Backend write step; owns its metadata and error handling. */\n protected abstract writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void>;\n\n protected normalizeObjectName(opts: { file: TUploadNaming }): string {\n const { originalName, folderPath } = opts.file;\n const normalizedFileName = originalName.toLowerCase().replace(/ /g, '_');\n\n if (!folderPath) {\n return normalizedFileName;\n }\n\n return `${folderPath.toLowerCase().replace(/ /g, '_')}/${normalizedFileName}`;\n }\n\n protected normalizeObjectLink(opts: IObjectLocation): string {\n const bucketName = opts.bucket.name;\n const encodedName = opts.object.key\n .split('/')\n .map(segment => encodeURIComponent(segment))\n .join('/');\n\n return `${this.defaultLinkPrefix}${bucketName}/${encodedName}`;\n }\n\n /** An original name that is only metadata - the key is resolved elsewhere and validated on its own. */\n protected isValidOriginalName(opts: { name: string }): boolean {\n const { name } = opts;\n\n if (typeof name !== 'string' || name.trim().length === 0 || name.length > 255) {\n this.logger.for(this.isValidOriginalName.name).error('Invalid original name: %j', name);\n return false;\n }\n\n if (BaseStorageHelper.UNSAFE_NAME_CHARACTERS.test(name)) {\n this.logger\n .for(this.isValidOriginalName.name)\n .error('Original name contains a control character or a lone surrogate: %j', name);\n return false;\n }\n\n return true;\n }\n\n /** `isKeyResolvedByCaller`: a `normalizeNameFn` decides the key, so the original name is metadata and meets the metadata rule, not the key rule. */\n protected validateUploadFiles(opts: {\n files: IUploadFile[];\n maxFolderDepth?: number;\n isKeyResolvedByCaller?: boolean;\n }): void {\n const { files, maxFolderDepth, isKeyResolvedByCaller = false } = opts;\n\n for (const file of files) {\n this.validateUploadFile({ file, maxFolderDepth, isKeyResolvedByCaller });\n }\n }\n\n private validateUploadFile(opts: {\n file: IUploadFile;\n maxFolderDepth?: number;\n isKeyResolvedByCaller: boolean;\n }): void {\n const { file, maxFolderDepth, isKeyResolvedByCaller } = opts;\n const { originalName, size, folderPath } = file;\n\n const isNameValid = isKeyResolvedByCaller\n ? this.isValidOriginalName({ name: originalName })\n : this.isValidSegment({ segment: originalName });\n\n if (!isNameValid) {\n throw getError({ message: '[upload] Invalid original file name' });\n }\n\n // Checked against the CALLER's depth, before the body is spooled. `isValidKeyPath` measures an\n // object path (one folder deeper than a bare folderPath), so the depth is checked directly.\n if (folderPath) {\n const depthLimit = maxFolderDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n const folderSegments = folderPath.replace(/^\\/+|\\/+$/g, '').split('/');\n\n if (folderSegments.length > depthLimit) {\n throw getError({\n message: `[upload] Invalid folder path | depth: ${folderSegments.length} | max: ${depthLimit}`,\n });\n }\n\n if (!this.isValidKeyPath({ path: folderPath, maxDepth: depthLimit })) {\n throw getError({ message: '[upload] Invalid folder path' });\n }\n }\n\n // Missing or negative is invalid; zero is a legitimate empty file.\n if (size === undefined || size === null || size < 0) {\n throw getError({ message: `[upload] Invalid file size | size: ${size}` });\n }\n }\n\n async upload(opts: {\n bucket: IBucketRef;\n files: IUploadFile[];\n normalizeNameFn?: (opts: { file: TUploadNaming }) => string;\n normalizeLinkFn?: (opts: IObjectLocation) => string;\n /** Folder nesting allowed. Omitted -> DEFAULT_MAX_FOLDER_DEPTH. */\n maxFolderDepth?: number;\n }): Promise<IUploadResult[]> {\n const { bucket, files, normalizeNameFn, normalizeLinkFn, maxFolderDepth } = opts;\n\n if (!files || files.length === 0) {\n return [];\n }\n\n const isExists = await this.hasBucket({ bucket });\n if (!isExists) {\n throw getError({\n message: `[upload] Bucket does not exist | name: ${bucket.name}`,\n });\n }\n\n this.validateUploadFiles({\n files,\n maxFolderDepth,\n isKeyResolvedByCaller: normalizeNameFn !== undefined,\n });\n\n // Every key is resolved and validated before the first write, so one bad key stores nothing.\n const keys = files.map(file => {\n const naming: TUploadNaming = {\n originalName: file.originalName,\n folderPath: file.folderPath,\n };\n const key = normalizeNameFn\n ? normalizeNameFn({ file: naming })\n : this.normalizeObjectName({ file: naming });\n\n if (!this.isValidObjectKey({ object: { key }, maxDepth: maxFolderDepth })) {\n throw getError({\n message: `[upload] Invalid normalized object name | name: ${key}`,\n });\n }\n\n return key;\n });\n\n return this.mapWithConcurrency({\n items: files,\n task: async ({ item: file, index }) => {\n const { mimetype: mimeType, size, encoding } = file;\n const t = performance.now();\n const key = keys[index];\n\n const object: IObjectRef = { key };\n const link = normalizeLinkFn\n ? normalizeLinkFn({ bucket, object })\n : this.normalizeObjectLink({ bucket, object });\n\n await this.writeObject({ bucket, object, file });\n\n this.logger\n .for(this.upload.name)\n .info(\n 'Uploaded: %j | Took: %s (ms)',\n { key, link, mimeType, encoding, size },\n performance.now() - t,\n );\n\n return {\n bucket: { name: bucket.name },\n object: { key, size, contentType: mimeType },\n link,\n };\n },\n });\n }\n\n /** Correct anywhere; overridden by a backend whose transport is already a web stream. */\n async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const source = await this.getObject({ bucket, object });\n\n if (!range) {\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n // No native range here: take the window off the front of the full stream. `pull` rather than\n // `start`, so one chunk is read per demand instead of the whole range landing in memory.\n const { start, end } = range;\n const chunks = source[Symbol.asyncIterator]();\n let offset = 0;\n\n return new ReadableStream<Uint8Array>({\n async pull(controller) {\n while (true) {\n const next = await chunks.next();\n\n if (next.done) {\n controller.close();\n return;\n }\n\n const bytes = next.value as Uint8Array;\n const chunkEnd = offset + bytes.byteLength;\n const from = Math.max(start - offset, 0);\n const to =\n end === undefined ? bytes.byteLength : Math.min(end + 1 - offset, bytes.byteLength);\n const isWanted = chunkEnd > start && from < to;\n\n if (isWanted) {\n controller.enqueue(bytes.subarray(from, to));\n }\n\n offset = chunkEnd;\n\n if (end !== undefined && offset > end) {\n source.destroy();\n controller.close();\n return;\n }\n\n if (isWanted) {\n return;\n }\n }\n },\n\n // Without this a client that aborts leaves the backend stream draining to nowhere.\n cancel() {\n source.destroy();\n },\n });\n }\n\n /**\n * Correct anywhere, and the wrong path to stay on: it buffers, so a backend whose transport takes\n * a stream overrides it. `BunS3Helper` does.\n */\n async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n const body =\n source instanceof Response || source instanceof Request ? source : new Response(source);\n const buffer = Buffer.from(await body.arrayBuffer());\n\n await this.writeObject({\n bucket,\n object,\n file: {\n originalName: object.key,\n mimetype: contentType ?? this.getMimeType({ filename: object.key }),\n buffer,\n size: buffer.length,\n },\n });\n }\n\n /** Bounded fan-out on the shared limiter; unbounded exhausts sockets and gets rate limited. */\n protected async mapWithConcurrency<Item, Result>(opts: {\n items: Item[];\n limit?: number;\n task: (taskOptions: { item: Item; index: number }) => Promise<Result>;\n }): Promise<Result[]> {\n const { items, task } = opts;\n\n if (items.length === 0) {\n return [];\n }\n\n return executePromiseWithLimit({\n limit: Math.max(1, opts.limit ?? StorageConcurrency.DEFAULT_LIMIT),\n tasks: items.map((item, index) => () => task({ item, index })),\n });\n }\n\n /** A \"not there\" failure becomes a catalogued 404; every other failure passes through unchanged. */\n protected asStorageError(opts: IObjectLocation & { error: unknown; operation: string }): unknown {\n const { error, operation, bucket, object } = opts;\n\n if (!isNotFoundError({ error })) {\n return error;\n }\n\n return getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[${operation}] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n // No transport for these: throwing beats returning undefined, which reads as a valid empty result.\n async copyObject(_opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.copyObject] Server-side copy is not supported by this helper`,\n });\n }\n\n async presignPost(_opts: {\n bucket: IBucketRef;\n keyPrefix: string;\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n }): Promise<IPostPolicy> {\n throw getError({\n message: `[${this.constructor.name}.presignPost] Signed POST policies are not supported by this helper`,\n });\n }\n\n async presignPut(\n _opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignPut] Presigned PUT URLs are not supported by this helper`,\n });\n }\n\n async presignGet(\n _opts: IObjectLocation & { expiresIn?: IDuration; responseContentType?: string },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignGet] Presigned GET URLs are not supported by this helper`,\n });\n }\n\n async getObjectTags(_opts: IObjectLocation): Promise<Record<string, string>> {\n throw getError({\n message: `[${this.constructor.name}.getObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n async replaceObjectTags(\n _opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.replaceObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n abstract hasBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n abstract getBuckets(): Promise<IBucketInfo[]>;\n abstract getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract removeBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n\n abstract getObject(opts: IObjectLocation & { options?: any }): Promise<Readable>;\n abstract getStat(opts: IObjectLocation): Promise<IFileStat>;\n abstract removeObject(opts: IObjectLocation): Promise<void>;\n abstract removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void>;\n abstract listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/modules/storage/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport { ContentTypeTable, type IDuration, MimeTypes } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { executePromiseWithLimit } from '@/utilities/promise.utility';\nimport { Readable } from 'node:stream';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IPostPolicy,\n type IObjectRef,\n type IStorageHelper,\n type IUploadFile,\n type IUploadResult,\n type TUploadNaming,\n} from './common';\nimport { isNotFoundError, StorageConcurrency, StorageErrors } from './common';\n\nexport abstract class BaseStorageHelper extends BaseHelper implements IStorageHelper {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n getMimeType(opts: { filename: string }): string {\n return ContentTypeTable.resolve(opts);\n }\n\n /** One path segment or file name: no separator, no traversal, no control or shell character. */\n isValidSegment(opts: { segment: string }): boolean {\n const name = opts.segment;\n\n if (typeof name !== 'string') {\n this.logger.for(this.isValidSegment.name).error('Invalid name provided: %j', name);\n return false;\n }\n\n if (!name || isEmpty({ value: name })) {\n this.logger.for(this.isValidSegment.name).error('Empty name provided');\n return false;\n }\n\n if (name.includes('..') || name.includes('/') || name.includes('\\\\')) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains invalid path characters: %s', name);\n return false;\n }\n\n if (name.startsWith('.')) {\n this.logger.for(this.isValidSegment.name).error('Name cannot start with a dot: %s', name);\n return false;\n }\n\n const dangerousChars = /[;|&$`<>{}[\\]!#]/;\n if (dangerousChars.test(name)) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains dangerous characters: %s', name);\n return false;\n }\n\n if (name.includes('\\n') || name.includes('\\r') || name.includes('\\0')) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains invalid control characters: %s', name);\n return false;\n }\n\n if (name.length > 255) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name is too long (%d characters): %s', name.length, name);\n return false;\n }\n\n if (name.trim().length === 0) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name cannot be empty or whitespace only: \"%s\"', name);\n return false;\n }\n\n return true;\n }\n\n static readonly DEFAULT_MAX_FOLDER_DEPTH = 2;\n\n /** Control characters and lone surrogates: never part of a file name, and not encodable into a header. */\n private static readonly UNSAFE_NAME_CHARACTERS = /[\\p{Cc}\\p{Cs}]/u;\n\n /** A bucket name is one segment; a separator in it would silently address a different bucket. */\n isValidBucketName(opts: { bucket: IBucketRef }): boolean {\n return this.isValidSegment({ segment: opts.bucket.name });\n }\n\n /** A whole object key: every segment valid, and no deeper than `maxDepth` folders. */\n isValidObjectKey(opts: { object: IObjectRef; maxDepth?: number }): boolean {\n return this.isValidKeyPath({ path: opts.object.key, maxDepth: opts.maxDepth });\n }\n\n /** The shared rule behind `isValidObjectKey` and the folder check inside `upload`. */\n protected isValidKeyPath(opts: { path: string; maxDepth?: number }): boolean {\n const { path: pathStr } = opts;\n const maxDepth = opts.maxDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n\n if (typeof pathStr !== 'string' || !pathStr || isEmpty({ value: pathStr })) {\n this.logger.for(this.isValidKeyPath.name).error('Empty or invalid path provided');\n return false;\n }\n\n const normalized = pathStr.replace(/^\\/+|\\/+$/g, '');\n if (!normalized) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path resolved to empty after trimming slashes');\n return false;\n }\n\n const segments = normalized.split('/');\n\n if (segments.some((s) => s.length === 0)) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path contains empty segments (double slashes): %s', pathStr);\n return false;\n }\n\n // segments include the filename, so depth is one less.\n const folderDepth = segments.length - 1;\n if (folderDepth > maxDepth) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path exceeds max folder depth (%d): %s (depth: %d)',\n maxDepth,\n pathStr,\n folderDepth,\n );\n return false;\n }\n\n for (const segment of segments) {\n if (!this.isValidSegment({ segment })) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path segment failed validation: %s (in path: %s)', segment, pathStr);\n return false;\n }\n }\n\n if (normalized.length > 1024) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path is too long (%d characters): %s', normalized.length, pathStr);\n return false;\n }\n\n return true;\n }\n\n getMediaType(opts: { mimeType: string }): string {\n const { mimeType } = opts;\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.IMAGE)) {\n return MimeTypes.IMAGE;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.VIDEO)) {\n return MimeTypes.VIDEO;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.TEXT)) {\n return MimeTypes.TEXT;\n }\n\n return MimeTypes.UNKNOWN;\n }\n\n /** Public URL prefix; keeps its trailing slash. */\n protected abstract get defaultLinkPrefix(): string;\n\n /** Backend write step; owns its metadata and error handling. */\n protected abstract writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void>;\n\n protected normalizeObjectName(opts: { file: TUploadNaming }): string {\n const { originalName, folderPath } = opts.file;\n const normalizedFileName = originalName.toLowerCase().replace(/ /g, '_');\n\n if (!folderPath) {\n return normalizedFileName;\n }\n\n return `${folderPath.toLowerCase().replace(/ /g, '_')}/${normalizedFileName}`;\n }\n\n protected normalizeObjectLink(opts: IObjectLocation): string {\n const bucketName = opts.bucket.name;\n const encodedName = opts.object.key\n .split('/')\n .map((segment) => encodeURIComponent(segment))\n .join('/');\n\n return `${this.defaultLinkPrefix}${bucketName}/${encodedName}`;\n }\n\n /** An original name that is only metadata - the key is resolved elsewhere and validated on its own. */\n protected isValidOriginalName(opts: { name: string }): boolean {\n const { name } = opts;\n\n if (typeof name !== 'string' || name.trim().length === 0 || name.length > 255) {\n this.logger.for(this.isValidOriginalName.name).error('Invalid original name: %j', name);\n return false;\n }\n\n if (BaseStorageHelper.UNSAFE_NAME_CHARACTERS.test(name)) {\n this.logger\n .for(this.isValidOriginalName.name)\n .error('Original name contains a control character or a lone surrogate: %j', name);\n return false;\n }\n\n return true;\n }\n\n /** `isKeyResolvedByCaller`: a `normalizeNameFn` decides the key, so the original name is metadata and meets the metadata rule, not the key rule. */\n protected validateUploadFiles(opts: {\n files: IUploadFile[];\n maxFolderDepth?: number;\n isKeyResolvedByCaller?: boolean;\n }): void {\n const { files, maxFolderDepth, isKeyResolvedByCaller = false } = opts;\n\n for (const file of files) {\n this.validateUploadFile({ file, maxFolderDepth, isKeyResolvedByCaller });\n }\n }\n\n private validateUploadFile(opts: {\n file: IUploadFile;\n maxFolderDepth?: number;\n isKeyResolvedByCaller: boolean;\n }): void {\n const { file, maxFolderDepth, isKeyResolvedByCaller } = opts;\n const { originalName, size, folderPath } = file;\n\n const isNameValid = isKeyResolvedByCaller\n ? this.isValidOriginalName({ name: originalName })\n : this.isValidSegment({ segment: originalName });\n\n if (!isNameValid) {\n throw getError({ message: '[upload] Invalid original file name' });\n }\n\n // Checked against the CALLER's depth, before the body is spooled. `isValidKeyPath` measures an\n // object path (one folder deeper than a bare folderPath), so the depth is checked directly.\n if (folderPath) {\n const depthLimit = maxFolderDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n const folderSegments = folderPath.replace(/^\\/+|\\/+$/g, '').split('/');\n\n if (folderSegments.length > depthLimit) {\n throw getError({\n message: `[upload] Invalid folder path | depth: ${folderSegments.length} | max: ${depthLimit}`,\n });\n }\n\n if (!this.isValidKeyPath({ path: folderPath, maxDepth: depthLimit })) {\n throw getError({ message: '[upload] Invalid folder path' });\n }\n }\n\n // Missing or negative is invalid; zero is a legitimate empty file.\n if (size === undefined || size === null || size < 0) {\n throw getError({ message: `[upload] Invalid file size | size: ${size}` });\n }\n }\n\n async upload(opts: {\n bucket: IBucketRef;\n files: IUploadFile[];\n normalizeNameFn?: (opts: { file: TUploadNaming }) => string;\n normalizeLinkFn?: (opts: IObjectLocation) => string;\n /** Folder nesting allowed. Omitted -> DEFAULT_MAX_FOLDER_DEPTH. */\n maxFolderDepth?: number;\n }): Promise<IUploadResult[]> {\n const { bucket, files, normalizeNameFn, normalizeLinkFn, maxFolderDepth } = opts;\n\n if (!files || files.length === 0) {\n return [];\n }\n\n const isExists = await this.hasBucket({ bucket });\n if (!isExists) {\n throw getError({\n message: `[upload] Bucket does not exist | name: ${bucket.name}`,\n });\n }\n\n this.validateUploadFiles({\n files,\n maxFolderDepth,\n isKeyResolvedByCaller: normalizeNameFn !== undefined,\n });\n\n // Every key is resolved and validated before the first write, so one bad key stores nothing.\n const keys = files.map((file) => {\n const naming: TUploadNaming = {\n originalName: file.originalName,\n folderPath: file.folderPath,\n };\n const key = normalizeNameFn\n ? normalizeNameFn({ file: naming })\n : this.normalizeObjectName({ file: naming });\n\n if (!this.isValidObjectKey({ object: { key }, maxDepth: maxFolderDepth })) {\n throw getError({\n message: `[upload] Invalid normalized object name | name: ${key}`,\n });\n }\n\n return key;\n });\n\n return this.mapWithConcurrency({\n items: files,\n task: async ({ item: file, index }) => {\n const { mimetype: mimeType, size, encoding } = file;\n const t = performance.now();\n const key = keys[index];\n\n const object: IObjectRef = { key };\n const link = normalizeLinkFn\n ? normalizeLinkFn({ bucket, object })\n : this.normalizeObjectLink({ bucket, object });\n\n await this.writeObject({ bucket, object, file });\n\n this.logger\n .for(this.upload.name)\n .info(\n 'Uploaded: %j | Took: %s (ms)',\n { key, link, mimeType, encoding, size },\n performance.now() - t,\n );\n\n return {\n bucket: { name: bucket.name },\n object: { key, size, contentType: mimeType },\n link,\n };\n },\n });\n }\n\n /** Correct anywhere; overridden by a backend whose transport is already a web stream. */\n async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const source = await this.getObject({ bucket, object });\n\n if (!range) {\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n // No native range here: take the window off the front of the full stream. `pull` rather than\n // `start`, so one chunk is read per demand instead of the whole range landing in memory.\n const { start, end } = range;\n const chunks = source[Symbol.asyncIterator]();\n let offset = 0;\n\n return new ReadableStream<Uint8Array>({\n async pull(controller) {\n while (true) {\n const next = await chunks.next();\n\n if (next.done) {\n controller.close();\n return;\n }\n\n const bytes = next.value as Uint8Array;\n const chunkEnd = offset + bytes.byteLength;\n const from = Math.max(start - offset, 0);\n const to =\n end === undefined ? bytes.byteLength : Math.min(end + 1 - offset, bytes.byteLength);\n const isWanted = chunkEnd > start && from < to;\n\n if (isWanted) {\n controller.enqueue(bytes.subarray(from, to));\n }\n\n offset = chunkEnd;\n\n if (end !== undefined && offset > end) {\n source.destroy();\n controller.close();\n return;\n }\n\n if (isWanted) {\n return;\n }\n }\n },\n\n // Without this a client that aborts leaves the backend stream draining to nowhere.\n cancel() {\n source.destroy();\n },\n });\n }\n\n /**\n * Correct anywhere, and the wrong path to stay on: it buffers, so a backend whose transport takes\n * a stream overrides it. `BunS3Helper` does.\n */\n async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n const body =\n source instanceof Response || source instanceof Request ? source : new Response(source);\n const buffer = Buffer.from(await body.arrayBuffer());\n\n await this.writeObject({\n bucket,\n object,\n file: {\n originalName: object.key,\n mimetype: contentType ?? this.getMimeType({ filename: object.key }),\n buffer,\n size: buffer.length,\n },\n });\n }\n\n /** Bounded fan-out on the shared limiter; unbounded exhausts sockets and gets rate limited. */\n protected async mapWithConcurrency<Item, Result>(opts: {\n items: Item[];\n limit?: number;\n task: (taskOptions: { item: Item; index: number }) => Promise<Result>;\n }): Promise<Result[]> {\n const { items, task } = opts;\n\n if (items.length === 0) {\n return [];\n }\n\n return executePromiseWithLimit({\n limit: Math.max(1, opts.limit ?? StorageConcurrency.DEFAULT_LIMIT),\n tasks: items.map((item, index) => () => task({ item, index })),\n });\n }\n\n /** A \"not there\" failure becomes a catalogued 404; every other failure passes through unchanged. */\n protected asStorageError(opts: IObjectLocation & { error: unknown; operation: string }): unknown {\n const { error, operation, bucket, object } = opts;\n\n if (!isNotFoundError({ error })) {\n return error;\n }\n\n return getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[${operation}] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n // No transport for these: throwing beats returning undefined, which reads as a valid empty result.\n async copyObject(_opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.copyObject] Server-side copy is not supported by this helper`,\n });\n }\n\n async presignPost(_opts: {\n bucket: IBucketRef;\n keyPrefix: string;\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n }): Promise<IPostPolicy> {\n throw getError({\n message: `[${this.constructor.name}.presignPost] Signed POST policies are not supported by this helper`,\n });\n }\n\n async presignPut(\n _opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignPut] Presigned PUT URLs are not supported by this helper`,\n });\n }\n\n async presignGet(\n _opts: IObjectLocation & { expiresIn?: IDuration; responseContentType?: string },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignGet] Presigned GET URLs are not supported by this helper`,\n });\n }\n\n async getObjectTags(_opts: IObjectLocation): Promise<Record<string, string>> {\n throw getError({\n message: `[${this.constructor.name}.getObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n async replaceObjectTags(\n _opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.replaceObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n abstract hasBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n abstract getBuckets(): Promise<IBucketInfo[]>;\n abstract getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract removeBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n\n abstract getObject(opts: IObjectLocation & { options?: any }): Promise<Readable>;\n abstract getStat(opts: IObjectLocation): Promise<IFileStat>;\n abstract removeObject(opts: IObjectLocation): Promise<void>;\n abstract removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void>;\n abstract listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;\n}\n"]}
|
|
@@ -113,7 +113,7 @@ export class BunS3Helper extends BaseStorageHelper {
|
|
|
113
113
|
return null;
|
|
114
114
|
}
|
|
115
115
|
const buckets = await this.getBuckets();
|
|
116
|
-
return buckets.find(bucket => bucket.name === name) ?? null;
|
|
116
|
+
return buckets.find((bucket) => bucket.name === name) ?? null;
|
|
117
117
|
}
|
|
118
118
|
async createBucket(opts) {
|
|
119
119
|
const { name } = opts.bucket;
|