@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 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 rootHttpRouter = require('@backstage/backend-defaults/rootHttpRouter');
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
- const DETECT_SYMLINKS_REGEX = "^(w+|.|/|-)+$";
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
@@ -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.BackendFeatureCompat;
8
+ declare const readmePlugin: _backstage_backend_plugin_api.BackendFeature;
50
9
 
51
- export { type RouterOptions, createRouter, readmePlugin as default };
10
+ export { readmePlugin as default };
@@ -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.10.1",
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-common": "^0.24.0",
32
- "@backstage/backend-defaults": "^0.4.3",
33
- "@backstage/backend-plugin-api": "^0.8.0",
34
- "@backstage/catalog-client": "^1.6.6",
35
- "@backstage/catalog-model": "^1.6.0",
36
- "@backstage/errors": "^1.2.4",
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": "^0.5.0",
44
- "@backstage/cli": "^0.27.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
  }