@backstage/plugin-techdocs-node 1.6.1-next.0 → 1.6.1-next.2
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 +26 -0
- package/dist/index.d.ts +20 -20
- package/package.json +5 -5
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,31 @@
|
|
|
1
1
|
# @backstage/plugin-techdocs-node
|
|
2
2
|
|
|
3
|
+
## 1.6.1-next.2
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies
|
|
8
|
+
- @backstage/backend-common@0.18.4-next.2
|
|
9
|
+
- @backstage/catalog-model@1.2.1
|
|
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.1
|
|
17
|
+
|
|
18
|
+
### Patch Changes
|
|
19
|
+
|
|
20
|
+
- Updated dependencies
|
|
21
|
+
- @backstage/integration@1.4.4-next.0
|
|
22
|
+
- @backstage/backend-common@0.18.4-next.1
|
|
23
|
+
- @backstage/catalog-model@1.2.1
|
|
24
|
+
- @backstage/config@1.0.7
|
|
25
|
+
- @backstage/errors@1.1.5
|
|
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.0
|
|
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
|
-
|
|
15
|
+
type ETag = string;
|
|
16
16
|
/**
|
|
17
17
|
* Options for building preparers
|
|
18
18
|
* @public
|
|
19
19
|
*/
|
|
20
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
80
|
+
type RemoteProtocol = 'url' | 'dir';
|
|
81
81
|
|
|
82
82
|
/**
|
|
83
83
|
* Parsed location annotation
|
|
84
84
|
* @public
|
|
85
85
|
*/
|
|
86
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
352
|
+
type PublisherType = 'local' | 'googleGcs' | 'awsS3' | 'azureBlobStorage' | 'openStackSwift';
|
|
353
353
|
/**
|
|
354
354
|
* Request publish definition
|
|
355
355
|
* @public
|
|
356
356
|
*/
|
|
357
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
4
|
+
"version": "1.6.1-next.2",
|
|
5
5
|
"main": "dist/index.cjs.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
7
7
|
"publishConfig": {
|
|
@@ -46,13 +46,13 @@
|
|
|
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.
|
|
49
|
+
"@backstage/backend-common": "^0.18.4-next.2",
|
|
50
50
|
"@backstage/catalog-model": "^1.2.1",
|
|
51
51
|
"@backstage/config": "^1.0.7",
|
|
52
52
|
"@backstage/errors": "^1.1.5",
|
|
53
|
-
"@backstage/integration": "^1.4.
|
|
53
|
+
"@backstage/integration": "^1.4.4-next.0",
|
|
54
54
|
"@backstage/integration-aws-node": "^0.1.2",
|
|
55
|
-
"@backstage/plugin-search-common": "^1.2.
|
|
55
|
+
"@backstage/plugin-search-common": "^1.2.3-next.0",
|
|
56
56
|
"@google-cloud/storage": "^6.0.0",
|
|
57
57
|
"@trendyol-js/openstack-swift-sdk": "^0.0.6",
|
|
58
58
|
"@types/express": "^4.17.6",
|
|
@@ -69,7 +69,7 @@
|
|
|
69
69
|
"winston": "^3.2.1"
|
|
70
70
|
},
|
|
71
71
|
"devDependencies": {
|
|
72
|
-
"@backstage/cli": "^0.22.6-next.
|
|
72
|
+
"@backstage/cli": "^0.22.6-next.2",
|
|
73
73
|
"@types/fs-extra": "^9.0.5",
|
|
74
74
|
"@types/js-yaml": "^4.0.0",
|
|
75
75
|
"@types/mime-types": "^2.1.0",
|