@geekmidas/events 10.0.0-alpha.9 → 10.0.0-alpha.91

package/dist/SQSSubscriber-COTqWvOk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SQSSubscriber-COTqWvOk.cjs","names":["SQSClient","chunk","publishTraced","carrierAsAttributes","SendMessageBatchCommand","ReceiveMessageCommand","consumeTraced","carrierFromAttributes","DeleteMessageCommand"],"sources":["../src/sqs/SQSConnection.ts","../src/sqs/SQSPublisher.ts","../src/sqs/SQSSubscriber.ts"],"sourcesContent":["import { SQSClient, type SQSClientConfig } from '@aws-sdk/client-sqs';\nimport type { EventConnection } from '../types';\nimport { EventPublisherType } from '../types';\nimport * as sqsUrl from './sqsUrl';\n\nexport interface SQSConnectionConfig {\n\tqueueUrl: string;\n\tregion?: string;\n\tendpoint?: string; // Custom endpoint (e.g., for LocalStack)\n\tcredentials?: {\n\t\taccessKeyId: string;\n\t\tsecretAccessKey: string;\n\t\tsessionToken?: string;\n\t};\n}\n\nexport class SQSConnection implements EventConnection {\n\treadonly type = EventPublisherType.SQS;\n\tprivate client: SQSClient;\n\tprivate connected = false;\n\n\tconstructor(readonly config: SQSConnectionConfig) {\n\t\tthis.config = config;\n\n\t\tconst clientConfig: SQSClientConfig = {\n\t\t\tregion: config.region,\n\t\t\tendpoint: config.endpoint,\n\t\t\tcredentials: config.credentials,\n\t\t};\n\n\t\tthis.client = new SQSClient(clientConfig);\n\t}\n\n\t/**\n\t * Create an SQSConnection from a connection string\n\t * Format: sqs://?queueUrl=https://sqs.region.amazonaws.com/accountId/queueName&region=us-east-1&endpoint=http://localhost:4566\n\t */\n\tstatic async fromConnectionString(\n\t\tconnectionString: string,\n\t): Promise<SQSConnection> {\n\t\t// Through the codec, not a second hand-rolled parse: the deploy target\n\t\t// composes these with `sqsUrl.build`, and a string it cannot read back is\n\t\t// exactly the drift one shared module rules out.\n\t\tconst { queueUrl, region, endpoint } = sqsUrl.parse(connectionString);\n\t\tconst params = new URL(connectionString).searchParams;\n\n\t\tconst config: SQSConnectionConfig = {\n\t\t\tqueueUrl,\n\t\t\tregion,\n\t\t\tendpoint,\n\t\t};\n\n\t\t// Credentials are not part of the address — see `sqsUrl` — but a caller\n\t\t// may still pin them here, so they are read beside it rather than in it.\n\t\tconst accessKeyId = params.get('accessKeyId');\n\t\tconst secretAccessKey = params.get('secretAccessKey');\n\t\tif (accessKeyId && secretAccessKey) {\n\t\t\tconfig.credentials = {\n\t\t\t\taccessKeyId,\n\t\t\t\tsecretAccessKey,\n\t\t\t\tsessionToken: params.get('sessionToken') || undefined,\n\t\t\t};\n\t\t}\n\n\t\tconst connection = new SQSConnection(config);\n\t\tawait connection.connect();\n\t\treturn connection;\n\t}\n\n\tasync connect(): Promise<void> {\n\t\t// SQS doesn't have a traditional connection, but we mark as connected\n\t\tthis.connected = true;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.client.destroy();\n\t\tthis.connected = false;\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Get the underlying SQS client\n\t */\n\tget sqsClient(): SQSClient {\n\t\treturn this.client;\n\t}\n\n\t/**\n\t * Get the queue URL for this connection\n\t */\n\tget queueUrl(): string {\n\t\treturn this.config.queueUrl;\n\t}\n}\n","import {\n\tSendMessageBatchCommand,\n\ttype SendMessageBatchCommandInput,\n\ttype SendMessageBatchRequestEntry,\n} from '@aws-sdk/client-sqs';\nimport chunk from 'lodash.chunk';\nimport { carrierAsAttributes, publishTraced } from '../telemetry';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SQSConnection } from './SQSConnection';\n\nexport interface SQSPublisherOptions {\n\tmaxBatchSize?: number; // Default: 10 (SQS limit)\n}\n\nexport class SQSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\treadonly options: Required<SQSPublisherOptions>;\n\n\tconstructor(\n\t\treadonly connection: SQSConnection,\n\t\toptions: SQSPublisherOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tmaxBatchSize: options.maxBatchSize ?? 10, // SQS limit\n\t\t};\n\t}\n\n\t/**\n\t * Create an SQSPublisher from a connection string\n\t * Format: sqs://?queueUrl=https://sqs.region.amazonaws.com/accountId/queueName&region=us-east-1&endpoint=http://localhost:4566&maxBatchSize=10\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SQSPublisher<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SQSConnection } = await import('./SQSConnection');\n\t\tconst connection =\n\t\t\tawait SQSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SQSPublisherOptions = {\n\t\t\tmaxBatchSize: params.get('maxBatchSize')\n\t\t\t\t? Number.parseInt(params.get('maxBatchSize')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SQSPublisher<TMessage>(connection, options);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\t// Split messages into batches (SQS limit is 10 messages per batch)\n\t\tconst batches = chunk(messages, this.options.maxBatchSize);\n\n\t\t// Send all batches\n\t\tawait Promise.all(batches.map((batch) => this.sendBatch(batch)));\n\t}\n\n\tprivate async sendBatch(messages: TMessage[]): Promise<void> {\n\t\tconst destination = sqsQueueName(this.connection.queueUrl);\n\t\tawait publishTraced(\n\t\t\tmessages,\n\t\t\t(message) => ({ system: 'aws_sqs', destination, type: message.type }),\n\t\t\t(carriers) =>\n\t\t\t\tthis.send(\n\t\t\t\t\tmessages.map((message, index) => ({\n\t\t\t\t\t\tId: `${index}`,\n\t\t\t\t\t\tMessageBody: JSON.stringify({\n\t\t\t\t\t\t\ttype: message.type,\n\t\t\t\t\t\t\tpayload: message.payload,\n\t\t\t\t\t\t}),\n\t\t\t\t\t\t// The trace context as message attributes — SQS's own header\n\t\t\t\t\t\t// field — beside the type.\n\t\t\t\t\t\tMessageAttributes: {\n\t\t\t\t\t\t\ttype: {\n\t\t\t\t\t\t\t\tDataType: 'String',\n\t\t\t\t\t\t\t\tStringValue: message.type,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t...carrierAsAttributes(carriers[index]),\n\t\t\t\t\t\t},\n\t\t\t\t\t})),\n\t\t\t\t),\n\t\t);\n\t}\n\n\tprivate async send(entries: SendMessageBatchRequestEntry[]): Promise<void> {\n\t\tconst input: SendMessageBatchCommandInput = {\n\t\t\tQueueUrl: this.connection.queueUrl,\n\t\t\tEntries: entries,\n\t\t};\n\n\t\tconst command = new SendMessageBatchCommand(input);\n\t\tconst response = await this.connection.sqsClient.send(command);\n\n\t\t// Check for failures\n\t\tif (response.Failed && response.Failed.length > 0) {\n\t\t\tthrow new SqsBatchPartlyFailed(\n\t\t\t\tresponse.Failed.map((f) => ({\n\t\t\t\t\tid: f.Id,\n\t\t\t\t\tcode: f.Code,\n\t\t\t\t\tmessage: f.Message,\n\t\t\t\t})),\n\t\t\t);\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n\n/** SQS accepted the batch but refused some of its messages; the rest were sent. */\nexport class SqsBatchPartlyFailed extends Error {\n\tconstructor(\n\t\treadonly failed: readonly {\n\t\t\tid?: string;\n\t\t\tcode?: string;\n\t\t\tmessage?: string;\n\t\t}[],\n\t) {\n\t\tsuper(\n\t\t\t`Failed to send ${failed.length} messages: ${failed.map((f) => `${f.id}: ${f.code} - ${f.message}`).join(', ')}. The others in the batch were sent; retry only these.`,\n\t\t);\n\t\tthis.name = 'SqsBatchPartlyFailed';\n\t}\n}\n\n/** The queue's name, the last segment of its URL. */\nexport function sqsQueueName(queueUrl: string): string {\n\treturn queueUrl.split('/').filter(Boolean).pop() ?? queueUrl;\n}\n","import {\n\tDeleteMessageCommand,\n\ttype Message,\n\tReceiveMessageCommand,\n} from '@aws-sdk/client-sqs';\nimport {\n\tcarrierFromAttributes,\n\tconsumeTraced,\n\ttype TraceCarrier,\n} from '../telemetry';\nimport type { EventSubscriber, PublishableMessage } from '../types';\nimport type { SQSConnection } from './SQSConnection';\nimport { sqsQueueName } from './SQSPublisher';\n\nexport interface SQSSubscriberOptions {\n\twaitTimeSeconds?: number; // SQS long polling (default: 20)\n\tmaxMessages?: number; // Max messages per poll (default: 10)\n\texpectedTopicArn?: string; // Optional: verify messages are from specific SNS topic\n}\n\n/**\n * SQS Subscriber - receives messages from an SQS queue\n *\n * This subscriber can receive:\n * 1. Direct SQS messages\n * 2. SNS messages that were pushed to the queue (SNS → SQS pattern)\n *\n * When receiving SNS messages, it:\n * - Automatically detects and parses the SNS wrapper format\n * - Filters by TopicArn (if expectedTopicArn is provided)\n * - Filters by message type\n * - Processes the actual message payload\n */\nexport class SQSSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tprivate polling = false;\n\tprivate messageTypes: Set<TMessage['type']> = new Set();\n\tprivate listener?: (payload: TMessage) => Promise<void>;\n\tprivate options: Required<SQSSubscriberOptions>;\n\n\tconstructor(\n\t\tprivate connection: SQSConnection,\n\t\toptions: SQSSubscriberOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\twaitTimeSeconds: options.waitTimeSeconds ?? 20,\n\t\t\tmaxMessages: options.maxMessages ?? 10,\n\t\t\texpectedTopicArn: options.expectedTopicArn ?? '',\n\t\t};\n\t}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\tthis.messageTypes = new Set(messages);\n\t\tthis.listener = listener;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\tthis.polling = true;\n\t\tthis.poll();\n\t}\n\n\tstop(): void {\n\t\tthis.polling = false;\n\t}\n\n\tprivate async poll(): Promise<void> {\n\t\twhile (this.polling) {\n\t\t\ttry {\n\t\t\t\tconst command = new ReceiveMessageCommand({\n\t\t\t\t\tQueueUrl: this.connection.queueUrl,\n\t\t\t\t\tMaxNumberOfMessages: this.options.maxMessages,\n\t\t\t\t\tWaitTimeSeconds: this.options.waitTimeSeconds,\n\t\t\t\t\tMessageAttributeNames: ['All'],\n\t\t\t\t});\n\n\t\t\t\tconst response = await this.connection.sqsClient.send(command);\n\n\t\t\t\tif (response.Messages && response.Messages.length > 0) {\n\t\t\t\t\tawait this.processMessages(response.Messages);\n\t\t\t\t}\n\t\t\t} catch (_error) {\n\t\t\t\tawait this.sleep(1000);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async processMessages(messages: Message[]): Promise<void> {\n\t\tfor (const message of messages) {\n\t\t\ttry {\n\t\t\t\tif (!message.Body) continue;\n\n\t\t\t\t// Try to parse as SNS message first\n\t\t\t\tconst parsedMessage = this.parseMessage(\n\t\t\t\t\tmessage.Body,\n\t\t\t\t\tmessage.MessageAttributes,\n\t\t\t\t);\n\n\t\t\t\tif (!parsedMessage) {\n\t\t\t\t\t// Not a valid message format\n\t\t\t\t\tawait this.deleteMessage(message.ReceiptHandle!);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tconst { payload, messageType, topicArn, carrier } = parsedMessage;\n\n\t\t\t\t// If expectedTopicArn is set, verify the message is from that topic\n\t\t\t\tif (this.options.expectedTopicArn && topicArn) {\n\t\t\t\t\tif (topicArn !== this.options.expectedTopicArn) {\n\t\t\t\t\t\tawait this.deleteMessage(message.ReceiptHandle!);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// Check if we're subscribed to this message type\n\t\t\t\tif (\n\t\t\t\t\tmessageType &&\n\t\t\t\t\tthis.messageTypes.has(messageType as TMessage['type'])\n\t\t\t\t) {\n\t\t\t\t\t// Call listener\n\t\t\t\t\tconst listener = this.listener;\n\t\t\t\t\tif (listener) {\n\t\t\t\t\t\tawait consumeTraced(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tsystem: 'aws_sqs',\n\t\t\t\t\t\t\t\tdestination: sqsQueueName(this.connection.queueUrl),\n\t\t\t\t\t\t\t\ttype: messageType,\n\t\t\t\t\t\t\t\tmessageId: message.MessageId,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tcarrier,\n\t\t\t\t\t\t\t() => listener(payload as TMessage),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Delete message after successful processing\n\t\t\t\t\tawait this.deleteMessage(message.ReceiptHandle!);\n\t\t\t\t} else {\n\t\t\t\t\t// Delete messages we're not subscribed to\n\t\t\t\t\tawait this.deleteMessage(message.ReceiptHandle!);\n\t\t\t\t}\n\t\t\t} catch (_error) {\n\t\t\t\t// Message will become visible again\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Parse message body - handles both direct SQS messages and SNS-wrapped messages\n\t */\n\tprivate parseMessage(\n\t\tbody: string,\n\t\tattributes: Record<string, unknown> | undefined,\n\t): {\n\t\tpayload: unknown;\n\t\tmessageType: string | undefined;\n\t\ttopicArn?: string;\n\t\tcarrier?: TraceCarrier;\n\t} | null {\n\t\ttry {\n\t\t\tconst parsed = JSON.parse(body);\n\n\t\t\t// Check if this is an SNS notification wrapper\n\t\t\tif (parsed.Type === 'Notification' && parsed.Message) {\n\t\t\t\t// This is an SNS message\n\t\t\t\tconst snsMessage = JSON.parse(parsed.Message);\n\t\t\t\tconst messageType =\n\t\t\t\t\tparsed.MessageAttributes?.type?.Value || snsMessage.type;\n\n\t\t\t\treturn {\n\t\t\t\t\tpayload: snsMessage,\n\t\t\t\t\tmessageType,\n\t\t\t\t\ttopicArn: parsed.TopicArn,\n\t\t\t\t\t// SNS's message attributes, carried in its envelope.\n\t\t\t\t\tcarrier: carrierFromAttributes(parsed.MessageAttributes),\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// This is a direct SQS message\n\t\t\treturn {\n\t\t\t\tpayload: parsed,\n\t\t\t\tmessageType: parsed.type,\n\t\t\t\tcarrier: carrierFromAttributes(attributes),\n\t\t\t};\n\t\t} catch (_error) {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tprivate async deleteMessage(receiptHandle: string): Promise<void> {\n\t\ttry {\n\t\t\tconst command = new DeleteMessageCommand({\n\t\t\t\tQueueUrl: this.connection.queueUrl,\n\t\t\t\tReceiptHandle: receiptHandle,\n\t\t\t});\n\t\t\tawait this.connection.sqsClient.send(command);\n\t\t} catch (_error) {}\n\t}\n\n\tprivate sleep(ms: number): Promise<void> {\n\t\treturn new Promise((resolve) => setTimeout(resolve, ms));\n\t}\n}\n"],"mappings":"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"}

package/dist/basic/index.cjs

@@ -1,10 +1,9 @@
-const require_chunk = require('../chunk-CsX-DzYB.cjs');
-const require_types = require('../types-Byv8N9ma.cjs');
-const node_events = require_chunk.__toESM(require("node:events"));
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_telemetry = require("../telemetry-DG3l807O.cjs");
+let node_events = require("node:events");
 //#region src/basic/BasicConnection.ts
 var BasicConnection = class BasicConnection {
-	type = require_types.EventPublisherType.Basic;
+	type = "basic";
 	emitter;
 	connected = false;
 	constructor() {
@@ -37,35 +36,66 @@ var BasicConnection = class BasicConnection {
 		return this.emitter;
 	}
 };
-
 //#endregion
 //#region src/basic/BasicPublisher.ts
 var BasicPublisher = class {
+	connection;
 	constructor(connection) {
 		this.connection = connection;
 	}
 	async publish(messages) {
 		const emitter = this.connection.eventEmitter;
-		for (const message of messages) emitter.emit(message.type, message);
+		await require_telemetry.publishTraced(messages, (message) => ({
+			system: "basic",
+			destination: message.type,
+			type: message.type
+		}), async (carriers) => {
+			messages.forEach((message, i) => {
+				emitter.emit(message.type, message, carriers[i]);
+			});
+		});
 	}
 };
-
 //#endregion
 //#region src/basic/BasicSubscriber.ts
 var BasicSubscriber = class {
+	connection;
 	constructor(connection) {
 		this.connection = connection;
 	}
 	async subscribe(messages, listener) {
 		const emitter = this.connection.eventEmitter;
-		for (const messageType of messages) emitter.on(messageType, (message) => {
-			listener(message).catch((_error) => {});
+		for (const messageType of messages) emitter.on(messageType, (message, carrier) => {
+			require_telemetry.consumeTraced({
+				system: "basic",
+				destination: messageType,
+				type: messageType
+			}, carrier, () => listener(message)).catch((_error) => {});
 		});
 	}
 };
-
+//#endregion
+//#region src/basic/driver.ts
+/**
+* `basic://` — an in-process `EventEmitter`. Register it with
+* `registerEventsDriver(basicEventsDriver)`.
+*/
+const basicEventsDriver = {
+	scheme: "basic",
+	connect: (url) => BasicConnection.fromConnectionString(url),
+	async publisher(url) {
+		return new BasicPublisher(await BasicConnection.fromConnectionString(url));
+	},
+	publisherFor: (connection) => new BasicPublisher(connection),
+	async subscriber(url) {
+		return new BasicSubscriber(await BasicConnection.fromConnectionString(url));
+	},
+	subscriberFor: (connection) => new BasicSubscriber(connection)
+};
 //#endregion
 exports.BasicConnection = BasicConnection;
 exports.BasicPublisher = BasicPublisher;
 exports.BasicSubscriber = BasicSubscriber;
+exports.basicEventsDriver = basicEventsDriver;
+
 //# sourceMappingURL=index.cjs.map

package/dist/basic/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["EventPublisherType","EventEmitter","_connectionString: string","connection: BasicConnection","messages: TMessage[]","connection: BasicConnection","messages: TMessage['type'][]","listener: (payload: TMessage) => Promise<void>","message: TMessage"],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { EventConnection } from '../types';\nimport { EventPublisherType } from '../types';\n\nexport class BasicConnection implements EventConnection {\n\treadonly type = EventPublisherType.Basic;\n\tprivate emitter: EventEmitter;\n\tprivate connected = false;\n\n\tconstructor() {\n\t\tthis.emitter = new EventEmitter();\n\t}\n\n\t/**\n\t * Create a BasicConnection from a connection string\n\t * Format: basic://\n\t */\n\tstatic async fromConnectionString(\n\t\t_connectionString: string,\n\t): Promise<BasicConnection> {\n\t\t// Basic connection doesn't need any configuration\n\t\tconst connection = new BasicConnection();\n\t\tawait connection.connect();\n\t\treturn connection;\n\t}\n\n\tasync connect(): Promise<void> {\n\t\tthis.connected = true;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.emitter.removeAllListeners();\n\t\tthis.connected = false;\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Get the underlying EventEmitter\n\t * Used by BasicPublisher and BasicSubscriber\n\t */\n\tget eventEmitter(): EventEmitter {\n\t\treturn this.emitter;\n\t}\n}\n","import type { EventPublisher, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync publish(messages: TMessage[]) {\n\t\tconst emitter = this.connection.eventEmitter;\n\t\tfor (const message of messages) {\n\t\t\temitter.emit(message.type, message);\n\t\t}\n\t}\n}\n","import type { EventSubscriber, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\tconst emitter = this.connection.eventEmitter;\n\n\t\tfor (const messageType of messages) {\n\t\t\temitter.on(messageType, (message: TMessage) => {\n\t\t\t\tlistener(message).catch((_error) => {});\n\t\t\t});\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AAIA,IAAa,kBAAb,MAAa,gBAA2C;CACvD,AAAS,OAAOA,iCAAmB;CACnC,AAAQ;CACR,AAAQ,YAAY;CAEpB,cAAc;AACb,OAAK,UAAU,IAAIC;CACnB;;;;;CAMD,aAAa,qBACZC,mBAC2B;EAE3B,MAAM,aAAa,IAAI;AACvB,QAAM,WAAW,SAAS;AAC1B,SAAO;CACP;CAED,MAAM,UAAyB;AAC9B,OAAK,YAAY;CACjB;CAED,MAAM,QAAuB;AAC5B,OAAK,QAAQ,oBAAoB;AACjC,OAAK,YAAY;CACjB;CAED,cAAuB;AACtB,SAAO,KAAK;CACZ;;;;;CAMD,IAAI,eAA6B;AAChC,SAAO,KAAK;CACZ;AACD;;;;AC3CD,IAAa,iBAAb,MAEA;CACC,YAAoBC,YAA6B;EAA7B;CAA+B;CAEnD,MAAM,QAAQC,UAAsB;EACnC,MAAM,UAAU,KAAK,WAAW;AAChC,OAAK,MAAM,WAAW,SACrB,SAAQ,KAAK,QAAQ,MAAM,QAAQ;CAEpC;AACD;;;;ACXD,IAAa,kBAAb,MAEA;CACC,YAAoBC,YAA6B;EAA7B;CAA+B;CAEnD,MAAM,UACLC,UACAC,UACgB;EAChB,MAAM,UAAU,KAAK,WAAW;AAEhC,OAAK,MAAM,eAAe,SACzB,SAAQ,GAAG,aAAa,CAACC,YAAsB;AAC9C,YAAS,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAE,EAAC;EACvC,EAAC;CAEH;AACD"}
+{"version":3,"file":"index.cjs","names":["EventEmitter","publishTraced"],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts","../../src/basic/driver.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { EventConnection } from '../types';\nimport { EventPublisherType } from '../types';\n\nexport class BasicConnection implements EventConnection {\n\treadonly type = EventPublisherType.Basic;\n\tprivate emitter: EventEmitter;\n\tprivate connected = false;\n\n\tconstructor() {\n\t\tthis.emitter = new EventEmitter();\n\t}\n\n\t/**\n\t * Create a BasicConnection from a connection string\n\t * Format: basic://\n\t */\n\tstatic async fromConnectionString(\n\t\t_connectionString: string,\n\t): Promise<BasicConnection> {\n\t\t// Basic connection doesn't need any configuration\n\t\tconst connection = new BasicConnection();\n\t\tawait connection.connect();\n\t\treturn connection;\n\t}\n\n\tasync connect(): Promise<void> {\n\t\tthis.connected = true;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.emitter.removeAllListeners();\n\t\tthis.connected = false;\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Get the underlying EventEmitter\n\t * Used by BasicPublisher and BasicSubscriber\n\t */\n\tget eventEmitter(): EventEmitter {\n\t\treturn this.emitter;\n\t}\n}\n","import { publishTraced } from '../telemetry';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync publish(messages: TMessage[]) {\n\t\tconst emitter = this.connection.eventEmitter;\n\t\t// The trace context rides beside the message, as the emitter's second\n\t\t// argument, so the message a listener receives is the one published.\n\t\tawait publishTraced(\n\t\t\tmessages,\n\t\t\t(message) => ({\n\t\t\t\tsystem: 'basic',\n\t\t\t\tdestination: message.type,\n\t\t\t\ttype: message.type,\n\t\t\t}),\n\t\t\tasync (carriers) => {\n\t\t\t\tmessages.forEach((message, i) => {\n\t\t\t\t\temitter.emit(message.type, message, carriers[i]);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\t}\n}\n","import { consumeTraced, type TraceCarrier } from '../telemetry';\nimport type { EventSubscriber, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\tconst emitter = this.connection.eventEmitter;\n\n\t\tfor (const messageType of messages) {\n\t\t\temitter.on(messageType, (message: TMessage, carrier?: TraceCarrier) => {\n\t\t\t\tconsumeTraced(\n\t\t\t\t\t{ system: 'basic', destination: messageType, type: messageType },\n\t\t\t\t\tcarrier,\n\t\t\t\t\t() => listener(message),\n\t\t\t\t).catch((_error) => {});\n\t\t\t});\n\t\t}\n\t}\n}\n","import type { EventsDriver } from '../registry';\nimport { EventPublisherType } from '../types';\nimport { BasicConnection } from './BasicConnection';\nimport { BasicPublisher } from './BasicPublisher';\nimport { BasicSubscriber } from './BasicSubscriber';\n\n/**\n * `basic://` — an in-process `EventEmitter`. Register it with\n * `registerEventsDriver(basicEventsDriver)`.\n */\nexport const basicEventsDriver: EventsDriver = {\n\tscheme: EventPublisherType.Basic,\n\tconnect: (url) => BasicConnection.fromConnectionString(url),\n\tasync publisher(url) {\n\t\treturn new BasicPublisher(await BasicConnection.fromConnectionString(url));\n\t},\n\tpublisherFor: (connection) =>\n\t\tnew BasicPublisher(connection as BasicConnection),\n\tasync subscriber(url) {\n\t\treturn new BasicSubscriber(await BasicConnection.fromConnectionString(url));\n\t},\n\tsubscriberFor: (connection) =>\n\t\tnew BasicSubscriber(connection as BasicConnection),\n};\n"],"mappings":";;;;AAIA,IAAa,kBAAb,MAAa,gBAA2C;CACvD,OAAS;CACT;CACA,YAAoB;CAEpB,cAAc;EACb,KAAK,UAAU,IAAIA,YAAAA,aAAa;CACjC;;;;;CAMA,aAAa,qBACZ,mBAC2B;EAE3B,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,WAAW,QAAQ;EACzB,OAAO;CACR;CAEA,MAAM,UAAyB;EAC9B,KAAK,YAAY;CAClB;CAEA,MAAM,QAAuB;EAC5B,KAAK,QAAQ,mBAAmB;EAChC,KAAK,YAAY;CAClB;CAEA,cAAuB;EACtB,OAAO,KAAK;CACb;;;;;CAMA,IAAI,eAA6B;EAChC,OAAO,KAAK;CACb;AACD;;;AC1CA,IAAa,iBAAb,MAEA;CACqB;CAApB,YAAY,YAAqC;EAA7B,KAAA,aAAA;CAA8B;CAElD,MAAM,QAAQ,UAAsB;EACnC,MAAM,UAAU,KAAK,WAAW;EAGhC,MAAMC,kBAAAA,cACL,WACC,aAAa;GACb,QAAQ;GACR,aAAa,QAAQ;GACrB,MAAM,QAAQ;EACf,IACA,OAAO,aAAa;GACnB,SAAS,SAAS,SAAS,MAAM;IAChC,QAAQ,KAAK,QAAQ,MAAM,SAAS,SAAS,EAAE;GAChD,CAAC;EACF,CACD;CACD;AACD;;;ACvBA,IAAa,kBAAb,MAEA;CACqB;CAApB,YAAY,YAAqC;EAA7B,KAAA,aAAA;CAA8B;CAElD,MAAM,UACL,UACA,UACgB;EAChB,MAAM,UAAU,KAAK,WAAW;EAEhC,KAAK,MAAM,eAAe,UACzB,QAAQ,GAAG,cAAc,SAAmB,YAA2B;GACtE,kBAAA,cACC;IAAE,QAAQ;IAAS,aAAa;IAAa,MAAM;GAAY,GAC/D,eACM,SAAS,OAAO,CACvB,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC;EACvB,CAAC;CAEH;AACD;;;;;;;ACfA,MAAa,oBAAkC;CAC9C,QAAA;CACA,UAAU,QAAQ,gBAAgB,qBAAqB,GAAG;CAC1D,MAAM,UAAU,KAAK;EACpB,OAAO,IAAI,eAAe,MAAM,gBAAgB,qBAAqB,GAAG,CAAC;CAC1E;CACA,eAAe,eACd,IAAI,eAAe,UAA6B;CACjD,MAAM,WAAW,KAAK;EACrB,OAAO,IAAI,gBAAgB,MAAM,gBAAgB,qBAAqB,GAAG,CAAC;CAC3E;CACA,gBAAgB,eACf,IAAI,gBAAgB,UAA6B;AACnD"}

package/dist/basic/index.d.cts

@@ -1,8 +1,7 @@
-import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, PublishableMessage } from "../types-BmixGrOD.cjs";
+import { d as EventPublisher, f as EventPublisherType, g as PublishableMessage, p as EventSubscriber, t as EventsDriver, u as EventConnection } from "../registry-DIx25Q5s.cjs";
 import { EventEmitter } from "node:events";
-
 //#region src/basic/BasicConnection.d.ts
-declare class BasicConnection implements EventConnection {
+export declare class BasicConnection implements EventConnection {
   readonly type = EventPublisherType.Basic;
   private emitter;
   private connected;
@@ -21,24 +20,26 @@ declare class BasicConnection implements EventConnection {
    */
   get eventEmitter(): EventEmitter;
 }
-//# sourceMappingURL=BasicConnection.d.ts.map
 //#endregion
 //#region src/basic/BasicPublisher.d.ts
-declare class BasicPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
+export declare class BasicPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
   private connection;
   constructor(connection: BasicConnection);
   publish(messages: TMessage[]): Promise<void>;
 }
-//# sourceMappingURL=BasicPublisher.d.ts.map
 //#endregion
 //#region src/basic/BasicSubscriber.d.ts
-declare class BasicSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
+export declare class BasicSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
   private connection;
   constructor(connection: BasicConnection);
   subscribe(messages: TMessage['type'][], listener: (payload: TMessage) => Promise<void>): Promise<void>;
 }
-//# sourceMappingURL=BasicSubscriber.d.ts.map
-
 //#endregion
-export { BasicConnection, BasicPublisher, BasicSubscriber };
+//#region src/basic/driver.d.ts
+/**
+ * `basic://` — an in-process `EventEmitter`. Register it with
+ * `registerEventsDriver(basicEventsDriver)`.
+ */
+export declare const basicEventsDriver: EventsDriver;
+//#endregion
 //# sourceMappingURL=index.d.cts.map

package/dist/basic/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts"],"sourcesContent":[],"mappings":";;;;cAIa,eAAA,YAA2B;EAA3B,SAAA,IAAA,GACC,kBAAA,CAAA,KAAA;EADe,QAAA,OAAA;EAAA,QACf,SAAA;EAAA,WAcF,CAAA;EAAe;;;;EAwBM,OAvCO,oBAAA,CAAA,iBAAA,EAAA,MAAA,CAAA,EAepC,OAfoC,CAe5B,eAf4B,CAAA;EAAe,OAAA,CAAA,CAAA,EAsBrC,OAtBqC,CAAA,IAAA,CAAA;WA0BvC;;;AC3BhB;;;EAA+D,IACpC,YAAA,CAAA,CAAA,EDuCN,YCvCM;;;;;cADd,gCAAgC,4CACjC,eAAe;;EDAd,WAAA,CAAA,UAAgB,ECEI,eDFJ;EAAA,OAAA,CAAA,QAAA,ECIJ,QDJI,EAAA,CAAA,ECIM,ODJN,CAAA,IAAA,CAAA;;;;;cEDhB,iCAAiC,4CAClC,gBAAgB;;EFAf,WAAA,CAAA,UAAgB,EEEI,eFFJ;EAAA,SAAA,CAAA,QAAA,EEKjB,QFLiB,CAAA,MAAA,CAAA,EAAA,EAAA,QAAA,EAAA,CAAA,OAAA,EEMP,QFNO,EAAA,GEMM,OFNN,CAAA,IAAA,CAAA,CAAA,EEOzB,OFPyB,CAAA,IAAA,CAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts","../../src/basic/driver.ts"],"mappings":";;;qBAIa,2BAA2B;WAC9B,OAAI,mBAAA;UACL;UACA;EAER;;;;;SAQa,qBACZ,4BACE,QAAQ;EAOL,WAAW;EAIX,SAAS;EAKf;;;;;MAQI,gBAAgB;;;;qBCvCR,eAAe,iBAAiB,4CACjC,eAAe;UAEN;EAApB,YAAoB,YAAY;EAE1B,QAAQ,UAAU,aAAU;;;;qBCLtB,gBAAgB,iBAAiB,4CAClC,gBAAgB;UAEP;EAApB,YAAoB,YAAY;EAE1B,UACL,UAAU,oBACV,WAAW,SAAS,aAAa,gBAC/B;;;;;;;;qBCFS,mBAAmB"}

package/dist/basic/index.d.mts

@@ -1,8 +1,7 @@
-import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, PublishableMessage } from "../types-DycjsYms.mjs";
+import { d as EventPublisher, f as EventPublisherType, g as PublishableMessage, p as EventSubscriber, t as EventsDriver, u as EventConnection } from "../registry-DIx25Q5s.mjs";
 import { EventEmitter } from "node:events";
-
 //#region src/basic/BasicConnection.d.ts
-declare class BasicConnection implements EventConnection {
+export declare class BasicConnection implements EventConnection {
   readonly type = EventPublisherType.Basic;
   private emitter;
   private connected;
@@ -21,24 +20,26 @@ declare class BasicConnection implements EventConnection {
    */
   get eventEmitter(): EventEmitter;
 }
-//# sourceMappingURL=BasicConnection.d.ts.map
 //#endregion
 //#region src/basic/BasicPublisher.d.ts
-declare class BasicPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
+export declare class BasicPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
   private connection;
   constructor(connection: BasicConnection);
   publish(messages: TMessage[]): Promise<void>;
 }
-//# sourceMappingURL=BasicPublisher.d.ts.map
 //#endregion
 //#region src/basic/BasicSubscriber.d.ts
-declare class BasicSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
+export declare class BasicSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
   private connection;
   constructor(connection: BasicConnection);
   subscribe(messages: TMessage['type'][], listener: (payload: TMessage) => Promise<void>): Promise<void>;
 }
-//# sourceMappingURL=BasicSubscriber.d.ts.map
-
 //#endregion
-export { BasicConnection, BasicPublisher, BasicSubscriber };
+//#region src/basic/driver.d.ts
+/**
+ * `basic://` — an in-process `EventEmitter`. Register it with
+ * `registerEventsDriver(basicEventsDriver)`.
+ */
+export declare const basicEventsDriver: EventsDriver;
+//#endregion
 //# sourceMappingURL=index.d.mts.map

package/dist/basic/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts"],"sourcesContent":[],"mappings":";;;;cAIa,eAAA,YAA2B;EAA3B,SAAA,IAAA,GACC,kBAAA,CAAA,KAAA;EADe,QAAA,OAAA;EAAA,QACf,SAAA;EAAA,WAcF,CAAA;EAAe;;;;EAwBM,OAvCO,oBAAA,CAAA,iBAAA,EAAA,MAAA,CAAA,EAepC,OAfoC,CAe5B,eAf4B,CAAA;EAAe,OAAA,CAAA,CAAA,EAsBrC,OAtBqC,CAAA,IAAA,CAAA;WA0BvC;;;AC3BhB;;;EAA+D,IACpC,YAAA,CAAA,CAAA,EDuCN,YCvCM;;;;;cADd,gCAAgC,4CACjC,eAAe;;EDAd,WAAA,CAAA,UAAgB,ECEI,eDFJ;EAAA,OAAA,CAAA,QAAA,ECIJ,QDJI,EAAA,CAAA,ECIM,ODJN,CAAA,IAAA,CAAA;;;;;cEDhB,iCAAiC,4CAClC,gBAAgB;;EFAf,WAAA,CAAA,UAAgB,EEEI,eFFJ;EAAA,SAAA,CAAA,QAAA,EEKjB,QFLiB,CAAA,MAAA,CAAA,EAAA,EAAA,QAAA,EAAA,CAAA,OAAA,EEMP,QFNO,EAAA,GEMM,OFNN,CAAA,IAAA,CAAA,CAAA,EEOzB,OFPyB,CAAA,IAAA,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts","../../src/basic/driver.ts"],"mappings":";;;qBAIa,2BAA2B;WAC9B,OAAI,mBAAA;UACL;UACA;EAER;;;;;SAQa,qBACZ,4BACE,QAAQ;EAOL,WAAW;EAIX,SAAS;EAKf;;;;;MAQI,gBAAgB;;;;qBCvCR,eAAe,iBAAiB,4CACjC,eAAe;UAEN;EAApB,YAAoB,YAAY;EAE1B,QAAQ,UAAU,aAAU;;;;qBCLtB,gBAAgB,iBAAiB,4CAClC,gBAAgB;UAEP;EAApB,YAAoB,YAAY;EAE1B,UACL,UAAU,oBACV,WAAW,SAAS,aAAa,gBAC/B;;;;;;;;qBCFS,mBAAmB"}

package/dist/basic/index.mjs

@@ -1,9 +1,8 @@
-import { EventPublisherType } from "../types-CYDt-2RQ.mjs";
+import { a as consumeTraced, s as publishTraced } from "../telemetry-DjjgJMul.mjs";
 import { EventEmitter } from "node:events";
-
 //#region src/basic/BasicConnection.ts
 var BasicConnection = class BasicConnection {
-	type = EventPublisherType.Basic;
+	type = "basic";
 	emitter;
 	connected = false;
 	constructor() {
@@ -36,33 +35,63 @@ var BasicConnection = class BasicConnection {
 		return this.emitter;
 	}
 };
-
 //#endregion
 //#region src/basic/BasicPublisher.ts
 var BasicPublisher = class {
+	connection;
 	constructor(connection) {
 		this.connection = connection;
 	}
 	async publish(messages) {
 		const emitter = this.connection.eventEmitter;
-		for (const message of messages) emitter.emit(message.type, message);
+		await publishTraced(messages, (message) => ({
+			system: "basic",
+			destination: message.type,
+			type: message.type
+		}), async (carriers) => {
+			messages.forEach((message, i) => {
+				emitter.emit(message.type, message, carriers[i]);
+			});
+		});
 	}
 };
-
 //#endregion
 //#region src/basic/BasicSubscriber.ts
 var BasicSubscriber = class {
+	connection;
 	constructor(connection) {
 		this.connection = connection;
 	}
 	async subscribe(messages, listener) {
 		const emitter = this.connection.eventEmitter;
-		for (const messageType of messages) emitter.on(messageType, (message) => {
-			listener(message).catch((_error) => {});
+		for (const messageType of messages) emitter.on(messageType, (message, carrier) => {
+			consumeTraced({
+				system: "basic",
+				destination: messageType,
+				type: messageType
+			}, carrier, () => listener(message)).catch((_error) => {});
 		});
 	}
 };
-
 //#endregion
-export { BasicConnection, BasicPublisher, BasicSubscriber };
+//#region src/basic/driver.ts
+/**
+* `basic://` — an in-process `EventEmitter`. Register it with
+* `registerEventsDriver(basicEventsDriver)`.
+*/
+const basicEventsDriver = {
+	scheme: "basic",
+	connect: (url) => BasicConnection.fromConnectionString(url),
+	async publisher(url) {
+		return new BasicPublisher(await BasicConnection.fromConnectionString(url));
+	},
+	publisherFor: (connection) => new BasicPublisher(connection),
+	async subscriber(url) {
+		return new BasicSubscriber(await BasicConnection.fromConnectionString(url));
+	},
+	subscriberFor: (connection) => new BasicSubscriber(connection)
+};
+//#endregion
+export { BasicConnection, BasicPublisher, BasicSubscriber, basicEventsDriver };
+
 //# sourceMappingURL=index.mjs.map

package/dist/basic/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["_connectionString: string","connection: BasicConnection","messages: TMessage[]","connection: BasicConnection","messages: TMessage['type'][]","listener: (payload: TMessage) => Promise<void>","message: TMessage"],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { EventConnection } from '../types';\nimport { EventPublisherType } from '../types';\n\nexport class BasicConnection implements EventConnection {\n\treadonly type = EventPublisherType.Basic;\n\tprivate emitter: EventEmitter;\n\tprivate connected = false;\n\n\tconstructor() {\n\t\tthis.emitter = new EventEmitter();\n\t}\n\n\t/**\n\t * Create a BasicConnection from a connection string\n\t * Format: basic://\n\t */\n\tstatic async fromConnectionString(\n\t\t_connectionString: string,\n\t): Promise<BasicConnection> {\n\t\t// Basic connection doesn't need any configuration\n\t\tconst connection = new BasicConnection();\n\t\tawait connection.connect();\n\t\treturn connection;\n\t}\n\n\tasync connect(): Promise<void> {\n\t\tthis.connected = true;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.emitter.removeAllListeners();\n\t\tthis.connected = false;\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Get the underlying EventEmitter\n\t * Used by BasicPublisher and BasicSubscriber\n\t */\n\tget eventEmitter(): EventEmitter {\n\t\treturn this.emitter;\n\t}\n}\n","import type { EventPublisher, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync publish(messages: TMessage[]) {\n\t\tconst emitter = this.connection.eventEmitter;\n\t\tfor (const message of messages) {\n\t\t\temitter.emit(message.type, message);\n\t\t}\n\t}\n}\n","import type { EventSubscriber, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\tconst emitter = this.connection.eventEmitter;\n\n\t\tfor (const messageType of messages) {\n\t\t\temitter.on(messageType, (message: TMessage) => {\n\t\t\t\tlistener(message).catch((_error) => {});\n\t\t\t});\n\t\t}\n\t}\n}\n"],"mappings":";;;;AAIA,IAAa,kBAAb,MAAa,gBAA2C;CACvD,AAAS,OAAO,mBAAmB;CACnC,AAAQ;CACR,AAAQ,YAAY;CAEpB,cAAc;AACb,OAAK,UAAU,IAAI;CACnB;;;;;CAMD,aAAa,qBACZA,mBAC2B;EAE3B,MAAM,aAAa,IAAI;AACvB,QAAM,WAAW,SAAS;AAC1B,SAAO;CACP;CAED,MAAM,UAAyB;AAC9B,OAAK,YAAY;CACjB;CAED,MAAM,QAAuB;AAC5B,OAAK,QAAQ,oBAAoB;AACjC,OAAK,YAAY;CACjB;CAED,cAAuB;AACtB,SAAO,KAAK;CACZ;;;;;CAMD,IAAI,eAA6B;AAChC,SAAO,KAAK;CACZ;AACD;;;;AC3CD,IAAa,iBAAb,MAEA;CACC,YAAoBC,YAA6B;EAA7B;CAA+B;CAEnD,MAAM,QAAQC,UAAsB;EACnC,MAAM,UAAU,KAAK,WAAW;AAChC,OAAK,MAAM,WAAW,SACrB,SAAQ,KAAK,QAAQ,MAAM,QAAQ;CAEpC;AACD;;;;ACXD,IAAa,kBAAb,MAEA;CACC,YAAoBC,YAA6B;EAA7B;CAA+B;CAEnD,MAAM,UACLC,UACAC,UACgB;EAChB,MAAM,UAAU,KAAK,WAAW;AAEhC,OAAK,MAAM,eAAe,SACzB,SAAQ,GAAG,aAAa,CAACC,YAAsB;AAC9C,YAAS,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAE,EAAC;EACvC,EAAC;CAEH;AACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/basic/BasicConnection.ts","../../src/basic/BasicPublisher.ts","../../src/basic/BasicSubscriber.ts","../../src/basic/driver.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { EventConnection } from '../types';\nimport { EventPublisherType } from '../types';\n\nexport class BasicConnection implements EventConnection {\n\treadonly type = EventPublisherType.Basic;\n\tprivate emitter: EventEmitter;\n\tprivate connected = false;\n\n\tconstructor() {\n\t\tthis.emitter = new EventEmitter();\n\t}\n\n\t/**\n\t * Create a BasicConnection from a connection string\n\t * Format: basic://\n\t */\n\tstatic async fromConnectionString(\n\t\t_connectionString: string,\n\t): Promise<BasicConnection> {\n\t\t// Basic connection doesn't need any configuration\n\t\tconst connection = new BasicConnection();\n\t\tawait connection.connect();\n\t\treturn connection;\n\t}\n\n\tasync connect(): Promise<void> {\n\t\tthis.connected = true;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.emitter.removeAllListeners();\n\t\tthis.connected = false;\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Get the underlying EventEmitter\n\t * Used by BasicPublisher and BasicSubscriber\n\t */\n\tget eventEmitter(): EventEmitter {\n\t\treturn this.emitter;\n\t}\n}\n","import { publishTraced } from '../telemetry';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync publish(messages: TMessage[]) {\n\t\tconst emitter = this.connection.eventEmitter;\n\t\t// The trace context rides beside the message, as the emitter's second\n\t\t// argument, so the message a listener receives is the one published.\n\t\tawait publishTraced(\n\t\t\tmessages,\n\t\t\t(message) => ({\n\t\t\t\tsystem: 'basic',\n\t\t\t\tdestination: message.type,\n\t\t\t\ttype: message.type,\n\t\t\t}),\n\t\t\tasync (carriers) => {\n\t\t\t\tmessages.forEach((message, i) => {\n\t\t\t\t\temitter.emit(message.type, message, carriers[i]);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\t}\n}\n","import { consumeTraced, type TraceCarrier } from '../telemetry';\nimport type { EventSubscriber, PublishableMessage } from '../types';\nimport type { BasicConnection } from './BasicConnection';\n\nexport class BasicSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tconstructor(private connection: BasicConnection) {}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\tconst emitter = this.connection.eventEmitter;\n\n\t\tfor (const messageType of messages) {\n\t\t\temitter.on(messageType, (message: TMessage, carrier?: TraceCarrier) => {\n\t\t\t\tconsumeTraced(\n\t\t\t\t\t{ system: 'basic', destination: messageType, type: messageType },\n\t\t\t\t\tcarrier,\n\t\t\t\t\t() => listener(message),\n\t\t\t\t).catch((_error) => {});\n\t\t\t});\n\t\t}\n\t}\n}\n","import type { EventsDriver } from '../registry';\nimport { EventPublisherType } from '../types';\nimport { BasicConnection } from './BasicConnection';\nimport { BasicPublisher } from './BasicPublisher';\nimport { BasicSubscriber } from './BasicSubscriber';\n\n/**\n * `basic://` — an in-process `EventEmitter`. Register it with\n * `registerEventsDriver(basicEventsDriver)`.\n */\nexport const basicEventsDriver: EventsDriver = {\n\tscheme: EventPublisherType.Basic,\n\tconnect: (url) => BasicConnection.fromConnectionString(url),\n\tasync publisher(url) {\n\t\treturn new BasicPublisher(await BasicConnection.fromConnectionString(url));\n\t},\n\tpublisherFor: (connection) =>\n\t\tnew BasicPublisher(connection as BasicConnection),\n\tasync subscriber(url) {\n\t\treturn new BasicSubscriber(await BasicConnection.fromConnectionString(url));\n\t},\n\tsubscriberFor: (connection) =>\n\t\tnew BasicSubscriber(connection as BasicConnection),\n};\n"],"mappings":";;;AAIA,IAAa,kBAAb,MAAa,gBAA2C;CACvD,OAAS;CACT;CACA,YAAoB;CAEpB,cAAc;EACb,KAAK,UAAU,IAAI,aAAa;CACjC;;;;;CAMA,aAAa,qBACZ,mBAC2B;EAE3B,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,WAAW,QAAQ;EACzB,OAAO;CACR;CAEA,MAAM,UAAyB;EAC9B,KAAK,YAAY;CAClB;CAEA,MAAM,QAAuB;EAC5B,KAAK,QAAQ,mBAAmB;EAChC,KAAK,YAAY;CAClB;CAEA,cAAuB;EACtB,OAAO,KAAK;CACb;;;;;CAMA,IAAI,eAA6B;EAChC,OAAO,KAAK;CACb;AACD;;;AC1CA,IAAa,iBAAb,MAEA;CACqB;CAApB,YAAY,YAAqC;EAA7B,KAAA,aAAA;CAA8B;CAElD,MAAM,QAAQ,UAAsB;EACnC,MAAM,UAAU,KAAK,WAAW;EAGhC,MAAM,cACL,WACC,aAAa;GACb,QAAQ;GACR,aAAa,QAAQ;GACrB,MAAM,QAAQ;EACf,IACA,OAAO,aAAa;GACnB,SAAS,SAAS,SAAS,MAAM;IAChC,QAAQ,KAAK,QAAQ,MAAM,SAAS,SAAS,EAAE;GAChD,CAAC;EACF,CACD;CACD;AACD;;;ACvBA,IAAa,kBAAb,MAEA;CACqB;CAApB,YAAY,YAAqC;EAA7B,KAAA,aAAA;CAA8B;CAElD,MAAM,UACL,UACA,UACgB;EAChB,MAAM,UAAU,KAAK,WAAW;EAEhC,KAAK,MAAM,eAAe,UACzB,QAAQ,GAAG,cAAc,SAAmB,YAA2B;GACtE,cACC;IAAE,QAAQ;IAAS,aAAa;IAAa,MAAM;GAAY,GAC/D,eACM,SAAS,OAAO,CACvB,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC;EACvB,CAAC;CAEH;AACD;;;;;;;ACfA,MAAa,oBAAkC;CAC9C,QAAA;CACA,UAAU,QAAQ,gBAAgB,qBAAqB,GAAG;CAC1D,MAAM,UAAU,KAAK;EACpB,OAAO,IAAI,eAAe,MAAM,gBAAgB,qBAAqB,GAAG,CAAC;CAC1E;CACA,eAAe,eACd,IAAI,eAAe,UAA6B;CACjD,MAAM,WAAW,KAAK;EACrB,OAAO,IAAI,gBAAgB,MAAM,gBAAgB,qBAAqB,GAAG,CAAC;CAC3E;CACA,gBAAgB,eACf,IAAI,gBAAgB,UAA6B;AACnD"}

package/dist/index.cjs

@@ -1,192 +1,88 @@
-const require_types = require('./types-Byv8N9ma.cjs');
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_telemetry = require("./telemetry-DG3l807O.cjs");
+const require_registry = require("./registry-DlT36229.cjs");
 //#region src/EventConnection.ts
 var EventConnectionFactory = class {
 	/**
-	* Create an EventConnection from a connection string
-	* Dynamically imports the appropriate connection implementation
+	* Create an EventConnection from a connection string, through whichever
+	* driver is registered for its scheme — see `registerEventsDriver`.
+	*
+	* @throws {UnregisteredEventsScheme} when the broker's driver is not
+	* registered.
 	*/
 	static async fromConnectionString(connectionStr) {
-		const url = new URL(connectionStr);
-		const protocol = url.protocol.replace(":", "");
-		switch (protocol) {
-			case require_types.EventPublisherType.Basic: {
-				const { BasicConnection } = await Promise.resolve().then(() => require("./basic/index.cjs"));
-				return BasicConnection.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.RabbitMQ: {
-				const { RabbitMQConnection } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
-				return RabbitMQConnection.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.SQS: {
-				const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				return SQSConnection.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.SNS: {
-				const { SNSConnection } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-				return SNSConnection.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.PgBoss: {
-				const { PgBossConnection } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
-				return PgBossConnection.fromConnectionString(connectionStr);
-			}
-			default: throw new Error(`Unsupported connection type: ${protocol}`);
-		}
+		const scheme = new URL(connectionStr).protocol;
+		return require_registry.eventsDriverFor(scheme, "connection").connect(connectionStr);
 	}
 };
-
 //#endregion
 //#region src/Publisher.ts
+/**
+* Publishers for a connection string or a connection, through whichever
+* driver is registered for its scheme — see `registerEventsDriver`.
+*/
 var Publisher = class {
 	/**
 	* Create a publisher from a connection string
 	* This creates both a connection and a publisher
+	*
+	* @throws {UnregisteredEventsScheme} when the broker's driver is not
+	* registered.
 	*/
-	static async fromConnectionString(connectionStr) {
-		const url = new URL(connectionStr);
-		switch (url.protocol.replace(":", "")) {
-			case require_types.EventPublisherType.Basic: {
-				const { BasicConnection, BasicPublisher } = await Promise.resolve().then(() => require("./basic/index.cjs"));
-				const connection = await BasicConnection.fromConnectionString(connectionStr);
-				return new BasicPublisher(connection);
-			}
-			case require_types.EventPublisherType.RabbitMQ: {
-				const { RabbitMQPublisher } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
-				return RabbitMQPublisher.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.SQS: {
-				const { SQSPublisher } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				return SQSPublisher.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.SNS: {
-				const { SNSPublisher } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-				return SNSPublisher.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.PgBoss: {
-				const { PgBossPublisher } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
-				return PgBossPublisher.fromConnectionString(connectionStr);
-			}
-			default: throw new Error(`Unsupported event publisher type: ${url.protocol}`);
-		}
+	static async fromConnectionString(connectionStr, options = {}) {
+		const scheme = new URL(connectionStr).protocol;
+		return require_registry.eventsDriverFor(scheme, "publisher").publisher(connectionStr, options);
 	}
 	/**
 	* Create a publisher from an existing connection
 	* This allows sharing connections between publishers and subscribers
 	*/
-	static async fromConnection(connection) {
-		switch (connection.type) {
-			case require_types.EventPublisherType.Basic: {
-				const { BasicPublisher } = await Promise.resolve().then(() => require("./basic/index.cjs"));
-				const { BasicConnection } = await Promise.resolve().then(() => require("./basic/index.cjs"));
-				return new BasicPublisher(connection);
-			}
-			case require_types.EventPublisherType.RabbitMQ: {
-				const { RabbitMQPublisher } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
-				const { RabbitMQConnection } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
-				return new RabbitMQPublisher(connection);
-			}
-			case require_types.EventPublisherType.SQS: {
-				const { SQSPublisher } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				return new SQSPublisher(connection);
-			}
-			case require_types.EventPublisherType.SNS: {
-				const { SNSPublisher } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-				const { SNSConnection } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-				return new SNSPublisher(connection);
-			}
-			case require_types.EventPublisherType.PgBoss: {
-				const { PgBossPublisher } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
-				const { PgBossConnection } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
-				return new PgBossPublisher(connection);
-			}
-			default: throw new Error(`Unsupported connection type: ${connection.type}`);
-		}
+	static async fromConnection(connection, options = {}) {
+		return require_registry.eventsDriverFor(connection.type, "publisher").publisherFor(connection, options);
 	}
 };
-
 //#endregion
 //#region src/Subscriber.ts
+/**
+* Subscribers for a connection string or a connection, through whichever
+* driver is registered for its scheme — see `registerEventsDriver`.
+*/
 var Subscriber = class {
 	/**
 	* Create a subscriber from a connection string
 	* This creates both a connection and a subscriber
+	*
+	* @throws {UnregisteredEventsScheme} when the broker's driver is not
+	* registered.
 	*/
 	static async fromConnectionString(connectionStr) {
-		const url = new URL(connectionStr);
-		switch (url.protocol.replace(":", "")) {
-			case require_types.EventPublisherType.Basic: {
-				const { BasicConnection, BasicSubscriber } = await Promise.resolve().then(() => require("./basic/index.cjs"));
-				const connection = await BasicConnection.fromConnectionString(connectionStr);
-				return new BasicSubscriber(connection);
-			}
-			case require_types.EventPublisherType.RabbitMQ: {
-				const { RabbitMQSubscriber } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
-				return RabbitMQSubscriber.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.SNS: {
-				const { SNSSubscriber } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-				return SNSSubscriber.fromConnectionString(connectionStr);
-			}
-			case require_types.EventPublisherType.SQS: {
-				const url$1 = new URL(connectionStr);
-				const topicArn = url$1.searchParams.get("topicArn");
-				if (topicArn) {
-					const { SNSSubscriber } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-					const snsConnectionStr = connectionStr.replace("sqs://", "sns://");
-					return SNSSubscriber.fromConnectionString(snsConnectionStr);
-				}
-				const { SQSSubscriber } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				const connection = await SQSConnection.fromConnectionString(connectionStr);
-				return new SQSSubscriber(connection);
-			}
-			case require_types.EventPublisherType.PgBoss: {
-				const { PgBossSubscriber } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
-				return PgBossSubscriber.fromConnectionString(connectionStr);
-			}
-			default: throw new Error(`Unsupported event subscriber type: ${url.protocol}`);
-		}
+		const scheme = new URL(connectionStr).protocol;
+		return require_registry.eventsDriverFor(scheme, "subscriber").subscriber(connectionStr);
 	}
 	/**
 	* Create a subscriber from an existing connection
 	* This allows sharing connections between publishers and subscribers
 	*/
-	static async fromConnection(connection) {
-		switch (connection.type) {
-			case require_types.EventPublisherType.Basic: {
-				const { BasicSubscriber } = await Promise.resolve().then(() => require("./basic/index.cjs"));
-				const { BasicConnection } = await Promise.resolve().then(() => require("./basic/index.cjs"));
-				return new BasicSubscriber(connection);
-			}
-			case require_types.EventPublisherType.RabbitMQ: {
-				const { RabbitMQSubscriber } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
-				const { RabbitMQConnection } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
-				return new RabbitMQSubscriber(connection);
-			}
-			case require_types.EventPublisherType.SNS: {
-				const { SNSSubscriber } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-				const { SNSConnection } = await Promise.resolve().then(() => require("./sns/index.cjs"));
-				return new SNSSubscriber(connection);
-			}
-			case require_types.EventPublisherType.SQS: {
-				const { SQSSubscriber } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
-				return new SQSSubscriber(connection);
-			}
-			case require_types.EventPublisherType.PgBoss: {
-				const { PgBossSubscriber } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
-				const { PgBossConnection } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
-				return new PgBossSubscriber(connection);
-			}
-			default: throw new Error(`Unsupported connection type: ${connection.type}`);
-		}
+	static async fromConnection(connection, options = {}) {
+		return require_registry.eventsDriverFor(connection.type, "subscriber").subscriberFor(connection, options);
 	}
 };
-
 //#endregion
 exports.EventConnectionFactory = EventConnectionFactory;
-exports.EventPublisherType = require_types.EventPublisherType;
+exports.EventPublisherType = require_telemetry.EventPublisherType;
 exports.Publisher = Publisher;
 exports.Subscriber = Subscriber;
+exports.TRACE_CONTEXT_KEY = require_telemetry.TRACE_CONTEXT_KEY;
+exports.UnregisteredEventsScheme = require_registry.UnregisteredEventsScheme;
+exports.UnsupportedEventTransport = require_telemetry.UnsupportedEventTransport;
+exports.carrierFromAttributes = require_telemetry.carrierFromAttributes;
+exports.consumeBatchTraced = require_telemetry.consumeBatchTraced;
+exports.consumeTraced = require_telemetry.consumeTraced;
+exports.eventsDriverFor = require_registry.eventsDriverFor;
+exports.extractTraceContext = require_telemetry.extractTraceContext;
+exports.publishTraced = require_telemetry.publishTraced;
+exports.registerEventsDriver = require_registry.registerEventsDriver;
+exports.registeredEventsSchemes = require_registry.registeredEventsSchemes;
+exports.withoutTraceKey = require_telemetry.withoutTraceKey;
+
 //# sourceMappingURL=index.cjs.map