@geekmidas/events 10.0.0-alpha.13 → 10.0.0-alpha.131

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.
Files changed (86) hide show
  1. package/README.md +46 -1
  2. package/dist/{SQSSubscriber-cpo624qU.mjs → SQSSubscriber-BEJBfNTe.mjs} +94 -10
  3. package/dist/SQSSubscriber-BEJBfNTe.mjs.map +1 -0
  4. package/dist/{SQSSubscriber-DLPZCzFE.cjs → SQSSubscriber-COTqWvOk.cjs} +101 -10
  5. package/dist/SQSSubscriber-COTqWvOk.cjs.map +1 -0
  6. package/dist/basic/index.cjs +35 -4
  7. package/dist/basic/index.cjs.map +1 -1
  8. package/dist/basic/index.d.cts +8 -1
  9. package/dist/basic/index.d.cts.map +1 -1
  10. package/dist/basic/index.d.mts +8 -1
  11. package/dist/basic/index.d.mts.map +1 -1
  12. package/dist/basic/index.mjs +35 -5
  13. package/dist/basic/index.mjs.map +1 -1
  14. package/dist/index.cjs +45 -141
  15. package/dist/index.cjs.map +1 -1
  16. package/dist/index.d.cts +80 -20
  17. package/dist/index.d.cts.map +1 -1
  18. package/dist/index.d.mts +80 -20
  19. package/dist/index.d.mts.map +1 -1
  20. package/dist/index.mjs +33 -141
  21. package/dist/index.mjs.map +1 -1
  22. package/dist/pgboss/index.cjs +124 -27
  23. package/dist/pgboss/index.cjs.map +1 -1
  24. package/dist/pgboss/index.d.cts +51 -4
  25. package/dist/pgboss/index.d.cts.map +1 -1
  26. package/dist/pgboss/index.d.mts +51 -4
  27. package/dist/pgboss/index.d.mts.map +1 -1
  28. package/dist/pgboss/index.mjs +121 -27
  29. package/dist/pgboss/index.mjs.map +1 -1
  30. package/dist/rabbitmq/index.cjs +63 -20
  31. package/dist/rabbitmq/index.cjs.map +1 -1
  32. package/dist/rabbitmq/index.d.cts +15 -1
  33. package/dist/rabbitmq/index.d.cts.map +1 -1
  34. package/dist/rabbitmq/index.d.mts +15 -1
  35. package/dist/rabbitmq/index.d.mts.map +1 -1
  36. package/dist/rabbitmq/index.mjs +63 -20
  37. package/dist/rabbitmq/index.mjs.map +1 -1
  38. package/dist/registry-DIx25Q5s.d.cts +255 -0
  39. package/dist/registry-DIx25Q5s.d.cts.map +1 -0
  40. package/dist/registry-DIx25Q5s.d.mts +255 -0
  41. package/dist/registry-DIx25Q5s.d.mts.map +1 -0
  42. package/dist/registry-DXLY1Xf6.mjs +99 -0
  43. package/dist/registry-DXLY1Xf6.mjs.map +1 -0
  44. package/dist/registry-DlT36229.cjs +122 -0
  45. package/dist/registry-DlT36229.cjs.map +1 -0
  46. package/dist/sns/index.cjs +439 -12
  47. package/dist/sns/index.cjs.map +1 -1
  48. package/dist/sns/index.d.cts +263 -8
  49. package/dist/sns/index.d.cts.map +1 -1
  50. package/dist/sns/index.d.mts +263 -8
  51. package/dist/sns/index.d.mts.map +1 -1
  52. package/dist/sns/index.mjs +423 -13
  53. package/dist/sns/index.mjs.map +1 -1
  54. package/dist/sns/snsUrl.d.cts.map +1 -1
  55. package/dist/sns/snsUrl.d.mts.map +1 -1
  56. package/dist/sqs/index.cjs +22 -55
  57. package/dist/sqs/index.cjs.map +1 -1
  58. package/dist/sqs/index.d.cts +23 -1
  59. package/dist/sqs/index.d.cts.map +1 -1
  60. package/dist/sqs/index.d.mts +23 -1
  61. package/dist/sqs/index.d.mts.map +1 -1
  62. package/dist/sqs/index.mjs +20 -53
  63. package/dist/sqs/index.mjs.map +1 -1
  64. package/dist/sqs/sqsUrl.d.cts.map +1 -1
  65. package/dist/sqs/sqsUrl.d.mts.map +1 -1
  66. package/dist/telemetry-DG3l807O.cjs +309 -0
  67. package/dist/telemetry-DG3l807O.cjs.map +1 -0
  68. package/dist/telemetry-DjjgJMul.mjs +244 -0
  69. package/dist/telemetry-DjjgJMul.mjs.map +1 -0
  70. package/package.json +8 -3
  71. package/dist/PgBossConnection-CywKoAZU.cjs +0 -2
  72. package/dist/PgBossConnection-DjoqT84r.mjs +0 -2
  73. package/dist/RabbitMQConnection-C9eccBL8.cjs +0 -2
  74. package/dist/RabbitMQConnection-CAp7VqyT.mjs +0 -2
  75. package/dist/SNSConnection-BWDC1wAF.cjs +0 -2
  76. package/dist/SNSConnection-ezQvVrDv.mjs +0 -2
  77. package/dist/SQSSubscriber-DLPZCzFE.cjs.map +0 -1
  78. package/dist/SQSSubscriber-cpo624qU.mjs.map +0 -1
  79. package/dist/types-C15FC0qp.mjs +0 -18
  80. package/dist/types-C15FC0qp.mjs.map +0 -1
  81. package/dist/types-DXNwyRyg.cjs +0 -23
  82. package/dist/types-DXNwyRyg.cjs.map +0 -1
  83. package/dist/types-lnM-qoe_.d.cts +0 -140
  84. package/dist/types-lnM-qoe_.d.cts.map +0 -1
  85. package/dist/types-lnM-qoe_.d.mts +0 -140
  86. package/dist/types-lnM-qoe_.d.mts.map +0 -1
@@ -1,4 +1,4 @@
1
- import "../types-C15FC0qp.mjs";
1
+ import { a as consumeTraced, s as publishTraced } from "../telemetry-DjjgJMul.mjs";
2
2
  import { EventEmitter } from "node:events";
3
3
  //#region src/basic/BasicConnection.ts
4
4
  var BasicConnection = class BasicConnection {
@@ -44,7 +44,15 @@ var BasicPublisher = class {
44
44
  }
45
45
  async publish(messages) {
46
46
  const emitter = this.connection.eventEmitter;
47
- for (const message of messages) emitter.emit(message.type, message);
47
+ await publishTraced(messages, (message) => ({
48
+ system: "basic",
49
+ destination: message.type,
50
+ type: message.type
51
+ }), async (carriers) => {
52
+ messages.forEach((message, i) => {
53
+ emitter.emit(message.type, message, carriers[i]);
54
+ });
55
+ });
48
56
  }
49
57
  };
50
58
  //#endregion
@@ -56,12 +64,34 @@ var BasicSubscriber = class {
56
64
  }
57
65
  async subscribe(messages, listener) {
58
66
  const emitter = this.connection.eventEmitter;
59
- for (const messageType of messages) emitter.on(messageType, (message) => {
60
- listener(message).catch((_error) => {});
67
+ for (const messageType of messages) emitter.on(messageType, (message, carrier) => {
68
+ consumeTraced({
69
+ system: "basic",
70
+ destination: messageType,
71
+ type: messageType
72
+ }, carrier, () => listener(message)).catch((_error) => {});
61
73
  });
62
74
  }
63
75
  };
64
76
  //#endregion
65
- export { BasicConnection, BasicPublisher, BasicSubscriber };
77
+ //#region src/basic/driver.ts
78
+ /**
79
+ * `basic://` — an in-process `EventEmitter`. Register it with
80
+ * `registerEventsDriver(basicEventsDriver)`.
81
+ */
82
+ const basicEventsDriver = {
83
+ scheme: "basic",
84
+ connect: (url) => BasicConnection.fromConnectionString(url),
85
+ async publisher(url) {
86
+ return new BasicPublisher(await BasicConnection.fromConnectionString(url));
87
+ },
88
+ publisherFor: (connection) => new BasicPublisher(connection),
89
+ async subscriber(url) {
90
+ return new BasicSubscriber(await BasicConnection.fromConnectionString(url));
91
+ },
92
+ subscriberFor: (connection) => new BasicSubscriber(connection)
93
+ };
94
+ //#endregion
95
+ export { BasicConnection, BasicPublisher, BasicSubscriber, basicEventsDriver };
66
96
 
67
97
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"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,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;;;AC3CA,IAAa,iBAAb,MAEA;CACqB;CAApB,YAAY,YAAqC;EAA7B,KAAA,aAAA;CAA8B;CAElD,MAAM,QAAQ,UAAsB;EACnC,MAAM,UAAU,KAAK,WAAW;EAChC,KAAK,MAAM,WAAW,UACrB,QAAQ,KAAK,QAAQ,MAAM,OAAO;CAEpC;AACD;;;ACXA,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,YAAsB;GAC9C,SAAS,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC;EACvC,CAAC;CAEH;AACD"}
1
+ {"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 CHANGED
@@ -1,184 +1,88 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_types = require("./types-DXNwyRyg.cjs");
2
+ const require_telemetry = require("./telemetry-DG3l807O.cjs");
3
+ const require_registry = require("./registry-DlT36229.cjs");
3
4
  //#region src/EventConnection.ts
4
5
  var EventConnectionFactory = class {
5
6
  /**
6
- * Create an EventConnection from a connection string
7
- * Dynamically imports the appropriate connection implementation
7
+ * Create an EventConnection from a connection string, through whichever
8
+ * driver is registered for its scheme — see `registerEventsDriver`.
9
+ *
10
+ * @throws {UnregisteredEventsScheme} when the broker's driver is not
11
+ * registered.
8
12
  */
9
13
  static async fromConnectionString(connectionStr) {
10
- const protocol = new URL(connectionStr).protocol.replace(":", "");
11
- switch (protocol) {
12
- case "basic": {
13
- const { BasicConnection } = await Promise.resolve().then(() => require("./basic/index.cjs"));
14
- return BasicConnection.fromConnectionString(connectionStr);
15
- }
16
- case "rabbitmq": {
17
- const { RabbitMQConnection } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
18
- return RabbitMQConnection.fromConnectionString(connectionStr);
19
- }
20
- case "sqs": {
21
- const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
22
- return SQSConnection.fromConnectionString(connectionStr);
23
- }
24
- case "sns": {
25
- const { SNSConnection } = await Promise.resolve().then(() => require("./sns/index.cjs"));
26
- return SNSConnection.fromConnectionString(connectionStr);
27
- }
28
- case "pgboss": {
29
- const { PgBossConnection } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
30
- return PgBossConnection.fromConnectionString(connectionStr);
31
- }
32
- default: throw new Error(`Unsupported connection type: ${protocol}`);
33
- }
14
+ const scheme = new URL(connectionStr).protocol;
15
+ return require_registry.eventsDriverFor(scheme, "connection").connect(connectionStr);
34
16
  }
35
17
  };
36
18
  //#endregion
37
19
  //#region src/Publisher.ts
20
+ /**
21
+ * Publishers for a connection string or a connection, through whichever
22
+ * driver is registered for its scheme — see `registerEventsDriver`.
23
+ */
38
24
  var Publisher = class {
39
25
  /**
40
26
  * Create a publisher from a connection string
41
27
  * This creates both a connection and a publisher
28
+ *
29
+ * @throws {UnregisteredEventsScheme} when the broker's driver is not
30
+ * registered.
42
31
  */
43
- static async fromConnectionString(connectionStr) {
44
- const url = new URL(connectionStr);
45
- switch (url.protocol.replace(":", "")) {
46
- case "basic": {
47
- const { BasicConnection, BasicPublisher } = await Promise.resolve().then(() => require("./basic/index.cjs"));
48
- return new BasicPublisher(await BasicConnection.fromConnectionString(connectionStr));
49
- }
50
- case "rabbitmq": {
51
- const { RabbitMQPublisher } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
52
- return RabbitMQPublisher.fromConnectionString(connectionStr);
53
- }
54
- case "sqs": {
55
- const { SQSPublisher } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
56
- return SQSPublisher.fromConnectionString(connectionStr);
57
- }
58
- case "sns": {
59
- const { SNSPublisher } = await Promise.resolve().then(() => require("./sns/index.cjs"));
60
- return SNSPublisher.fromConnectionString(connectionStr);
61
- }
62
- case "pgboss": {
63
- const { PgBossPublisher } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
64
- return PgBossPublisher.fromConnectionString(connectionStr);
65
- }
66
- default: throw new Error(`Unsupported event publisher type: ${url.protocol}`);
67
- }
32
+ static async fromConnectionString(connectionStr, options = {}) {
33
+ const scheme = new URL(connectionStr).protocol;
34
+ return require_registry.eventsDriverFor(scheme, "publisher").publisher(connectionStr, options);
68
35
  }
69
36
  /**
70
37
  * Create a publisher from an existing connection
71
38
  * This allows sharing connections between publishers and subscribers
72
39
  */
73
- static async fromConnection(connection) {
74
- switch (connection.type) {
75
- case "basic": {
76
- const { BasicPublisher } = await Promise.resolve().then(() => require("./basic/index.cjs"));
77
- const { BasicConnection } = await Promise.resolve().then(() => require("./basic/index.cjs"));
78
- return new BasicPublisher(connection);
79
- }
80
- case "rabbitmq": {
81
- const { RabbitMQPublisher } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
82
- const { RabbitMQConnection } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
83
- return new RabbitMQPublisher(connection);
84
- }
85
- case "sqs": {
86
- const { SQSPublisher } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
87
- const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
88
- return new SQSPublisher(connection);
89
- }
90
- case "sns": {
91
- const { SNSPublisher } = await Promise.resolve().then(() => require("./sns/index.cjs"));
92
- const { SNSConnection } = await Promise.resolve().then(() => require("./sns/index.cjs"));
93
- return new SNSPublisher(connection);
94
- }
95
- case "pgboss": {
96
- const { PgBossPublisher } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
97
- const { PgBossConnection } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
98
- return new PgBossPublisher(connection);
99
- }
100
- default: throw new Error(`Unsupported connection type: ${connection.type}`);
101
- }
40
+ static async fromConnection(connection, options = {}) {
41
+ return require_registry.eventsDriverFor(connection.type, "publisher").publisherFor(connection, options);
102
42
  }
103
43
  };
104
44
  //#endregion
105
45
  //#region src/Subscriber.ts
46
+ /**
47
+ * Subscribers for a connection string or a connection, through whichever
48
+ * driver is registered for its scheme — see `registerEventsDriver`.
49
+ */
106
50
  var Subscriber = class {
107
51
  /**
108
52
  * Create a subscriber from a connection string
109
53
  * This creates both a connection and a subscriber
54
+ *
55
+ * @throws {UnregisteredEventsScheme} when the broker's driver is not
56
+ * registered.
110
57
  */
111
58
  static async fromConnectionString(connectionStr) {
112
- const url = new URL(connectionStr);
113
- switch (url.protocol.replace(":", "")) {
114
- case "basic": {
115
- const { BasicConnection, BasicSubscriber } = await Promise.resolve().then(() => require("./basic/index.cjs"));
116
- return new BasicSubscriber(await BasicConnection.fromConnectionString(connectionStr));
117
- }
118
- case "rabbitmq": {
119
- const { RabbitMQSubscriber } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
120
- return RabbitMQSubscriber.fromConnectionString(connectionStr);
121
- }
122
- case "sns": {
123
- const { SNSSubscriber } = await Promise.resolve().then(() => require("./sns/index.cjs"));
124
- return SNSSubscriber.fromConnectionString(connectionStr);
125
- }
126
- case "sqs": {
127
- if (new URL(connectionStr).searchParams.get("topicArn")) {
128
- const { SNSSubscriber } = await Promise.resolve().then(() => require("./sns/index.cjs"));
129
- const snsConnectionStr = connectionStr.replace("sqs://", "sns://");
130
- return SNSSubscriber.fromConnectionString(snsConnectionStr);
131
- }
132
- const { SQSSubscriber } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
133
- const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
134
- return new SQSSubscriber(await SQSConnection.fromConnectionString(connectionStr));
135
- }
136
- case "pgboss": {
137
- const { PgBossSubscriber } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
138
- return PgBossSubscriber.fromConnectionString(connectionStr);
139
- }
140
- default: throw new Error(`Unsupported event subscriber type: ${url.protocol}`);
141
- }
59
+ const scheme = new URL(connectionStr).protocol;
60
+ return require_registry.eventsDriverFor(scheme, "subscriber").subscriber(connectionStr);
142
61
  }
143
62
  /**
144
63
  * Create a subscriber from an existing connection
145
64
  * This allows sharing connections between publishers and subscribers
146
65
  */
147
- static async fromConnection(connection) {
148
- switch (connection.type) {
149
- case "basic": {
150
- const { BasicSubscriber } = await Promise.resolve().then(() => require("./basic/index.cjs"));
151
- const { BasicConnection } = await Promise.resolve().then(() => require("./basic/index.cjs"));
152
- return new BasicSubscriber(connection);
153
- }
154
- case "rabbitmq": {
155
- const { RabbitMQSubscriber } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
156
- const { RabbitMQConnection } = await Promise.resolve().then(() => require("./rabbitmq/index.cjs"));
157
- return new RabbitMQSubscriber(connection);
158
- }
159
- case "sns": {
160
- const { SNSSubscriber } = await Promise.resolve().then(() => require("./sns/index.cjs"));
161
- const { SNSConnection } = await Promise.resolve().then(() => require("./sns/index.cjs"));
162
- return new SNSSubscriber(connection);
163
- }
164
- case "sqs": {
165
- const { SQSSubscriber } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
166
- const { SQSConnection } = await Promise.resolve().then(() => require("./sqs/index.cjs"));
167
- return new SQSSubscriber(connection);
168
- }
169
- case "pgboss": {
170
- const { PgBossSubscriber } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
171
- const { PgBossConnection } = await Promise.resolve().then(() => require("./pgboss/index.cjs"));
172
- return new PgBossSubscriber(connection);
173
- }
174
- default: throw new Error(`Unsupported connection type: ${connection.type}`);
175
- }
66
+ static async fromConnection(connection, options = {}) {
67
+ return require_registry.eventsDriverFor(connection.type, "subscriber").subscriberFor(connection, options);
176
68
  }
177
69
  };
178
70
  //#endregion
179
71
  exports.EventConnectionFactory = EventConnectionFactory;
180
- exports.EventPublisherType = require_types.EventPublisherType;
72
+ exports.EventPublisherType = require_telemetry.EventPublisherType;
181
73
  exports.Publisher = Publisher;
182
74
  exports.Subscriber = Subscriber;
75
+ exports.TRACE_CONTEXT_KEY = require_telemetry.TRACE_CONTEXT_KEY;
76
+ exports.UnregisteredEventsScheme = require_registry.UnregisteredEventsScheme;
77
+ exports.UnsupportedEventTransport = require_telemetry.UnsupportedEventTransport;
78
+ exports.carrierFromAttributes = require_telemetry.carrierFromAttributes;
79
+ exports.consumeBatchTraced = require_telemetry.consumeBatchTraced;
80
+ exports.consumeTraced = require_telemetry.consumeTraced;
81
+ exports.eventsDriverFor = require_registry.eventsDriverFor;
82
+ exports.extractTraceContext = require_telemetry.extractTraceContext;
83
+ exports.publishTraced = require_telemetry.publishTraced;
84
+ exports.registerEventsDriver = require_registry.registerEventsDriver;
85
+ exports.registeredEventsSchemes = require_registry.registeredEventsSchemes;
86
+ exports.withoutTraceKey = require_telemetry.withoutTraceKey;
183
87
 
184
88
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":[],"sources":["../src/EventConnection.ts","../src/Publisher.ts","../src/Subscriber.ts"],"sourcesContent":["import type { EventConnection } from './types';\nimport { EventPublisherType } from './types';\n\nexport class EventConnectionFactory {\n\t/**\n\t * Create an EventConnection from a connection string\n\t * Dynamically imports the appropriate connection implementation\n\t */\n\tstatic async fromConnectionString(\n\t\tconnectionStr: string,\n\t): Promise<EventConnection> {\n\t\tconst url = new URL(connectionStr);\n\t\tconst protocol = url.protocol.replace(':', '') as EventPublisherType;\n\n\t\tswitch (protocol) {\n\t\t\tcase EventPublisherType.Basic: {\n\t\t\t\tconst { BasicConnection } = await import('./basic');\n\t\t\t\treturn BasicConnection.fromConnectionString(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.RabbitMQ: {\n\t\t\t\tconst { RabbitMQConnection } = await import('./rabbitmq');\n\t\t\t\treturn RabbitMQConnection.fromConnectionString(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SQS: {\n\t\t\t\tconst { SQSConnection } = await import('./sqs');\n\t\t\t\treturn SQSConnection.fromConnectionString(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SNS: {\n\t\t\t\tconst { SNSConnection } = await import('./sns');\n\t\t\t\treturn SNSConnection.fromConnectionString(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.PgBoss: {\n\t\t\t\tconst { PgBossConnection } = await import('./pgboss');\n\t\t\t\treturn PgBossConnection.fromConnectionString(connectionStr);\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`Unsupported connection type: ${protocol}`);\n\t\t}\n\t}\n}\n\nexport type { EventConnection } from './types';\nexport { EventPublisherType } from './types';\n","import type {\n\tEventConnection,\n\tEventPublisher,\n\tPublishableMessage,\n} from './types';\nimport { EventPublisherType } from './types';\n\nexport class Publisher {\n\t/**\n\t * Create a publisher from a connection string\n\t * This creates both a connection and a publisher\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(\n\t\tconnectionStr: EventPublisherConnectionString,\n\t): Promise<EventPublisher<TMessage>> {\n\t\tconst url = new URL(connectionStr);\n\t\tswitch (url.protocol.replace(':', '')) {\n\t\t\tcase EventPublisherType.Basic: {\n\t\t\t\tconst { BasicConnection, BasicPublisher } = await import('./basic');\n\t\t\t\tconst connection =\n\t\t\t\t\tawait BasicConnection.fromConnectionString(connectionStr);\n\t\t\t\treturn new BasicPublisher<TMessage>(connection);\n\t\t\t}\n\t\t\tcase EventPublisherType.RabbitMQ: {\n\t\t\t\tconst { RabbitMQPublisher } = await import('./rabbitmq');\n\t\t\t\treturn RabbitMQPublisher.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SQS: {\n\t\t\t\tconst { SQSPublisher } = await import('./sqs');\n\t\t\t\treturn SQSPublisher.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SNS: {\n\t\t\t\tconst { SNSPublisher } = await import('./sns');\n\t\t\t\treturn SNSPublisher.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.PgBoss: {\n\t\t\t\tconst { PgBossPublisher } = await import('./pgboss');\n\t\t\t\treturn PgBossPublisher.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\t// Future implementations for EventBridge, Kafka, etc.\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`Unsupported event publisher type: ${url.protocol}`);\n\t\t}\n\t}\n\n\t/**\n\t * Create a publisher from an existing connection\n\t * This allows sharing connections between publishers and subscribers\n\t */\n\tstatic async fromConnection<TMessage extends PublishableMessage<string, any>>(\n\t\tconnection: EventConnection,\n\t): Promise<EventPublisher<TMessage>> {\n\t\tswitch (connection.type) {\n\t\t\tcase EventPublisherType.Basic: {\n\t\t\t\tconst { BasicPublisher } = await import('./basic');\n\t\t\t\tconst { BasicConnection } = await import('./basic');\n\t\t\t\treturn new BasicPublisher<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof BasicConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.RabbitMQ: {\n\t\t\t\tconst { RabbitMQPublisher } = await import('./rabbitmq');\n\t\t\t\tconst { RabbitMQConnection } = await import('./rabbitmq');\n\t\t\t\treturn new RabbitMQPublisher<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof RabbitMQConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.SQS: {\n\t\t\t\tconst { SQSPublisher } = await import('./sqs');\n\t\t\t\tconst { SQSConnection } = await import('./sqs');\n\t\t\t\treturn new SQSPublisher<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof SQSConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.SNS: {\n\t\t\t\tconst { SNSPublisher } = await import('./sns');\n\t\t\t\tconst { SNSConnection } = await import('./sns');\n\t\t\t\treturn new SNSPublisher<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof SNSConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.PgBoss: {\n\t\t\t\tconst { PgBossPublisher } = await import('./pgboss');\n\t\t\t\tconst { PgBossConnection } = await import('./pgboss');\n\t\t\t\treturn new PgBossPublisher<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof PgBossConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`Unsupported connection type: ${connection.type}`);\n\t\t}\n\t}\n}\n\nexport type EventPublisherConnectionString =\n\t`${EventPublisherType}://${string}`;\n","import type {\n\tEventConnection,\n\tEventSubscriber,\n\tPublishableMessage,\n} from './types';\nimport { EventPublisherType } from './types';\n\nexport class Subscriber {\n\t/**\n\t * Create a subscriber from a connection string\n\t * This creates both a connection and a subscriber\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(\n\t\tconnectionStr: EventSubscriberConnectionString,\n\t): Promise<EventSubscriber<TMessage>> {\n\t\tconst url = new URL(connectionStr);\n\t\tswitch (url.protocol.replace(':', '')) {\n\t\t\tcase EventPublisherType.Basic: {\n\t\t\t\tconst { BasicConnection, BasicSubscriber } = await import('./basic');\n\t\t\t\tconst connection =\n\t\t\t\t\tawait BasicConnection.fromConnectionString(connectionStr);\n\t\t\t\treturn new BasicSubscriber<TMessage>(connection);\n\t\t\t}\n\t\t\tcase EventPublisherType.RabbitMQ: {\n\t\t\t\tconst { RabbitMQSubscriber } = await import('./rabbitmq');\n\t\t\t\treturn RabbitMQSubscriber.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SNS: {\n\t\t\t\tconst { SNSSubscriber } = await import('./sns');\n\t\t\t\treturn SNSSubscriber.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SQS: {\n\t\t\t\tconst url = new URL(connectionStr);\n\t\t\t\tconst topicArn = url.searchParams.get('topicArn');\n\n\t\t\t\t// If topicArn is present, use managed SNS→SQS subscription\n\t\t\t\tif (topicArn) {\n\t\t\t\t\tconst { SNSSubscriber } = await import('./sns');\n\t\t\t\t\t// Convert SQS connection string to SNS connection string\n\t\t\t\t\tconst snsConnectionStr = connectionStr.replace('sqs://', 'sns://');\n\t\t\t\t\treturn SNSSubscriber.fromConnectionString<TMessage>(snsConnectionStr);\n\t\t\t\t}\n\n\t\t\t\t// Direct SQS subscriber\n\t\t\t\tconst { SQSSubscriber } = await import('./sqs');\n\t\t\t\tconst { SQSConnection } = await import('./sqs');\n\t\t\t\tconst connection =\n\t\t\t\t\tawait SQSConnection.fromConnectionString(connectionStr);\n\t\t\t\treturn new SQSSubscriber<TMessage>(connection);\n\t\t\t}\n\t\t\tcase EventPublisherType.PgBoss: {\n\t\t\t\tconst { PgBossSubscriber } = await import('./pgboss');\n\t\t\t\treturn PgBossSubscriber.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\t// Future implementations for EventBridge, Kafka, etc.\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`Unsupported event subscriber type: ${url.protocol}`);\n\t\t}\n\t}\n\n\t/**\n\t * Create a subscriber from an existing connection\n\t * This allows sharing connections between publishers and subscribers\n\t */\n\tstatic async fromConnection<TMessage extends PublishableMessage<string, any>>(\n\t\tconnection: EventConnection,\n\t): Promise<EventSubscriber<TMessage>> {\n\t\tswitch (connection.type) {\n\t\t\tcase EventPublisherType.Basic: {\n\t\t\t\tconst { BasicSubscriber } = await import('./basic');\n\t\t\t\tconst { BasicConnection } = await import('./basic');\n\t\t\t\treturn new BasicSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof BasicConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.RabbitMQ: {\n\t\t\t\tconst { RabbitMQSubscriber } = await import('./rabbitmq');\n\t\t\t\tconst { RabbitMQConnection } = await import('./rabbitmq');\n\t\t\t\treturn new RabbitMQSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof RabbitMQConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.SNS: {\n\t\t\t\tconst { SNSSubscriber } = await import('./sns');\n\t\t\t\tconst { SNSConnection } = await import('./sns');\n\t\t\t\treturn new SNSSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof SNSConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.SQS: {\n\t\t\t\tconst { SQSSubscriber } = await import('./sqs');\n\t\t\t\tconst { SQSConnection } = await import('./sqs');\n\t\t\t\treturn new SQSSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof SQSConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.PgBoss: {\n\t\t\t\tconst { PgBossSubscriber } = await import('./pgboss');\n\t\t\t\tconst { PgBossConnection } = await import('./pgboss');\n\t\t\t\treturn new PgBossSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof PgBossConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`Unsupported connection type: ${connection.type}`);\n\t\t}\n\t}\n}\n\nexport type EventSubscriberConnectionString =\n\t`${EventPublisherType}://${string}`;\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["eventsDriverFor","eventsDriverFor","eventsDriverFor"],"sources":["../src/EventConnection.ts","../src/Publisher.ts","../src/Subscriber.ts"],"sourcesContent":["import { eventsDriverFor } from './registry';\nimport type { EventConnection } from './types';\n\nexport class EventConnectionFactory {\n\t/**\n\t * Create an EventConnection from a connection string, through whichever\n\t * driver is registered for its scheme — see `registerEventsDriver`.\n\t *\n\t * @throws {UnregisteredEventsScheme} when the broker's driver is not\n\t * registered.\n\t */\n\tstatic async fromConnectionString(\n\t\tconnectionStr: string,\n\t): Promise<EventConnection> {\n\t\tconst scheme = new URL(connectionStr).protocol;\n\t\treturn eventsDriverFor(scheme, 'connection').connect(connectionStr);\n\t}\n}\n\nexport type { EventConnection } from './types';\nexport { EventPublisherType } from './types';\n","import { eventsDriverFor } from './registry';\nimport type {\n\tEventConnection,\n\tEventPublisher,\n\tEventPublisherType,\n\tPublishableMessage,\n} from './types';\n\n/** How a publisher is used, beyond the address it reaches. */\nexport interface PublisherOptions {\n\t/**\n\t * The topic this publisher fans out to. SNS and RabbitMQ name the topic in\n\t * their address already; pg-boss has one address for every topic and queue,\n\t * so it is told here that a message goes to every subscriber rather than to\n\t * one queue.\n\t */\n\ttopic?: string;\n}\n\n/**\n * Publishers for a connection string or a connection, through whichever\n * driver is registered for its scheme — see `registerEventsDriver`.\n */\nexport class Publisher {\n\t/**\n\t * Create a publisher from a connection string\n\t * This creates both a connection and a publisher\n\t *\n\t * @throws {UnregisteredEventsScheme} when the broker's driver is not\n\t * registered.\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(\n\t\tconnectionStr: EventPublisherConnectionString,\n\t\toptions: PublisherOptions = {},\n\t): Promise<EventPublisher<TMessage>> {\n\t\tconst scheme = new URL(connectionStr).protocol;\n\t\treturn eventsDriverFor(scheme, 'publisher').publisher<TMessage>(\n\t\t\tconnectionStr,\n\t\t\toptions,\n\t\t);\n\t}\n\n\t/**\n\t * Create a publisher from an existing connection\n\t * This allows sharing connections between publishers and subscribers\n\t */\n\tstatic async fromConnection<TMessage extends PublishableMessage<string, any>>(\n\t\tconnection: EventConnection,\n\t\toptions: PublisherOptions = {},\n\t): Promise<EventPublisher<TMessage>> {\n\t\treturn eventsDriverFor(connection.type, 'publisher').publisherFor<TMessage>(\n\t\t\tconnection,\n\t\t\toptions,\n\t\t);\n\t}\n}\n\nexport type EventPublisherConnectionString =\n\t`${EventPublisherType}://${string}`;\n","import { eventsDriverFor, type SubscriberOptions } from './registry';\nimport type {\n\tEventConnection,\n\tEventPublisherType,\n\tEventSubscriber,\n\tPublishableMessage,\n} from './types';\n\n/**\n * Subscribers for a connection string or a connection, through whichever\n * driver is registered for its scheme — see `registerEventsDriver`.\n */\nexport class Subscriber {\n\t/**\n\t * Create a subscriber from a connection string\n\t * This creates both a connection and a subscriber\n\t *\n\t * @throws {UnregisteredEventsScheme} when the broker's driver is not\n\t * registered.\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(\n\t\tconnectionStr: EventSubscriberConnectionString,\n\t): Promise<EventSubscriber<TMessage>> {\n\t\tconst scheme = new URL(connectionStr).protocol;\n\t\treturn eventsDriverFor(scheme, 'subscriber').subscriber<TMessage>(\n\t\t\tconnectionStr,\n\t\t);\n\t}\n\n\t/**\n\t * Create a subscriber from an existing connection\n\t * This allows sharing connections between publishers and subscribers\n\t */\n\tstatic async fromConnection<TMessage extends PublishableMessage<string, any>>(\n\t\tconnection: EventConnection,\n\t\t/**\n\t\t * Subscribing to a topic as a named subscriber. pg-boss needs both to\n\t\t * give each subscriber its own queue; the other transports carry the\n\t\t * topic in their address and ignore it.\n\t\t */\n\t\toptions: SubscriberOptions = {},\n\t): Promise<EventSubscriber<TMessage>> {\n\t\treturn eventsDriverFor(\n\t\t\tconnection.type,\n\t\t\t'subscriber',\n\t\t).subscriberFor<TMessage>(connection, options);\n\t}\n}\n\nexport type EventSubscriberConnectionString =\n\t`${EventPublisherType}://${string}`;\n"],"mappings":";;;;AAGA,IAAa,yBAAb,MAAoC;;;;;;;;CAQnC,aAAa,qBACZ,eAC2B;EAC3B,MAAM,SAAS,IAAI,IAAI,aAAa,CAAC,CAAC;EACtC,OAAOA,iBAAAA,gBAAgB,QAAQ,YAAY,CAAC,CAAC,QAAQ,aAAa;CACnE;AACD;;;;;;;ACMA,IAAa,YAAb,MAAuB;;;;;;;;CAQtB,aAAa,qBAGZ,eACA,UAA4B,CAAC,GACO;EACpC,MAAM,SAAS,IAAI,IAAI,aAAa,CAAC,CAAC;EACtC,OAAOC,iBAAAA,gBAAgB,QAAQ,WAAW,CAAC,CAAC,UAC3C,eACA,OACD;CACD;;;;;CAMA,aAAa,eACZ,YACA,UAA4B,CAAC,GACO;EACpC,OAAOA,iBAAAA,gBAAgB,WAAW,MAAM,WAAW,CAAC,CAAC,aACpD,YACA,OACD;CACD;AACD;;;;;;;AC7CA,IAAa,aAAb,MAAwB;;;;;;;;CAQvB,aAAa,qBAGZ,eACqC;EACrC,MAAM,SAAS,IAAI,IAAI,aAAa,CAAC,CAAC;EACtC,OAAOC,iBAAAA,gBAAgB,QAAQ,YAAY,CAAC,CAAC,WAC5C,aACD;CACD;;;;;CAMA,aAAa,eACZ,YAMA,UAA6B,CAAC,GACO;EACrC,OAAOA,iBAAAA,gBACN,WAAW,MACX,YACD,CAAC,CAAC,cAAwB,YAAY,OAAO;CAC9C;AACD"}
package/dist/index.d.cts CHANGED
@@ -1,42 +1,102 @@
1
- import { a as ExtractPublisherMessage, i as EventSubscriber, n as EventPublisher, o as MappedEvent, r as EventPublisherType, s as PublishableMessage, t as EventConnection } from "./types-lnM-qoe_.cjs";
1
+ import { _ as UnsupportedEventTransport, a as registerEventsDriver, c as Publisher, d as EventPublisher, f as EventPublisherType, g as PublishableMessage, h as MappedEvent, i as eventsDriverFor, l as PublisherOptions, m as ExtractPublisherMessage, n as SubscriberOptions, o as registeredEventsSchemes, p as EventSubscriber, r as UnregisteredEventsScheme, s as EventPublisherConnectionString, t as EventsDriver, u as EventConnection } from "./registry-DIx25Q5s.cjs";
2
+ import { Context } from "@opentelemetry/api";
2
3
  //#region src/EventConnection.d.ts
3
4
  export declare class EventConnectionFactory {
4
5
  /**
5
- * Create an EventConnection from a connection string
6
- * Dynamically imports the appropriate connection implementation
6
+ * Create an EventConnection from a connection string, through whichever
7
+ * driver is registered for its scheme — see `registerEventsDriver`.
8
+ *
9
+ * @throws {UnregisteredEventsScheme} when the broker's driver is not
10
+ * registered.
7
11
  */
8
12
  static fromConnectionString(connectionStr: string): Promise<EventConnection>;
9
13
  }
10
14
  //#endregion
11
- //#region src/Publisher.d.ts
12
- export declare class Publisher {
13
- /**
14
- * Create a publisher from a connection string
15
- * This creates both a connection and a publisher
16
- */
17
- static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionStr: EventPublisherConnectionString): Promise<EventPublisher<TMessage>>;
18
- /**
19
- * Create a publisher from an existing connection
20
- * This allows sharing connections between publishers and subscribers
21
- */
22
- static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection): Promise<EventPublisher<TMessage>>;
23
- }
24
- type EventPublisherConnectionString = `${EventPublisherType}://${string}`;
25
- //#endregion
26
15
  //#region src/Subscriber.d.ts
16
+ /**
17
+ * Subscribers for a connection string or a connection, through whichever
18
+ * driver is registered for its scheme — see `registerEventsDriver`.
19
+ */
27
20
  export declare class Subscriber {
28
21
  /**
29
22
  * Create a subscriber from a connection string
30
23
  * This creates both a connection and a subscriber
24
+ *
25
+ * @throws {UnregisteredEventsScheme} when the broker's driver is not
26
+ * registered.
31
27
  */
32
28
  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionStr: EventSubscriberConnectionString): Promise<EventSubscriber<TMessage>>;
33
29
  /**
34
30
  * Create a subscriber from an existing connection
35
31
  * This allows sharing connections between publishers and subscribers
36
32
  */
37
- static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection): Promise<EventSubscriber<TMessage>>;
33
+ static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection,
34
+ /**
35
+ * Subscribing to a topic as a named subscriber. pg-boss needs both to
36
+ * give each subscriber its own queue; the other transports carry the
37
+ * topic in their address and ignore it.
38
+ */
39
+ options?: SubscriberOptions): Promise<EventSubscriber<TMessage>>;
38
40
  }
39
41
  type EventSubscriberConnectionString = `${EventPublisherType}://${string}`;
40
42
  //#endregion
41
- export { type EventConnection, type EventPublisher, type EventPublisherConnectionString, EventPublisherType, type EventSubscriber, type EventSubscriberConnectionString, type ExtractPublisherMessage, type MappedEvent, type PublishableMessage };
43
+ //#region src/telemetry.d.ts
44
+ /**
45
+ * The key a trace context travels under where a broker has no header field of
46
+ * its own — a pg-boss job's data. Reserved: it is removed before a handler sees
47
+ * the payload, and a payload of the application's own should not use it.
48
+ */
49
+ export declare const TRACE_CONTEXT_KEY = "__gkmTrace";
50
+ /** A propagated trace context: `traceparent`, and `tracestate` when set. */
51
+ type TraceCarrier = Record<string, string>;
52
+ /** What a message is, as its spans describe it. */
53
+ interface MessagingTarget {
54
+ /** `messaging.system`: `pgboss`, `aws_sqs`, `aws_sns`, `rabbitmq`, `basic`. */
55
+ system: string;
56
+ /** The queue or topic — `messaging.destination.name`. */
57
+ destination: string;
58
+ /** The event's type, when the message has one. */
59
+ type?: string;
60
+ /** The broker's id for the message, when it has one. */
61
+ messageId?: string;
62
+ }
63
+ /**
64
+ * Publish `items`, each with a PRODUCER span of its own, through `send` —
65
+ * which receives the carrier to attach to each item, in order.
66
+ */
67
+ export declare function publishTraced<T, R>(items: readonly T[], describe: (item: T) => MessagingTarget, send: (carriers: (TraceCarrier | undefined)[]) => Promise<R>): Promise<R>;
68
+ /**
69
+ * The context a carrier holds, or undefined when it holds none — no carrier, a
70
+ * malformed `traceparent`, or a propagator that throws.
71
+ */
72
+ export declare function extractTraceContext(carrier: TraceCarrier | undefined): Context | undefined;
73
+ /**
74
+ * Run `fn` inside a CONSUMER span for one message: a child of the context the
75
+ * message carried, or a new trace when it carried none. The active context of
76
+ * the poller that received it is never the parent — a job is not part of
77
+ * whatever happened to start the poll loop.
78
+ */
79
+ export declare function consumeTraced<R>(target: MessagingTarget, carrier: TraceCarrier | undefined, fn: () => Promise<R>): Promise<R>;
80
+ /**
81
+ * One CONSUMER span for a batch that arrived together — a Lambda's records.
82
+ * One message with a context is its child; several start a trace of their own
83
+ * that links to each message's producer, since a span has one parent.
84
+ */
85
+ export declare function consumeBatchTraced<R>(target: MessagingTarget, carriers: readonly (TraceCarrier | undefined)[], fn: () => Promise<R>): Promise<R>;
86
+ /**
87
+ * A carrier from broker message attributes, in any of the shapes they arrive
88
+ * in: SQS's `{ StringValue }`, a Lambda SQS record's `{ stringValue }`, an SNS
89
+ * envelope's `{ Value }`, or plain strings (RabbitMQ headers).
90
+ */
91
+ export declare function carrierFromAttributes(attributes: Record<string, unknown> | undefined | null): TraceCarrier | undefined;
92
+ /**
93
+ * `data` without {@link TRACE_CONTEXT_KEY}, and the carrier that was under it.
94
+ * What a handler sees never has the key.
95
+ */
96
+ export declare function withoutTraceKey<T>(data: T): {
97
+ data: T;
98
+ carrier: TraceCarrier | undefined;
99
+ };
100
+ //#endregion
101
+ export { type EventConnection, type EventPublisher, type EventPublisherConnectionString, EventPublisherType, type EventSubscriber, type EventSubscriberConnectionString, type EventsDriver, type ExtractPublisherMessage, type MappedEvent, type MessagingTarget, type PublishableMessage, Publisher, type PublisherOptions, type SubscriberOptions, type TraceCarrier, UnregisteredEventsScheme, UnsupportedEventTransport, eventsDriverFor, registerEventsDriver, registeredEventsSchemes };
42
102
  //# sourceMappingURL=index.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.cts","names":[],"sources":["../src/EventConnection.ts","../src/Publisher.ts","../src/Subscriber.ts"],"mappings":";;qBAGa;;;;;SAKC,qBACZ,wBACE,QAAQ;;;;qBCHC;;;;;SAKC,qBACZ,iBAAiB,iCAEjB,eAAe,iCACb,QAAQ,eAAe;;;;;SAmCb,eAAe,iBAAiB,iCAC5C,YAAY,kBACV,QAAQ,eAAe;;KA2Cf,oCACR;;;qBC1FS;;;;;SAKC,qBACZ,iBAAiB,iCAEjB,eAAe,kCACb,QAAQ,gBAAgB;;;;;SAkDd,eAAe,iBAAiB,iCAC5C,YAAY,kBACV,QAAQ,gBAAgB;;KA2ChB,qCACR"}
1
+ {"version":3,"file":"index.d.cts","names":[],"sources":["../src/EventConnection.ts","../src/Subscriber.ts","../src/telemetry.ts"],"mappings":";;;qBAGa;;;;;;;;SAQC,qBACZ,wBACE,QAAQ;;;;;;;;qBCDC;;;;;;;;SAQC,qBACZ,iBAAiB,iCAEjB,eAAe,kCACb,QAAQ,gBAAgB;;;;;SAWd,eAAe,iBAAiB,iCAC5C,YAAY,iBAMZ;;;;;;EAAA,UAAS,oBACP,QAAQ,gBAAgB;;KAQhB,qCACR;;;;;;;;qBCjBS;;KAGD,eAAe;;UAGV;;EAEhB;;EAEA;;EAEA;;EAEA;;;;;;wBA+DqB,cAAc,GAAG,GACtC,gBAAgB,KAChB,WAAW,MAAM,MAAM,iBACvB,OAAO,WAAW,gCAAgC,QAAQ,KACxD,QAAQ;;;;;wBAiBK,oBACf,SAAS,2BACP;;;;;;;wBAgBa,cAAc,GAC7B,QAAQ,iBACR,SAAS,0BACT,UAAU,QAAQ,KAChB,QAAQ;;;;;;wBAUK,mBAAmB,GAClC,QAAQ,iBACR,oBAAoB,6BACpB,UAAU,QAAQ,KAChB,QAAQ;;;;;;wBAwDK,sBACf,YAAY,6CACV;;;;;wBA+Da,gBAAgB,GAAG,MAAM;EACxC,MAAM;EACN,SAAS"}
package/dist/index.d.mts CHANGED
@@ -1,42 +1,102 @@
1
- import { a as ExtractPublisherMessage, i as EventSubscriber, n as EventPublisher, o as MappedEvent, r as EventPublisherType, s as PublishableMessage, t as EventConnection } from "./types-lnM-qoe_.mjs";
1
+ import { _ as UnsupportedEventTransport, a as registerEventsDriver, c as Publisher, d as EventPublisher, f as EventPublisherType, g as PublishableMessage, h as MappedEvent, i as eventsDriverFor, l as PublisherOptions, m as ExtractPublisherMessage, n as SubscriberOptions, o as registeredEventsSchemes, p as EventSubscriber, r as UnregisteredEventsScheme, s as EventPublisherConnectionString, t as EventsDriver, u as EventConnection } from "./registry-DIx25Q5s.mjs";
2
+ import { Context } from "@opentelemetry/api";
2
3
  //#region src/EventConnection.d.ts
3
4
  export declare class EventConnectionFactory {
4
5
  /**
5
- * Create an EventConnection from a connection string
6
- * Dynamically imports the appropriate connection implementation
6
+ * Create an EventConnection from a connection string, through whichever
7
+ * driver is registered for its scheme — see `registerEventsDriver`.
8
+ *
9
+ * @throws {UnregisteredEventsScheme} when the broker's driver is not
10
+ * registered.
7
11
  */
8
12
  static fromConnectionString(connectionStr: string): Promise<EventConnection>;
9
13
  }
10
14
  //#endregion
11
- //#region src/Publisher.d.ts
12
- export declare class Publisher {
13
- /**
14
- * Create a publisher from a connection string
15
- * This creates both a connection and a publisher
16
- */
17
- static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionStr: EventPublisherConnectionString): Promise<EventPublisher<TMessage>>;
18
- /**
19
- * Create a publisher from an existing connection
20
- * This allows sharing connections between publishers and subscribers
21
- */
22
- static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection): Promise<EventPublisher<TMessage>>;
23
- }
24
- type EventPublisherConnectionString = `${EventPublisherType}://${string}`;
25
- //#endregion
26
15
  //#region src/Subscriber.d.ts
16
+ /**
17
+ * Subscribers for a connection string or a connection, through whichever
18
+ * driver is registered for its scheme — see `registerEventsDriver`.
19
+ */
27
20
  export declare class Subscriber {
28
21
  /**
29
22
  * Create a subscriber from a connection string
30
23
  * This creates both a connection and a subscriber
24
+ *
25
+ * @throws {UnregisteredEventsScheme} when the broker's driver is not
26
+ * registered.
31
27
  */
32
28
  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionStr: EventSubscriberConnectionString): Promise<EventSubscriber<TMessage>>;
33
29
  /**
34
30
  * Create a subscriber from an existing connection
35
31
  * This allows sharing connections between publishers and subscribers
36
32
  */
37
- static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection): Promise<EventSubscriber<TMessage>>;
33
+ static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection,
34
+ /**
35
+ * Subscribing to a topic as a named subscriber. pg-boss needs both to
36
+ * give each subscriber its own queue; the other transports carry the
37
+ * topic in their address and ignore it.
38
+ */
39
+ options?: SubscriberOptions): Promise<EventSubscriber<TMessage>>;
38
40
  }
39
41
  type EventSubscriberConnectionString = `${EventPublisherType}://${string}`;
40
42
  //#endregion
41
- export { type EventConnection, type EventPublisher, type EventPublisherConnectionString, EventPublisherType, type EventSubscriber, type EventSubscriberConnectionString, type ExtractPublisherMessage, type MappedEvent, type PublishableMessage };
43
+ //#region src/telemetry.d.ts
44
+ /**
45
+ * The key a trace context travels under where a broker has no header field of
46
+ * its own — a pg-boss job's data. Reserved: it is removed before a handler sees
47
+ * the payload, and a payload of the application's own should not use it.
48
+ */
49
+ export declare const TRACE_CONTEXT_KEY = "__gkmTrace";
50
+ /** A propagated trace context: `traceparent`, and `tracestate` when set. */
51
+ type TraceCarrier = Record<string, string>;
52
+ /** What a message is, as its spans describe it. */
53
+ interface MessagingTarget {
54
+ /** `messaging.system`: `pgboss`, `aws_sqs`, `aws_sns`, `rabbitmq`, `basic`. */
55
+ system: string;
56
+ /** The queue or topic — `messaging.destination.name`. */
57
+ destination: string;
58
+ /** The event's type, when the message has one. */
59
+ type?: string;
60
+ /** The broker's id for the message, when it has one. */
61
+ messageId?: string;
62
+ }
63
+ /**
64
+ * Publish `items`, each with a PRODUCER span of its own, through `send` —
65
+ * which receives the carrier to attach to each item, in order.
66
+ */
67
+ export declare function publishTraced<T, R>(items: readonly T[], describe: (item: T) => MessagingTarget, send: (carriers: (TraceCarrier | undefined)[]) => Promise<R>): Promise<R>;
68
+ /**
69
+ * The context a carrier holds, or undefined when it holds none — no carrier, a
70
+ * malformed `traceparent`, or a propagator that throws.
71
+ */
72
+ export declare function extractTraceContext(carrier: TraceCarrier | undefined): Context | undefined;
73
+ /**
74
+ * Run `fn` inside a CONSUMER span for one message: a child of the context the
75
+ * message carried, or a new trace when it carried none. The active context of
76
+ * the poller that received it is never the parent — a job is not part of
77
+ * whatever happened to start the poll loop.
78
+ */
79
+ export declare function consumeTraced<R>(target: MessagingTarget, carrier: TraceCarrier | undefined, fn: () => Promise<R>): Promise<R>;
80
+ /**
81
+ * One CONSUMER span for a batch that arrived together — a Lambda's records.
82
+ * One message with a context is its child; several start a trace of their own
83
+ * that links to each message's producer, since a span has one parent.
84
+ */
85
+ export declare function consumeBatchTraced<R>(target: MessagingTarget, carriers: readonly (TraceCarrier | undefined)[], fn: () => Promise<R>): Promise<R>;
86
+ /**
87
+ * A carrier from broker message attributes, in any of the shapes they arrive
88
+ * in: SQS's `{ StringValue }`, a Lambda SQS record's `{ stringValue }`, an SNS
89
+ * envelope's `{ Value }`, or plain strings (RabbitMQ headers).
90
+ */
91
+ export declare function carrierFromAttributes(attributes: Record<string, unknown> | undefined | null): TraceCarrier | undefined;
92
+ /**
93
+ * `data` without {@link TRACE_CONTEXT_KEY}, and the carrier that was under it.
94
+ * What a handler sees never has the key.
95
+ */
96
+ export declare function withoutTraceKey<T>(data: T): {
97
+ data: T;
98
+ carrier: TraceCarrier | undefined;
99
+ };
100
+ //#endregion
101
+ export { type EventConnection, type EventPublisher, type EventPublisherConnectionString, EventPublisherType, type EventSubscriber, type EventSubscriberConnectionString, type EventsDriver, type ExtractPublisherMessage, type MappedEvent, type MessagingTarget, type PublishableMessage, Publisher, type PublisherOptions, type SubscriberOptions, type TraceCarrier, UnregisteredEventsScheme, UnsupportedEventTransport, eventsDriverFor, registerEventsDriver, registeredEventsSchemes };
42
102
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/EventConnection.ts","../src/Publisher.ts","../src/Subscriber.ts"],"mappings":";;qBAGa;;;;;SAKC,qBACZ,wBACE,QAAQ;;;;qBCHC;;;;;SAKC,qBACZ,iBAAiB,iCAEjB,eAAe,iCACb,QAAQ,eAAe;;;;;SAmCb,eAAe,iBAAiB,iCAC5C,YAAY,kBACV,QAAQ,eAAe;;KA2Cf,oCACR;;;qBC1FS;;;;;SAKC,qBACZ,iBAAiB,iCAEjB,eAAe,kCACb,QAAQ,gBAAgB;;;;;SAkDd,eAAe,iBAAiB,iCAC5C,YAAY,kBACV,QAAQ,gBAAgB;;KA2ChB,qCACR"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/EventConnection.ts","../src/Subscriber.ts","../src/telemetry.ts"],"mappings":";;;qBAGa;;;;;;;;SAQC,qBACZ,wBACE,QAAQ;;;;;;;;qBCDC;;;;;;;;SAQC,qBACZ,iBAAiB,iCAEjB,eAAe,kCACb,QAAQ,gBAAgB;;;;;SAWd,eAAe,iBAAiB,iCAC5C,YAAY,iBAMZ;;;;;;EAAA,UAAS,oBACP,QAAQ,gBAAgB;;KAQhB,qCACR;;;;;;;;qBCjBS;;KAGD,eAAe;;UAGV;;EAEhB;;EAEA;;EAEA;;EAEA;;;;;;wBA+DqB,cAAc,GAAG,GACtC,gBAAgB,KAChB,WAAW,MAAM,MAAM,iBACvB,OAAO,WAAW,gCAAgC,QAAQ,KACxD,QAAQ;;;;;wBAiBK,oBACf,SAAS,2BACP;;;;;;;wBAgBa,cAAc,GAC7B,QAAQ,iBACR,SAAS,0BACT,UAAU,QAAQ,KAChB,QAAQ;;;;;;wBAUK,mBAAmB,GAClC,QAAQ,iBACR,oBAAoB,6BACpB,UAAU,QAAQ,KAChB,QAAQ;;;;;;wBAwDK,sBACf,YAAY,6CACV;;;;;wBA+Da,gBAAgB,GAAG,MAAM;EACxC,MAAM;EACN,SAAS"}