@backstage/plugin-techdocs-node 1.12.7-next.0 → 1.12.8-next.1

package/dist/index.d.ts

@@ -207,7 +207,7 @@ declare class TechdocsGenerator implements GeneratorBase {
      * The default docker image (and version) used to generate content. Public
      * and static so that techdocs-node consumers can use the same version.
      */
-    static readonly defaultDockerImage = "spotify/techdocs:v1.2.3";
+    static readonly defaultDockerImage = "spotify/techdocs:v1.2.4";
     private readonly logger;
     private readonly containerRunner?;
     private readonly options;
@@ -362,6 +362,7 @@ declare class Preparers implements PreparerBuilder {
 type PublisherFactory = {
     logger: Logger;
     discovery: PluginEndpointDiscovery;
+    customPublisher?: PublisherBase | undefined;
 };
 /**
  * Key for all the different types of TechDocs publishers that are supported.
@@ -473,13 +474,24 @@ interface PublisherBase {
      */
     migrateDocsCase?(migrateRequest: MigrateRequest): Promise<void>;
 }
+/**
+ * Definition for a TechDocs publisher builder
+ * @public
+ */
+type PublisherBuilder = {
+    register(type: PublisherType, publisher: PublisherBase): void;
+    get(config: Config): PublisherBase;
+};
 
 /**
  * Factory class to create a TechDocs publisher based on defined publisher type in app config.
  * Uses `techdocs.publisher.type`.
  * @public
  */
-declare class Publisher {
+declare class Publisher implements PublisherBuilder {
+    private publishers;
+    register(type: PublisherType | 'techdocs', publisher: PublisherBase): void;
+    get(config: Config): PublisherBase;
     /**
      * Returns a instance of TechDocs publisher
      * @param config - A Backstage configuration
@@ -572,5 +584,19 @@ interface TechdocsPreparerExtensionPoint {
  * @public
  */
 declare const techdocsPreparerExtensionPoint: _backstage_backend_plugin_api.ExtensionPoint<TechdocsPreparerExtensionPoint>;
+/**
+ * Extension point type for configuring a custom Techdocs publisher
+ *
+ * @public
+ */
+interface TechdocsPublisherExtensionPoint {
+    registerPublisher(type: PublisherType, publisher: PublisherBase): void;
+}
+/**
+ * Extension point for configuring a custom Techdocs publisher
+ *
+ * @public
+ */
+declare const techdocsPublisherExtensionPoint: _backstage_backend_plugin_api.ExtensionPoint<TechdocsPublisherExtensionPoint>;
 
-export { DirectoryPreparer, type DocsBuildStrategy, type ETag, type GeneratorBase, type GeneratorBuilder, type GeneratorOptions, type GeneratorRunOptions, Generators, type MigrateRequest, type ParsedLocationAnnotation, type PreparerBase, type PreparerBuilder, type PreparerConfig, type PreparerOptions, type PreparerResponse, Preparers, type PublishRequest, type PublishResponse, Publisher, type PublisherBase, type PublisherFactory, type PublisherType, type ReadinessResponse, type RemoteProtocol, type SupportedGeneratorKey, type TechDocsDocument, type TechDocsMetadata, type TechdocsBuildsExtensionPoint, TechdocsGenerator, type TechdocsGeneratorExtensionPoint, type TechdocsPreparerExtensionPoint, UrlPreparer, getDocFilesFromRepository, getLocationForEntity, getMkDocsYml, getMkdocsYml, parseReferenceAnnotation, techdocsBuildsExtensionPoint, techdocsGeneratorExtensionPoint, techdocsPreparerExtensionPoint, transformDirLocation };
+export { DirectoryPreparer, type DocsBuildStrategy, type ETag, type GeneratorBase, type GeneratorBuilder, type GeneratorOptions, type GeneratorRunOptions, Generators, type MigrateRequest, type ParsedLocationAnnotation, type PreparerBase, type PreparerBuilder, type PreparerConfig, type PreparerOptions, type PreparerResponse, Preparers, type PublishRequest, type PublishResponse, Publisher, type PublisherBase, type PublisherBuilder, type PublisherFactory, type PublisherType, type ReadinessResponse, type RemoteProtocol, type SupportedGeneratorKey, type TechDocsDocument, type TechDocsMetadata, type TechdocsBuildsExtensionPoint, TechdocsGenerator, type TechdocsGeneratorExtensionPoint, type TechdocsPreparerExtensionPoint, type TechdocsPublisherExtensionPoint, UrlPreparer, getDocFilesFromRepository, getLocationForEntity, getMkDocsYml, getMkdocsYml, parseReferenceAnnotation, techdocsBuildsExtensionPoint, techdocsGeneratorExtensionPoint, techdocsPreparerExtensionPoint, techdocsPublisherExtensionPoint, transformDirLocation };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-techdocs-node",
-  "version": "1.12.7-next.0",
+  "version": "1.12.8-next.1",
   "description": "Common node.js functionalities for TechDocs, to be shared between techdocs-backend plugin and techdocs-cli",
   "backstage": {
     "role": "node-library",
@@ -52,8 +52,8 @@
     "@aws-sdk/types": "^3.347.0",
     "@azure/identity": "^4.0.0",
     "@azure/storage-blob": "^12.5.0",
-    "@backstage/backend-common": "^0.23.2-next.0",
-    "@backstage/backend-plugin-api": "^0.6.21-next.0",
+    "@backstage/backend-common": "^0.23.3-next.1",
+    "@backstage/backend-plugin-api": "^0.6.22-next.1",
     "@backstage/catalog-model": "^1.5.0",
     "@backstage/config": "^1.2.0",
     "@backstage/errors": "^1.2.4",
@@ -77,8 +77,8 @@
     "winston": "^3.2.1"
   },
   "devDependencies": {
-    "@backstage/backend-test-utils": "^0.4.3-next.0",
-    "@backstage/cli": "^0.26.10-next.0",
+    "@backstage/backend-test-utils": "^0.4.4-next.1",
+    "@backstage/cli": "^0.26.11-next.1",
     "@types/fs-extra": "^11.0.0",
     "@types/js-yaml": "^4.0.0",
     "@types/mime-types": "^2.1.0",