@geekmidas/events 10.0.0-alpha.13 → 10.0.0-alpha.130
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +46 -1
- package/dist/{SQSSubscriber-cpo624qU.mjs → SQSSubscriber-BEJBfNTe.mjs} +94 -10
- package/dist/SQSSubscriber-BEJBfNTe.mjs.map +1 -0
- package/dist/{SQSSubscriber-DLPZCzFE.cjs → SQSSubscriber-COTqWvOk.cjs} +101 -10
- package/dist/SQSSubscriber-COTqWvOk.cjs.map +1 -0
- package/dist/basic/index.cjs +35 -4
- package/dist/basic/index.cjs.map +1 -1
- package/dist/basic/index.d.cts +8 -1
- package/dist/basic/index.d.cts.map +1 -1
- package/dist/basic/index.d.mts +8 -1
- package/dist/basic/index.d.mts.map +1 -1
- package/dist/basic/index.mjs +35 -5
- package/dist/basic/index.mjs.map +1 -1
- package/dist/index.cjs +45 -141
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +80 -20
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.mts +80 -20
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +33 -141
- package/dist/index.mjs.map +1 -1
- package/dist/pgboss/index.cjs +124 -27
- package/dist/pgboss/index.cjs.map +1 -1
- package/dist/pgboss/index.d.cts +51 -4
- package/dist/pgboss/index.d.cts.map +1 -1
- package/dist/pgboss/index.d.mts +51 -4
- package/dist/pgboss/index.d.mts.map +1 -1
- package/dist/pgboss/index.mjs +121 -27
- package/dist/pgboss/index.mjs.map +1 -1
- package/dist/rabbitmq/index.cjs +63 -20
- package/dist/rabbitmq/index.cjs.map +1 -1
- package/dist/rabbitmq/index.d.cts +15 -1
- package/dist/rabbitmq/index.d.cts.map +1 -1
- package/dist/rabbitmq/index.d.mts +15 -1
- package/dist/rabbitmq/index.d.mts.map +1 -1
- package/dist/rabbitmq/index.mjs +63 -20
- package/dist/rabbitmq/index.mjs.map +1 -1
- package/dist/registry-DIx25Q5s.d.cts +255 -0
- package/dist/registry-DIx25Q5s.d.cts.map +1 -0
- package/dist/registry-DIx25Q5s.d.mts +255 -0
- package/dist/registry-DIx25Q5s.d.mts.map +1 -0
- package/dist/registry-DXLY1Xf6.mjs +99 -0
- package/dist/registry-DXLY1Xf6.mjs.map +1 -0
- package/dist/registry-DlT36229.cjs +122 -0
- package/dist/registry-DlT36229.cjs.map +1 -0
- package/dist/sns/index.cjs +439 -12
- package/dist/sns/index.cjs.map +1 -1
- package/dist/sns/index.d.cts +263 -8
- package/dist/sns/index.d.cts.map +1 -1
- package/dist/sns/index.d.mts +263 -8
- package/dist/sns/index.d.mts.map +1 -1
- package/dist/sns/index.mjs +423 -13
- package/dist/sns/index.mjs.map +1 -1
- package/dist/sns/snsUrl.d.cts.map +1 -1
- package/dist/sns/snsUrl.d.mts.map +1 -1
- package/dist/sqs/index.cjs +22 -55
- package/dist/sqs/index.cjs.map +1 -1
- package/dist/sqs/index.d.cts +23 -1
- package/dist/sqs/index.d.cts.map +1 -1
- package/dist/sqs/index.d.mts +23 -1
- package/dist/sqs/index.d.mts.map +1 -1
- package/dist/sqs/index.mjs +20 -53
- package/dist/sqs/index.mjs.map +1 -1
- package/dist/sqs/sqsUrl.d.cts.map +1 -1
- package/dist/sqs/sqsUrl.d.mts.map +1 -1
- package/dist/telemetry-DG3l807O.cjs +309 -0
- package/dist/telemetry-DG3l807O.cjs.map +1 -0
- package/dist/telemetry-DjjgJMul.mjs +244 -0
- package/dist/telemetry-DjjgJMul.mjs.map +1 -0
- package/package.json +8 -3
- package/dist/PgBossConnection-CywKoAZU.cjs +0 -2
- package/dist/PgBossConnection-DjoqT84r.mjs +0 -2
- package/dist/RabbitMQConnection-C9eccBL8.cjs +0 -2
- package/dist/RabbitMQConnection-CAp7VqyT.mjs +0 -2
- package/dist/SNSConnection-BWDC1wAF.cjs +0 -2
- package/dist/SNSConnection-ezQvVrDv.mjs +0 -2
- package/dist/SQSSubscriber-DLPZCzFE.cjs.map +0 -1
- package/dist/SQSSubscriber-cpo624qU.mjs.map +0 -1
- package/dist/types-C15FC0qp.mjs +0 -18
- package/dist/types-C15FC0qp.mjs.map +0 -1
- package/dist/types-DXNwyRyg.cjs +0 -23
- package/dist/types-DXNwyRyg.cjs.map +0 -1
- package/dist/types-lnM-qoe_.d.cts +0 -140
- package/dist/types-lnM-qoe_.d.cts.map +0 -1
- package/dist/types-lnM-qoe_.d.mts +0 -140
- package/dist/types-lnM-qoe_.d.mts.map +0 -1
package/dist/basic/index.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import "../
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
package/dist/basic/index.mjs.map
CHANGED
|
@@ -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\
|
|
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
|
|
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
|
-
*
|
|
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
|
|
11
|
-
|
|
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
|
|
45
|
-
|
|
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
|
-
|
|
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
|
|
113
|
-
|
|
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
|
-
|
|
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 =
|
|
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
|
package/dist/index.cjs.map
CHANGED
|
@@ -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
|
|
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
|
-
*
|
|
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
|
|
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
|
-
|
|
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
|
package/dist/index.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.cts","names":[],"sources":["../src/EventConnection.ts","../src/
|
|
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
|
|
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
|
-
*
|
|
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
|
|
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
|
-
|
|
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
|
package/dist/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/EventConnection.ts","../src/
|
|
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"}
|