@backstage/connections 0.0.0-nightly-20260610032156

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @backstage/connections
+
+## 0.0.0-nightly-20260610032156
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/backend-plugin-api@0.0.0-nightly-20260610032156
+  - @backstage/config@1.3.8
+  - @backstage/errors@1.3.1
+  - @backstage/types@1.2.2

package/README.md

@@ -0,0 +1,5 @@
+## Connections
+
+Connection Service for Backstage - a centralized system for configuring and querying connections to external services.
+It replaces the current integrations configuration and provides a shared foundation that the entire plugin ecosystem can build on.
+More details can be found in [BEP-14](https://github.com/backstage/backstage/pull/33921).

package/dist/api/DefaultConnectionService.cjs.js

@@ -0,0 +1,205 @@
+'use strict';
+
+require('../schema/awsCodeCommit.cjs.js');
+require('../schema/awsS3.cjs.js');
+require('../schema/azureBlobStorage.cjs.js');
+require('../schema/azure.cjs.js');
+require('../schema/bitbucketCloud.cjs.js');
+require('../schema/bitbucketServer.cjs.js');
+require('../schema/gerrit.cjs.js');
+require('../schema/gitea.cjs.js');
+require('../schema/github.cjs.js');
+require('../schema/gitlab.cjs.js');
+require('../schema/googleGcs.cjs.js');
+require('../schema/harness.cjs.js');
+var lookup = require('../definitions/lookup.cjs.js');
+var errors = require('@backstage/errors');
+var v4 = require('zod/v4');
+var getLegacyIntegrations = require('../system/getLegacyIntegrations.cjs.js');
+var combineConnectionSources = require('../system/combineConnectionSources.cjs.js');
+
+function describeError(error) {
+  const e = errors.toError(error);
+  if (e.name === "ZodError") {
+    return v4.z.prettifyError(e);
+  }
+  return e.message;
+}
+class PluginConnectionsService {
+  logger;
+  connections;
+  constructor(logger, connections) {
+    this.logger = logger;
+    this.connections = connections;
+  }
+  async find(options) {
+    const result = await this.findOptional(options);
+    if (!result) {
+      throw new errors.NotFoundError(
+        `Connection not found for type "${options.type}" matching url "${options.url}"`
+      );
+    }
+    return result;
+  }
+  async findOptional({
+    type,
+    url,
+    authMethods
+  }) {
+    this.logger.debug(
+      `Finding connection of type "${type}" matching url "${url}"`
+    );
+    let host;
+    try {
+      host = new URL(url).host;
+    } catch {
+      throw new errors.InputError(
+        `Invalid url "${url}" passed to ConnectionsService.find`
+      );
+    }
+    const connection = this.connections.find(
+      (c) => c.type === type && c.host === host
+    );
+    if (!connection) {
+      return void 0;
+    }
+    if (connection.auth.length === 0) {
+      throw new errors.NotAllowedError(
+        `Connection of type "${type}" for host "${host}" has no auth method available to this plugin`
+      );
+    }
+    const matchAuth = lookup.getConnectionType(type).matchAuth;
+    const selected = matchAuth ? matchAuth(connection.auth, url) : connection.auth[0];
+    if (!selected) {
+      return void 0;
+    }
+    if (!authMethods.includes(selected.method)) {
+      throw new errors.NotAllowedError(
+        `Connection not found for type "${type}" with auth method "${selected.method}"`
+      );
+    }
+    return {
+      ...connection,
+      auth: selected
+    };
+  }
+}
+class DefaultConnectionsService {
+  logger;
+  connections;
+  config;
+  constructor(logger, config) {
+    this.logger = logger;
+    this.config = config;
+    this.connections = [];
+    this.#registerConnectionsFromConfig();
+  }
+  static create(options) {
+    return new DefaultConnectionsService(options.logger, options.config);
+  }
+  #registerConnectionsFromConfig() {
+    const legacy = this.#validateLegacy(getLegacyIntegrations.getLegacyIntegrations(this.config));
+    const rawConnections = this.config.getOptional("connections");
+    if (rawConnections !== void 0 && !Array.isArray(rawConnections)) {
+      throw new errors.InputError(
+        'Expected "connections" config to be an array of connection objects'
+      );
+    }
+    const fromConfig = this.#validateConfig(
+      rawConnections ?? []
+    );
+    if (legacy.length === 0 && fromConfig.length === 0) {
+      return;
+    }
+    this.connections.push(
+      ...combineConnectionSources.combineConnectionSources(legacy, fromConfig, this.logger)
+    );
+    const seen = /* @__PURE__ */ new Set();
+    for (const c of this.connections) {
+      const host = c.host;
+      const key = `${c.type} ${host}`;
+      if (seen.has(key)) {
+        throw new errors.InputError(
+          `Duplicate connection of type "${c.type}" for host "${host}"`
+        );
+      }
+      seen.add(key);
+    }
+    this.logger.info(
+      `Loaded ${this.connections.length} connection${this.connections.length === 1 ? "" : "s"} from configuration`
+    );
+  }
+  #validateConfig(raw) {
+    return raw.map((v) => {
+      try {
+        return this.#validateConnection(v);
+      } catch (e) {
+        const type = typeof v.type === "string" ? v.type : "unknown";
+        throw new errors.InputError(
+          `Invalid connection of type "${type}" in connections config:
+${describeError(
+            e
+          )}`
+        );
+      }
+    });
+  }
+  #validateLegacy(raw) {
+    const result = [];
+    for (const v of raw) {
+      try {
+        result.push(this.#validateConnection(v));
+      } catch (e) {
+        const type = typeof v.type === "string" ? v.type : "unknown";
+        this.logger.error(
+          `Failed to validate connection of type "${type}":
+${describeError(
+            e
+          )}`
+        );
+      }
+    }
+    return result;
+  }
+  #validateConnection(connection) {
+    if (typeof connection.type !== "string") {
+      throw new errors.InputError(`Unrecognised connection type ${connection.type}`);
+    }
+    if (!lookup.isConnectionTypeKey(connection.type)) {
+      throw new errors.InputError(`Unrecognised connection type ${connection.type}`);
+    }
+    return lookup.getConnectionType(connection.type).schema.parse(
+      connection
+    );
+  }
+  #getConnectionsForPlugin(pluginId) {
+    return this.connections.flatMap(({ match, auth, ...rest }) => {
+      if (match && !match.plugins.includes(pluginId)) {
+        return [];
+      }
+      const pluginMatched = [];
+      const unmatched = [];
+      for (const { match: authMatch, ...authRest } of auth) {
+        if (authMatch) {
+          if (!authMatch.plugins.includes(pluginId)) continue;
+          pluginMatched.push(authRest);
+        } else {
+          unmatched.push(authRest);
+        }
+      }
+      return [
+        { ...rest, auth: [...pluginMatched, ...unmatched] }
+      ];
+    });
+  }
+  forPlugin(pluginId, options) {
+    const logger = options?.logger ?? this.logger;
+    return new PluginConnectionsService(
+      logger,
+      this.#getConnectionsForPlugin(pluginId)
+    );
+  }
+}
+
+exports.DefaultConnectionsService = DefaultConnectionsService;
+//# sourceMappingURL=DefaultConnectionService.cjs.js.map

package/dist/api/DefaultConnectionService.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultConnectionService.cjs.js","sources":["../../src/api/DefaultConnectionService.ts"],"sourcesContent":["/*\n * Copyright 2026 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 */\nimport { ConnectionsService } from './ConnectionsService';\nimport {\n  LoggerService,\n  RootConfigService,\n} from '@backstage/backend-plugin-api';\nimport {\n  ConnectionTypeKey,\n  getConnectionType,\n  isConnectionTypeKey,\n} from '../definitions';\nimport { ConnectionAuthMethodKey } from './ConnectionType';\nimport { Connection, RootConnection } from './Connection';\nimport { JsonObject } from '@backstage/types';\nimport {\n  InputError,\n  NotAllowedError,\n  NotFoundError,\n  toError,\n} from '@backstage/errors';\nimport { z } from 'zod/v4';\nimport { getLegacyIntegrations } from '../system/getLegacyIntegrations';\nimport { combineConnectionSources } from '../system/combineConnectionSources';\n\nfunction describeError(error: unknown): string {\n  const e = toError(error);\n  if (e.name === 'ZodError') {\n    return z.prettifyError(e as unknown as z.ZodError);\n  }\n  return e.message;\n}\n\nclass PluginConnectionsService implements ConnectionsService {\n  private readonly logger: LoggerService;\n  private readonly connections: Connection[];\n\n  constructor(logger: LoggerService, connections: Connection[]) {\n    this.logger = logger;\n    this.connections = connections;\n  }\n\n  async find<\n    TType extends ConnectionTypeKey,\n    TAuthMethod extends ConnectionAuthMethodKey<TType>,\n  >(options: {\n    type: TType;\n    url: string;\n    authMethods: readonly [TAuthMethod, ...TAuthMethod[]];\n  }): Promise<Connection<TType, TAuthMethod>> {\n    const result = await this.findOptional(options);\n    if (!result) {\n      throw new NotFoundError(\n        `Connection not found for type \"${options.type}\" matching url \"${options.url}\"`,\n      );\n    }\n    return result;\n  }\n\n  async findOptional<\n    TType extends ConnectionTypeKey,\n    TAuthMethod extends ConnectionAuthMethodKey<TType>,\n  >({\n    type,\n    url,\n    authMethods,\n  }: {\n    type: TType;\n    url: string;\n    authMethods: readonly [TAuthMethod, ...TAuthMethod[]];\n  }): Promise<Connection<TType, TAuthMethod> | undefined> {\n    this.logger.debug(\n      `Finding connection of type \"${type}\" matching url \"${url}\"`,\n    );\n    let host: string;\n    try {\n      host = new URL(url).host;\n    } catch {\n      throw new InputError(\n        `Invalid url \"${url}\" passed to ConnectionsService.find`,\n      );\n    }\n\n    const connection = this.connections.find(\n      c => c.type === type && (c as { host?: unknown }).host === host,\n    ) as Connection<TType> | undefined;\n\n    if (!connection) {\n      return undefined;\n    }\n\n    if (connection.auth.length === 0) {\n      throw new NotAllowedError(\n        `Connection of type \"${type}\" for host \"${host}\" has no auth method available to this plugin`,\n      );\n    }\n\n    const matchAuth = getConnectionType(type).matchAuth as\n      | ((authMethods: any[], query: string) => any | undefined)\n      | undefined;\n\n    // We take the host-matched connection and check to see if there's an auth method better suited to the current url\n    // e.g. org selection\n    const selected = matchAuth\n      ? matchAuth(connection.auth, url)\n      : connection.auth[0];\n\n    if (!selected) {\n      return undefined;\n    }\n\n    // Now we compare user requested auth methods with what the connection can provide\n    if (!(authMethods as readonly string[]).includes(selected.method)) {\n      throw new NotAllowedError(\n        `Connection not found for type \"${type}\" with auth method \"${selected.method}\"`,\n      );\n    }\n\n    return {\n      ...connection,\n      auth: selected,\n    } as Connection<TType, TAuthMethod>;\n  }\n}\n\n/** @public */\nexport class DefaultConnectionsService {\n  private readonly logger: LoggerService;\n  private readonly connections: RootConnection[];\n  private readonly config: RootConfigService;\n\n  private constructor(logger: LoggerService, config: RootConfigService) {\n    this.logger = logger;\n    this.config = config;\n    this.connections = [];\n    this.#registerConnectionsFromConfig();\n  }\n\n  static create(options: {\n    logger: LoggerService;\n    config: RootConfigService;\n  }): DefaultConnectionsService {\n    return new DefaultConnectionsService(options.logger, options.config);\n  }\n\n  #registerConnectionsFromConfig(): void {\n    const legacy = this.#validateLegacy(getLegacyIntegrations(this.config));\n\n    const rawConnections = this.config.getOptional('connections');\n    if (rawConnections !== undefined && !Array.isArray(rawConnections)) {\n      throw new InputError(\n        'Expected \"connections\" config to be an array of connection objects',\n      );\n    }\n\n    const fromConfig = this.#validateConfig(\n      (rawConnections as JsonObject[] | undefined) ?? [],\n    );\n\n    if (legacy.length === 0 && fromConfig.length === 0) {\n      return;\n    }\n\n    this.connections.push(\n      ...combineConnectionSources(legacy, fromConfig, this.logger),\n    );\n\n    const seen = new Set<string>();\n    for (const c of this.connections) {\n      const host = (c as unknown as { host: string }).host;\n      const key = `${c.type} ${host}`;\n      if (seen.has(key)) {\n        throw new InputError(\n          `Duplicate connection of type \"${c.type}\" for host \"${host}\"`,\n        );\n      }\n      seen.add(key);\n    }\n\n    this.logger.info(\n      `Loaded ${this.connections.length} connection${\n        this.connections.length === 1 ? '' : 's'\n      } from configuration`,\n    );\n  }\n\n  #validateConfig(raw: JsonObject[]): RootConnection[] {\n    return raw.map(v => {\n      try {\n        return this.#validateConnection(v);\n      } catch (e) {\n        const type = typeof v.type === 'string' ? v.type : 'unknown';\n        throw new InputError(\n          `Invalid connection of type \"${type}\" in connections config:\\n${describeError(\n            e,\n          )}`,\n        );\n      }\n    });\n  }\n\n  #validateLegacy(raw: JsonObject[]): RootConnection[] {\n    const result: RootConnection[] = [];\n    for (const v of raw) {\n      try {\n        result.push(this.#validateConnection(v));\n      } catch (e) {\n        const type = typeof v.type === 'string' ? v.type : 'unknown';\n        this.logger.error(\n          `Failed to validate connection of type \"${type}\":\\n${describeError(\n            e,\n          )}`,\n        );\n      }\n    }\n    return result;\n  }\n\n  #validateConnection(connection: JsonObject): RootConnection {\n    if (typeof connection.type !== 'string') {\n      throw new InputError(`Unrecognised connection type ${connection.type}`);\n    }\n\n    if (!isConnectionTypeKey(connection.type)) {\n      throw new InputError(`Unrecognised connection type ${connection.type}`);\n    }\n\n    return getConnectionType(connection.type).schema.parse(\n      connection,\n    ) as RootConnection;\n  }\n\n  #getConnectionsForPlugin(pluginId: string): Connection[] {\n    // Filter connections and hide auth methods based on these conditions:\n    // 1. Include Connections with no plugin matcher condition\n    // 2. Include Connections with a plugin matcher condition for this plugin\n    // 3. Include auth methods with no plugin matcher condition\n    // 4. Remove auth methods with a plugin matcher condition for other plugins\n    return this.connections.flatMap(({ match, auth, ...rest }) => {\n      if (match && !match.plugins.includes(pluginId)) {\n        return [];\n      }\n\n      const pluginMatched: Connection['auth'] = [];\n      const unmatched: Connection['auth'] = [];\n      for (const { match: authMatch, ...authRest } of auth) {\n        if (authMatch) {\n          if (!authMatch.plugins.includes(pluginId)) continue;\n          pluginMatched.push(authRest as Connection['auth'][number]);\n        } else {\n          unmatched.push(authRest as Connection['auth'][number]);\n        }\n      }\n\n      return [\n        { ...rest, auth: [...pluginMatched, ...unmatched] } as Connection,\n      ];\n    });\n  }\n\n  forPlugin(\n    pluginId: string,\n    options?: {\n      logger: LoggerService;\n    },\n  ): ConnectionsService {\n    const logger = options?.logger ?? this.logger;\n    return new PluginConnectionsService(\n      logger,\n      this.#getConnectionsForPlugin(pluginId),\n    );\n  }\n}\n"],"names":["toError","z","NotFoundError","InputError","NotAllowedError","getConnectionType","getLegacyIntegrations","combineConnectionSources","isConnectionTypeKey"],"mappings":"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"}

package/dist/api/declareConnection.cjs.js

@@ -0,0 +1,14 @@
+'use strict';
+
+function declareConnection(reg, registration) {
+  const internal = reg;
+  if (typeof internal.registerConnection !== "function") {
+    throw new Error(
+      "declareConnection: the provided registration points object does not support registerConnection. Make sure you are calling this inside a createBackendPlugin or createBackendModule register callback."
+    );
+  }
+  internal.registerConnection(registration);
+}
+
+exports.declareConnection = declareConnection;
+//# sourceMappingURL=declareConnection.cjs.js.map

package/dist/api/declareConnection.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declareConnection.cjs.js","sources":["../../src/api/declareConnection.ts"],"sourcesContent":["/*\n * Copyright 2026 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 */\nimport type {\n  BackendModuleRegistrationPoints,\n  BackendPluginRegistrationPoints,\n} from '@backstage/backend-plugin-api';\n\nimport type { ConnectionRegistration } from '@backstage/backend-plugin-api/alpha';\n\n/**\n * Declares that a plugin or module uses a particular connection type.\n * Must be called inside the `register` callback, before `registerInit`.\n *\n * @public\n */\nexport function declareConnection(\n  reg: BackendPluginRegistrationPoints | BackendModuleRegistrationPoints,\n  registration: ConnectionRegistration,\n): void {\n  const internal = reg as {\n    registerConnection?: (r: ConnectionRegistration) => void;\n  };\n  if (typeof internal.registerConnection !== 'function') {\n    throw new Error(\n      'declareConnection: the provided registration points object does not support registerConnection. ' +\n        'Make sure you are calling this inside a createBackendPlugin or createBackendModule register callback.',\n    );\n  }\n  internal.registerConnection(registration);\n}\n"],"names":[],"mappings":";;AA4BO,SAAS,iBAAA,CACd,KACA,YAAA,EACM;AACN,EAAA,MAAM,QAAA,GAAW,GAAA;AAGjB,EAAA,IAAI,OAAO,QAAA,CAAS,kBAAA,KAAuB,UAAA,EAAY;AACrD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,QAAA,CAAS,mBAAmB,YAAY,CAAA;AAC1C;;;;"}

package/dist/definitions/lookup.cjs.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var types = require('./types.cjs.js');
+
+const connectionTypesMap = new Map(Object.entries(types.connectionTypes));
+function getConnectionType(key) {
+  return connectionTypesMap.get(key);
+}
+function isConnectionTypeKey(value) {
+  if (!value) return false;
+  return connectionTypesMap.has(value);
+}
+
+exports.getConnectionType = getConnectionType;
+exports.isConnectionTypeKey = isConnectionTypeKey;
+//# sourceMappingURL=lookup.cjs.js.map

package/dist/definitions/lookup.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.cjs.js","sources":["../../src/definitions/lookup.ts"],"sourcesContent":["/*\n * Copyright 2026 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 */\nimport {\n  LookupConnectionType,\n  ConnectionTypeKey,\n  connectionTypes,\n} from './types';\n\nconst connectionTypesMap = new Map(Object.entries(connectionTypes));\n\nexport function getConnectionType<T extends ConnectionTypeKey>(\n  key: T,\n): LookupConnectionType<T> {\n  return connectionTypesMap.get(key) as LookupConnectionType<T>;\n}\n\nexport function isConnectionTypeKey(\n  value: string | undefined,\n): value is ConnectionTypeKey {\n  if (!value) return false;\n\n  return connectionTypesMap.has(value);\n}\n"],"names":["connectionTypes"],"mappings":";;;;AAqBA,MAAM,qBAAqB,IAAI,GAAA,CAAI,MAAA,CAAO,OAAA,CAAQA,qBAAe,CAAC,CAAA;AAE3D,SAAS,kBACd,GAAA,EACyB;AACzB,EAAA,OAAO,kBAAA,CAAmB,IAAI,GAAG,CAAA;AACnC;AAEO,SAAS,oBACd,KAAA,EAC4B;AAC5B,EAAA,IAAI,CAAC,OAAO,OAAO,KAAA;AAEnB,EAAA,OAAO,kBAAA,CAAmB,IAAI,KAAK,CAAA;AACrC;;;;;"}

package/dist/definitions/types.cjs.js

@@ -0,0 +1,32 @@
+'use strict';
+
+var awsCodeCommit = require('../schema/awsCodeCommit.cjs.js');
+var awsS3 = require('../schema/awsS3.cjs.js');
+var azureBlobStorage = require('../schema/azureBlobStorage.cjs.js');
+var azure = require('../schema/azure.cjs.js');
+var bitbucketCloud = require('../schema/bitbucketCloud.cjs.js');
+var bitbucketServer = require('../schema/bitbucketServer.cjs.js');
+var gerrit = require('../schema/gerrit.cjs.js');
+var gitea = require('../schema/gitea.cjs.js');
+var github = require('../schema/github.cjs.js');
+var gitlab = require('../schema/gitlab.cjs.js');
+var googleGcs = require('../schema/googleGcs.cjs.js');
+var harness = require('../schema/harness.cjs.js');
+
+const connectionTypes = {
+  "aws-codecommit": awsCodeCommit.AwsCodeCommitConnectionType,
+  "aws-s3": awsS3.AwsS3ConnectionType,
+  "azure-blob-storage": azureBlobStorage.AzureBlobStorageConnectionType,
+  azure: azure.AzureConnectionType,
+  "bitbucket-cloud": bitbucketCloud.BitbucketCloudConnectionType,
+  "bitbucket-server": bitbucketServer.BitbucketServerConnectionType,
+  gerrit: gerrit.GerritConnectionType,
+  gitea: gitea.GiteaConnectionType,
+  github: github.GithubConnectionType,
+  gitlab: gitlab.GitlabConnectionType,
+  "google-gcs": googleGcs.GoogleGcsConnectionType,
+  harness: harness.HarnessConnectionType
+};
+
+exports.connectionTypes = connectionTypes;
+//# sourceMappingURL=types.cjs.js.map

package/dist/definitions/types.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs.js","sources":["../../src/definitions/types.ts"],"sourcesContent":["/*\n * Copyright 2026 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 */\nimport { AwsCodeCommitConnectionType } from '../schema/awsCodeCommit';\nimport { AwsS3ConnectionType } from '../schema/awsS3';\nimport { AzureBlobStorageConnectionType } from '../schema/azureBlobStorage';\nimport { AzureConnectionType } from '../schema/azure';\nimport { BitbucketCloudConnectionType } from '../schema/bitbucketCloud';\nimport { BitbucketServerConnectionType } from '../schema/bitbucketServer';\nimport { GerritConnectionType } from '../schema/gerrit';\nimport { GiteaConnectionType } from '../schema/gitea';\nimport { GithubConnectionType } from '../schema/github';\nimport { GitlabConnectionType } from '../schema/gitlab';\nimport { GoogleGcsConnectionType } from '../schema/googleGcs';\nimport { HarnessConnectionType } from '../schema/harness';\nimport { ConnectionType } from '../api/ConnectionType';\n\n/** @public */\nexport const connectionTypes = {\n  'aws-codecommit': AwsCodeCommitConnectionType,\n  'aws-s3': AwsS3ConnectionType,\n  'azure-blob-storage': AzureBlobStorageConnectionType,\n  azure: AzureConnectionType,\n  'bitbucket-cloud': BitbucketCloudConnectionType,\n  'bitbucket-server': BitbucketServerConnectionType,\n  gerrit: GerritConnectionType,\n  gitea: GiteaConnectionType,\n  github: GithubConnectionType,\n  gitlab: GitlabConnectionType,\n  'google-gcs': GoogleGcsConnectionType,\n  harness: HarnessConnectionType,\n} as const satisfies { [K in string]: ConnectionType<K> };\n\n/** @public */\nexport type ConnectionTypeKey = keyof typeof connectionTypes;\n\n/** @public */\nexport type LookupConnectionType<T extends ConnectionTypeKey | ConnectionType> =\n  T extends ConnectionTypeKey ? (typeof connectionTypes)[T] : T;\n\nexport type ConnectionMatch = {\n  plugins: string[];\n};\n"],"names":["AwsCodeCommitConnectionType","AwsS3ConnectionType","AzureBlobStorageConnectionType","AzureConnectionType","BitbucketCloudConnectionType","BitbucketServerConnectionType","GerritConnectionType","GiteaConnectionType","GithubConnectionType","GitlabConnectionType","GoogleGcsConnectionType","HarnessConnectionType"],"mappings":";;;;;;;;;;;;;;;AA8BO,MAAM,eAAA,GAAkB;AAAA,EAC7B,gBAAA,EAAkBA,yCAAA;AAAA,EAClB,QAAA,EAAUC,yBAAA;AAAA,EACV,oBAAA,EAAsBC,+CAAA;AAAA,EACtB,KAAA,EAAOC,yBAAA;AAAA,EACP,iBAAA,EAAmBC,2CAAA;AAAA,EACnB,kBAAA,EAAoBC,6CAAA;AAAA,EACpB,MAAA,EAAQC,2BAAA;AAAA,EACR,KAAA,EAAOC,yBAAA;AAAA,EACP,MAAA,EAAQC,2BAAA;AAAA,EACR,MAAA,EAAQC,2BAAA;AAAA,EACR,YAAA,EAAcC,iCAAA;AAAA,EACd,OAAA,EAASC;AACX;;;;"}

package/dist/index.cjs.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var service = require('./service.cjs.js');
+var DefaultConnectionService = require('./api/DefaultConnectionService.cjs.js');
+var declareConnection = require('./api/declareConnection.cjs.js');
+var types = require('./definitions/types.cjs.js');
+
+
+
+exports.connectionsServiceFactory = service.connectionsServiceFactory;
+exports.connectionsServiceRef = service.connectionsServiceRef;
+exports.DefaultConnectionsService = DefaultConnectionService.DefaultConnectionsService;
+exports.declareConnection = declareConnection.declareConnection;
+exports.connectionTypes = types.connectionTypes;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}