@aag1999/plugin-github-trending-backend 0.1.0

package/config.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://backstage.io/schema/config-v1",
+  "type": "object",
+  "properties": {
+    "githubTrending": {
+      "type": "object",
+      "description": "GitHub Trending ticker backend",
+      "additionalProperties": false,
+      "properties": {
+        "baseUrl": {
+          "type": "string",
+          "description": "GitHub website origin that hosts /trending. Default https://github.com. GHES has no Trending page."
+        },
+        "since": {
+          "type": "string",
+          "description": "Default window: daily, weekly, or monthly",
+          "enum": ["daily", "weekly", "monthly"]
+        },
+        "language": {
+          "type": "string",
+          "description": "Optional programming-language slug, e.g. typescript"
+        },
+        "spokenLanguageCode": {
+          "type": "string",
+          "description": "Optional spoken-language code from github.com/trending, e.g. en"
+        },
+        "cacheTtlMinutes": {
+          "type": "number",
+          "description": "In-memory cache TTL in minutes. Default 45."
+        }
+      }
+    }
+  }
+}

package/dist/cache.cjs.js

@@ -0,0 +1,22 @@
+'use strict';
+
+class MemoryTtlCache {
+  store = /* @__PURE__ */ new Map();
+  get(key) {
+    const hit = this.store.get(key);
+    if (!hit) {
+      return void 0;
+    }
+    if (Date.now() > hit.expiresAt) {
+      this.store.delete(key);
+      return void 0;
+    }
+    return hit.value;
+  }
+  set(key, value, ttlMs) {
+    this.store.set(key, { value, expiresAt: Date.now() + ttlMs });
+  }
+}
+
+exports.MemoryTtlCache = MemoryTtlCache;
+//# sourceMappingURL=cache.cjs.js.map

package/dist/cache.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.cjs.js","sources":["../src/cache.ts"],"sourcesContent":["/*\n * Copyright 2026 AAG1999 / contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n */\n\ntype Entry<T> = { value: T; expiresAt: number };\n\n/** Process-local TTL cache so many portal users share one GitHub fetch. */\nexport class MemoryTtlCache<T> {\n  private readonly store = new Map<string, Entry<T>>();\n\n  get(key: string): T | undefined {\n    const hit = this.store.get(key);\n    if (!hit) {\n      return undefined;\n    }\n    if (Date.now() > hit.expiresAt) {\n      this.store.delete(key);\n      return undefined;\n    }\n    return hit.value;\n  }\n\n  set(key: string, value: T, ttlMs: number): void {\n    this.store.set(key, { value, expiresAt: Date.now() + ttlMs });\n  }\n}\n"],"names":[],"mappings":";;AAaO,MAAM,cAAA,CAAkB;AAAA,EACZ,KAAA,uBAAY,GAAA,EAAsB;AAAA,EAEnD,IAAI,GAAA,EAA4B;AAC9B,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAC9B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,IAAI,IAAA,CAAK,GAAA,EAAI,GAAI,GAAA,CAAI,SAAA,EAAW;AAC9B,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAO,GAAA,CAAI,KAAA;AAAA,EACb;AAAA,EAEA,GAAA,CAAI,GAAA,EAAa,KAAA,EAAU,KAAA,EAAqB;AAC9C,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,EAAE,KAAA,EAAO,WAAW,IAAA,CAAK,GAAA,EAAI,GAAI,KAAA,EAAO,CAAA;AAAA,EAC9D;AACF;;"}

package/dist/index.cjs.js

@@ -0,0 +1,13 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var plugin = require('./plugin.cjs.js');
+var parser = require('./parser.cjs.js');
+
+
+
+exports.default = plugin.githubTrendingPlugin;
+exports.githubTrendingPlugin = plugin.githubTrendingPlugin;
+exports.parseTrendingHtml = parser.parseTrendingHtml;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+import { TrendingRepository } from '@aag1999/plugin-github-trending-common';
+
+/**
+ * Fetches and caches github.com/trending for the home ticker.
+ * @public
+ */
+declare const githubTrendingPlugin: _backstage_backend_plugin_api.BackendFeature;
+
+/**
+ * Parse github.com/trending HTML into structured rows.
+ * Markup is treated as unstable; keep fixtures in lockstep with GitHub.
+ */
+declare function parseTrendingHtml(html: string, siteOrigin?: string): TrendingRepository[];
+
+export { githubTrendingPlugin as default, githubTrendingPlugin, parseTrendingHtml };

package/dist/parser.cjs.js

@@ -0,0 +1,58 @@
+'use strict';
+
+const ARTICLE_RE = /<article\b[^>]*\bBox-row\b[^>]*>([\s\S]*?)<\/article>/gi;
+const HREF_RE = /<h2\b[^>]*>[\s\S]*?href="\/([^"/]+)\/([^"/?#]+)"/i;
+const DESC_RE = /<p\b[^>]*col-9[^>]*>([\s\S]*?)<\/p>/i;
+const LANG_RE = /itemprop="programmingLanguage">\s*([^<]+)\s*</i;
+const STARS_RE = /href="\/[^"]+\/stargazers"[^>]*>[\s\S]*?([\d,]+)\s*</i;
+const FORKS_RE = /href="\/[^"]+\/(?:network\/members|forks)"[^>]*>[\s\S]*?([\d,]+)\s*</i;
+const PERIOD_RE = /([\d,]+)\s+stars\s+(today|this week|this month)/i;
+function parseCount(raw) {
+  if (!raw) {
+    return 0;
+  }
+  const n = Number(raw.replace(/,/g, "").trim());
+  return Number.isFinite(n) ? n : 0;
+}
+function decodeEntities(text) {
+  return text.replace(/<[^>]+>/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
+}
+function parseTrendingHtml(html, siteOrigin = "https://github.com") {
+  const origin = siteOrigin.replace(/\/$/, "");
+  const rows = [];
+  const articleRe = new RegExp(ARTICLE_RE.source, ARTICLE_RE.flags);
+  let rank = 0;
+  for (; ; ) {
+    const match = articleRe.exec(html);
+    if (!match) {
+      break;
+    }
+    const body = match[1];
+    const href = body.match(HREF_RE);
+    if (!href) {
+      continue;
+    }
+    rank += 1;
+    const owner = href[1];
+    const name = href[2];
+    const descMatch = body.match(DESC_RE);
+    const langMatch = body.match(LANG_RE);
+    const periodMatch = body.match(PERIOD_RE);
+    rows.push({
+      rank,
+      owner,
+      name,
+      url: `${origin}/${owner}/${name}`,
+      description: descMatch ? decodeEntities(descMatch[1]) : void 0,
+      language: langMatch ? decodeEntities(langMatch[1]) : void 0,
+      stars: parseCount(body.match(STARS_RE)?.[1]),
+      forks: parseCount(body.match(FORKS_RE)?.[1]),
+      starsInPeriod: parseCount(periodMatch?.[1]),
+      periodLabel: periodMatch?.[2] ?? "today"
+    });
+  }
+  return rows;
+}
+
+exports.parseTrendingHtml = parseTrendingHtml;
+//# sourceMappingURL=parser.cjs.js.map

package/dist/parser.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.cjs.js","sources":["../src/parser.ts"],"sourcesContent":["/*\n * Copyright 2026 AAG1999 / contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n */\n\nimport type { TrendingRepository } from '@aag1999/plugin-github-trending-common';\n\nconst ARTICLE_RE =\n  /<article\\b[^>]*\\bBox-row\\b[^>]*>([\\s\\S]*?)<\\/article>/gi;\nconst HREF_RE = /<h2\\b[^>]*>[\\s\\S]*?href=\"\\/([^\"/]+)\\/([^\"/?#]+)\"/i;\nconst DESC_RE = /<p\\b[^>]*col-9[^>]*>([\\s\\S]*?)<\\/p>/i;\nconst LANG_RE = /itemprop=\"programmingLanguage\">\\s*([^<]+)\\s*</i;\nconst STARS_RE = /href=\"\\/[^\"]+\\/stargazers\"[^>]*>[\\s\\S]*?([\\d,]+)\\s*</i;\nconst FORKS_RE = /href=\"\\/[^\"]+\\/(?:network\\/members|forks)\"[^>]*>[\\s\\S]*?([\\d,]+)\\s*</i;\nconst PERIOD_RE =\n  /([\\d,]+)\\s+stars\\s+(today|this week|this month)/i;\n\nfunction parseCount(raw: string | undefined): number {\n  if (!raw) {\n    return 0;\n  }\n  const n = Number(raw.replace(/,/g, '').trim());\n  return Number.isFinite(n) ? n : 0;\n}\n\nfunction decodeEntities(text: string): string {\n  return text\n    .replace(/<[^>]+>/g, '')\n    .replace(/&amp;/g, '&')\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&#39;/g, \"'\")\n    .replace(/&nbsp;/g, ' ')\n    .replace(/\\s+/g, ' ')\n    .trim();\n}\n\n/**\n * Parse github.com/trending HTML into structured rows.\n * Markup is treated as unstable; keep fixtures in lockstep with GitHub.\n */\nexport function parseTrendingHtml(\n  html: string,\n  siteOrigin = 'https://github.com',\n): TrendingRepository[] {\n  const origin = siteOrigin.replace(/\\/$/, '');\n  const rows: TrendingRepository[] = [];\n  const articleRe = new RegExp(ARTICLE_RE.source, ARTICLE_RE.flags);\n  let rank = 0;\n  for (;;) {\n    const match = articleRe.exec(html);\n    if (!match) {\n      break;\n    }\n    const body = match[1];\n    const href = body.match(HREF_RE);\n    if (!href) {\n      continue;\n    }\n    rank += 1;\n    const owner = href[1];\n    const name = href[2];\n    const descMatch = body.match(DESC_RE);\n    const langMatch = body.match(LANG_RE);\n    const periodMatch = body.match(PERIOD_RE);\n    rows.push({\n      rank,\n      owner,\n      name,\n      url: `${origin}/${owner}/${name}`,\n      description: descMatch ? decodeEntities(descMatch[1]) : undefined,\n      language: langMatch ? decodeEntities(langMatch[1]) : undefined,\n      stars: parseCount(body.match(STARS_RE)?.[1]),\n      forks: parseCount(body.match(FORKS_RE)?.[1]),\n      starsInPeriod: parseCount(periodMatch?.[1]),\n      periodLabel: periodMatch?.[2] ?? 'today',\n    });\n  }\n  return rows;\n}\n"],"names":[],"mappings":"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"}

package/dist/plugin.cjs.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var router = require('./router.cjs.js');
+
+const githubTrendingPlugin = backendPluginApi.createBackendPlugin({
+  pluginId: "github-trending",
+  register(env) {
+    env.registerInit({
+      deps: {
+        httpRouter: backendPluginApi.coreServices.httpRouter,
+        logger: backendPluginApi.coreServices.logger,
+        config: backendPluginApi.coreServices.rootConfig
+      },
+      async init({ httpRouter, logger, config }) {
+        httpRouter.use(await router.createRouter({ logger, config }));
+        httpRouter.addAuthPolicy({
+          path: "/health",
+          allow: "unauthenticated"
+        });
+      }
+    });
+  }
+});
+
+exports.githubTrendingPlugin = githubTrendingPlugin;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["/*\n * Copyright 2026 AAG1999 / contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n */\n\nimport {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './router';\n\n/**\n * Fetches and caches github.com/trending for the home ticker.\n * @public\n */\nexport const githubTrendingPlugin = createBackendPlugin({\n  pluginId: 'github-trending',\n  register(env) {\n    env.registerInit({\n      deps: {\n        httpRouter: coreServices.httpRouter,\n        logger: coreServices.logger,\n        config: coreServices.rootConfig,\n      },\n      async init({ httpRouter, logger, config }) {\n        httpRouter.use(await createRouter({ logger, config }));\n        httpRouter.addAuthPolicy({\n          path: '/health',\n          allow: 'unauthenticated',\n        });\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","coreServices","createRouter"],"mappings":";;;;;AAoBO,MAAM,uBAAuBA,oCAAA,CAAoB;AAAA,EACtD,QAAA,EAAU,iBAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,YAAYC,6BAAA,CAAa,UAAA;AAAA,QACzB,QAAQA,6BAAA,CAAa,MAAA;AAAA,QACrB,QAAQA,6BAAA,CAAa;AAAA,OACvB;AAAA,MACA,MAAM,IAAA,CAAK,EAAE,UAAA,EAAY,MAAA,EAAQ,QAAO,EAAG;AACzC,QAAA,UAAA,CAAW,IAAI,MAAMC,mBAAA,CAAa,EAAE,MAAA,EAAQ,MAAA,EAAQ,CAAC,CAAA;AACrD,QAAA,UAAA,CAAW,aAAA,CAAc;AAAA,UACvB,IAAA,EAAM,SAAA;AAAA,UACN,KAAA,EAAO;AAAA,SACR,CAAA;AAAA,MACH;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;"}

package/dist/router.cjs.js

@@ -0,0 +1,116 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+var express = require('express');
+var Router = require('express-promise-router');
+var cache = require('./cache.cjs.js');
+var parser = require('./parser.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var express__default = /*#__PURE__*/_interopDefaultCompat(express);
+var Router__default = /*#__PURE__*/_interopDefaultCompat(Router);
+
+const USER_AGENT = "backstage-plugin-github-trending/0.1 (+https://github.com/AAG1999/backstage-plugin-github-trending)";
+const ALLOWED_SINCE = ["daily", "weekly", "monthly"];
+function readSince(raw, fallback) {
+  if (raw === void 0 || raw === "") {
+    return fallback;
+  }
+  if (typeof raw === "string" && ALLOWED_SINCE.includes(raw)) {
+    return raw;
+  }
+  throw new errors.InputError(`since must be one of ${ALLOWED_SINCE.join(", ")}`);
+}
+function buildSourceUrl(opts) {
+  const url = new URL(
+    opts.language ? `/trending/${encodeURIComponent(opts.language)}` : "/trending",
+    opts.baseUrl
+  );
+  if (opts.since !== "daily") {
+    url.searchParams.set("since", opts.since);
+  }
+  if (opts.spokenLanguageCode) {
+    url.searchParams.set("spoken_language_code", opts.spokenLanguageCode);
+  }
+  return url.toString();
+}
+async function createRouter(options) {
+  const { logger, config } = options;
+  const fetchFn = options.fetchFn ?? fetch;
+  const cache$1 = new cache.MemoryTtlCache();
+  const trendingConfig = config.getOptionalConfig("githubTrending");
+  const baseUrl = (trendingConfig?.getOptionalString("baseUrl") ?? "https://github.com").replace(/\/$/, "");
+  const defaultSince = readSince(
+    trendingConfig?.getOptionalString("since"),
+    "daily"
+  );
+  const defaultLanguage = trendingConfig?.getOptionalString("language");
+  const defaultSpoken = trendingConfig?.getOptionalString("spokenLanguageCode");
+  const ttlMs = (trendingConfig?.getOptionalNumber("cacheTtlMinutes") ?? 45) * 6e4;
+  const router = Router__default.default();
+  router.use(express__default.default.json());
+  router.get("/health", (_req, res) => {
+    res.json({ status: "ok" });
+  });
+  router.get("/repositories", async (req, res) => {
+    const since = readSince(req.query.since, defaultSince);
+    const language = typeof req.query.language === "string" && req.query.language ? req.query.language : defaultLanguage;
+    const spokenLanguageCode = typeof req.query.spoken_language_code === "string" && req.query.spoken_language_code ? req.query.spoken_language_code : defaultSpoken;
+    const cacheKey = JSON.stringify({ since, language, spokenLanguageCode });
+    const cached = cache$1.get(cacheKey);
+    if (cached) {
+      res.json(cached);
+      return;
+    }
+    const sourceUrl = buildSourceUrl({
+      baseUrl,
+      since,
+      language,
+      spokenLanguageCode
+    });
+    logger.info(`Fetching GitHub Trending ${sourceUrl}`);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15e3);
+    let html;
+    try {
+      const response = await fetchFn(sourceUrl, {
+        headers: {
+          Accept: "text/html",
+          "User-Agent": USER_AGENT
+        },
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        logger.warn(
+          `GitHub Trending returned HTTP ${response.status} for ${sourceUrl}`
+        );
+        res.status(502).json({
+          error: `Upstream GitHub Trending returned HTTP ${response.status}`
+        });
+        return;
+      }
+      html = await response.text();
+    } catch (error) {
+      logger.warn(`GitHub Trending fetch failed: ${error}`);
+      res.status(502).json({ error: "Failed to fetch GitHub Trending" });
+      return;
+    } finally {
+      clearTimeout(timeout);
+    }
+    const payload = {
+      fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      since,
+      language,
+      spokenLanguageCode,
+      sourceUrl,
+      repositories: parser.parseTrendingHtml(html, baseUrl)
+    };
+    cache$1.set(cacheKey, payload, ttlMs);
+    res.json(payload);
+  });
+  return router;
+}
+
+exports.createRouter = createRouter;
+//# sourceMappingURL=router.cjs.js.map

package/dist/router.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.cjs.js","sources":["../src/router.ts"],"sourcesContent":["/*\n * Copyright 2026 AAG1999 / contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n */\n\nimport { Config } from '@backstage/config';\nimport { LoggerService } from '@backstage/backend-plugin-api';\nimport { InputError } from '@backstage/errors';\nimport type {\n  TrendingResponse,\n  TrendingSince,\n} from '@aag1999/plugin-github-trending-common';\nimport express from 'express';\nimport Router from 'express-promise-router';\nimport { MemoryTtlCache } from './cache';\nimport { parseTrendingHtml } from './parser';\n\nconst USER_AGENT =\n  'backstage-plugin-github-trending/0.1 (+https://github.com/AAG1999/backstage-plugin-github-trending)';\nconst ALLOWED_SINCE: TrendingSince[] = ['daily', 'weekly', 'monthly'];\n\nexport type RouterOptions = {\n  logger: LoggerService;\n  config: Config;\n  fetchFn?: typeof fetch;\n};\n\nfunction readSince(raw: unknown, fallback: TrendingSince): TrendingSince {\n  if (raw === undefined || raw === '') {\n    return fallback;\n  }\n  if (typeof raw === 'string' && ALLOWED_SINCE.includes(raw as TrendingSince)) {\n    return raw as TrendingSince;\n  }\n  throw new InputError(`since must be one of ${ALLOWED_SINCE.join(', ')}`);\n}\n\nfunction buildSourceUrl(opts: {\n  baseUrl: string;\n  since: TrendingSince;\n  language?: string;\n  spokenLanguageCode?: string;\n}): string {\n  const url = new URL(\n    opts.language\n      ? `/trending/${encodeURIComponent(opts.language)}`\n      : '/trending',\n    opts.baseUrl,\n  );\n  if (opts.since !== 'daily') {\n    url.searchParams.set('since', opts.since);\n  }\n  if (opts.spokenLanguageCode) {\n    url.searchParams.set('spoken_language_code', opts.spokenLanguageCode);\n  }\n  return url.toString();\n}\n\nexport async function createRouter(\n  options: RouterOptions,\n): Promise<express.Router> {\n  const { logger, config } = options;\n  const fetchFn = options.fetchFn ?? fetch;\n  const cache = new MemoryTtlCache<TrendingResponse>();\n  const trendingConfig = config.getOptionalConfig('githubTrending');\n  const baseUrl = (\n    trendingConfig?.getOptionalString('baseUrl') ?? 'https://github.com'\n  ).replace(/\\/$/, '');\n  const defaultSince = readSince(\n    trendingConfig?.getOptionalString('since'),\n    'daily',\n  );\n  const defaultLanguage = trendingConfig?.getOptionalString('language');\n  const defaultSpoken =\n    trendingConfig?.getOptionalString('spokenLanguageCode');\n  const ttlMs =\n    (trendingConfig?.getOptionalNumber('cacheTtlMinutes') ?? 45) * 60_000;\n\n  const router = Router();\n  router.use(express.json());\n\n  router.get('/health', (_req, res) => {\n    res.json({ status: 'ok' });\n  });\n\n  router.get('/repositories', async (req, res) => {\n    const since = readSince(req.query.since, defaultSince);\n    const language =\n      typeof req.query.language === 'string' && req.query.language\n        ? req.query.language\n        : defaultLanguage;\n    const spokenLanguageCode =\n      typeof req.query.spoken_language_code === 'string' &&\n      req.query.spoken_language_code\n        ? req.query.spoken_language_code\n        : defaultSpoken;\n    const cacheKey = JSON.stringify({ since, language, spokenLanguageCode });\n    const cached = cache.get(cacheKey);\n    if (cached) {\n      res.json(cached);\n      return;\n    }\n\n    const sourceUrl = buildSourceUrl({\n      baseUrl,\n      since,\n      language,\n      spokenLanguageCode,\n    });\n    logger.info(`Fetching GitHub Trending ${sourceUrl}`);\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 15_000);\n    let html: string;\n    try {\n      const response = await fetchFn(sourceUrl, {\n        headers: {\n          Accept: 'text/html',\n          'User-Agent': USER_AGENT,\n        },\n        signal: controller.signal,\n      });\n      if (!response.ok) {\n        logger.warn(\n          `GitHub Trending returned HTTP ${response.status} for ${sourceUrl}`,\n        );\n        res.status(502).json({\n          error: `Upstream GitHub Trending returned HTTP ${response.status}`,\n        });\n        return;\n      }\n      html = await response.text();\n    } catch (error) {\n      logger.warn(`GitHub Trending fetch failed: ${error}`);\n      res.status(502).json({ error: 'Failed to fetch GitHub Trending' });\n      return;\n    } finally {\n      clearTimeout(timeout);\n    }\n\n    const payload: TrendingResponse = {\n      fetchedAt: new Date().toISOString(),\n      since,\n      language,\n      spokenLanguageCode,\n      sourceUrl,\n      repositories: parseTrendingHtml(html, baseUrl),\n    };\n    cache.set(cacheKey, payload, ttlMs);\n    res.json(payload);\n  });\n\n  return router;\n}\n"],"names":["InputError","cache","MemoryTtlCache","Router","express","parseTrendingHtml"],"mappings":";;;;;;;;;;;;;AAsBA,MAAM,UAAA,GACJ,qGAAA;AACF,MAAM,aAAA,GAAiC,CAAC,OAAA,EAAS,QAAA,EAAU,SAAS,CAAA;AAQpE,SAAS,SAAA,CAAU,KAAc,QAAA,EAAwC;AACvE,EAAA,IAAI,GAAA,KAAQ,MAAA,IAAa,GAAA,KAAQ,EAAA,EAAI;AACnC,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,IAAY,aAAA,CAAc,QAAA,CAAS,GAAoB,CAAA,EAAG;AAC3E,IAAA,OAAO,GAAA;AAAA,EACT;AACA,EAAA,MAAM,IAAIA,iBAAA,CAAW,CAAA,qBAAA,EAAwB,cAAc,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AACzE;AAEA,SAAS,eAAe,IAAA,EAKb;AACT,EAAA,MAAM,MAAM,IAAI,GAAA;AAAA,IACd,KAAK,QAAA,GACD,CAAA,UAAA,EAAa,mBAAmB,IAAA,CAAK,QAAQ,CAAC,CAAA,CAAA,GAC9C,WAAA;AAAA,IACJ,IAAA,CAAK;AAAA,GACP;AACA,EAAA,IAAI,IAAA,CAAK,UAAU,OAAA,EAAS;AAC1B,IAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,OAAA,EAAS,IAAA,CAAK,KAAK,CAAA;AAAA,EAC1C;AACA,EAAA,IAAI,KAAK,kBAAA,EAAoB;AAC3B,IAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,sBAAA,EAAwB,IAAA,CAAK,kBAAkB,CAAA;AAAA,EACtE;AACA,EAAA,OAAO,IAAI,QAAA,EAAS;AACtB;AAEA,eAAsB,aACpB,OAAA,EACyB;AACzB,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAO,GAAI,OAAA;AAC3B,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,KAAA;AACnC,EAAA,MAAMC,OAAA,GAAQ,IAAIC,oBAAA,EAAiC;AACnD,EAAA,MAAM,cAAA,GAAiB,MAAA,CAAO,iBAAA,CAAkB,gBAAgB,CAAA;AAChE,EAAA,MAAM,OAAA,GAAA,CACJ,gBAAgB,iBAAA,CAAkB,SAAS,KAAK,oBAAA,EAChD,OAAA,CAAQ,OAAO,EAAE,CAAA;AACnB,EAAA,MAAM,YAAA,GAAe,SAAA;AAAA,IACnB,cAAA,EAAgB,kBAAkB,OAAO,CAAA;AAAA,IACzC;AAAA,GACF;AACA,EAAA,MAAM,eAAA,GAAkB,cAAA,EAAgB,iBAAA,CAAkB,UAAU,CAAA;AACpE,EAAA,MAAM,aAAA,GACJ,cAAA,EAAgB,iBAAA,CAAkB,oBAAoB,CAAA;AACxD,EAAA,MAAM,KAAA,GAAA,CACH,cAAA,EAAgB,iBAAA,CAAkB,iBAAiB,KAAK,EAAA,IAAM,GAAA;AAEjE,EAAA,MAAM,SAASC,uBAAA,EAAO;AACtB,EAAA,MAAA,CAAO,GAAA,CAAIC,wBAAA,CAAQ,IAAA,EAAM,CAAA;AAEzB,EAAA,MAAA,CAAO,GAAA,CAAI,SAAA,EAAW,CAAC,IAAA,EAAM,GAAA,KAAQ;AACnC,IAAA,GAAA,CAAI,IAAA,CAAK,EAAE,MAAA,EAAQ,IAAA,EAAM,CAAA;AAAA,EAC3B,CAAC,CAAA;AAED,EAAA,MAAA,CAAO,GAAA,CAAI,eAAA,EAAiB,OAAO,GAAA,EAAK,GAAA,KAAQ;AAC9C,IAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,GAAA,CAAI,KAAA,CAAM,OAAO,YAAY,CAAA;AACrD,IAAA,MAAM,QAAA,GACJ,OAAO,GAAA,CAAI,KAAA,CAAM,QAAA,KAAa,QAAA,IAAY,GAAA,CAAI,KAAA,CAAM,QAAA,GAChD,GAAA,CAAI,KAAA,CAAM,QAAA,GACV,eAAA;AACN,IAAA,MAAM,kBAAA,GACJ,OAAO,GAAA,CAAI,KAAA,CAAM,oBAAA,KAAyB,QAAA,IAC1C,GAAA,CAAI,KAAA,CAAM,oBAAA,GACN,GAAA,CAAI,KAAA,CAAM,oBAAA,GACV,aAAA;AACN,IAAA,MAAM,WAAW,IAAA,CAAK,SAAA,CAAU,EAAE,KAAA,EAAO,QAAA,EAAU,oBAAoB,CAAA;AACvE,IAAA,MAAM,MAAA,GAASH,OAAA,CAAM,GAAA,CAAI,QAAQ,CAAA;AACjC,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,GAAA,CAAI,KAAK,MAAM,CAAA;AACf,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,YAAY,cAAA,CAAe;AAAA,MAC/B,OAAA;AAAA,MACA,KAAA;AAAA,MACA,QAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,MAAA,CAAO,IAAA,CAAK,CAAA,yBAAA,EAA4B,SAAS,CAAA,CAAE,CAAA;AAEnD,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,MAAM,UAAU,UAAA,CAAW,MAAM,UAAA,CAAW,KAAA,IAAS,IAAM,CAAA;AAC3D,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,SAAA,EAAW;AAAA,QACxC,OAAA,EAAS;AAAA,UACP,MAAA,EAAQ,WAAA;AAAA,UACR,YAAA,EAAc;AAAA,SAChB;AAAA,QACA,QAAQ,UAAA,CAAW;AAAA,OACpB,CAAA;AACD,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAA,CAAO,IAAA;AAAA,UACL,CAAA,8BAAA,EAAiC,QAAA,CAAS,MAAM,CAAA,KAAA,EAAQ,SAAS,CAAA;AAAA,SACnE;AACA,QAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK;AAAA,UACnB,KAAA,EAAO,CAAA,uCAAA,EAA0C,QAAA,CAAS,MAAM,CAAA;AAAA,SACjE,CAAA;AACD,QAAA;AAAA,MACF;AACA,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,SAAS,KAAA,EAAO;AACd,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,8BAAA,EAAiC,KAAK,CAAA,CAAE,CAAA;AACpD,MAAA,GAAA,CAAI,OAAO,GAAG,CAAA,CAAE,KAAK,EAAE,KAAA,EAAO,mCAAmC,CAAA;AACjE,MAAA;AAAA,IACF,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,OAAO,CAAA;AAAA,IACtB;AAEA,IAAA,MAAM,OAAA,GAA4B;AAAA,MAChC,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,MAClC,KAAA;AAAA,MACA,QAAA;AAAA,MACA,kBAAA;AAAA,MACA,SAAA;AAAA,MACA,YAAA,EAAcI,wBAAA,CAAkB,IAAA,EAAM,OAAO;AAAA,KAC/C;AACA,IAAAJ,OAAA,CAAM,GAAA,CAAI,QAAA,EAAU,OAAA,EAAS,KAAK,CAAA;AAClC,IAAA,GAAA,CAAI,KAAK,OAAO,CAAA;AAAA,EAClB,CAAC,CAAA;AAED,EAAA,OAAO,MAAA;AACT;;"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@aag1999/plugin-github-trending-backend",
+  "version": "0.1.0",
+  "description": "Backend for the GitHub Trending Backstage plugin",
+  "backstage": {
+    "role": "backend-plugin",
+    "pluginId": "github-trending",
+    "pluginPackages": [
+      "@aag1999/plugin-github-trending",
+      "@aag1999/plugin-github-trending-backend",
+      "@aag1999/plugin-github-trending-common"
+    ],
+    "features": {
+      ".": "@backstage/BackendFeature"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AAG1999/backstage-plugin-github-trending",
+    "directory": "plugins/github-trending-backend"
+  },
+  "license": "Apache-2.0",
+  "main": "./dist/index.cjs.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "config.schema.json"
+  ],
+  "scripts": {
+    "start": "backstage-cli package start",
+    "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
+    "clean": "backstage-cli package clean",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack"
+  },
+  "dependencies": {
+    "@aag1999/plugin-github-trending-common": "workspace:^",
+    "@backstage/backend-plugin-api": "^1.10.0",
+    "@backstage/config": "^1.3.8",
+    "@backstage/errors": "^1.2.7",
+    "express": "^4.17.1",
+    "express-promise-router": "^4.1.0",
+    "yn": "^4.0.0"
+  },
+  "devDependencies": {
+    "@backstage/backend-test-utils": "^1.11.6",
+    "@backstage/cli": "^0.36.5",
+    "@types/express": "^4.17.21",
+    "@types/supertest": "^6.0.0",
+    "supertest": "^7.0.0"
+  },
+  "typesVersions": {
+    "*": {
+      "package.json": [
+        "package.json"
+      ]
+    }
+  }
+}