@backstage/plugin-events-backend-module-google-pubsub 0.1.1-next.1 → 0.1.2-next.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @backstage/plugin-events-backend-module-google-pubsub
 
+## 0.1.2-next.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/config@1.3.3-next.0
+  - @backstage/backend-plugin-api@1.4.1-next.0
+  - @backstage/plugin-events-node@0.4.13-next.0
+
+## 0.1.1
+
+### Patch Changes
+
+- f983e99: Add an `EventConsumingGooglePubSubPublisher`, for pushing Backstage events to pubsub
+- Updated dependencies
+  - @backstage/backend-plugin-api@1.4.0
+  - @backstage/config@1.3.2
+  - @backstage/errors@1.2.7
+  - @backstage/types@1.2.1
+  - @backstage/plugin-events-node@0.4.12
+
 ## 0.1.1-next.1
 
 ### Patch Changes

package/README.md

@@ -19,11 +19,24 @@ events:
             # The fully qualified name of the subscription
             subscriptionName: 'projects/my-google-project/subscriptions/github-enterprise-events'
             # The event system topic to transfer to. This can also be just a plain string
-            targetTopic:
-              # This example picks the topic name from a message attribute + a prefix
-              fromMessageAttribute:
-                attributeName: 'x-github-event'
-                withPrefix: 'github.'
+            targetTopic: 'github.{{ event.attributes.x-github-event }}'
+```
+
+The following configuration enables the transfer of events from a Backstage events topic into a Google
+Pub/Sub topic.
+
+```yaml
+events:
+  modules:
+    googlePubSub:
+      eventConsumingGooglePubSubPublisher:
+        subscriptions:
+          # A unique key for your subscription, to be used in logging and metrics
+          mySubscription:
+            # The source topic (or array of topics)
+            sourceTopic: 'github'
+            # The fully qualified name of the target topic
+            targetTopicName: 'projects/my-google-project/topics/github-enterprise-events'
 ```
 
 ## Installation

package/config.d.ts

@@ -90,6 +90,68 @@ export interface Config {
             };
           };
         };
+
+        /**
+         * Configuration for `EventConsumingGooglePubSubPublisher`, which
+         * consumes messages from the Backstage events system and forwards them
+         * into Google Pub/Sub topics.
+         */
+        eventConsumingGooglePubSubPublisher?: {
+          subscriptions: {
+            [name: string]: {
+              /**
+               * The name of the events backend topic(s) that messages are
+               * consumed from.
+               */
+              sourceTopic: string | string[];
+
+              /**
+               * The complete name of the Google Pub/Sub subscription to forward
+               * events to, on the form
+               * `projects/PROJECT_ID/topics/TOPIC_ID`.
+               *
+               * The value can contain placeholders on the form `{{
+               * message.attributes.foo }}`, to mirror attribute `foo` as the
+               * whole or part of the topic name.
+               *
+               * @example
+               *
+               * This example expects the events topic to contain GitHub
+               * webhook events where the HTTP headers were mapped into
+               * event metadata fields. The outcome should be that messages
+               * end up on event topics such as `github.push`,
+               * `github.repository` etc which matches the [`@backstage/plugin-events-backend-module-github`](https://github.com/backstage/backstage/tree/master/plugins/events-backend-module-github) structure.
+               *
+               * ```yaml
+               * targetTopic: 'projects/my-project/topics/github.{{ event.metadata.x-github-event }}'
+               * ```
+               */
+              targetTopicName: string;
+
+              /**
+               * Event metadata fields are by default copied to the Pub/Sub
+               * message attribute. This setting allows you to override or amend
+               * those attributes.
+               *
+               * @remarks
+               *
+               * The values can contain placeholders on the form `{{ event.metadata.foo }}`,
+               * to mirror metadata field `foo` as the whole or part of a
+               * message attribute value.
+               *
+               * @example
+               *
+               * ```yaml
+               * messageAttributes:
+               *   x-gitHub-event: '{{ event.metadata.event }}'
+               * ```
+               */
+              messageAttributes?: {
+                [key: string]: string;
+              };
+            };
+          };
+        };
       };
     };
   };

package/dist/EventConsumingGooglePubSubPublisher/EventConsumingGooglePubSubPublisher.cjs.js

@@ -0,0 +1,102 @@
+'use strict';
+
+var pubsub = require('@google-cloud/pubsub');
+var api = require('@opentelemetry/api');
+var config = require('./config.cjs.js');
+
+class EventConsumingGooglePubSubPublisher {
+  #logger;
+  #events;
+  #tasks;
+  #pubSubFactory;
+  #metrics;
+  #activeClientsByProjectId;
+  static create(options) {
+    const publisher = new EventConsumingGooglePubSubPublisher({
+      logger: options.logger,
+      events: options.events,
+      tasks: config.readSubscriptionTasksFromConfig(options.config),
+      pubSubFactory: (projectId) => new pubsub.PubSub({ projectId })
+    });
+    options.rootLifecycle.addStartupHook(async () => {
+      await publisher.start();
+    });
+    options.rootLifecycle.addBeforeShutdownHook(async () => {
+      await publisher.stop();
+    });
+    return publisher;
+  }
+  constructor(options) {
+    this.#logger = options.logger;
+    this.#events = options.events;
+    this.#tasks = options.tasks;
+    this.#pubSubFactory = options.pubSubFactory;
+    const meter = api.metrics.getMeter("default");
+    this.#metrics = {
+      messages: meter.createCounter(
+        "events.google.pubsub.publisher.messages.total",
+        {
+          description: "Number of Pub/Sub messages sent by EventConsumingGooglePubSubPublisher",
+          unit: "short"
+        }
+      )
+    };
+    this.#activeClientsByProjectId = /* @__PURE__ */ new Map();
+  }
+  async start() {
+    for (const task of this.#tasks) {
+      this.#logger.info(
+        `Starting publisher: id=${task.id} sourceTopics=${task.sourceTopics.join(",")} targetTopic=${task.targetTopicPattern}`
+      );
+      await this.#events.subscribe({
+        id: `EventConsumingGooglePubSubPublisher.${task.id}`,
+        topics: task.sourceTopics,
+        onEvent: async (event) => {
+          let status = "failed";
+          try {
+            const topic = task.mapToTopic(event);
+            if (!topic) {
+              status = "ignored";
+              return;
+            }
+            let pubsub = this.#activeClientsByProjectId.get(topic.project);
+            if (!pubsub) {
+              pubsub = this.#pubSubFactory(topic.project);
+              this.#activeClientsByProjectId.set(topic.project, pubsub);
+            }
+            await pubsub.topic(topic.topic).publishMessage({
+              json: event.eventPayload,
+              attributes: task.mapToAttributes(event)
+            });
+            status = "success";
+          } catch (error) {
+            this.#logger.error(
+              "Error publishing Google Pub/Sub message",
+              error
+            );
+            status = "failed";
+            throw error;
+          } finally {
+            this.#metrics.messages.add(1, {
+              subscription: task.id,
+              status
+            });
+          }
+        }
+      });
+    }
+  }
+  async stop() {
+    const clients = Array.from(this.#activeClientsByProjectId.values());
+    this.#activeClientsByProjectId = /* @__PURE__ */ new Map();
+    await Promise.allSettled(
+      clients.map(async (client) => {
+        this.#logger.info(`Closing Google Pub/Sub client: ${client.projectId}`);
+        await client.close();
+      })
+    );
+  }
+}
+
+exports.EventConsumingGooglePubSubPublisher = EventConsumingGooglePubSubPublisher;
+//# sourceMappingURL=EventConsumingGooglePubSubPublisher.cjs.js.map

package/dist/EventConsumingGooglePubSubPublisher/EventConsumingGooglePubSubPublisher.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventConsumingGooglePubSubPublisher.cjs.js","sources":["../../src/EventConsumingGooglePubSubPublisher/EventConsumingGooglePubSubPublisher.ts"],"sourcesContent":["/*\n * Copyright 2025 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  LoggerService,\n  RootConfigService,\n  RootLifecycleService,\n} from '@backstage/backend-plugin-api';\nimport { EventsService } from '@backstage/plugin-events-node';\nimport { PubSub } from '@google-cloud/pubsub';\nimport { Counter, metrics } from '@opentelemetry/api';\nimport { readSubscriptionTasksFromConfig } from './config';\nimport { SubscriptionTask } from './types';\n\n/**\n * Reads messages off of the events system and forwards them into Google Pub/Sub\n * topics.\n */\nexport class EventConsumingGooglePubSubPublisher {\n  readonly #logger: LoggerService;\n  readonly #events: EventsService;\n  readonly #tasks: SubscriptionTask[];\n  readonly #pubSubFactory: (projectId: string) => PubSub;\n  readonly #metrics: { messages: Counter };\n  #activeClientsByProjectId: Map<string, PubSub>;\n\n  static create(options: {\n    config: RootConfigService;\n    logger: LoggerService;\n    rootLifecycle: RootLifecycleService;\n    events: EventsService;\n  }) {\n    const publisher = new EventConsumingGooglePubSubPublisher({\n      logger: options.logger,\n      events: options.events,\n      tasks: readSubscriptionTasksFromConfig(options.config),\n      pubSubFactory: projectId => new PubSub({ projectId }),\n    });\n\n    options.rootLifecycle.addStartupHook(async () => {\n      await publisher.start();\n    });\n\n    options.rootLifecycle.addBeforeShutdownHook(async () => {\n      await publisher.stop();\n    });\n\n    return publisher;\n  }\n\n  constructor(options: {\n    logger: LoggerService;\n    events: EventsService;\n    tasks: SubscriptionTask[];\n    pubSubFactory: (projectId: string) => PubSub;\n  }) {\n    this.#logger = options.logger;\n    this.#events = options.events;\n    this.#tasks = options.tasks;\n    this.#pubSubFactory = options.pubSubFactory;\n\n    const meter = metrics.getMeter('default');\n    this.#metrics = {\n      messages: meter.createCounter(\n        'events.google.pubsub.publisher.messages.total',\n        {\n          description:\n            'Number of Pub/Sub messages sent by EventConsumingGooglePubSubPublisher',\n          unit: 'short',\n        },\n      ),\n    };\n\n    this.#activeClientsByProjectId = new Map();\n  }\n\n  async start() {\n    for (const task of this.#tasks) {\n      this.#logger.info(\n        `Starting publisher: id=${\n          task.id\n        } sourceTopics=${task.sourceTopics.join(',')} targetTopic=${\n          task.targetTopicPattern\n        }`,\n      );\n\n      await this.#events.subscribe({\n        id: `EventConsumingGooglePubSubPublisher.${task.id}`,\n        topics: task.sourceTopics,\n        onEvent: async event => {\n          let status: 'success' | 'failed' | 'ignored' = 'failed';\n          try {\n            const topic = task.mapToTopic(event);\n            if (!topic) {\n              status = 'ignored';\n              return;\n            }\n\n            let pubsub = this.#activeClientsByProjectId.get(topic.project);\n            if (!pubsub) {\n              pubsub = this.#pubSubFactory(topic.project);\n              this.#activeClientsByProjectId.set(topic.project, pubsub);\n            }\n\n            await pubsub.topic(topic.topic).publishMessage({\n              json: event.eventPayload,\n              attributes: task.mapToAttributes(event),\n            });\n\n            status = 'success';\n          } catch (error) {\n            this.#logger.error(\n              'Error publishing Google Pub/Sub message',\n              error,\n            );\n            status = 'failed';\n            throw error;\n          } finally {\n            this.#metrics.messages.add(1, {\n              subscription: task.id,\n              status: status,\n            });\n          }\n        },\n      });\n    }\n  }\n\n  async stop() {\n    const clients = Array.from(this.#activeClientsByProjectId.values());\n    this.#activeClientsByProjectId = new Map();\n\n    await Promise.allSettled(\n      clients.map(async client => {\n        this.#logger.info(`Closing Google Pub/Sub client: ${client.projectId}`);\n        await client.close();\n      }),\n    );\n  }\n}\n"],"names":["readSubscriptionTasksFromConfig","PubSub","metrics"],"mappings":"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"}

package/dist/EventConsumingGooglePubSubPublisher/config.cjs.js

@@ -0,0 +1,100 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+var createPatternResolver = require('../util/createPatternResolver.cjs.js');
+
+function readSubscriptionTasksFromConfig(rootConfig) {
+  const subscriptionsConfig = rootConfig.getOptionalConfig(
+    "events.modules.googlePubSub.eventConsumingGooglePubSubPublisher.subscriptions"
+  );
+  if (!subscriptionsConfig) {
+    return [];
+  }
+  return subscriptionsConfig.keys().map((subscriptionId) => {
+    if (!subscriptionId.match(/^[-_\w]+$/)) {
+      throw new errors.InputError(
+        `Expected Google Pub/Sub subscription ID to consist of letters, numbers, dashes and underscores, but got '${subscriptionId}'`
+      );
+    }
+    const config = subscriptionsConfig.getConfig(subscriptionId);
+    const sourceTopics = readSourceTopics(config);
+    const mapToTopic = readTopicMapper(config);
+    const mapToAttributes = readAttributeMapper(config);
+    return {
+      id: subscriptionId,
+      sourceTopics,
+      targetTopicPattern: config.getString("targetTopicName"),
+      mapToTopic,
+      mapToAttributes
+    };
+  });
+}
+function readSourceTopics(config) {
+  if (Array.isArray(config.getOptional("sourceTopic"))) {
+    return config.getStringArray("sourceTopic");
+  }
+  return [config.getString("sourceTopic")];
+}
+function readTopicMapper(config) {
+  const regex = /^projects\/([^/]+)\/topics\/(.+)$/;
+  const targetTopicPattern = config.getString("targetTopicName");
+  let parts = targetTopicPattern.match(regex);
+  if (!parts) {
+    throw new errors.InputError(
+      `Expected Google Pub/Sub 'targetTopicName' to be on the form 'projects/PROJECT_ID/topics/TOPIC_ID' but got '${targetTopicPattern}'`
+    );
+  }
+  const patternResolver = createPatternResolver.createPatternResolver(targetTopicPattern);
+  return (event) => {
+    try {
+      parts = patternResolver({ event }).match(regex);
+      if (!parts) {
+        return void 0;
+      }
+      return {
+        project: parts[1],
+        topic: parts[2]
+      };
+    } catch {
+      return void 0;
+    }
+  };
+}
+function readAttributeMapper(config) {
+  const setters = new Array();
+  const eventMetadata = config.getOptionalConfig("messageAttributes");
+  if (eventMetadata) {
+    for (const key of eventMetadata?.keys() ?? []) {
+      const valuePattern = eventMetadata.getString(key);
+      const patternResolver = createPatternResolver.createPatternResolver(valuePattern);
+      setters.push(({ event, attributes }) => {
+        try {
+          const value = patternResolver({ event });
+          if (value) {
+            attributes[key] = value;
+          }
+        } catch {
+        }
+      });
+    }
+  }
+  return (event) => {
+    const result = {};
+    for (const [key, value] of Object.entries(event.metadata ?? {})) {
+      if (value) {
+        if (typeof value === "string") {
+          result[key] = value;
+        } else if (Array.isArray(value) && value.length > 0) {
+          result[key] = value.join(",");
+        }
+      }
+    }
+    for (const setter of setters) {
+      setter({ event, attributes: result });
+    }
+    return result;
+  };
+}
+
+exports.readSubscriptionTasksFromConfig = readSubscriptionTasksFromConfig;
+//# sourceMappingURL=config.cjs.js.map

package/dist/EventConsumingGooglePubSubPublisher/config.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.cjs.js","sources":["../../src/EventConsumingGooglePubSubPublisher/config.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { RootConfigService } from '@backstage/backend-plugin-api';\nimport { Config } from '@backstage/config';\nimport { InputError } from '@backstage/errors';\nimport { EventParams } from '@backstage/plugin-events-node';\nimport { createPatternResolver } from '../util/createPatternResolver';\nimport { SubscriptionTask } from './types';\n\nexport function readSubscriptionTasksFromConfig(\n  rootConfig: RootConfigService,\n): SubscriptionTask[] {\n  const subscriptionsConfig = rootConfig.getOptionalConfig(\n    'events.modules.googlePubSub.eventConsumingGooglePubSubPublisher.subscriptions',\n  );\n  if (!subscriptionsConfig) {\n    return [];\n  }\n\n  return subscriptionsConfig.keys().map(subscriptionId => {\n    if (!subscriptionId.match(/^[-_\\w]+$/)) {\n      throw new InputError(\n        `Expected Google Pub/Sub subscription ID to consist of letters, numbers, dashes and underscores, but got '${subscriptionId}'`,\n      );\n    }\n\n    const config = subscriptionsConfig.getConfig(subscriptionId);\n    const sourceTopics = readSourceTopics(config);\n    const mapToTopic = readTopicMapper(config);\n    const mapToAttributes = readAttributeMapper(config);\n\n    return {\n      id: subscriptionId,\n      sourceTopics: sourceTopics,\n      targetTopicPattern: config.getString('targetTopicName'),\n      mapToTopic,\n      mapToAttributes,\n    };\n  });\n}\n\nfunction readSourceTopics(config: Config): string[] {\n  if (Array.isArray(config.getOptional('sourceTopic'))) {\n    return config.getStringArray('sourceTopic');\n  }\n  return [config.getString('sourceTopic')];\n}\n\n/**\n * Handles the `targetTopicName` configuration field.\n */\nfunction readTopicMapper(\n  config: Config,\n): (event: EventParams) => { project: string; topic: string } | undefined {\n  const regex = /^projects\\/([^/]+)\\/topics\\/(.+)$/;\n\n  const targetTopicPattern = config.getString('targetTopicName');\n  let parts = targetTopicPattern.match(regex);\n  if (!parts) {\n    throw new InputError(\n      `Expected Google Pub/Sub 'targetTopicName' to be on the form 'projects/PROJECT_ID/topics/TOPIC_ID' but got '${targetTopicPattern}'`,\n    );\n  }\n\n  const patternResolver = createPatternResolver(targetTopicPattern);\n\n  return event => {\n    try {\n      parts = patternResolver({ event }).match(regex);\n      if (!parts) {\n        return undefined;\n      }\n      return {\n        project: parts[1],\n        topic: parts[2],\n      };\n    } catch {\n      // could not map to a topic\n      return undefined;\n    }\n  };\n}\n\n/**\n * Handles the `messageAttributes` configuration field.\n */\nfunction readAttributeMapper(\n  config: Config,\n): (event: EventParams) => Record<string, string> {\n  const setters = new Array<\n    (options: {\n      event: EventParams;\n      attributes: Record<string, string>;\n    }) => void\n  >();\n\n  const eventMetadata = config.getOptionalConfig('messageAttributes');\n  if (eventMetadata) {\n    for (const key of eventMetadata?.keys() ?? []) {\n      const valuePattern = eventMetadata.getString(key);\n      const patternResolver = createPatternResolver(valuePattern);\n      setters.push(({ event, attributes }) => {\n        try {\n          const value = patternResolver({ event });\n          if (value) {\n            attributes[key] = value;\n          }\n        } catch {\n          // ignore silently, keep original\n        }\n      });\n    }\n  }\n\n  return event => {\n    const result: Record<string, string> = {};\n    for (const [key, value] of Object.entries(event.metadata ?? {})) {\n      if (value) {\n        if (typeof value === 'string') {\n          result[key] = value;\n        } else if (Array.isArray(value) && value.length > 0) {\n          // Google Pub/Sub does not support array values\n          result[key] = value.join(',');\n        }\n      }\n    }\n    for (const setter of setters) {\n      setter({ event, attributes: result });\n    }\n    return result;\n  };\n}\n"],"names":["InputError","createPatternResolver"],"mappings":"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"}

package/dist/EventConsumingGooglePubSubPublisher/module.cjs.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var pluginEventsNode = require('@backstage/plugin-events-node');
+var EventConsumingGooglePubSubPublisher = require('./EventConsumingGooglePubSubPublisher.cjs.js');
+
+const eventsModuleEventConsumingGooglePubSubPublisher = backendPluginApi.createBackendModule({
+  pluginId: "events",
+  moduleId: "event-consuming-google-pubsub-publisher",
+  register(reg) {
+    reg.registerInit({
+      deps: {
+        config: backendPluginApi.coreServices.rootConfig,
+        logger: backendPluginApi.coreServices.logger,
+        rootLifecycle: backendPluginApi.coreServices.rootLifecycle,
+        events: pluginEventsNode.eventsServiceRef
+      },
+      async init({ config, logger, rootLifecycle, events }) {
+        EventConsumingGooglePubSubPublisher.EventConsumingGooglePubSubPublisher.create({
+          config,
+          logger,
+          rootLifecycle,
+          events
+        });
+      }
+    });
+  }
+});
+
+exports.eventsModuleEventConsumingGooglePubSubPublisher = eventsModuleEventConsumingGooglePubSubPublisher;
+//# sourceMappingURL=module.cjs.js.map

package/dist/EventConsumingGooglePubSubPublisher/module.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.cjs.js","sources":["../../src/EventConsumingGooglePubSubPublisher/module.ts"],"sourcesContent":["/*\n * Copyright 2025 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  createBackendModule,\n} from '@backstage/backend-plugin-api';\nimport { eventsServiceRef } from '@backstage/plugin-events-node';\nimport { EventConsumingGooglePubSubPublisher } from './EventConsumingGooglePubSubPublisher';\n\n/**\n * Reads messages off of the events system and forwards them into Google Pub/Sub\n * topics.\n *\n * @public\n */\nexport const eventsModuleEventConsumingGooglePubSubPublisher =\n  createBackendModule({\n    pluginId: 'events',\n    moduleId: 'event-consuming-google-pubsub-publisher',\n    register(reg) {\n      reg.registerInit({\n        deps: {\n          config: coreServices.rootConfig,\n          logger: coreServices.logger,\n          rootLifecycle: coreServices.rootLifecycle,\n          events: eventsServiceRef,\n        },\n        async init({ config, logger, rootLifecycle, events }) {\n          EventConsumingGooglePubSubPublisher.create({\n            config,\n            logger,\n            rootLifecycle,\n            events,\n          });\n        },\n      });\n    },\n  });\n"],"names":["createBackendModule","coreServices","eventsServiceRef","EventConsumingGooglePubSubPublisher"],"mappings":";;;;;;AA6BO,MAAM,kDACXA,oCAAoB,CAAA;AAAA,EAClB,QAAU,EAAA,QAAA;AAAA,EACV,QAAU,EAAA,yCAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,QAAQC,6BAAa,CAAA,UAAA;AAAA,QACrB,QAAQA,6BAAa,CAAA,MAAA;AAAA,QACrB,eAAeA,6BAAa,CAAA,aAAA;AAAA,QAC5B,MAAQ,EAAAC;AAAA,OACV;AAAA,MACA,MAAM,IAAK,CAAA,EAAE,QAAQ,MAAQ,EAAA,aAAA,EAAe,QAAU,EAAA;AACpD,QAAAC,uEAAA,CAAoC,MAAO,CAAA;AAAA,UACzC,MAAA;AAAA,UACA,MAAA;AAAA,UACA,aAAA;AAAA,UACA;AAAA,SACD,CAAA;AAAA;AACH,KACD,CAAA;AAAA;AAEL,CAAC;;;;"}

package/dist/GooglePubSubConsumingEventPublisher/config.cjs.js

@@ -13,7 +13,7 @@ function readSubscriptionTasksFromConfig(rootConfig) {
   return subscriptionsConfig.keys().map((subscriptionId) => {
     if (!subscriptionId.match(/^[-_\w]+$/)) {
       throw new errors.InputError(
-        `Expected Googoe Pub/Sub subscription ID to consist of letters, numbers, dashes and underscores, but got '${subscriptionId}'`
+        `Expected Google Pub/Sub subscription ID to consist of letters, numbers, dashes and underscores, but got '${subscriptionId}'`
       );
     }
     const config = subscriptionsConfig.getConfig(subscriptionId);
@@ -36,7 +36,7 @@ function readSubscriptionName(config) {
   );
   if (!parts) {
     throw new errors.InputError(
-      `Expected Googoe Pub/Sub 'subscriptionName' to be on the form 'projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID' but got '${subscriptionName}'`
+      `Expected Google Pub/Sub 'subscriptionName' to be on the form 'projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID' but got '${subscriptionName}'`
     );
   }
   return {

package/dist/GooglePubSubConsumingEventPublisher/config.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs.js","sources":["../../src/GooglePubSubConsumingEventPublisher/config.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { RootConfigService } from '@backstage/backend-plugin-api';\nimport { Config } from '@backstage/config';\nimport { InputError } from '@backstage/errors';\nimport { Message } from '@google-cloud/pubsub';\nimport { createPatternResolver } from '../util/createPatternResolver';\nimport { SubscriptionTask } from './types';\n\nexport function readSubscriptionTasksFromConfig(\n  rootConfig: RootConfigService,\n): SubscriptionTask[] {\n  const subscriptionsConfig = rootConfig.getOptionalConfig(\n    'events.modules.googlePubSub.googlePubSubConsumingEventPublisher.subscriptions',\n  );\n  if (!subscriptionsConfig) {\n    return [];\n  }\n\n  return subscriptionsConfig.keys().map(subscriptionId => {\n    if (!subscriptionId.match(/^[-_\\w]+$/)) {\n      throw new InputError(\n        `Expected Googoe Pub/Sub subscription ID to consist of letters, numbers, dashes and underscores, but got '${subscriptionId}'`,\n      );\n    }\n\n    const config = subscriptionsConfig.getConfig(subscriptionId);\n    const { project, subscription } = readSubscriptionName(config);\n    const mapToTopic = readTopicMapper(config);\n    const mapToMetadata = readMetadataMapper(config);\n\n    return {\n      id: subscriptionId,\n      project,\n      subscription,\n      mapToTopic,\n      mapToMetadata,\n    };\n  });\n}\n\nfunction readSubscriptionName(config: Config): {\n  project: string;\n  subscription: string;\n} {\n  const subscriptionName = config.getString('subscriptionName');\n  const parts = subscriptionName.match(\n    /^projects\\/([^/]+)\\/subscriptions\\/(.+)$/,\n  );\n  if (!parts) {\n    throw new InputError(\n      `Expected Googoe Pub/Sub 'subscriptionName' to be on the form 'projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID' but got '${subscriptionName}'`,\n    );\n  }\n  return {\n    project: parts[1],\n    subscription: parts[2],\n  };\n}\n\n/**\n * Handles the `targetTopic` configuration field.\n */\nfunction readTopicMapper(\n  config: Config,\n): (message: Message) => string | undefined {\n  const targetTopicPattern = config.getString('targetTopic');\n  const patternResolver = createPatternResolver(targetTopicPattern);\n  return message => {\n    try {\n      return patternResolver({ message });\n    } catch {\n      // could not map to a topic\n      return undefined;\n    }\n  };\n}\n\n/**\n * Handles the `eventMetadata` configuration field.\n */\nfunction readMetadataMapper(\n  config: Config,\n): (message: Message) => Record<string, string> {\n  const setters = new Array<\n    (options: { message: Message; metadata: Record<string, string> }) => void\n  >();\n\n  const eventMetadata = config.getOptionalConfig('eventMetadata');\n  if (eventMetadata) {\n    for (const key of eventMetadata?.keys() ?? []) {\n      const valuePattern = eventMetadata.getString(key);\n      const patternResolver = createPatternResolver(valuePattern);\n      setters.push(({ message, metadata }) => {\n        try {\n          const value = patternResolver({ message });\n          if (value) {\n            metadata[key] = value;\n          }\n        } catch {\n          // ignore silently, keep original\n        }\n      });\n    }\n  }\n\n  return message => {\n    const result: Record<string, string> = {\n      ...message.attributes,\n    };\n    for (const setter of setters) {\n      setter({ message, metadata: result });\n    }\n    return result;\n  };\n}\n"],"names":["InputError","createPatternResolver"],"mappings":"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"}
+{"version":3,"file":"config.cjs.js","sources":["../../src/GooglePubSubConsumingEventPublisher/config.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { RootConfigService } from '@backstage/backend-plugin-api';\nimport { Config } from '@backstage/config';\nimport { InputError } from '@backstage/errors';\nimport { Message } from '@google-cloud/pubsub';\nimport { createPatternResolver } from '../util/createPatternResolver';\nimport { SubscriptionTask } from './types';\n\nexport function readSubscriptionTasksFromConfig(\n  rootConfig: RootConfigService,\n): SubscriptionTask[] {\n  const subscriptionsConfig = rootConfig.getOptionalConfig(\n    'events.modules.googlePubSub.googlePubSubConsumingEventPublisher.subscriptions',\n  );\n  if (!subscriptionsConfig) {\n    return [];\n  }\n\n  return subscriptionsConfig.keys().map(subscriptionId => {\n    if (!subscriptionId.match(/^[-_\\w]+$/)) {\n      throw new InputError(\n        `Expected Google Pub/Sub subscription ID to consist of letters, numbers, dashes and underscores, but got '${subscriptionId}'`,\n      );\n    }\n\n    const config = subscriptionsConfig.getConfig(subscriptionId);\n    const { project, subscription } = readSubscriptionName(config);\n    const mapToTopic = readTopicMapper(config);\n    const mapToMetadata = readMetadataMapper(config);\n\n    return {\n      id: subscriptionId,\n      project,\n      subscription,\n      mapToTopic,\n      mapToMetadata,\n    };\n  });\n}\n\nfunction readSubscriptionName(config: Config): {\n  project: string;\n  subscription: string;\n} {\n  const subscriptionName = config.getString('subscriptionName');\n  const parts = subscriptionName.match(\n    /^projects\\/([^/]+)\\/subscriptions\\/(.+)$/,\n  );\n  if (!parts) {\n    throw new InputError(\n      `Expected Google Pub/Sub 'subscriptionName' to be on the form 'projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID' but got '${subscriptionName}'`,\n    );\n  }\n  return {\n    project: parts[1],\n    subscription: parts[2],\n  };\n}\n\n/**\n * Handles the `targetTopic` configuration field.\n */\nfunction readTopicMapper(\n  config: Config,\n): (message: Message) => string | undefined {\n  const targetTopicPattern = config.getString('targetTopic');\n  const patternResolver = createPatternResolver(targetTopicPattern);\n  return message => {\n    try {\n      return patternResolver({ message });\n    } catch {\n      // could not map to a topic\n      return undefined;\n    }\n  };\n}\n\n/**\n * Handles the `eventMetadata` configuration field.\n */\nfunction readMetadataMapper(\n  config: Config,\n): (message: Message) => Record<string, string> {\n  const setters = new Array<\n    (options: { message: Message; metadata: Record<string, string> }) => void\n  >();\n\n  const eventMetadata = config.getOptionalConfig('eventMetadata');\n  if (eventMetadata) {\n    for (const key of eventMetadata?.keys() ?? []) {\n      const valuePattern = eventMetadata.getString(key);\n      const patternResolver = createPatternResolver(valuePattern);\n      setters.push(({ message, metadata }) => {\n        try {\n          const value = patternResolver({ message });\n          if (value) {\n            metadata[key] = value;\n          }\n        } catch {\n          // ignore silently, keep original\n        }\n      });\n    }\n  }\n\n  return message => {\n    const result: Record<string, string> = {\n      ...message.attributes,\n    };\n    for (const setter of setters) {\n      setter({ message, metadata: result });\n    }\n    return result;\n  };\n}\n"],"names":["InputError","createPatternResolver"],"mappings":"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"}

package/dist/GooglePubSubConsumingEventPublisher/module.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.cjs.js","sources":["../../src/GooglePubSubConsumingEventPublisher/module.ts"],"sourcesContent":["/*\n * Copyright 2025 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  createBackendModule,\n} from '@backstage/backend-plugin-api';\nimport { eventsServiceRef } from '@backstage/plugin-events-node';\nimport { GooglePubSubConsumingEventPublisher } from './GooglePubSubConsumingEventPublisher';\n\n/**\n * Reads messages off of Google Pub/Sub subscriptions and forwards them into the\n * Backstage events system.\n *\n * @public\n */\nexport const eventsModuleGooglePubsubConsumingEventPublisher =\n  createBackendModule({\n    pluginId: 'events',\n    moduleId: 'google-pubsub-consuming-event-publisher',\n    register(reg) {\n      reg.registerInit({\n        deps: {\n          config: coreServices.rootConfig,\n          logger: coreServices.logger,\n          rootLifecycle: coreServices.rootLifecycle,\n          events: eventsServiceRef,\n        },\n        async init({ config, logger, rootLifecycle, events }) {\n          GooglePubSubConsumingEventPublisher.create({\n            config,\n            logger,\n            rootLifecycle,\n            events,\n          });\n        },\n      });\n    },\n  });\n"],"names":["createBackendModule","coreServices","eventsServiceRef","GooglePubSubConsumingEventPublisher"],"mappings":";;;;;;AA6BO,MAAM,kDACXA,oCAAoB,CAAA;AAAA,EAClB,QAAU,EAAA,QAAA;AAAA,EACV,QAAU,EAAA,yCAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,QAAQC,6BAAa,CAAA,UAAA;AAAA,QACrB,QAAQA,6BAAa,CAAA,MAAA;AAAA,QACrB,eAAeA,6BAAa,CAAA,aAAA;AAAA,QAC5B,MAAQ,EAAAC;AAAA,OACV;AAAA,MACA,MAAM,IAAK,CAAA,EAAE,QAAQ,MAAQ,EAAA,aAAA,EAAe,QAAU,EAAA;AACpD,QAAAC,uEAAA,CAAoC,MAAO,CAAA;AAAA,UACzC,MAAA;AAAA,UACA,MAAA;AAAA,UACA,aAAA;AAAA,UACA;AAAA,SACD,CAAA;AAAA;AACH,KACD,CAAA;AAAA;AAEL,CAAC;;;;"}
+{"version":3,"file":"module.cjs.js","sources":["../../src/GooglePubSubConsumingEventPublisher/module.ts"],"sourcesContent":["/*\n * Copyright 2025 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  createBackendModule,\n} from '@backstage/backend-plugin-api';\nimport { eventsServiceRef } from '@backstage/plugin-events-node';\nimport { GooglePubSubConsumingEventPublisher } from './GooglePubSubConsumingEventPublisher';\n\n/**\n * Reads messages off of Google Pub/Sub subscriptions and forwards them into the\n * Backstage events system.\n */\nexport const eventsModuleGooglePubsubConsumingEventPublisher =\n  createBackendModule({\n    pluginId: 'events',\n    moduleId: 'google-pubsub-consuming-event-publisher',\n    register(reg) {\n      reg.registerInit({\n        deps: {\n          config: coreServices.rootConfig,\n          logger: coreServices.logger,\n          rootLifecycle: coreServices.rootLifecycle,\n          events: eventsServiceRef,\n        },\n        async init({ config, logger, rootLifecycle, events }) {\n          GooglePubSubConsumingEventPublisher.create({\n            config,\n            logger,\n            rootLifecycle,\n            events,\n          });\n        },\n      });\n    },\n  });\n"],"names":["createBackendModule","coreServices","eventsServiceRef","GooglePubSubConsumingEventPublisher"],"mappings":";;;;;;AA2BO,MAAM,kDACXA,oCAAoB,CAAA;AAAA,EAClB,QAAU,EAAA,QAAA;AAAA,EACV,QAAU,EAAA,yCAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,QAAQC,6BAAa,CAAA,UAAA;AAAA,QACrB,QAAQA,6BAAa,CAAA,MAAA;AAAA,QACrB,eAAeA,6BAAa,CAAA,aAAA;AAAA,QAC5B,MAAQ,EAAAC;AAAA,OACV;AAAA,MACA,MAAM,IAAK,CAAA,EAAE,QAAQ,MAAQ,EAAA,aAAA,EAAe,QAAU,EAAA;AACpD,QAAAC,uEAAA,CAAoC,MAAO,CAAA;AAAA,UACzC,MAAA;AAAA,UACA,MAAA;AAAA,UACA,aAAA;AAAA,UACA;AAAA,SACD,CAAA;AAAA;AACH,KACD,CAAA;AAAA;AAEL,CAAC;;;;"}

package/dist/index.cjs.js

@@ -2,9 +2,16 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var module$2 = require('./EventConsumingGooglePubSubPublisher/module.cjs.js');
 var module$1 = require('./GooglePubSubConsumingEventPublisher/module.cjs.js');
 
+var index = backendPluginApi.createBackendFeatureLoader({
+  *loader() {
+    yield module$1.eventsModuleGooglePubsubConsumingEventPublisher;
+    yield module$2.eventsModuleEventConsumingGooglePubSubPublisher;
+  }
+});
 
-
-exports.default = module$1.eventsModuleGooglePubsubConsumingEventPublisher;
+exports.default = index;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
+{"version":3,"file":"index.cjs.js","sources":["../src/index.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { createBackendFeatureLoader } from '@backstage/backend-plugin-api';\nimport { eventsModuleEventConsumingGooglePubSubPublisher } from './EventConsumingGooglePubSubPublisher';\nimport { eventsModuleGooglePubsubConsumingEventPublisher } from './GooglePubSubConsumingEventPublisher';\n\n/**\n * The google-pubsub backend module for the events plugin.\n *\n * @packageDocumentation\n */\n\nexport default createBackendFeatureLoader({\n  *loader() {\n    yield eventsModuleGooglePubsubConsumingEventPublisher;\n    yield eventsModuleEventConsumingGooglePubSubPublisher;\n  },\n});\n"],"names":["createBackendFeatureLoader","eventsModuleGooglePubsubConsumingEventPublisher","eventsModuleEventConsumingGooglePubSubPublisher"],"mappings":";;;;;;;;AA0BA,YAAeA,2CAA2B,CAAA;AAAA,EACxC,CAAC,MAAS,GAAA;AACR,IAAM,MAAAC,wDAAA;AACN,IAAM,MAAAC,wDAAA;AAAA;AAEV,CAAC,CAAA;;;;"}

package/dist/index.d.ts

@@ -1,11 +1,10 @@
 import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
 
 /**
- * Reads messages off of Google Pub/Sub subscriptions and forwards them into the
- * Backstage events system.
+ * The google-pubsub backend module for the events plugin.
  *
- * @public
+ * @packageDocumentation
  */
-declare const eventsModuleGooglePubsubConsumingEventPublisher: _backstage_backend_plugin_api.BackendFeature;
+declare const _default: _backstage_backend_plugin_api.BackendFeature;
 
-export { eventsModuleGooglePubsubConsumingEventPublisher as default };
+export { _default as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-events-backend-module-google-pubsub",
-  "version": "0.1.1-next.1",
+  "version": "0.1.2-next.0",
   "description": "The google-pubsub backend module for the events plugin.",
   "backstage": {
     "role": "backend-plugin-module",
@@ -37,19 +37,19 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/backend-plugin-api": "1.4.0-next.1",
-    "@backstage/config": "1.3.2",
+    "@backstage/backend-plugin-api": "1.4.1-next.0",
+    "@backstage/config": "1.3.3-next.0",
     "@backstage/errors": "1.2.7",
-    "@backstage/plugin-events-node": "0.4.12-next.1",
+    "@backstage/plugin-events-node": "0.4.13-next.0",
     "@backstage/types": "1.2.1",
     "@google-cloud/pubsub": "^4.10.0",
     "@opentelemetry/api": "^1.9.0"
   },
   "devDependencies": {
-    "@backstage/backend-defaults": "0.10.1-next.1",
-    "@backstage/backend-test-utils": "1.6.0-next.1",
-    "@backstage/cli": "0.32.2-next.0",
-    "@backstage/plugin-events-backend": "0.5.3-next.1",
+    "@backstage/backend-defaults": "0.11.1-next.1",
+    "@backstage/backend-test-utils": "1.7.0-next.1",
+    "@backstage/cli": "0.33.1-next.1",
+    "@backstage/plugin-events-backend": "0.5.4-next.0",
     "wait-for-expect": "^3.0.2"
   },
   "configSchema": "config.d.ts",