@backstage/plugin-events-node 0.4.0-next.2 → 0.4.1-next.0

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/CHANGELOG.md CHANGED
@@ -1,5 +1,32 @@
1
1
  # @backstage/plugin-events-node
2
2
 
3
+ ## 0.4.1-next.0
4
+
5
+ ### Patch Changes
6
+
7
+ - 094eaa3: Remove references to in-repo backend-common
8
+ - 2f88f88: Updated backend installation instructions.
9
+ - a90ce4a: The default implementation of the `EventsService` now uses the new event bus for distributing events across multiple backend instances if the events backend plugin is installed.
10
+ - Updated dependencies
11
+ - @backstage/backend-plugin-api@1.0.1-next.0
12
+ - @backstage/errors@1.2.4
13
+ - @backstage/types@1.1.1
14
+
15
+ ## 0.4.0
16
+
17
+ ### Minor Changes
18
+
19
+ - d425fc4: **BREAKING**: The return values from `createBackendPlugin`, `createBackendModule`, and `createServiceFactory` are now simply `BackendFeature` and `ServiceFactory`, instead of the previously deprecated form of a function that returns them. For this reason, `createServiceFactory` also no longer accepts the callback form where you provide direct options to the service. This also affects all `coreServices.*` service refs.
20
+
21
+ This may in particular affect tests; if you were effectively doing `createBackendModule({...})()` (note the parentheses), you can now remove those extra parentheses at the end. You may encounter cases of this in your `packages/backend/src/index.ts` too, where you add plugins, modules, and services. If you were using `createServiceFactory` with a function as its argument for the purpose of passing in options, this pattern has been deprecated for a while and is no longer supported. You may want to explore the new multiton patterns to achieve your goals, or moving settings to app-config.
22
+
23
+ As part of this change, the `IdentityFactoryOptions` type was removed, and can no longer be used to tweak that service. The identity service was also deprecated some time ago, and you will want to [migrate to the new auth system](https://backstage.io/docs/tutorials/auth-service-migration) if you still rely on it.
24
+
25
+ ### Patch Changes
26
+
27
+ - Updated dependencies
28
+ - @backstage/backend-plugin-api@1.0.0
29
+
3
30
  ## 0.4.0-next.2
4
31
 
5
32
  ### Patch Changes
package/README.md CHANGED
@@ -78,5 +78,5 @@ and your custom implementation:
78
78
 
79
79
  ```diff
80
80
  // packages/backend/src/index.ts
81
- + backend.add(customEventsServiceFactory());
81
+ + backend.add(customEventsServiceFactory);
82
82
  ```
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@backstage/plugin-events-node__alpha",
3
- "version": "0.4.0-next.2",
3
+ "version": "0.4.1-next.0",
4
4
  "main": "../dist/alpha.cjs.js",
5
5
  "types": "../dist/alpha.d.ts"
6
6
  }
package/dist/index.cjs.js CHANGED
@@ -1,7 +1,33 @@
1
1
  'use strict';
2
2
 
3
+ var crossFetch = require('cross-fetch');
4
+ var parser = require('uri-template');
5
+ var errors = require('@backstage/errors');
3
6
  var backendPluginApi = require('@backstage/backend-plugin-api');
4
7
 
8
+ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
9
+
10
+ function _interopNamespaceCompat(e) {
11
+ if (e && typeof e === 'object' && 'default' in e) return e;
12
+ var n = Object.create(null);
13
+ if (e) {
14
+ Object.keys(e).forEach(function (k) {
15
+ if (k !== 'default') {
16
+ var d = Object.getOwnPropertyDescriptor(e, k);
17
+ Object.defineProperty(n, k, d.get ? d : {
18
+ enumerable: true,
19
+ get: function () { return e[k]; }
20
+ });
21
+ }
22
+ });
23
+ }
24
+ n.default = e;
25
+ return Object.freeze(n);
26
+ }
27
+
28
+ var crossFetch__default = /*#__PURE__*/_interopDefaultCompat(crossFetch);
29
+ var parser__namespace = /*#__PURE__*/_interopNamespaceCompat(parser);
30
+
5
31
  class EventRouter {
6
32
  events;
7
33
  topics;
@@ -38,71 +64,363 @@ class EventRouter {
38
64
  }
39
65
  }
40
66
 
41
- class DefaultEventsService {
42
- constructor(logger) {
43
- this.logger = logger;
67
+ const pluginId = "events";
68
+
69
+ class DefaultApiClient {
70
+ discoveryApi;
71
+ fetchApi;
72
+ constructor(options) {
73
+ this.discoveryApi = options.discoveryApi;
74
+ this.fetchApi = options.fetchApi || { fetch: crossFetch__default.default };
44
75
  }
45
- subscribers = /* @__PURE__ */ new Map();
46
- static create(options) {
47
- return new DefaultEventsService(options.logger);
76
+ /**
77
+ * Get new events for the provided subscription
78
+ * @param subscriptionId
79
+ */
80
+ async getSubscriptionEvents(request, options) {
81
+ const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);
82
+ const uriTemplate = `/bus/v1/subscriptions/{subscriptionId}/events`;
83
+ const uri = parser__namespace.parse(uriTemplate).expand({
84
+ subscriptionId: request.path.subscriptionId
85
+ });
86
+ return await this.fetchApi.fetch(`${baseUrl}${uri}`, {
87
+ headers: {
88
+ "Content-Type": "application/json",
89
+ ...options?.token && { Authorization: `Bearer ${options?.token}` }
90
+ },
91
+ method: "GET"
92
+ });
48
93
  }
49
94
  /**
50
- * Returns a plugin-scoped context of the `EventService`
51
- * that ensures to prefix subscriber IDs with the plugin ID.
52
- *
53
- * @param pluginId - The plugin that the `EventService` should be created for.
95
+ * Publish a new event
96
+ * @param postEventRequest
54
97
  */
55
- forPlugin(pluginId) {
56
- return {
57
- publish: (params) => {
58
- return this.publish(params);
98
+ async postEvent(request, options) {
99
+ const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);
100
+ const uriTemplate = `/bus/v1/events`;
101
+ const uri = parser__namespace.parse(uriTemplate).expand({});
102
+ return await this.fetchApi.fetch(`${baseUrl}${uri}`, {
103
+ headers: {
104
+ "Content-Type": "application/json",
105
+ ...options?.token && { Authorization: `Bearer ${options?.token}` }
59
106
  },
60
- subscribe: (options) => {
61
- return this.subscribe({
62
- ...options,
63
- id: `${pluginId}.${options.id}`
64
- });
65
- }
66
- };
107
+ method: "POST",
108
+ body: JSON.stringify(request.body)
109
+ });
110
+ }
111
+ /**
112
+ * Ensures that the subscription exists with the provided configuration
113
+ * @param subscriptionId
114
+ * @param putSubscriptionRequest
115
+ */
116
+ async putSubscription(request, options) {
117
+ const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);
118
+ const uriTemplate = `/bus/v1/subscriptions/{subscriptionId}`;
119
+ const uri = parser__namespace.parse(uriTemplate).expand({
120
+ subscriptionId: request.path.subscriptionId
121
+ });
122
+ return await this.fetchApi.fetch(`${baseUrl}${uri}`, {
123
+ headers: {
124
+ "Content-Type": "application/json",
125
+ ...options?.token && { Authorization: `Bearer ${options?.token}` }
126
+ },
127
+ method: "PUT",
128
+ body: JSON.stringify(request.body)
129
+ });
130
+ }
131
+ }
132
+
133
+ const POLL_BACKOFF_START_MS = 1e3;
134
+ const POLL_BACKOFF_MAX_MS = 6e4;
135
+ const POLL_BACKOFF_FACTOR = 2;
136
+ class LocalEventBus {
137
+ #logger;
138
+ #subscribers = /* @__PURE__ */ new Map();
139
+ constructor(logger) {
140
+ this.#logger = logger;
67
141
  }
68
142
  async publish(params) {
69
- this.logger.debug(
143
+ this.#logger.debug(
70
144
  `Event received: topic=${params.topic}, metadata=${JSON.stringify(
71
145
  params.metadata
72
146
  )}, payload=${JSON.stringify(params.eventPayload)}`
73
147
  );
74
- if (!this.subscribers.has(params.topic)) {
75
- return;
148
+ if (!this.#subscribers.has(params.topic)) {
149
+ return { notifiedSubscribers: [] };
76
150
  }
77
151
  const onEventPromises = [];
78
- this.subscribers.get(params.topic)?.forEach((subscription) => {
152
+ this.#subscribers.get(params.topic)?.forEach((subscription) => {
79
153
  onEventPromises.push(
80
154
  (async () => {
81
155
  try {
82
156
  await subscription.onEvent(params);
83
157
  } catch (error) {
84
- this.logger.warn(
158
+ this.#logger.warn(
85
159
  `Subscriber "${subscription.id}" failed to process event for topic "${params.topic}"`,
86
160
  error
87
161
  );
88
162
  }
163
+ return subscription.id;
89
164
  })()
90
165
  );
91
166
  });
92
- await Promise.all(onEventPromises);
167
+ return { notifiedSubscribers: await Promise.all(onEventPromises) };
93
168
  }
94
169
  async subscribe(options) {
95
170
  options.topics.forEach((topic) => {
96
- if (!this.subscribers.has(topic)) {
97
- this.subscribers.set(topic, []);
171
+ if (!this.#subscribers.has(topic)) {
172
+ this.#subscribers.set(topic, []);
98
173
  }
99
- this.subscribers.get(topic).push({
174
+ this.#subscribers.get(topic).push({
100
175
  id: options.id,
101
176
  onEvent: options.onEvent
102
177
  });
103
178
  });
104
179
  }
105
180
  }
181
+ class PluginEventsService {
182
+ constructor(pluginId, localBus, logger, client, auth) {
183
+ this.pluginId = pluginId;
184
+ this.localBus = localBus;
185
+ this.logger = logger;
186
+ this.client = client;
187
+ this.auth = auth;
188
+ }
189
+ async publish(params) {
190
+ const lock = this.#getShutdownLock();
191
+ try {
192
+ const { notifiedSubscribers } = await this.localBus.publish(params);
193
+ if (!this.client) {
194
+ return;
195
+ }
196
+ const token = await this.#getToken();
197
+ if (!token) {
198
+ return;
199
+ }
200
+ const res = await this.client.postEvent(
201
+ {
202
+ body: {
203
+ event: { payload: params.eventPayload, topic: params.topic },
204
+ notifiedSubscribers
205
+ }
206
+ },
207
+ { token }
208
+ );
209
+ if (!res.ok) {
210
+ if (res.status === 404) {
211
+ this.logger.warn(
212
+ `Event publish request failed with status 404, events backend not found. Future events will not be persisted.`
213
+ );
214
+ delete this.client;
215
+ return;
216
+ }
217
+ throw await errors.ResponseError.fromResponse(res);
218
+ }
219
+ } finally {
220
+ lock.release();
221
+ }
222
+ }
223
+ async subscribe(options) {
224
+ const subscriptionId = `${this.pluginId}.${options.id}`;
225
+ await this.localBus.subscribe({
226
+ id: subscriptionId,
227
+ topics: options.topics,
228
+ onEvent: options.onEvent
229
+ });
230
+ if (!this.client) {
231
+ return;
232
+ }
233
+ const token = await this.#getToken();
234
+ if (!token) {
235
+ return;
236
+ }
237
+ const res = await this.client.putSubscription(
238
+ {
239
+ path: { subscriptionId },
240
+ body: { topics: options.topics }
241
+ },
242
+ { token }
243
+ );
244
+ if (!res.ok) {
245
+ if (res.status === 404) {
246
+ this.logger.warn(
247
+ `Event subscribe request failed with status 404, events backend not found. Will only receive events that were sent locally on this process.`
248
+ );
249
+ delete this.client;
250
+ return;
251
+ }
252
+ throw await errors.ResponseError.fromResponse(res);
253
+ }
254
+ this.#startPolling(subscriptionId, options.topics, options.onEvent);
255
+ }
256
+ #startPolling(subscriptionId, topics, onEvent) {
257
+ let backoffMs = POLL_BACKOFF_START_MS;
258
+ const poll = async () => {
259
+ if (!this.client) {
260
+ return;
261
+ }
262
+ const lock = this.#getShutdownLock();
263
+ try {
264
+ const token = await this.#getToken();
265
+ if (!token) {
266
+ return;
267
+ }
268
+ const res = await this.client.getSubscriptionEvents(
269
+ {
270
+ path: { subscriptionId }
271
+ },
272
+ { token }
273
+ );
274
+ if (!res.ok) {
275
+ if (res.status === 404) {
276
+ this.logger.info(
277
+ `Polling event subscription resulted in a 404, recreating subscription`
278
+ );
279
+ const putRes = await this.client.putSubscription(
280
+ {
281
+ path: { subscriptionId },
282
+ body: { topics }
283
+ },
284
+ { token }
285
+ );
286
+ if (!putRes.ok) {
287
+ throw await errors.ResponseError.fromResponse(res);
288
+ }
289
+ }
290
+ throw await errors.ResponseError.fromResponse(res);
291
+ }
292
+ backoffMs = POLL_BACKOFF_START_MS;
293
+ if (res.status === 202) {
294
+ lock.release();
295
+ await res.body?.getReader()?.closed;
296
+ process.nextTick(poll);
297
+ } else if (res.status === 200) {
298
+ const data = await res.json();
299
+ if (data) {
300
+ for (const event of data.events ?? []) {
301
+ try {
302
+ await onEvent({
303
+ topic: event.topic,
304
+ eventPayload: event.payload
305
+ });
306
+ } catch (error) {
307
+ this.logger.warn(
308
+ `Subscriber "${subscriptionId}" failed to process event for topic "${event.topic}"`,
309
+ error
310
+ );
311
+ }
312
+ }
313
+ }
314
+ process.nextTick(poll);
315
+ } else {
316
+ this.logger.warn(
317
+ `Unexpected response status ${res.status} from events backend for subscription "${subscriptionId}"`
318
+ );
319
+ }
320
+ } catch (error) {
321
+ this.logger.warn(
322
+ `Poll failed for subscription "${subscriptionId}", retrying in ${backoffMs.toFixed(
323
+ 0
324
+ )}ms`,
325
+ error
326
+ );
327
+ setTimeout(poll, backoffMs);
328
+ backoffMs = Math.min(
329
+ backoffMs * POLL_BACKOFF_FACTOR,
330
+ POLL_BACKOFF_MAX_MS
331
+ );
332
+ } finally {
333
+ lock.release();
334
+ }
335
+ };
336
+ poll();
337
+ }
338
+ async #getToken() {
339
+ if (!this.auth) {
340
+ throw new Error("Auth service not available");
341
+ }
342
+ try {
343
+ const { token } = await this.auth.getPluginRequestToken({
344
+ onBehalfOf: await this.auth.getOwnServiceCredentials(),
345
+ targetPluginId: "events"
346
+ });
347
+ return token;
348
+ } catch (error) {
349
+ if (String(error).includes("Unable to generate legacy token")) {
350
+ this.logger.warn(
351
+ `The events backend is not available and neither is legacy auth. Future events will not be persisted.`
352
+ );
353
+ delete this.client;
354
+ return void 0;
355
+ }
356
+ throw error;
357
+ }
358
+ }
359
+ async shutdown() {
360
+ this.#isShuttingDown = true;
361
+ await Promise.all(this.#shutdownLocks);
362
+ }
363
+ #isShuttingDown = false;
364
+ #shutdownLocks = [];
365
+ // This locking mechanism helps ensure that we are either idle or waiting for
366
+ // a blocked events call before shutting down. It increases out changes of
367
+ // never dropping any events on shutdown.
368
+ #getShutdownLock() {
369
+ if (this.#isShuttingDown) {
370
+ throw new Error("Service is shutting down");
371
+ }
372
+ let release;
373
+ this.#shutdownLocks.push(
374
+ new Promise((resolve) => {
375
+ release = resolve;
376
+ })
377
+ );
378
+ return { release };
379
+ }
380
+ }
381
+ class DefaultEventsService {
382
+ constructor(logger, localBus) {
383
+ this.logger = logger;
384
+ this.localBus = localBus;
385
+ }
386
+ static create(options) {
387
+ return new DefaultEventsService(
388
+ options.logger,
389
+ new LocalEventBus(options.logger)
390
+ );
391
+ }
392
+ /**
393
+ * Returns a plugin-scoped context of the `EventService`
394
+ * that ensures to prefix subscriber IDs with the plugin ID.
395
+ *
396
+ * @param pluginId - The plugin that the `EventService` should be created for.
397
+ */
398
+ forPlugin(pluginId, options) {
399
+ const client = options && new DefaultApiClient({
400
+ discoveryApi: options.discovery,
401
+ fetchApi: { fetch }
402
+ // use native node fetch
403
+ });
404
+ const logger = options?.logger ?? this.logger;
405
+ const service = new PluginEventsService(
406
+ pluginId,
407
+ this.localBus,
408
+ logger,
409
+ client,
410
+ options?.auth
411
+ );
412
+ options?.lifecycle.addShutdownHook(async () => {
413
+ await service.shutdown();
414
+ });
415
+ return service;
416
+ }
417
+ async publish(params) {
418
+ await this.localBus.publish(params);
419
+ }
420
+ async subscribe(options) {
421
+ this.localBus.subscribe(options);
422
+ }
423
+ }
106
424
 
107
425
  class SubTopicEventRouter extends EventRouter {
108
426
  constructor(options) {
@@ -125,13 +443,22 @@ const eventsServiceFactory = backendPluginApi.createServiceFactory({
125
443
  service: eventsServiceRef,
126
444
  deps: {
127
445
  pluginMetadata: backendPluginApi.coreServices.pluginMetadata,
128
- rootLogger: backendPluginApi.coreServices.rootLogger
446
+ rootLogger: backendPluginApi.coreServices.rootLogger,
447
+ discovery: backendPluginApi.coreServices.discovery,
448
+ logger: backendPluginApi.coreServices.logger,
449
+ lifecycle: backendPluginApi.coreServices.lifecycle,
450
+ auth: backendPluginApi.coreServices.auth
129
451
  },
130
452
  async createRootContext({ rootLogger }) {
131
453
  return DefaultEventsService.create({ logger: rootLogger });
132
454
  },
133
- async factory({ pluginMetadata }, eventsService) {
134
- return eventsService.forPlugin(pluginMetadata.getId());
455
+ async factory({ pluginMetadata, discovery, logger, lifecycle, auth }, eventsService) {
456
+ return eventsService.forPlugin(pluginMetadata.getId(), {
457
+ discovery,
458
+ logger,
459
+ lifecycle,
460
+ auth
461
+ });
135
462
  }
136
463
  });
137
464
 
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs.js","sources":["../src/api/EventRouter.ts","../src/api/DefaultEventsService.ts","../src/api/SubTopicEventRouter.ts","../src/service.ts"],"sourcesContent":["/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { EventParams } from './EventParams';\nimport { EventsService } from './EventsService';\n\n/**\n * Subscribes to a topic and - depending on a set of conditions -\n * republishes the event to another topic.\n *\n * @see {@link https://www.enterpriseintegrationpatterns.com/MessageRouter.html | Message Router pattern}.\n * @public\n */\nexport abstract class EventRouter {\n private readonly events: EventsService;\n private readonly topics: string[];\n private subscribed: boolean = false;\n\n protected constructor(options: { events: EventsService; topics: string[] }) {\n this.events = options.events;\n this.topics = options.topics;\n }\n\n protected abstract getSubscriberId(): string;\n\n protected abstract determineDestinationTopic(\n params: EventParams,\n ): string | undefined;\n\n /**\n * Subscribes itself to the topic(s),\n * after which events potentially can be received\n * and processed by {@link EventRouter.onEvent}.\n */\n async subscribe(): Promise<void> {\n if (this.subscribed) {\n return;\n }\n\n this.subscribed = true;\n\n await this.events.subscribe({\n id: this.getSubscriberId(),\n topics: this.topics,\n onEvent: this.onEvent.bind(this),\n });\n }\n\n async onEvent(params: EventParams): Promise<void> {\n const topic = this.determineDestinationTopic(params);\n\n if (!topic) {\n return;\n }\n\n // republish to different topic\n await this.events.publish({\n ...params,\n topic,\n });\n }\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { LoggerService } from '@backstage/backend-plugin-api';\nimport { EventParams } from './EventParams';\nimport { EventsService, EventsServiceSubscribeOptions } from './EventsService';\n\n/**\n * In-process event broker which will pass the event to all registered subscribers\n * interested in it.\n * Events will not be persisted in any form.\n * Events will not be passed to subscribers at other instances of the same cluster.\n *\n * @public\n */\n// TODO(pjungermann): add opentelemetry? (see plugins/catalog-backend/src/util/opentelemetry.ts, etc.)\nexport class DefaultEventsService implements EventsService {\n private readonly subscribers = new Map<\n string,\n Omit<EventsServiceSubscribeOptions, 'topics'>[]\n >();\n\n private constructor(private readonly logger: LoggerService) {}\n\n static create(options: { logger: LoggerService }): DefaultEventsService {\n return new DefaultEventsService(options.logger);\n }\n\n /**\n * Returns a plugin-scoped context of the `EventService`\n * that ensures to prefix subscriber IDs with the plugin ID.\n *\n * @param pluginId - The plugin that the `EventService` should be created for.\n */\n forPlugin(pluginId: string): EventsService {\n return {\n publish: (params: EventParams): Promise<void> => {\n return this.publish(params);\n },\n subscribe: (options: EventsServiceSubscribeOptions): Promise<void> => {\n return this.subscribe({\n ...options,\n id: `${pluginId}.${options.id}`,\n });\n },\n };\n }\n\n async publish(params: EventParams): Promise<void> {\n this.logger.debug(\n `Event received: topic=${params.topic}, metadata=${JSON.stringify(\n params.metadata,\n )}, payload=${JSON.stringify(params.eventPayload)}`,\n );\n\n if (!this.subscribers.has(params.topic)) {\n return;\n }\n\n const onEventPromises: Promise<void>[] = [];\n this.subscribers.get(params.topic)?.forEach(subscription => {\n onEventPromises.push(\n (async () => {\n try {\n await subscription.onEvent(params);\n } catch (error) {\n this.logger.warn(\n `Subscriber \"${subscription.id}\" failed to process event for topic \"${params.topic}\"`,\n error,\n );\n }\n })(),\n );\n });\n\n await Promise.all(onEventPromises);\n }\n\n async subscribe(options: EventsServiceSubscribeOptions): Promise<void> {\n options.topics.forEach(topic => {\n if (!this.subscribers.has(topic)) {\n this.subscribers.set(topic, []);\n }\n\n this.subscribers.get(topic)!.push({\n id: options.id,\n onEvent: options.onEvent,\n });\n });\n }\n}\n","/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { EventParams } from './EventParams';\nimport { EventRouter } from './EventRouter';\nimport { EventsService } from './EventsService';\n\n/**\n * Subscribes to the provided (generic) topic\n * and publishes the events under the more concrete sub-topic\n * depending on the implemented logic for determining it.\n * Implementing classes might use information from `metadata`\n * and/or properties within the payload.\n *\n * @public\n */\nexport abstract class SubTopicEventRouter extends EventRouter {\n protected constructor(options: { events: EventsService; topic: string }) {\n super({\n events: options.events,\n topics: [options.topic],\n });\n }\n\n protected abstract determineSubTopic(params: EventParams): string | undefined;\n\n protected determineDestinationTopic(params: EventParams): string | undefined {\n const subTopic = this.determineSubTopic(params);\n return subTopic ? `${params.topic}.${subTopic}` : undefined;\n }\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n coreServices,\n createServiceFactory,\n createServiceRef,\n} from '@backstage/backend-plugin-api';\nimport { EventsService, DefaultEventsService } from './api';\n\n/**\n * The {@link EventsService} that allows to publish events, and subscribe to topics.\n * Uses the `root` scope so that events can be shared across all plugins, modules, and more.\n *\n * @public\n */\nexport const eventsServiceRef = createServiceRef<EventsService>({\n id: 'events.service',\n scope: 'plugin',\n});\n\n/** @public */\nexport const eventsServiceFactory = createServiceFactory({\n service: eventsServiceRef,\n deps: {\n pluginMetadata: coreServices.pluginMetadata,\n rootLogger: coreServices.rootLogger,\n },\n async createRootContext({ rootLogger }) {\n return DefaultEventsService.create({ logger: rootLogger });\n },\n async factory({ pluginMetadata }, eventsService) {\n return eventsService.forPlugin(pluginMetadata.getId());\n },\n});\n"],"names":["createServiceRef","createServiceFactory","coreServices"],"mappings":";;;;AA0BO,MAAe,WAAY,CAAA;AAAA,EACf,MAAA,CAAA;AAAA,EACA,MAAA,CAAA;AAAA,EACT,UAAsB,GAAA,KAAA,CAAA;AAAA,EAEpB,YAAY,OAAsD,EAAA;AAC1E,IAAA,IAAA,CAAK,SAAS,OAAQ,CAAA,MAAA,CAAA;AACtB,IAAA,IAAA,CAAK,SAAS,OAAQ,CAAA,MAAA,CAAA;AAAA,GACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,SAA2B,GAAA;AAC/B,IAAA,IAAI,KAAK,UAAY,EAAA;AACnB,MAAA,OAAA;AAAA,KACF;AAEA,IAAA,IAAA,CAAK,UAAa,GAAA,IAAA,CAAA;AAElB,IAAM,MAAA,IAAA,CAAK,OAAO,SAAU,CAAA;AAAA,MAC1B,EAAA,EAAI,KAAK,eAAgB,EAAA;AAAA,MACzB,QAAQ,IAAK,CAAA,MAAA;AAAA,MACb,OAAS,EAAA,IAAA,CAAK,OAAQ,CAAA,IAAA,CAAK,IAAI,CAAA;AAAA,KAChC,CAAA,CAAA;AAAA,GACH;AAAA,EAEA,MAAM,QAAQ,MAAoC,EAAA;AAChD,IAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,yBAAA,CAA0B,MAAM,CAAA,CAAA;AAEnD,IAAA,IAAI,CAAC,KAAO,EAAA;AACV,MAAA,OAAA;AAAA,KACF;AAGA,IAAM,MAAA,IAAA,CAAK,OAAO,OAAQ,CAAA;AAAA,MACxB,GAAG,MAAA;AAAA,MACH,KAAA;AAAA,KACD,CAAA,CAAA;AAAA,GACH;AACF;;AC7CO,MAAM,oBAA8C,CAAA;AAAA,EAMjD,YAA6B,MAAuB,EAAA;AAAvB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA,CAAA;AAAA,GAAwB;AAAA,EAL5C,WAAA,uBAAkB,GAGjC,EAAA,CAAA;AAAA,EAIF,OAAO,OAAO,OAA0D,EAAA;AACtE,IAAO,OAAA,IAAI,oBAAqB,CAAA,OAAA,CAAQ,MAAM,CAAA,CAAA;AAAA,GAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,QAAiC,EAAA;AACzC,IAAO,OAAA;AAAA,MACL,OAAA,EAAS,CAAC,MAAuC,KAAA;AAC/C,QAAO,OAAA,IAAA,CAAK,QAAQ,MAAM,CAAA,CAAA;AAAA,OAC5B;AAAA,MACA,SAAA,EAAW,CAAC,OAA0D,KAAA;AACpE,QAAA,OAAO,KAAK,SAAU,CAAA;AAAA,UACpB,GAAG,OAAA;AAAA,UACH,EAAI,EAAA,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,QAAQ,EAAE,CAAA,CAAA;AAAA,SAC9B,CAAA,CAAA;AAAA,OACH;AAAA,KACF,CAAA;AAAA,GACF;AAAA,EAEA,MAAM,QAAQ,MAAoC,EAAA;AAChD,IAAA,IAAA,CAAK,MAAO,CAAA,KAAA;AAAA,MACV,CAAyB,sBAAA,EAAA,MAAA,CAAO,KAAK,CAAA,WAAA,EAAc,IAAK,CAAA,SAAA;AAAA,QACtD,MAAO,CAAA,QAAA;AAAA,OACR,CAAa,UAAA,EAAA,IAAA,CAAK,SAAU,CAAA,MAAA,CAAO,YAAY,CAAC,CAAA,CAAA;AAAA,KACnD,CAAA;AAEA,IAAA,IAAI,CAAC,IAAK,CAAA,WAAA,CAAY,GAAI,CAAA,MAAA,CAAO,KAAK,CAAG,EAAA;AACvC,MAAA,OAAA;AAAA,KACF;AAEA,IAAA,MAAM,kBAAmC,EAAC,CAAA;AAC1C,IAAA,IAAA,CAAK,YAAY,GAAI,CAAA,MAAA,CAAO,KAAK,CAAA,EAAG,QAAQ,CAAgB,YAAA,KAAA;AAC1D,MAAgB,eAAA,CAAA,IAAA;AAAA,QAAA,CACb,YAAY;AACX,UAAI,IAAA;AACF,YAAM,MAAA,YAAA,CAAa,QAAQ,MAAM,CAAA,CAAA;AAAA,mBAC1B,KAAO,EAAA;AACd,YAAA,IAAA,CAAK,MAAO,CAAA,IAAA;AAAA,cACV,CAAe,YAAA,EAAA,YAAA,CAAa,EAAE,CAAA,qCAAA,EAAwC,OAAO,KAAK,CAAA,CAAA,CAAA;AAAA,cAClF,KAAA;AAAA,aACF,CAAA;AAAA,WACF;AAAA,SACC,GAAA;AAAA,OACL,CAAA;AAAA,KACD,CAAA,CAAA;AAED,IAAM,MAAA,OAAA,CAAQ,IAAI,eAAe,CAAA,CAAA;AAAA,GACnC;AAAA,EAEA,MAAM,UAAU,OAAuD,EAAA;AACrE,IAAQ,OAAA,CAAA,MAAA,CAAO,QAAQ,CAAS,KAAA,KAAA;AAC9B,MAAA,IAAI,CAAC,IAAA,CAAK,WAAY,CAAA,GAAA,CAAI,KAAK,CAAG,EAAA;AAChC,QAAA,IAAA,CAAK,WAAY,CAAA,GAAA,CAAI,KAAO,EAAA,EAAE,CAAA,CAAA;AAAA,OAChC;AAEA,MAAA,IAAA,CAAK,WAAY,CAAA,GAAA,CAAI,KAAK,CAAA,CAAG,IAAK,CAAA;AAAA,QAChC,IAAI,OAAQ,CAAA,EAAA;AAAA,QACZ,SAAS,OAAQ,CAAA,OAAA;AAAA,OAClB,CAAA,CAAA;AAAA,KACF,CAAA,CAAA;AAAA,GACH;AACF;;AC1EO,MAAe,4BAA4B,WAAY,CAAA;AAAA,EAClD,YAAY,OAAmD,EAAA;AACvE,IAAM,KAAA,CAAA;AAAA,MACJ,QAAQ,OAAQ,CAAA,MAAA;AAAA,MAChB,MAAA,EAAQ,CAAC,OAAA,CAAQ,KAAK,CAAA;AAAA,KACvB,CAAA,CAAA;AAAA,GACH;AAAA,EAIU,0BAA0B,MAAyC,EAAA;AAC3E,IAAM,MAAA,QAAA,GAAW,IAAK,CAAA,iBAAA,CAAkB,MAAM,CAAA,CAAA;AAC9C,IAAA,OAAO,WAAW,CAAG,EAAA,MAAA,CAAO,KAAK,CAAA,CAAA,EAAI,QAAQ,CAAK,CAAA,GAAA,KAAA,CAAA,CAAA;AAAA,GACpD;AACF;;ACdO,MAAM,mBAAmBA,iCAAgC,CAAA;AAAA,EAC9D,EAAI,EAAA,gBAAA;AAAA,EACJ,KAAO,EAAA,QAAA;AACT,CAAC,EAAA;AAGM,MAAM,uBAAuBC,qCAAqB,CAAA;AAAA,EACvD,OAAS,EAAA,gBAAA;AAAA,EACT,IAAM,EAAA;AAAA,IACJ,gBAAgBC,6BAAa,CAAA,cAAA;AAAA,IAC7B,YAAYA,6BAAa,CAAA,UAAA;AAAA,GAC3B;AAAA,EACA,MAAM,iBAAA,CAAkB,EAAE,UAAA,EAAc,EAAA;AACtC,IAAA,OAAO,oBAAqB,CAAA,MAAA,CAAO,EAAE,MAAA,EAAQ,YAAY,CAAA,CAAA;AAAA,GAC3D;AAAA,EACA,MAAM,OAAA,CAAQ,EAAE,cAAA,IAAkB,aAAe,EAAA;AAC/C,IAAA,OAAO,aAAc,CAAA,SAAA,CAAU,cAAe,CAAA,KAAA,EAAO,CAAA,CAAA;AAAA,GACvD;AACF,CAAC;;;;;;;;"}
1
+ {"version":3,"file":"index.cjs.js","sources":["../src/api/EventRouter.ts","../src/generated/pluginId.ts","../src/generated/apis/DefaultApi.client.ts","../src/api/DefaultEventsService.ts","../src/api/SubTopicEventRouter.ts","../src/service.ts"],"sourcesContent":["/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { EventParams } from './EventParams';\nimport { EventsService } from './EventsService';\n\n/**\n * Subscribes to a topic and - depending on a set of conditions -\n * republishes the event to another topic.\n *\n * @see {@link https://www.enterpriseintegrationpatterns.com/MessageRouter.html | Message Router pattern}.\n * @public\n */\nexport abstract class EventRouter {\n private readonly events: EventsService;\n private readonly topics: string[];\n private subscribed: boolean = false;\n\n protected constructor(options: { events: EventsService; topics: string[] }) {\n this.events = options.events;\n this.topics = options.topics;\n }\n\n protected abstract getSubscriberId(): string;\n\n protected abstract determineDestinationTopic(\n params: EventParams,\n ): string | undefined;\n\n /**\n * Subscribes itself to the topic(s),\n * after which events potentially can be received\n * and processed by {@link EventRouter.onEvent}.\n */\n async subscribe(): Promise<void> {\n if (this.subscribed) {\n return;\n }\n\n this.subscribed = true;\n\n await this.events.subscribe({\n id: this.getSubscriberId(),\n topics: this.topics,\n onEvent: this.onEvent.bind(this),\n });\n }\n\n async onEvent(params: EventParams): Promise<void> {\n const topic = this.determineDestinationTopic(params);\n\n if (!topic) {\n return;\n }\n\n // republish to different topic\n await this.events.publish({\n ...params,\n topic,\n });\n }\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport const pluginId = 'events';\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// ******************************************************************\n// * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY. *\n// ******************************************************************\nimport { DiscoveryApi } from '../types/discovery';\nimport { FetchApi } from '../types/fetch';\nimport crossFetch from 'cross-fetch';\nimport { pluginId } from '../pluginId';\nimport * as parser from 'uri-template';\n\nimport { GetSubscriptionEvents200Response } from '../models/GetSubscriptionEvents200Response.model';\nimport { PostEventRequest } from '../models/PostEventRequest.model';\nimport { PutSubscriptionRequest } from '../models/PutSubscriptionRequest.model';\n\n/**\n * Wraps the Response type to convey a type on the json call.\n *\n * @public\n */\nexport type TypedResponse<T> = Omit<Response, 'json'> & {\n json: () => Promise<T>;\n};\n\n/**\n * Options you can pass into a request for additional information.\n *\n * @public\n */\nexport interface RequestOptions {\n token?: string;\n}\n\n/**\n * no description\n */\nexport class DefaultApiClient {\n private readonly discoveryApi: DiscoveryApi;\n private readonly fetchApi: FetchApi;\n\n constructor(options: {\n discoveryApi: { getBaseUrl(pluginId: string): Promise<string> };\n fetchApi?: { fetch: typeof fetch };\n }) {\n this.discoveryApi = options.discoveryApi;\n this.fetchApi = options.fetchApi || { fetch: crossFetch };\n }\n\n /**\n * Get new events for the provided subscription\n * @param subscriptionId\n */\n public async getSubscriptionEvents(\n // @ts-ignore\n request: {\n path: {\n subscriptionId: string;\n };\n },\n options?: RequestOptions,\n ): Promise<TypedResponse<void | GetSubscriptionEvents200Response>> {\n const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);\n\n const uriTemplate = `/bus/v1/subscriptions/{subscriptionId}/events`;\n\n const uri = parser.parse(uriTemplate).expand({\n subscriptionId: request.path.subscriptionId,\n });\n\n return await this.fetchApi.fetch(`${baseUrl}${uri}`, {\n headers: {\n 'Content-Type': 'application/json',\n ...(options?.token && { Authorization: `Bearer ${options?.token}` }),\n },\n method: 'GET',\n });\n }\n\n /**\n * Publish a new event\n * @param postEventRequest\n */\n public async postEvent(\n // @ts-ignore\n request: {\n body: PostEventRequest;\n },\n options?: RequestOptions,\n ): Promise<TypedResponse<void>> {\n const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);\n\n const uriTemplate = `/bus/v1/events`;\n\n const uri = parser.parse(uriTemplate).expand({});\n\n return await this.fetchApi.fetch(`${baseUrl}${uri}`, {\n headers: {\n 'Content-Type': 'application/json',\n ...(options?.token && { Authorization: `Bearer ${options?.token}` }),\n },\n method: 'POST',\n body: JSON.stringify(request.body),\n });\n }\n\n /**\n * Ensures that the subscription exists with the provided configuration\n * @param subscriptionId\n * @param putSubscriptionRequest\n */\n public async putSubscription(\n // @ts-ignore\n request: {\n path: {\n subscriptionId: string;\n };\n body: PutSubscriptionRequest;\n },\n options?: RequestOptions,\n ): Promise<TypedResponse<void>> {\n const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);\n\n const uriTemplate = `/bus/v1/subscriptions/{subscriptionId}`;\n\n const uri = parser.parse(uriTemplate).expand({\n subscriptionId: request.path.subscriptionId,\n });\n\n return await this.fetchApi.fetch(`${baseUrl}${uri}`, {\n headers: {\n 'Content-Type': 'application/json',\n ...(options?.token && { Authorization: `Bearer ${options?.token}` }),\n },\n method: 'PUT',\n body: JSON.stringify(request.body),\n });\n }\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n AuthService,\n DiscoveryService,\n LifecycleService,\n LoggerService,\n} from '@backstage/backend-plugin-api';\nimport { EventParams } from './EventParams';\nimport { EventsService, EventsServiceSubscribeOptions } from './EventsService';\nimport { DefaultApiClient } from '../generated';\nimport { ResponseError } from '@backstage/errors';\n\nconst POLL_BACKOFF_START_MS = 1_000;\nconst POLL_BACKOFF_MAX_MS = 60_000;\nconst POLL_BACKOFF_FACTOR = 2;\n\n/**\n * Local event bus for subscribers within the same process.\n *\n * When publishing events we'll keep track of which subscribers we managed to\n * reach locally, and forward those subscriber IDs to the events backend if it\n * is in use. The events backend will then both avoid forwarding the same events\n * to those subscribers again, but also avoid storing the event altogether if\n * there are no other subscribers.\n * @internal\n */\nexport class LocalEventBus {\n readonly #logger: LoggerService;\n\n readonly #subscribers = new Map<\n string,\n Omit<EventsServiceSubscribeOptions, 'topics'>[]\n >();\n\n constructor(logger: LoggerService) {\n this.#logger = logger;\n }\n\n async publish(\n params: EventParams,\n ): Promise<{ notifiedSubscribers: string[] }> {\n this.#logger.debug(\n `Event received: topic=${params.topic}, metadata=${JSON.stringify(\n params.metadata,\n )}, payload=${JSON.stringify(params.eventPayload)}`,\n );\n\n if (!this.#subscribers.has(params.topic)) {\n return { notifiedSubscribers: [] };\n }\n\n const onEventPromises: Promise<string>[] = [];\n this.#subscribers.get(params.topic)?.forEach(subscription => {\n onEventPromises.push(\n (async () => {\n try {\n await subscription.onEvent(params);\n } catch (error) {\n this.#logger.warn(\n `Subscriber \"${subscription.id}\" failed to process event for topic \"${params.topic}\"`,\n error,\n );\n }\n return subscription.id;\n })(),\n );\n });\n\n return { notifiedSubscribers: await Promise.all(onEventPromises) };\n }\n\n async subscribe(options: EventsServiceSubscribeOptions): Promise<void> {\n options.topics.forEach(topic => {\n if (!this.#subscribers.has(topic)) {\n this.#subscribers.set(topic, []);\n }\n\n this.#subscribers.get(topic)!.push({\n id: options.id,\n onEvent: options.onEvent,\n });\n });\n }\n}\n\n/**\n * Plugin specific events bus that delegates to the local bus, as well as the\n * events backend if it is available.\n */\nclass PluginEventsService implements EventsService {\n constructor(\n private readonly pluginId: string,\n private readonly localBus: LocalEventBus,\n private readonly logger: LoggerService,\n private client?: DefaultApiClient,\n private readonly auth?: AuthService,\n ) {}\n\n async publish(params: EventParams): Promise<void> {\n const lock = this.#getShutdownLock();\n try {\n const { notifiedSubscribers } = await this.localBus.publish(params);\n\n if (!this.client) {\n return;\n }\n const token = await this.#getToken();\n if (!token) {\n return;\n }\n const res = await this.client.postEvent(\n {\n body: {\n event: { payload: params.eventPayload, topic: params.topic },\n notifiedSubscribers,\n },\n },\n { token },\n );\n\n if (!res.ok) {\n if (res.status === 404) {\n this.logger.warn(\n `Event publish request failed with status 404, events backend not found. Future events will not be persisted.`,\n );\n delete this.client;\n return;\n }\n throw await ResponseError.fromResponse(res);\n }\n } finally {\n lock.release();\n }\n }\n\n async subscribe(options: EventsServiceSubscribeOptions): Promise<void> {\n const subscriptionId = `${this.pluginId}.${options.id}`;\n\n await this.localBus.subscribe({\n id: subscriptionId,\n topics: options.topics,\n onEvent: options.onEvent,\n });\n\n if (!this.client) {\n return;\n }\n const token = await this.#getToken();\n if (!token) {\n return;\n }\n const res = await this.client.putSubscription(\n {\n path: { subscriptionId },\n body: { topics: options.topics },\n },\n { token },\n );\n if (!res.ok) {\n if (res.status === 404) {\n this.logger.warn(\n `Event subscribe request failed with status 404, events backend not found. Will only receive events that were sent locally on this process.`,\n );\n delete this.client;\n return;\n }\n throw await ResponseError.fromResponse(res);\n }\n\n this.#startPolling(subscriptionId, options.topics, options.onEvent);\n }\n\n #startPolling(\n subscriptionId: string,\n topics: string[],\n onEvent: EventsServiceSubscribeOptions['onEvent'],\n ) {\n let backoffMs = POLL_BACKOFF_START_MS;\n const poll = async () => {\n if (!this.client) {\n return;\n }\n const lock = this.#getShutdownLock();\n try {\n const token = await this.#getToken();\n if (!token) {\n return;\n }\n const res = await this.client.getSubscriptionEvents(\n {\n path: { subscriptionId },\n },\n { token },\n );\n\n if (!res.ok) {\n if (res.status === 404) {\n this.logger.info(\n `Polling event subscription resulted in a 404, recreating subscription`,\n );\n const putRes = await this.client.putSubscription(\n {\n path: { subscriptionId },\n body: { topics },\n },\n { token },\n );\n if (!putRes.ok) {\n throw await ResponseError.fromResponse(res);\n }\n }\n throw await ResponseError.fromResponse(res);\n }\n backoffMs = POLL_BACKOFF_START_MS;\n\n // 202 means there were no immediately available events, but the\n // response will block until either new events are available or the\n // request times out. In both cases we should should try to read events\n // immediately again\n if (res.status === 202) {\n lock.release();\n await res.body?.getReader()?.closed;\n process.nextTick(poll);\n } else if (res.status === 200) {\n const data = await res.json();\n if (data) {\n for (const event of data.events ?? []) {\n try {\n await onEvent({\n topic: event.topic,\n eventPayload: event.payload,\n });\n } catch (error) {\n this.logger.warn(\n `Subscriber \"${subscriptionId}\" failed to process event for topic \"${event.topic}\"`,\n error,\n );\n }\n }\n }\n process.nextTick(poll);\n } else {\n this.logger.warn(\n `Unexpected response status ${res.status} from events backend for subscription \"${subscriptionId}\"`,\n );\n }\n } catch (error) {\n this.logger.warn(\n `Poll failed for subscription \"${subscriptionId}\", retrying in ${backoffMs.toFixed(\n 0,\n )}ms`,\n error,\n );\n setTimeout(poll, backoffMs);\n backoffMs = Math.min(\n backoffMs * POLL_BACKOFF_FACTOR,\n POLL_BACKOFF_MAX_MS,\n );\n } finally {\n lock.release();\n }\n };\n poll();\n }\n\n async #getToken() {\n if (!this.auth) {\n throw new Error('Auth service not available');\n }\n\n try {\n const { token } = await this.auth.getPluginRequestToken({\n onBehalfOf: await this.auth.getOwnServiceCredentials(),\n targetPluginId: 'events',\n });\n return token;\n } catch (error) {\n // This is a bit hacky, but handles the case where new auth is used\n // without legacy auth fallback, and the events backend is not installed\n if (String(error).includes('Unable to generate legacy token')) {\n this.logger.warn(\n `The events backend is not available and neither is legacy auth. Future events will not be persisted.`,\n );\n delete this.client;\n return undefined;\n }\n throw error;\n }\n }\n\n async shutdown() {\n this.#isShuttingDown = true;\n await Promise.all(this.#shutdownLocks);\n }\n\n #isShuttingDown = false;\n #shutdownLocks: Promise<void>[] = [];\n\n // This locking mechanism helps ensure that we are either idle or waiting for\n // a blocked events call before shutting down. It increases out changes of\n // never dropping any events on shutdown.\n #getShutdownLock(): { release(): void } {\n if (this.#isShuttingDown) {\n throw new Error('Service is shutting down');\n }\n\n let release: () => void;\n this.#shutdownLocks.push(\n new Promise<void>(resolve => {\n release = resolve;\n }),\n );\n return { release: release! };\n }\n}\n\n/**\n * In-process event broker which will pass the event to all registered subscribers\n * interested in it.\n * Events will not be persisted in any form.\n * Events will not be passed to subscribers at other instances of the same cluster.\n *\n * @public\n */\n// TODO(pjungermann): add opentelemetry? (see plugins/catalog-backend/src/util/opentelemetry.ts, etc.)\nexport class DefaultEventsService implements EventsService {\n private constructor(\n private readonly logger: LoggerService,\n private readonly localBus: LocalEventBus,\n ) {}\n\n static create(options: { logger: LoggerService }): DefaultEventsService {\n return new DefaultEventsService(\n options.logger,\n new LocalEventBus(options.logger),\n );\n }\n\n /**\n * Returns a plugin-scoped context of the `EventService`\n * that ensures to prefix subscriber IDs with the plugin ID.\n *\n * @param pluginId - The plugin that the `EventService` should be created for.\n */\n forPlugin(\n pluginId: string,\n options?: {\n discovery: DiscoveryService;\n logger: LoggerService;\n auth: AuthService;\n lifecycle: LifecycleService;\n },\n ): EventsService {\n const client =\n options &&\n new DefaultApiClient({\n discoveryApi: options.discovery,\n fetchApi: { fetch }, // use native node fetch\n });\n const logger = options?.logger ?? this.logger;\n const service = new PluginEventsService(\n pluginId,\n this.localBus,\n logger,\n client,\n options?.auth,\n );\n options?.lifecycle.addShutdownHook(async () => {\n await service.shutdown();\n });\n return service;\n }\n\n async publish(params: EventParams): Promise<void> {\n await this.localBus.publish(params);\n }\n\n async subscribe(options: EventsServiceSubscribeOptions): Promise<void> {\n this.localBus.subscribe(options);\n }\n}\n","/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { EventParams } from './EventParams';\nimport { EventRouter } from './EventRouter';\nimport { EventsService } from './EventsService';\n\n/**\n * Subscribes to the provided (generic) topic\n * and publishes the events under the more concrete sub-topic\n * depending on the implemented logic for determining it.\n * Implementing classes might use information from `metadata`\n * and/or properties within the payload.\n *\n * @public\n */\nexport abstract class SubTopicEventRouter extends EventRouter {\n protected constructor(options: { events: EventsService; topic: string }) {\n super({\n events: options.events,\n topics: [options.topic],\n });\n }\n\n protected abstract determineSubTopic(params: EventParams): string | undefined;\n\n protected determineDestinationTopic(params: EventParams): string | undefined {\n const subTopic = this.determineSubTopic(params);\n return subTopic ? `${params.topic}.${subTopic}` : undefined;\n }\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n coreServices,\n createServiceFactory,\n createServiceRef,\n} from '@backstage/backend-plugin-api';\nimport { EventsService, DefaultEventsService } from './api';\n\n/**\n * The {@link EventsService} that allows to publish events, and subscribe to topics.\n * Uses the `root` scope so that events can be shared across all plugins, modules, and more.\n *\n * @public\n */\nexport const eventsServiceRef = createServiceRef<EventsService>({\n id: 'events.service',\n scope: 'plugin',\n});\n\n/** @public */\nexport const eventsServiceFactory = createServiceFactory({\n service: eventsServiceRef,\n deps: {\n pluginMetadata: coreServices.pluginMetadata,\n rootLogger: coreServices.rootLogger,\n discovery: coreServices.discovery,\n logger: coreServices.logger,\n lifecycle: coreServices.lifecycle,\n auth: coreServices.auth,\n },\n async createRootContext({ rootLogger }) {\n return DefaultEventsService.create({ logger: rootLogger });\n },\n async factory(\n { pluginMetadata, discovery, logger, lifecycle, auth },\n eventsService,\n ) {\n return eventsService.forPlugin(pluginMetadata.getId(), {\n discovery,\n logger,\n lifecycle,\n auth,\n });\n },\n});\n"],"names":["crossFetch","parser","ResponseError","createServiceRef","createServiceFactory","coreServices"],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
2
- import { LoggerService } from '@backstage/backend-plugin-api';
2
+ import { LoggerService, DiscoveryService, AuthService, LifecycleService } from '@backstage/backend-plugin-api';
3
3
 
4
4
  /**
5
5
  * @public
@@ -92,7 +92,7 @@ declare abstract class EventRouter {
92
92
  */
93
93
  declare class DefaultEventsService implements EventsService {
94
94
  private readonly logger;
95
- private readonly subscribers;
95
+ private readonly localBus;
96
96
  private constructor();
97
97
  static create(options: {
98
98
  logger: LoggerService;
@@ -103,7 +103,12 @@ declare class DefaultEventsService implements EventsService {
103
103
  *
104
104
  * @param pluginId - The plugin that the `EventService` should be created for.
105
105
  */
106
- forPlugin(pluginId: string): EventsService;
106
+ forPlugin(pluginId: string, options?: {
107
+ discovery: DiscoveryService;
108
+ logger: LoggerService;
109
+ auth: AuthService;
110
+ lifecycle: LifecycleService;
111
+ }): EventsService;
107
112
  publish(params: EventParams): Promise<void>;
108
113
  subscribe(options: EventsServiceSubscribeOptions): Promise<void>;
109
114
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@backstage/plugin-events-node",
3
- "version": "0.4.0-next.2",
3
+ "version": "0.4.1-next.0",
4
4
  "description": "The plugin-events-node module for @backstage/plugin-events-backend",
5
5
  "backstage": {
6
6
  "role": "node-library",
@@ -50,11 +50,15 @@
50
50
  "test": "backstage-cli package test"
51
51
  },
52
52
  "dependencies": {
53
- "@backstage/backend-plugin-api": "^1.0.0-next.2"
53
+ "@backstage/backend-plugin-api": "^1.0.1-next.0",
54
+ "@backstage/errors": "^1.2.4",
55
+ "@backstage/types": "^1.1.1",
56
+ "cross-fetch": "^4.0.0",
57
+ "uri-template": "^2.0.0"
54
58
  },
55
59
  "devDependencies": {
56
- "@backstage/backend-common": "^0.25.0-next.2",
57
- "@backstage/backend-test-utils": "^1.0.0-next.2",
58
- "@backstage/cli": "^0.27.1-next.2"
60
+ "@backstage/backend-common": "^0.25.0",
61
+ "@backstage/backend-test-utils": "^1.0.1-next.0",
62
+ "@backstage/cli": "^0.28.0-next.0"
59
63
  }
60
64
  }