@axis-backstage/plugin-readme-backend 0.10.1 → 0.12.0
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 +13 -0
- package/README.md +0 -39
- package/dist/index.cjs.js +2 -163
- package/dist/index.cjs.js.map +1 -1
- package/dist/index.d.ts +2 -43
- package/dist/lib.cjs.js +14 -0
- package/dist/lib.cjs.js.map +1 -0
- package/dist/plugin.cjs.js +44 -0
- package/dist/plugin.cjs.js.map +1 -0
- package/dist/service/constants.cjs.js +14 -0
- package/dist/service/constants.cjs.js.map +1 -0
- package/dist/service/router.cjs.js +117 -0
- package/dist/service/router.cjs.js.map +1 -0
- package/package.json +20 -11
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# @axis-backstage/plugin-readme-backend
|
|
2
2
|
|
|
3
|
+
## 0.12.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- ede8341: Updated to Backstage v1.36.1.
|
|
8
|
+
|
|
9
|
+
## 0.11.0
|
|
10
|
+
|
|
11
|
+
### Minor Changes
|
|
12
|
+
|
|
13
|
+
- 6939770: **BREAKING**: The `readme-backend` has been migrated to the new backend system. If
|
|
14
|
+
you are using the new backend system module, this does not affect you.
|
|
15
|
+
|
|
3
16
|
## 0.10.1
|
|
4
17
|
|
|
5
18
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -21,45 +21,6 @@ yarn --cwd packages/backend add @axis-backstage/plugin-readme-backend
|
|
|
21
21
|
|
|
22
22
|
Here's how to get the backend plugin up and running:
|
|
23
23
|
|
|
24
|
-
1. Create a new file named `packages/backend/src/plugins/readme.ts`, and add the following to it:
|
|
25
|
-
|
|
26
|
-
```ts
|
|
27
|
-
import { createRouter } from '@axis-backstage/plugin-readme-backend';
|
|
28
|
-
import { Router } from 'express';
|
|
29
|
-
import { PluginEnvironment } from '../types';
|
|
30
|
-
|
|
31
|
-
export default async function createPlugin(
|
|
32
|
-
env: PluginEnvironment,
|
|
33
|
-
): Promise<Router> {
|
|
34
|
-
return await createRouter({
|
|
35
|
-
logger: env.logger,
|
|
36
|
-
config: env.config,
|
|
37
|
-
reader: env.reader,
|
|
38
|
-
discovery: env.discovery,
|
|
39
|
-
tokenManager: env.tokenManager,
|
|
40
|
-
});
|
|
41
|
-
}
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
2. Wire this into the overall backend router by adding the following to `packages/backend/src/index.ts`:
|
|
45
|
-
|
|
46
|
-
```ts
|
|
47
|
-
import readme from './plugins/readme';
|
|
48
|
-
...
|
|
49
|
-
|
|
50
|
-
async function main() {
|
|
51
|
-
// Add this line under the other lines that follow the useHotMemoize pattern
|
|
52
|
-
const readmeEnv = useHotMemoize(module, () => createEnv('readme'),
|
|
53
|
-
|
|
54
|
-
// Add this under the lines that add their routers to apiRouter
|
|
55
|
-
apiRouter.use('/readme', await readme(readmeEnv));
|
|
56
|
-
}
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### New Backend System
|
|
60
|
-
|
|
61
|
-
The Readme backend plugin has support for the [new backend system](https://backstage.io/docs/backend-system/). Here is how you can set it up:
|
|
62
|
-
|
|
63
24
|
In your `packages/backend/src/index.ts` make the following changes:
|
|
64
25
|
|
|
65
26
|
```diff
|
package/dist/index.cjs.js
CHANGED
|
@@ -2,170 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
Object.defineProperty(exports, '__esModule', { value: true });
|
|
4
4
|
|
|
5
|
-
var
|
|
6
|
-
var cache = require('@backstage/backend-defaults/cache');
|
|
7
|
-
var backendCommon = require('@backstage/backend-common');
|
|
8
|
-
var integration = require('@backstage/integration');
|
|
9
|
-
var catalogModel = require('@backstage/catalog-model');
|
|
10
|
-
var catalogClient = require('@backstage/catalog-client');
|
|
11
|
-
var errors = require('@backstage/errors');
|
|
12
|
-
var express = require('express');
|
|
13
|
-
var Router = require('express-promise-router');
|
|
14
|
-
var backendPluginApi = require('@backstage/backend-plugin-api');
|
|
5
|
+
var plugin = require('./plugin.cjs.js');
|
|
15
6
|
|
|
16
|
-
function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
|
|
17
7
|
|
|
18
|
-
var express__default = /*#__PURE__*/_interopDefaultCompat(express);
|
|
19
|
-
var Router__default = /*#__PURE__*/_interopDefaultCompat(Router);
|
|
20
8
|
|
|
21
|
-
|
|
22
|
-
const isSymLink = (content) => {
|
|
23
|
-
const lines = content.split("\n");
|
|
24
|
-
if (lines.length > 1) return false;
|
|
25
|
-
const line = lines[0];
|
|
26
|
-
if (line.includes(" ")) return false;
|
|
27
|
-
const regex = RegExp(DETECT_SYMLINKS_REGEX);
|
|
28
|
-
return regex.test(content);
|
|
29
|
-
};
|
|
30
|
-
|
|
31
|
-
const NOT_FOUND_PLACEHOLDER = "NOT_FOUND";
|
|
32
|
-
const DEFAULT_TTL = 1800 * 1e3;
|
|
33
|
-
const README_TYPES = [
|
|
34
|
-
{ name: "README", type: "text/plain" },
|
|
35
|
-
{ name: "README.md", type: "text/markdown" },
|
|
36
|
-
{ name: "README.rst", type: "text/plain" },
|
|
37
|
-
{ name: "README.txt", type: "text/plain" },
|
|
38
|
-
{ name: "README.MD", type: "text/markdown" }
|
|
39
|
-
];
|
|
40
|
-
|
|
41
|
-
async function createRouter(options) {
|
|
42
|
-
const { logger, config, reader, discovery } = options;
|
|
43
|
-
const { auth } = backendCommon.createLegacyAuthAdapters(options);
|
|
44
|
-
const catalogClient$1 = new catalogClient.CatalogClient({ discoveryApi: discovery });
|
|
45
|
-
const pluginCache = cache.CacheManager.fromConfig(config).forPlugin("readme");
|
|
46
|
-
const cache$1 = pluginCache.getClient({ defaultTtl: DEFAULT_TTL });
|
|
47
|
-
logger.info("Initializing readme backend");
|
|
48
|
-
const integrations = integration.ScmIntegrations.fromConfig(config);
|
|
49
|
-
const router = Router__default.default();
|
|
50
|
-
router.use(express__default.default.json());
|
|
51
|
-
router.get("/health", (_, response) => {
|
|
52
|
-
response.json({ status: "ok" });
|
|
53
|
-
});
|
|
54
|
-
router.get("/:kind/:namespace/:name", async (request, response) => {
|
|
55
|
-
const { kind, namespace, name } = request.params;
|
|
56
|
-
const entityRef = catalogModel.stringifyEntityRef({ kind, namespace, name });
|
|
57
|
-
const cacheDoc = await cache$1.get(entityRef);
|
|
58
|
-
if (cacheDoc && cacheDoc.name === NOT_FOUND_PLACEHOLDER) {
|
|
59
|
-
throw new errors.NotFoundError("Readme could not be found");
|
|
60
|
-
}
|
|
61
|
-
if (cacheDoc) {
|
|
62
|
-
logger.info(`Loading README for ${entityRef} from cache.`);
|
|
63
|
-
response.type(cacheDoc.type);
|
|
64
|
-
response.send(cacheDoc.content);
|
|
65
|
-
return;
|
|
66
|
-
}
|
|
67
|
-
const { token } = await auth.getPluginRequestToken({
|
|
68
|
-
onBehalfOf: await auth.getOwnServiceCredentials(),
|
|
69
|
-
targetPluginId: "catalog"
|
|
70
|
-
});
|
|
71
|
-
const entity = await catalogClient$1.getEntityByRef(entityRef, { token });
|
|
72
|
-
if (!entity) {
|
|
73
|
-
logger.info(`No integration found for ${entityRef}`);
|
|
74
|
-
response.status(500).json({ error: `No integration found for ${entityRef}` });
|
|
75
|
-
return;
|
|
76
|
-
}
|
|
77
|
-
const source = catalogModel.getEntitySourceLocation(entity);
|
|
78
|
-
if (!source || source.type !== "url") {
|
|
79
|
-
const errorMessage = `Not valid location for ${source.target}`;
|
|
80
|
-
logger.info(errorMessage);
|
|
81
|
-
throw new errors.NotFoundError(errorMessage);
|
|
82
|
-
}
|
|
83
|
-
const integration = integrations.byUrl(source.target);
|
|
84
|
-
if (!integration) {
|
|
85
|
-
logger.info(`No integration found for ${source.target}`);
|
|
86
|
-
response.status(500).json({ error: `No integration found for ${source.target}` });
|
|
87
|
-
return;
|
|
88
|
-
}
|
|
89
|
-
for (const fileType of README_TYPES) {
|
|
90
|
-
const url = integration.resolveUrl({
|
|
91
|
-
url: fileType.name,
|
|
92
|
-
base: source.target
|
|
93
|
-
});
|
|
94
|
-
let content;
|
|
95
|
-
try {
|
|
96
|
-
logger.debug(`Trying README location: ${url} for ${entityRef} `);
|
|
97
|
-
response.type(fileType.type);
|
|
98
|
-
const urlResponse = await reader.readUrl(url);
|
|
99
|
-
content = (await urlResponse.buffer()).toString("utf-8");
|
|
100
|
-
if (isSymLink(content)) {
|
|
101
|
-
const symLinkUrl = integration.resolveUrl({
|
|
102
|
-
url: content,
|
|
103
|
-
base: source.target
|
|
104
|
-
});
|
|
105
|
-
const symLinkUrlResponse = await reader.readUrl(symLinkUrl);
|
|
106
|
-
content = (await symLinkUrlResponse.buffer()).toString("utf-8");
|
|
107
|
-
}
|
|
108
|
-
cache$1.set(entityRef, {
|
|
109
|
-
name: fileType.name,
|
|
110
|
-
type: fileType.type,
|
|
111
|
-
content
|
|
112
|
-
});
|
|
113
|
-
logger.info(
|
|
114
|
-
`Found README for ${entityRef}: ${url} type ${fileType.type}`
|
|
115
|
-
);
|
|
116
|
-
response.send(content);
|
|
117
|
-
return;
|
|
118
|
-
} catch (error) {
|
|
119
|
-
if (errors.isError(error) && error.name === "NotFoundError") {
|
|
120
|
-
continue;
|
|
121
|
-
} else {
|
|
122
|
-
response.status(500).json({
|
|
123
|
-
error: `Readme failure: ${error}`
|
|
124
|
-
});
|
|
125
|
-
return;
|
|
126
|
-
}
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
logger.info(`Readme not found for ${entityRef}`);
|
|
130
|
-
cache$1.set(entityRef, {
|
|
131
|
-
name: NOT_FOUND_PLACEHOLDER,
|
|
132
|
-
type: "",
|
|
133
|
-
content: ""
|
|
134
|
-
});
|
|
135
|
-
throw new errors.NotFoundError("Readme could not be found");
|
|
136
|
-
});
|
|
137
|
-
const middleware = rootHttpRouter.MiddlewareFactory.create({ logger, config });
|
|
138
|
-
router.use(middleware.error());
|
|
139
|
-
return router;
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
const readmePlugin = backendPluginApi.createBackendPlugin({
|
|
143
|
-
pluginId: "readme",
|
|
144
|
-
register(env) {
|
|
145
|
-
env.registerInit({
|
|
146
|
-
deps: {
|
|
147
|
-
logger: backendPluginApi.coreServices.logger,
|
|
148
|
-
config: backendPluginApi.coreServices.rootConfig,
|
|
149
|
-
reader: backendPluginApi.coreServices.urlReader,
|
|
150
|
-
discovery: backendPluginApi.coreServices.discovery,
|
|
151
|
-
auth: backendPluginApi.coreServices.auth,
|
|
152
|
-
httpRouter: backendPluginApi.coreServices.httpRouter
|
|
153
|
-
},
|
|
154
|
-
async init({ auth, logger, config, reader, discovery, httpRouter }) {
|
|
155
|
-
httpRouter.use(
|
|
156
|
-
await createRouter({
|
|
157
|
-
auth,
|
|
158
|
-
logger,
|
|
159
|
-
config,
|
|
160
|
-
reader,
|
|
161
|
-
discovery
|
|
162
|
-
})
|
|
163
|
-
);
|
|
164
|
-
}
|
|
165
|
-
});
|
|
166
|
-
}
|
|
167
|
-
});
|
|
168
|
-
|
|
169
|
-
exports.createRouter = createRouter;
|
|
170
|
-
exports.default = readmePlugin;
|
|
9
|
+
exports.default = plugin.readmePlugin;
|
|
171
10
|
//# sourceMappingURL=index.cjs.js.map
|
package/dist/index.cjs.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs.js","sources":["../src/lib.ts","../src/service/constants.ts","../src/service/router.ts","../src/plugin.ts"],"sourcesContent":["const DETECT_SYMLINKS_REGEX = '^(w+|.|/|-)+$';\n\nexport const isSymLink = (content: string): boolean => {\n const lines = content.split('\\n');\n if (lines.length > 1) return false;\n const line = lines[0];\n if (line.includes(' ')) return false;\n\n const regex = RegExp(DETECT_SYMLINKS_REGEX);\n return regex.test(content);\n};\n","import { FileType } from './types';\n\n// Cache placeholder for entities where no readme\nexport const NOT_FOUND_PLACEHOLDER = 'NOT_FOUND';\nexport const DEFAULT_TTL = 1800 * 1000;\n\nexport const README_TYPES: FileType[] = [\n { name: 'README', type: 'text/plain' },\n { name: 'README.md', type: 'text/markdown' },\n { name: 'README.rst', type: 'text/plain' },\n { name: 'README.txt', type: 'text/plain' },\n { name: 'README.MD', type: 'text/markdown' },\n];\n","import { MiddlewareFactory } from '@backstage/backend-defaults/rootHttpRouter';\nimport { CacheManager } from '@backstage/backend-defaults/cache';\nimport {\n AuthService,\n DiscoveryService,\n LoggerService,\n RootConfigService,\n UrlReaderService,\n TokenManagerService,\n} from '@backstage/backend-plugin-api';\nimport { createLegacyAuthAdapters } from '@backstage/backend-common';\nimport { ScmIntegrations } from '@backstage/integration';\nimport {\n getEntitySourceLocation,\n stringifyEntityRef,\n} from '@backstage/catalog-model';\nimport { CatalogClient } from '@backstage/catalog-client';\nimport { isError, NotFoundError } from '@backstage/errors';\nimport express from 'express';\nimport Router from 'express-promise-router';\nimport { isSymLink } from '../lib';\nimport { DEFAULT_TTL, NOT_FOUND_PLACEHOLDER, README_TYPES } from './constants';\nimport { ReadmeFile } from './types';\n\n/**\n * Constructs a readme router.\n * @deprecated Please migrate to the new backend system as this will be removed in the future.\n * @public\n */\nexport interface RouterOptions {\n /**\n * Implementation of Winston logger\n */\n logger: LoggerService;\n\n /**\n * Backstage config object\n */\n config: RootConfigService;\n\n /**\n * Backstage url reader instance\n */\n reader: UrlReaderService;\n /**\n * Backstage discovery service\n */\n discovery: DiscoveryService;\n /**\n * Backstage token manager service\n */\n tokenManager?: TokenManagerService;\n /**\n * Backstage auth service\n */\n auth?: AuthService;\n}\n\n/**\n * Constructs a readme router.\n *\n * @deprecated Please migrate to the new backend system as this will be removed in the future.\n * @public\n */\nexport async function createRouter(\n options: RouterOptions,\n): Promise<express.Router> {\n const { logger, config, reader, discovery } = options;\n const { auth } = createLegacyAuthAdapters(options);\n const catalogClient = new CatalogClient({ discoveryApi: discovery });\n\n const pluginCache = CacheManager.fromConfig(config).forPlugin('readme');\n const cache = pluginCache.getClient({ defaultTtl: DEFAULT_TTL });\n\n logger.info('Initializing readme backend');\n const integrations = ScmIntegrations.fromConfig(config);\n const router = Router();\n router.use(express.json());\n\n router.get('/health', (_, response) => {\n response.json({ status: 'ok' });\n });\n\n router.get('/:kind/:namespace/:name', async (request, response) => {\n const { kind, namespace, name } = request.params;\n const entityRef = stringifyEntityRef({ kind, namespace, name });\n const cacheDoc = (await cache.get(entityRef)) as ReadmeFile | undefined;\n\n if (cacheDoc && cacheDoc.name === NOT_FOUND_PLACEHOLDER) {\n throw new NotFoundError('Readme could not be found');\n }\n if (cacheDoc) {\n logger.info(`Loading README for ${entityRef} from cache.`);\n response.type(cacheDoc.type);\n response.send(cacheDoc.content);\n return;\n }\n const { token } = await auth.getPluginRequestToken({\n onBehalfOf: await auth.getOwnServiceCredentials(),\n targetPluginId: 'catalog',\n });\n const entity = await catalogClient.getEntityByRef(entityRef, { token });\n if (!entity) {\n logger.info(`No integration found for ${entityRef}`);\n response\n .status(500)\n .json({ error: `No integration found for ${entityRef}` });\n return;\n }\n const source = getEntitySourceLocation(entity);\n\n if (!source || source.type !== 'url') {\n const errorMessage = `Not valid location for ${source.target}`;\n logger.info(errorMessage);\n throw new NotFoundError(errorMessage);\n }\n const integration = integrations.byUrl(source.target);\n\n if (!integration) {\n logger.info(`No integration found for ${source.target}`);\n response\n .status(500)\n .json({ error: `No integration found for ${source.target}` });\n return;\n }\n\n for (const fileType of README_TYPES) {\n const url = integration.resolveUrl({\n url: fileType.name,\n base: source.target,\n });\n\n let content;\n\n try {\n logger.debug(`Trying README location: ${url} for ${entityRef} `);\n response.type(fileType.type);\n\n const urlResponse = await reader.readUrl(url);\n content = (await urlResponse.buffer()).toString('utf-8');\n\n if (isSymLink(content)) {\n const symLinkUrl = integration.resolveUrl({\n url: content,\n base: source.target,\n });\n const symLinkUrlResponse = await reader.readUrl(symLinkUrl);\n content = (await symLinkUrlResponse.buffer()).toString('utf-8');\n }\n\n cache.set(entityRef, {\n name: fileType.name,\n type: fileType.type,\n content: content,\n });\n logger.info(\n `Found README for ${entityRef}: ${url} type ${fileType.type}`,\n );\n response.send(content);\n return;\n } catch (error: unknown) {\n if (isError(error) && error.name === 'NotFoundError') {\n continue;\n } else {\n response.status(500).json({\n error: `Readme failure: ${error}`,\n });\n return;\n }\n }\n }\n logger.info(`Readme not found for ${entityRef}`);\n cache.set(entityRef, {\n name: NOT_FOUND_PLACEHOLDER,\n type: '',\n content: '',\n });\n throw new NotFoundError('Readme could not be found');\n });\n\n const middleware = MiddlewareFactory.create({ logger, config });\n router.use(middleware.error());\n return router;\n}\n","import {\n coreServices,\n createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\n\n/**\n * The Readme backend plugin.\n *\n * @public\n */\nexport const readmePlugin = createBackendPlugin({\n pluginId: 'readme',\n register(env) {\n env.registerInit({\n deps: {\n logger: coreServices.logger,\n config: coreServices.rootConfig,\n reader: coreServices.urlReader,\n discovery: coreServices.discovery,\n auth: coreServices.auth,\n httpRouter: coreServices.httpRouter,\n },\n async init({ auth, logger, config, reader, discovery, httpRouter }) {\n httpRouter.use(\n await createRouter({\n auth,\n logger,\n config,\n reader,\n discovery,\n }),\n );\n },\n });\n },\n});\n"],"names":["createLegacyAuthAdapters","catalogClient","CatalogClient","CacheManager","cache","ScmIntegrations","Router","express","stringifyEntityRef","NotFoundError","getEntitySourceLocation","isError","MiddlewareFactory","createBackendPlugin","coreServices"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,51 +1,10 @@
|
|
|
1
1
|
import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
|
|
2
|
-
import { LoggerService, RootConfigService, UrlReaderService, DiscoveryService, TokenManagerService, AuthService } from '@backstage/backend-plugin-api';
|
|
3
|
-
import express from 'express';
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* Constructs a readme router.
|
|
7
|
-
* @deprecated Please migrate to the new backend system as this will be removed in the future.
|
|
8
|
-
* @public
|
|
9
|
-
*/
|
|
10
|
-
interface RouterOptions {
|
|
11
|
-
/**
|
|
12
|
-
* Implementation of Winston logger
|
|
13
|
-
*/
|
|
14
|
-
logger: LoggerService;
|
|
15
|
-
/**
|
|
16
|
-
* Backstage config object
|
|
17
|
-
*/
|
|
18
|
-
config: RootConfigService;
|
|
19
|
-
/**
|
|
20
|
-
* Backstage url reader instance
|
|
21
|
-
*/
|
|
22
|
-
reader: UrlReaderService;
|
|
23
|
-
/**
|
|
24
|
-
* Backstage discovery service
|
|
25
|
-
*/
|
|
26
|
-
discovery: DiscoveryService;
|
|
27
|
-
/**
|
|
28
|
-
* Backstage token manager service
|
|
29
|
-
*/
|
|
30
|
-
tokenManager?: TokenManagerService;
|
|
31
|
-
/**
|
|
32
|
-
* Backstage auth service
|
|
33
|
-
*/
|
|
34
|
-
auth?: AuthService;
|
|
35
|
-
}
|
|
36
|
-
/**
|
|
37
|
-
* Constructs a readme router.
|
|
38
|
-
*
|
|
39
|
-
* @deprecated Please migrate to the new backend system as this will be removed in the future.
|
|
40
|
-
* @public
|
|
41
|
-
*/
|
|
42
|
-
declare function createRouter(options: RouterOptions): Promise<express.Router>;
|
|
43
2
|
|
|
44
3
|
/**
|
|
45
4
|
* The Readme backend plugin.
|
|
46
5
|
*
|
|
47
6
|
* @public
|
|
48
7
|
*/
|
|
49
|
-
declare const readmePlugin: _backstage_backend_plugin_api.
|
|
8
|
+
declare const readmePlugin: _backstage_backend_plugin_api.BackendFeature;
|
|
50
9
|
|
|
51
|
-
export {
|
|
10
|
+
export { readmePlugin as default };
|
package/dist/lib.cjs.js
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
const DETECT_SYMLINKS_REGEX = "^(w+|.|/|-)+$";
|
|
4
|
+
const isSymLink = (content) => {
|
|
5
|
+
const lines = content.split("\n");
|
|
6
|
+
if (lines.length > 1) return false;
|
|
7
|
+
const line = lines[0];
|
|
8
|
+
if (line.includes(" ")) return false;
|
|
9
|
+
const regex = RegExp(DETECT_SYMLINKS_REGEX);
|
|
10
|
+
return regex.test(content);
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
exports.isSymLink = isSymLink;
|
|
14
|
+
//# sourceMappingURL=lib.cjs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lib.cjs.js","sources":["../src/lib.ts"],"sourcesContent":["const DETECT_SYMLINKS_REGEX = '^(w+|.|/|-)+$';\n\nexport const isSymLink = (content: string): boolean => {\n const lines = content.split('\\n');\n if (lines.length > 1) return false;\n const line = lines[0];\n if (line.includes(' ')) return false;\n\n const regex = RegExp(DETECT_SYMLINKS_REGEX);\n return regex.test(content);\n};\n"],"names":[],"mappings":";;AAAA,MAAM,qBAAwB,GAAA,eAAA;AAEjB,MAAA,SAAA,GAAY,CAAC,OAA6B,KAAA;AACrD,EAAM,MAAA,KAAA,GAAQ,OAAQ,CAAA,KAAA,CAAM,IAAI,CAAA;AAChC,EAAI,IAAA,KAAA,CAAM,MAAS,GAAA,CAAA,EAAU,OAAA,KAAA;AAC7B,EAAM,MAAA,IAAA,GAAO,MAAM,CAAC,CAAA;AACpB,EAAA,IAAI,IAAK,CAAA,QAAA,CAAS,GAAG,CAAA,EAAU,OAAA,KAAA;AAE/B,EAAM,MAAA,KAAA,GAAQ,OAAO,qBAAqB,CAAA;AAC1C,EAAO,OAAA,KAAA,CAAM,KAAK,OAAO,CAAA;AAC3B;;;;"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var backendPluginApi = require('@backstage/backend-plugin-api');
|
|
4
|
+
var router = require('./service/router.cjs.js');
|
|
5
|
+
|
|
6
|
+
const readmePlugin = backendPluginApi.createBackendPlugin({
|
|
7
|
+
pluginId: "readme",
|
|
8
|
+
register(env) {
|
|
9
|
+
env.registerInit({
|
|
10
|
+
deps: {
|
|
11
|
+
auth: backendPluginApi.coreServices.auth,
|
|
12
|
+
config: backendPluginApi.coreServices.rootConfig,
|
|
13
|
+
discovery: backendPluginApi.coreServices.discovery,
|
|
14
|
+
httpRouter: backendPluginApi.coreServices.httpRouter,
|
|
15
|
+
logger: backendPluginApi.coreServices.logger,
|
|
16
|
+
reader: backendPluginApi.coreServices.urlReader,
|
|
17
|
+
cache: backendPluginApi.coreServices.cache
|
|
18
|
+
},
|
|
19
|
+
async init({
|
|
20
|
+
auth,
|
|
21
|
+
logger,
|
|
22
|
+
config,
|
|
23
|
+
reader,
|
|
24
|
+
discovery,
|
|
25
|
+
httpRouter,
|
|
26
|
+
cache
|
|
27
|
+
}) {
|
|
28
|
+
httpRouter.use(
|
|
29
|
+
await router.createRouter({
|
|
30
|
+
auth,
|
|
31
|
+
logger,
|
|
32
|
+
config,
|
|
33
|
+
reader,
|
|
34
|
+
discovery,
|
|
35
|
+
cache
|
|
36
|
+
})
|
|
37
|
+
);
|
|
38
|
+
}
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
exports.readmePlugin = readmePlugin;
|
|
44
|
+
//# sourceMappingURL=plugin.cjs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["import {\n coreServices,\n createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\n\n/**\n * The Readme backend plugin.\n *\n * @public\n */\nexport const readmePlugin = createBackendPlugin({\n pluginId: 'readme',\n register(env) {\n env.registerInit({\n deps: {\n auth: coreServices.auth,\n config: coreServices.rootConfig,\n discovery: coreServices.discovery,\n httpRouter: coreServices.httpRouter,\n logger: coreServices.logger,\n reader: coreServices.urlReader,\n cache: coreServices.cache,\n },\n async init({\n auth,\n logger,\n config,\n reader,\n discovery,\n httpRouter,\n cache,\n }) {\n httpRouter.use(\n await createRouter({\n auth,\n logger,\n config,\n reader,\n discovery,\n cache,\n }),\n );\n },\n });\n },\n});\n"],"names":["createBackendPlugin","coreServices","createRouter"],"mappings":";;;;;AAWO,MAAM,eAAeA,oCAAoB,CAAA;AAAA,EAC9C,QAAU,EAAA,QAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,MAAMC,6BAAa,CAAA,IAAA;AAAA,QACnB,QAAQA,6BAAa,CAAA,UAAA;AAAA,QACrB,WAAWA,6BAAa,CAAA,SAAA;AAAA,QACxB,YAAYA,6BAAa,CAAA,UAAA;AAAA,QACzB,QAAQA,6BAAa,CAAA,MAAA;AAAA,QACrB,QAAQA,6BAAa,CAAA,SAAA;AAAA,QACrB,OAAOA,6BAAa,CAAA;AAAA,OACtB;AAAA,MACA,MAAM,IAAK,CAAA;AAAA,QACT,IAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,QACA,UAAA;AAAA,QACA;AAAA,OACC,EAAA;AACD,QAAW,UAAA,CAAA,GAAA;AAAA,UACT,MAAMC,mBAAa,CAAA;AAAA,YACjB,IAAA;AAAA,YACA,MAAA;AAAA,YACA,MAAA;AAAA,YACA,MAAA;AAAA,YACA,SAAA;AAAA,YACA;AAAA,WACD;AAAA,SACH;AAAA;AACF,KACD,CAAA;AAAA;AAEL,CAAC;;;;"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
const NOT_FOUND_PLACEHOLDER = "NOT_FOUND";
|
|
4
|
+
const README_TYPES = [
|
|
5
|
+
{ name: "README", type: "text/plain" },
|
|
6
|
+
{ name: "README.md", type: "text/markdown" },
|
|
7
|
+
{ name: "README.rst", type: "text/plain" },
|
|
8
|
+
{ name: "README.txt", type: "text/plain" },
|
|
9
|
+
{ name: "README.MD", type: "text/markdown" }
|
|
10
|
+
];
|
|
11
|
+
|
|
12
|
+
exports.NOT_FOUND_PLACEHOLDER = NOT_FOUND_PLACEHOLDER;
|
|
13
|
+
exports.README_TYPES = README_TYPES;
|
|
14
|
+
//# sourceMappingURL=constants.cjs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"constants.cjs.js","sources":["../../src/service/constants.ts"],"sourcesContent":["import { FileType } from './types';\n\n// Cache placeholder for entities where no readme\nexport const NOT_FOUND_PLACEHOLDER = 'NOT_FOUND';\n\nexport const README_TYPES: FileType[] = [\n { name: 'README', type: 'text/plain' },\n { name: 'README.md', type: 'text/markdown' },\n { name: 'README.rst', type: 'text/plain' },\n { name: 'README.txt', type: 'text/plain' },\n { name: 'README.MD', type: 'text/markdown' },\n];\n"],"names":[],"mappings":";;AAGO,MAAM,qBAAwB,GAAA;AAE9B,MAAM,YAA2B,GAAA;AAAA,EACtC,EAAE,IAAA,EAAM,QAAU,EAAA,IAAA,EAAM,YAAa,EAAA;AAAA,EACrC,EAAE,IAAA,EAAM,WAAa,EAAA,IAAA,EAAM,eAAgB,EAAA;AAAA,EAC3C,EAAE,IAAA,EAAM,YAAc,EAAA,IAAA,EAAM,YAAa,EAAA;AAAA,EACzC,EAAE,IAAA,EAAM,YAAc,EAAA,IAAA,EAAM,YAAa,EAAA;AAAA,EACzC,EAAE,IAAA,EAAM,WAAa,EAAA,IAAA,EAAM,eAAgB;AAC7C;;;;;"}
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var rootHttpRouter = require('@backstage/backend-defaults/rootHttpRouter');
|
|
4
|
+
var integration = require('@backstage/integration');
|
|
5
|
+
var catalogModel = require('@backstage/catalog-model');
|
|
6
|
+
var catalogClient = require('@backstage/catalog-client');
|
|
7
|
+
var errors = require('@backstage/errors');
|
|
8
|
+
var express = require('express');
|
|
9
|
+
var Router = require('express-promise-router');
|
|
10
|
+
var lib = require('../lib.cjs.js');
|
|
11
|
+
var constants = require('./constants.cjs.js');
|
|
12
|
+
|
|
13
|
+
function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
|
|
14
|
+
|
|
15
|
+
var express__default = /*#__PURE__*/_interopDefaultCompat(express);
|
|
16
|
+
var Router__default = /*#__PURE__*/_interopDefaultCompat(Router);
|
|
17
|
+
|
|
18
|
+
async function createRouter(options) {
|
|
19
|
+
const { auth, logger, config, reader, discovery, cache } = options;
|
|
20
|
+
const catalogClient$1 = new catalogClient.CatalogClient({ discoveryApi: discovery });
|
|
21
|
+
logger.info("Initializing readme backend");
|
|
22
|
+
const integrations = integration.ScmIntegrations.fromConfig(config);
|
|
23
|
+
const router = Router__default.default();
|
|
24
|
+
router.use(express__default.default.json());
|
|
25
|
+
router.get("/health", (_, response) => {
|
|
26
|
+
response.json({ status: "ok" });
|
|
27
|
+
});
|
|
28
|
+
router.get("/:kind/:namespace/:name", async (request, response) => {
|
|
29
|
+
const { kind, namespace, name } = request.params;
|
|
30
|
+
const entityRef = catalogModel.stringifyEntityRef({ kind, namespace, name });
|
|
31
|
+
const cacheDoc = await cache.get(entityRef);
|
|
32
|
+
if (cacheDoc && cacheDoc.name === constants.NOT_FOUND_PLACEHOLDER) {
|
|
33
|
+
throw new errors.NotFoundError("Readme could not be found");
|
|
34
|
+
}
|
|
35
|
+
if (cacheDoc) {
|
|
36
|
+
logger.info(`Loading README for ${entityRef} from cache.`);
|
|
37
|
+
response.type(cacheDoc.type);
|
|
38
|
+
response.send(cacheDoc.content);
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
const { token } = await auth.getPluginRequestToken({
|
|
42
|
+
onBehalfOf: await auth.getOwnServiceCredentials(),
|
|
43
|
+
targetPluginId: "catalog"
|
|
44
|
+
});
|
|
45
|
+
const entity = await catalogClient$1.getEntityByRef(entityRef, { token });
|
|
46
|
+
if (!entity) {
|
|
47
|
+
logger.info(`No integration found for ${entityRef}`);
|
|
48
|
+
response.status(500).json({ error: `No integration found for ${entityRef}` });
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
const source = catalogModel.getEntitySourceLocation(entity);
|
|
52
|
+
if (!source || source.type !== "url") {
|
|
53
|
+
const errorMessage = `Not valid location for ${source.target}`;
|
|
54
|
+
logger.info(errorMessage);
|
|
55
|
+
throw new errors.NotFoundError(errorMessage);
|
|
56
|
+
}
|
|
57
|
+
const integration = integrations.byUrl(source.target);
|
|
58
|
+
if (!integration) {
|
|
59
|
+
logger.info(`No integration found for ${source.target}`);
|
|
60
|
+
response.status(500).json({ error: `No integration found for ${source.target}` });
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
for (const fileType of constants.README_TYPES) {
|
|
64
|
+
const url = integration.resolveUrl({
|
|
65
|
+
url: fileType.name,
|
|
66
|
+
base: source.target
|
|
67
|
+
});
|
|
68
|
+
let content;
|
|
69
|
+
try {
|
|
70
|
+
logger.debug(`Trying README location: ${url} for ${entityRef} `);
|
|
71
|
+
response.type(fileType.type);
|
|
72
|
+
const urlResponse = await reader.readUrl(url);
|
|
73
|
+
content = (await urlResponse.buffer()).toString("utf-8");
|
|
74
|
+
if (lib.isSymLink(content)) {
|
|
75
|
+
const symLinkUrl = integration.resolveUrl({
|
|
76
|
+
url: content,
|
|
77
|
+
base: source.target
|
|
78
|
+
});
|
|
79
|
+
const symLinkUrlResponse = await reader.readUrl(symLinkUrl);
|
|
80
|
+
content = (await symLinkUrlResponse.buffer()).toString("utf-8");
|
|
81
|
+
}
|
|
82
|
+
cache.set(entityRef, {
|
|
83
|
+
name: fileType.name,
|
|
84
|
+
type: fileType.type,
|
|
85
|
+
content
|
|
86
|
+
});
|
|
87
|
+
logger.info(
|
|
88
|
+
`Found README for ${entityRef}: ${url} type ${fileType.type}`
|
|
89
|
+
);
|
|
90
|
+
response.send(content);
|
|
91
|
+
return;
|
|
92
|
+
} catch (error) {
|
|
93
|
+
if (errors.isError(error) && error.name === "NotFoundError") {
|
|
94
|
+
continue;
|
|
95
|
+
} else {
|
|
96
|
+
response.status(500).json({
|
|
97
|
+
error: `Readme failure: ${error}`
|
|
98
|
+
});
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
logger.info(`Readme not found for ${entityRef}`);
|
|
104
|
+
cache.set(entityRef, {
|
|
105
|
+
name: constants.NOT_FOUND_PLACEHOLDER,
|
|
106
|
+
type: "",
|
|
107
|
+
content: ""
|
|
108
|
+
});
|
|
109
|
+
throw new errors.NotFoundError("Readme could not be found");
|
|
110
|
+
});
|
|
111
|
+
const middleware = rootHttpRouter.MiddlewareFactory.create({ logger, config });
|
|
112
|
+
router.use(middleware.error());
|
|
113
|
+
return router;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
exports.createRouter = createRouter;
|
|
117
|
+
//# sourceMappingURL=router.cjs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"router.cjs.js","sources":["../../src/service/router.ts"],"sourcesContent":["import { MiddlewareFactory } from '@backstage/backend-defaults/rootHttpRouter';\nimport {\n AuthService,\n CacheService,\n DiscoveryService,\n LoggerService,\n RootConfigService,\n UrlReaderService,\n} from '@backstage/backend-plugin-api';\nimport { ScmIntegrations } from '@backstage/integration';\nimport {\n getEntitySourceLocation,\n stringifyEntityRef,\n} from '@backstage/catalog-model';\nimport { CatalogClient } from '@backstage/catalog-client';\nimport { isError, NotFoundError } from '@backstage/errors';\nimport express from 'express';\nimport Router from 'express-promise-router';\nimport { isSymLink } from '../lib';\nimport { NOT_FOUND_PLACEHOLDER, README_TYPES } from './constants';\nimport { ReadmeFile } from './types';\n\n/**\n * Constructs a readme router.\n *\n */\ninterface RouterOptions {\n auth: AuthService;\n config: RootConfigService;\n discovery: DiscoveryService;\n logger: LoggerService;\n reader: UrlReaderService;\n cache: CacheService;\n}\n\n/**\n * Constructs a readme router.\n *\n */\nexport async function createRouter(\n options: RouterOptions,\n): Promise<express.Router> {\n const { auth, logger, config, reader, discovery, cache } = options;\n const catalogClient = new CatalogClient({ discoveryApi: discovery });\n\n logger.info('Initializing readme backend');\n const integrations = ScmIntegrations.fromConfig(config);\n const router = Router();\n router.use(express.json());\n\n router.get('/health', (_, response) => {\n response.json({ status: 'ok' });\n });\n\n router.get('/:kind/:namespace/:name', async (request, response) => {\n const { kind, namespace, name } = request.params;\n const entityRef = stringifyEntityRef({ kind, namespace, name });\n const cacheDoc = (await cache.get(entityRef)) as ReadmeFile | undefined;\n\n if (cacheDoc && cacheDoc.name === NOT_FOUND_PLACEHOLDER) {\n throw new NotFoundError('Readme could not be found');\n }\n if (cacheDoc) {\n logger.info(`Loading README for ${entityRef} from cache.`);\n response.type(cacheDoc.type);\n response.send(cacheDoc.content);\n return;\n }\n const { token } = await auth.getPluginRequestToken({\n onBehalfOf: await auth.getOwnServiceCredentials(),\n targetPluginId: 'catalog',\n });\n const entity = await catalogClient.getEntityByRef(entityRef, { token });\n if (!entity) {\n logger.info(`No integration found for ${entityRef}`);\n response\n .status(500)\n .json({ error: `No integration found for ${entityRef}` });\n return;\n }\n const source = getEntitySourceLocation(entity);\n\n if (!source || source.type !== 'url') {\n const errorMessage = `Not valid location for ${source.target}`;\n logger.info(errorMessage);\n throw new NotFoundError(errorMessage);\n }\n const integration = integrations.byUrl(source.target);\n\n if (!integration) {\n logger.info(`No integration found for ${source.target}`);\n response\n .status(500)\n .json({ error: `No integration found for ${source.target}` });\n return;\n }\n\n for (const fileType of README_TYPES) {\n const url = integration.resolveUrl({\n url: fileType.name,\n base: source.target,\n });\n\n let content;\n\n try {\n logger.debug(`Trying README location: ${url} for ${entityRef} `);\n response.type(fileType.type);\n\n const urlResponse = await reader.readUrl(url);\n content = (await urlResponse.buffer()).toString('utf-8');\n\n if (isSymLink(content)) {\n const symLinkUrl = integration.resolveUrl({\n url: content,\n base: source.target,\n });\n const symLinkUrlResponse = await reader.readUrl(symLinkUrl);\n content = (await symLinkUrlResponse.buffer()).toString('utf-8');\n }\n\n cache.set(entityRef, {\n name: fileType.name,\n type: fileType.type,\n content: content,\n });\n logger.info(\n `Found README for ${entityRef}: ${url} type ${fileType.type}`,\n );\n response.send(content);\n return;\n } catch (error: unknown) {\n if (isError(error) && error.name === 'NotFoundError') {\n continue;\n } else {\n response.status(500).json({\n error: `Readme failure: ${error}`,\n });\n return;\n }\n }\n }\n logger.info(`Readme not found for ${entityRef}`);\n cache.set(entityRef, {\n name: NOT_FOUND_PLACEHOLDER,\n type: '',\n content: '',\n });\n throw new NotFoundError('Readme could not be found');\n });\n\n const middleware = MiddlewareFactory.create({ logger, config });\n router.use(middleware.error());\n return router;\n}\n"],"names":["catalogClient","CatalogClient","ScmIntegrations","Router","express","stringifyEntityRef","NOT_FOUND_PLACEHOLDER","NotFoundError","getEntitySourceLocation","README_TYPES","isSymLink","isError","MiddlewareFactory"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@axis-backstage/plugin-readme-backend",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0",
|
|
4
4
|
"main": "dist/index.cjs.js",
|
|
5
5
|
"types": "dist/index.d.ts",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -16,7 +16,10 @@
|
|
|
16
16
|
"pluginPackages": [
|
|
17
17
|
"@axis-backstage/plugin-readme",
|
|
18
18
|
"@axis-backstage/plugin-readme-backend"
|
|
19
|
-
]
|
|
19
|
+
],
|
|
20
|
+
"features": {
|
|
21
|
+
".": "@backstage/BackendFeature"
|
|
22
|
+
}
|
|
20
23
|
},
|
|
21
24
|
"scripts": {
|
|
22
25
|
"start": "backstage-cli package start",
|
|
@@ -28,20 +31,19 @@
|
|
|
28
31
|
"postpack": "backstage-cli package postpack"
|
|
29
32
|
},
|
|
30
33
|
"dependencies": {
|
|
31
|
-
"@backstage/backend-
|
|
32
|
-
"@backstage/backend-
|
|
33
|
-
"@backstage/
|
|
34
|
-
"@backstage/catalog-
|
|
35
|
-
"@backstage/
|
|
36
|
-
"@backstage/
|
|
37
|
-
"@backstage/integration": "^1.14.0",
|
|
34
|
+
"@backstage/backend-defaults": "^0.8.1",
|
|
35
|
+
"@backstage/backend-plugin-api": "^1.2.0",
|
|
36
|
+
"@backstage/catalog-client": "^1.9.1",
|
|
37
|
+
"@backstage/catalog-model": "^1.7.3",
|
|
38
|
+
"@backstage/errors": "^1.2.7",
|
|
39
|
+
"@backstage/integration": "^1.16.1",
|
|
38
40
|
"@types/express": "*",
|
|
39
41
|
"express": "^4.17.1",
|
|
40
42
|
"express-promise-router": "^4.1.0"
|
|
41
43
|
},
|
|
42
44
|
"devDependencies": {
|
|
43
|
-
"@backstage/backend-test-utils": "^
|
|
44
|
-
"@backstage/cli": "^0.
|
|
45
|
+
"@backstage/backend-test-utils": "^1.3.0",
|
|
46
|
+
"@backstage/cli": "^0.30.0",
|
|
45
47
|
"@types/supertest": "^2.0.12",
|
|
46
48
|
"msw": "^1.0.0",
|
|
47
49
|
"supertest": "^6.2.4"
|
|
@@ -49,5 +51,12 @@
|
|
|
49
51
|
"files": [
|
|
50
52
|
"dist"
|
|
51
53
|
],
|
|
54
|
+
"typesVersions": {
|
|
55
|
+
"*": {
|
|
56
|
+
"index": [
|
|
57
|
+
"dist/index.d.ts"
|
|
58
|
+
]
|
|
59
|
+
}
|
|
60
|
+
},
|
|
52
61
|
"directory": "_release/package"
|
|
53
62
|
}
|