@backstage/plugin-techdocs-node 1.6.1-next.1 → 1.6.1-next.3

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,31 @@
1
1
  # @backstage/plugin-techdocs-node
2
2
 
3
+ ## 1.6.1-next.3
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies
8
+ - @backstage/catalog-model@1.3.0-next.0
9
+ - @backstage/backend-common@0.18.4-next.2
10
+ - @backstage/config@1.0.7
11
+ - @backstage/errors@1.1.5
12
+ - @backstage/integration@1.4.4-next.0
13
+ - @backstage/integration-aws-node@0.1.2
14
+ - @backstage/plugin-search-common@1.2.3-next.0
15
+
16
+ ## 1.6.1-next.2
17
+
18
+ ### Patch Changes
19
+
20
+ - Updated dependencies
21
+ - @backstage/backend-common@0.18.4-next.2
22
+ - @backstage/catalog-model@1.2.1
23
+ - @backstage/config@1.0.7
24
+ - @backstage/errors@1.1.5
25
+ - @backstage/integration@1.4.4-next.0
26
+ - @backstage/integration-aws-node@0.1.2
27
+ - @backstage/plugin-search-common@1.2.3-next.0
28
+
3
29
  ## 1.6.1-next.1
4
30
 
5
31
  ### Patch Changes
package/dist/index.d.ts CHANGED
@@ -12,12 +12,12 @@ import { Writable } from 'stream';
12
12
  * A unique identifier of the tree blob, usually the commit SHA or etag from the target.
13
13
  * @public
14
14
  */
15
- declare type ETag = string;
15
+ type ETag = string;
16
16
  /**
17
17
  * Options for building preparers
18
18
  * @public
19
19
  */
20
- declare type PreparerConfig = {
20
+ type PreparerConfig = {
21
21
  logger: Logger;
22
22
  reader: UrlReader;
23
23
  };
@@ -25,7 +25,7 @@ declare type PreparerConfig = {
25
25
  * Options for configuring the content preparation process.
26
26
  * @public
27
27
  */
28
- declare type PreparerOptions = {
28
+ type PreparerOptions = {
29
29
  /**
30
30
  * An instance of the logger
31
31
  */
@@ -39,7 +39,7 @@ declare type PreparerOptions = {
39
39
  * Result of the preparation step.
40
40
  * @public
41
41
  */
42
- declare type PreparerResponse = {
42
+ type PreparerResponse = {
43
43
  /**
44
44
  * The path to directory where the tree is downloaded.
45
45
  */
@@ -53,7 +53,7 @@ declare type PreparerResponse = {
53
53
  * Definition of a TechDocs preparer
54
54
  * @public
55
55
  */
56
- declare type PreparerBase = {
56
+ type PreparerBase = {
57
57
  /**
58
58
  * Given an Entity definition from the Software Catalog, go and prepare a directory
59
59
  * with contents from the location in temporary storage and return the path.
@@ -69,7 +69,7 @@ declare type PreparerBase = {
69
69
  * Definition for a TechDocs preparer builder
70
70
  * @public
71
71
  */
72
- declare type PreparerBuilder = {
72
+ type PreparerBuilder = {
73
73
  register(protocol: RemoteProtocol, preparer: PreparerBase): void;
74
74
  get(entity: Entity): PreparerBase;
75
75
  };
@@ -77,13 +77,13 @@ declare type PreparerBuilder = {
77
77
  * Location where documentation files are stored
78
78
  * @public
79
79
  */
80
- declare type RemoteProtocol = 'url' | 'dir';
80
+ type RemoteProtocol = 'url' | 'dir';
81
81
 
82
82
  /**
83
83
  * Parsed location annotation
84
84
  * @public
85
85
  */
86
- declare type ParsedLocationAnnotation = {
86
+ type ParsedLocationAnnotation = {
87
87
  type: RemoteProtocol;
88
88
  target: string;
89
89
  };
@@ -135,7 +135,7 @@ declare const getDocFilesFromRepository: (reader: UrlReader, entity: Entity, opt
135
135
  * Options for building generators
136
136
  * @public
137
137
  */
138
- declare type GeneratorOptions = {
138
+ type GeneratorOptions = {
139
139
  containerRunner?: ContainerRunner;
140
140
  logger: Logger;
141
141
  };
@@ -151,7 +151,7 @@ declare type GeneratorOptions = {
151
151
  * @param logStream - A log stream that can send raw log messages to the caller to be displayed outside of the backend.
152
152
  * @param siteOptions - Options for the site: The `name` property will be used in mkdocs.yml config for the required `site_name` property, default value is "Documentation Site"
153
153
  */
154
- declare type GeneratorRunOptions = {
154
+ type GeneratorRunOptions = {
155
155
  inputDir: string;
156
156
  outputDir: string;
157
157
  parsedLocationAnnotation?: ParsedLocationAnnotation;
@@ -166,7 +166,7 @@ declare type GeneratorRunOptions = {
166
166
  * Generates documentation files
167
167
  * @public
168
168
  */
169
- declare type GeneratorBase = {
169
+ type GeneratorBase = {
170
170
  /**
171
171
  * Runs the generator with the values
172
172
  * @public
@@ -177,12 +177,12 @@ declare type GeneratorBase = {
177
177
  * List of supported generator options
178
178
  * @public
179
179
  */
180
- declare type SupportedGeneratorKey = 'techdocs' | string;
180
+ type SupportedGeneratorKey = 'techdocs' | string;
181
181
  /**
182
182
  * The generator builder holds the generator ready for run time
183
183
  * @public
184
184
  */
185
- declare type GeneratorBuilder = {
185
+ type GeneratorBuilder = {
186
186
  register(protocol: SupportedGeneratorKey, generator: GeneratorBase): void;
187
187
  get(entity: Entity): GeneratorBase;
188
188
  };
@@ -341,7 +341,7 @@ declare class Preparers implements PreparerBuilder {
341
341
  * Options for building publishers
342
342
  * @public
343
343
  */
344
- declare type PublisherFactory = {
344
+ type PublisherFactory = {
345
345
  logger: Logger;
346
346
  discovery: PluginEndpointDiscovery;
347
347
  };
@@ -349,12 +349,12 @@ declare type PublisherFactory = {
349
349
  * Key for all the different types of TechDocs publishers that are supported.
350
350
  * @public
351
351
  */
352
- declare type PublisherType = 'local' | 'googleGcs' | 'awsS3' | 'azureBlobStorage' | 'openStackSwift';
352
+ type PublisherType = 'local' | 'googleGcs' | 'awsS3' | 'azureBlobStorage' | 'openStackSwift';
353
353
  /**
354
354
  * Request publish definition
355
355
  * @public
356
356
  */
357
- declare type PublishRequest = {
357
+ type PublishRequest = {
358
358
  entity: Entity;
359
359
  directory: string;
360
360
  };
@@ -363,7 +363,7 @@ declare type PublishRequest = {
363
363
  * have been published or updated.
364
364
  * @public
365
365
  */
366
- declare type PublishResponse = {
366
+ type PublishResponse = {
367
367
  /**
368
368
  * The URL which serves files from the local publisher's static directory.
369
369
  */
@@ -379,7 +379,7 @@ declare type PublishResponse = {
379
379
  * Result for the validation check.
380
380
  * @public
381
381
  */
382
- declare type ReadinessResponse = {
382
+ type ReadinessResponse = {
383
383
  /** If true, the publisher is able to interact with the backing storage. */
384
384
  isAvailable: boolean;
385
385
  };
@@ -388,7 +388,7 @@ declare type ReadinessResponse = {
388
388
  * @param etag - ETag of the resource used to generate the site. Usually the latest commit sha of the source repository.
389
389
  * @public
390
390
  */
391
- declare type TechDocsMetadata = {
391
+ type TechDocsMetadata = {
392
392
  site_name: string;
393
393
  site_description: string;
394
394
  etag: string;
@@ -399,7 +399,7 @@ declare type TechDocsMetadata = {
399
399
  * TechDocs entity triplet migration request
400
400
  * @public
401
401
  */
402
- declare type MigrateRequest = {
402
+ type MigrateRequest = {
403
403
  /**
404
404
  * Whether or not to remove the source file. Defaults to false (acting like a
405
405
  * copy instead of a move).
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@backstage/plugin-techdocs-node",
3
3
  "description": "Common node.js functionalities for TechDocs, to be shared between techdocs-backend plugin and techdocs-cli",
4
- "version": "1.6.1-next.1",
4
+ "version": "1.6.1-next.3",
5
5
  "main": "dist/index.cjs.js",
6
6
  "types": "dist/index.d.ts",
7
7
  "publishConfig": {
@@ -46,8 +46,8 @@
46
46
  "@aws-sdk/types": "^3.208.0",
47
47
  "@azure/identity": "^2.1.0",
48
48
  "@azure/storage-blob": "^12.5.0",
49
- "@backstage/backend-common": "^0.18.4-next.1",
50
- "@backstage/catalog-model": "^1.2.1",
49
+ "@backstage/backend-common": "^0.18.4-next.2",
50
+ "@backstage/catalog-model": "^1.3.0-next.0",
51
51
  "@backstage/config": "^1.0.7",
52
52
  "@backstage/errors": "^1.1.5",
53
53
  "@backstage/integration": "^1.4.4-next.0",
@@ -69,7 +69,7 @@
69
69
  "winston": "^3.2.1"
70
70
  },
71
71
  "devDependencies": {
72
- "@backstage/cli": "^0.22.6-next.1",
72
+ "@backstage/cli": "^0.22.6-next.3",
73
73
  "@types/fs-extra": "^9.0.5",
74
74
  "@types/js-yaml": "^4.0.0",
75
75
  "@types/mime-types": "^2.1.0",