@letthem/backstage-plugin-aws-cost-insights-backend 0.2.0

package/README.md

@@ -0,0 +1,299 @@
+# Cost Insights Backend Plugin
+
+Backstage backend plugin that serves EC2 cost insights from S3 CUR-derived data.
+
+## Overview
+
+This plugin:
+
+- reads daily cost data files from S3
+- aggregates costs by resource
+- provides monthly rollups
+- exposes REST endpoints consumed by the frontend plugin
+
+## Configuration
+
+```yaml
+costInsights:
+  environments:
+    - dev
+    - stg
+    - prod
+  defaultEnvironment: prod
+  auth:
+    allowUnauthenticated: false
+  s3:
+    region: ap-northeast-2
+    bucket: your-cur-result-bucket
+    # Optional: local SSO profile
+    # profile: your-aws-profile
+    # Optional: prefix template
+    # Tokens: {environment}, {yearMonth}, {year}, {month}
+    dailyPrefixTemplate: '{environment}/daily/{yearMonth}/'
+```
+
+## Auth Behavior
+
+- `auth.allowUnauthenticated: false` -> `user-cookie`
+- `auth.allowUnauthenticated: true` -> `unauthenticated`
+
+Default is `false`.
+
+## AWS Credentials
+
+- If `s3.profile` is set, plugin uses that profile (local SSO use case).
+- If omitted, plugin uses AWS default credential chain:
+  - IRSA (EKS)
+  - EC2 Instance Profile
+  - environment variables
+  - shared credentials/default profile
+
+## API Endpoints
+
+- `GET /health`
+- `GET /config`
+- `GET /last-complete-date?environment=<env>`
+- `GET /product/ec2/insights?intervals=<ISO_START>/<ISO_END>&environment=<env>`
+
+## Query Rules
+
+- `environment` must exist in `costInsights.environments`.
+- `intervals` must be valid ISO interval (`start/end`).
+- `start <= end`.
+- max interval span is 24 months.
+
+## Data Loading Notes
+
+- The plugin resolves the latest `run=` prefix under month prefix.
+- It reads all data files in the run prefix (not just one file).
+- Non-numeric cost/usage rows are skipped to avoid `NaN` aggregation.
+
+## Input Data Contract
+
+This plugin is data-source agnostic. It does not require Athena specifically.
+Any upstream pipeline is valid as long as it writes data in the contract below.
+
+### Storage Layout
+
+- Base location is defined by `costInsights.s3.bucket`.
+- Prefix is resolved by `costInsights.s3.dailyPrefixTemplate`.
+- Default template:
+  - `'{environment}/daily/{yearMonth}/'`
+- Under each month prefix, plugin expects one or more `run=` folders:
+  - Example: `prd/daily/2026-01/run=2026-01-16T11-14-00/`
+
+### File Discovery Rules
+
+- All files under selected `run=` prefix are scanned.
+- Files ending with `-manifest.csv` are ignored.
+- Files ending with `.metadata` are ignored.
+- Directory markers (`.../`) are ignored.
+
+### File Format
+
+- NDJSON (JSON Lines): one JSON object per line.
+- UTF-8 text.
+
+### Required Fields (per line)
+
+- `usage_date`: string, ISO date (for example `2026-01-15`)
+- `resource_id`: string
+- `resource_type`: string
+- `total_cost`: number-like value
+- `usage_amount`: number-like value
+
+### Optional Fields
+
+- `product_instance_type`: string
+- `product_volume_type`: string
+
+### Validation Behavior
+
+- If `total_cost` or `usage_amount` is not numeric, that row is skipped.
+- Resource costs are aggregated by `resource_id`.
+- Daily points are sorted by `usage_date` before response.
+
+### Example NDJSON Line
+
+```json
+{"usage_date":"2026-01-15","resource_id":"i-0123456789abcdef0","resource_type":"instance","product_instance_type":"m6i.large","product_volume_type":"","total_cost":12.34,"usage_amount":24}
+```
+
+## Appendix: Example Athena UNLOAD Query
+
+Use this only as a reference implementation. Any pipeline is valid if it produces
+data that matches the Input Data Contract above.
+
+Replace placeholders before use:
+
+- `<cur_database>`, `<cur_table>`
+- `<year>`, `<month>`
+- `<bucket>`, `<environment>`, `<year-month>`, `<run-timestamp>`
+
+```sql
+UNLOAD (
+  SELECT
+    usage_date,
+    resource_id,
+    resource_type,
+    product_instance_type,
+    product_volume_type,
+    SUM(total_cost)   AS total_cost,
+    SUM(usage_amount) AS usage_amount
+  FROM (
+    SELECT
+      DATE(line_item_usage_start_date) AS usage_date,
+      line_item_resource_id AS resource_id,
+      'instance' AS resource_type,
+      product_instance_type AS product_instance_type,
+      '' AS product_volume_type,
+      SUM(line_item_unblended_cost) AS total_cost,
+      SUM(line_item_usage_amount) AS usage_amount
+    FROM <cur_database>.<cur_table>
+    WHERE
+      line_item_product_code = 'AmazonEC2'
+      AND product_product_family = 'Compute Instance'
+      AND line_item_line_item_type IN ('Usage', 'DiscountedUsage', 'SavingsPlanCoveredUsage')
+      AND year = '<year>'
+      AND month = '<month>'
+      AND line_item_resource_id IS NOT NULL
+    GROUP BY
+      DATE(line_item_usage_start_date),
+      line_item_resource_id,
+      product_instance_type
+
+    UNION ALL
+
+    SELECT
+      DATE(line_item_usage_start_date) AS usage_date,
+      line_item_resource_id AS resource_id,
+      CASE
+        WHEN product_product_family = 'Storage Snapshot' THEN 'snapshot'
+        ELSE 'volume'
+      END AS resource_type,
+      '' AS product_instance_type,
+      product_volume_type AS product_volume_type,
+      SUM(line_item_unblended_cost) AS total_cost,
+      SUM(line_item_usage_amount) AS usage_amount
+    FROM <cur_database>.<cur_table>
+    WHERE
+      line_item_product_code = 'AmazonEC2'
+      AND line_item_line_item_type = 'Usage'
+      AND year = '<year>'
+      AND month = '<month>'
+      AND product_product_family IN ('Storage', 'Storage Snapshot')
+      AND line_item_resource_id IS NOT NULL
+    GROUP BY
+      DATE(line_item_usage_start_date),
+      line_item_resource_id,
+      product_product_family,
+      product_volume_type
+
+    UNION ALL
+
+    SELECT
+      DATE(line_item_usage_start_date) AS usage_date,
+      COALESCE(line_item_resource_id, 'Unattached-IP') AS resource_id,
+      'elastic-ip' AS resource_type,
+      '' AS product_instance_type,
+      line_item_usage_type AS product_volume_type,
+      SUM(line_item_unblended_cost) AS total_cost,
+      SUM(line_item_usage_amount) AS usage_amount
+    FROM <cur_database>.<cur_table>
+    WHERE
+      line_item_product_code = 'AmazonEC2'
+      AND line_item_line_item_type = 'Usage'
+      AND year = '<year>'
+      AND month = '<month>'
+      AND product_product_family = 'IP Address'
+    GROUP BY
+      DATE(line_item_usage_start_date),
+      line_item_resource_id,
+      line_item_usage_type
+
+    UNION ALL
+
+    SELECT
+      DATE(line_item_usage_start_date) AS usage_date,
+      line_item_resource_id AS resource_id,
+      'nat-gateway' AS resource_type,
+      '' AS product_instance_type,
+      '' AS product_volume_type,
+      SUM(line_item_unblended_cost) AS total_cost,
+      SUM(line_item_usage_amount) AS usage_amount
+    FROM <cur_database>.<cur_table>
+    WHERE
+      line_item_product_code = 'AmazonEC2'
+      AND line_item_line_item_type = 'Usage'
+      AND year = '<year>'
+      AND month = '<month>'
+      AND (line_item_resource_id LIKE 'nat-%' OR product_product_family = 'NAT Gateway')
+      AND line_item_resource_id IS NOT NULL
+    GROUP BY
+      DATE(line_item_usage_start_date),
+      line_item_resource_id
+
+    UNION ALL
+
+    SELECT
+      DATE(line_item_usage_start_date) AS usage_date,
+      COALESCE(line_item_resource_id, 'Data-Transfer') AS resource_id,
+      'data-transfer' AS resource_type,
+      '' AS product_instance_type,
+      CASE
+        WHEN COUNT(DISTINCT product_transfer_type) > 1 THEN 'Mixed'
+        ELSE MAX(product_transfer_type)
+      END AS product_volume_type,
+      SUM(line_item_unblended_cost) AS total_cost,
+      SUM(line_item_usage_amount) AS usage_amount
+    FROM <cur_database>.<cur_table>
+    WHERE
+      line_item_product_code = 'AmazonEC2'
+      AND line_item_line_item_type = 'Usage'
+      AND year = '<year>'
+      AND month = '<month>'
+      AND product_product_family = 'Data Transfer'
+    GROUP BY
+      DATE(line_item_usage_start_date),
+      line_item_resource_id
+
+    UNION ALL
+
+    SELECT
+      DATE(line_item_usage_start_date) AS usage_date,
+      COALESCE(line_item_resource_id, 'VPC-Peering') AS resource_id,
+      'vpc' AS resource_type,
+      '' AS product_instance_type,
+      CASE
+        WHEN COUNT(DISTINCT product_product_family) > 1 THEN 'Mixed'
+        ELSE MAX(product_product_family)
+      END AS product_volume_type,
+      SUM(line_item_unblended_cost) AS total_cost,
+      SUM(line_item_usage_amount) AS usage_amount
+    FROM <cur_database>.<cur_table>
+    WHERE
+      line_item_product_code = 'AmazonEC2'
+      AND line_item_line_item_type = 'Usage'
+      AND year = '<year>'
+      AND month = '<month>'
+      AND (
+        line_item_resource_id LIKE 'vpce-%'
+        OR product_product_family IN ('VPC Peering', 'VpcEndpoint')
+      )
+    GROUP BY
+      DATE(line_item_usage_start_date),
+      line_item_resource_id
+  )
+  GROUP BY
+    usage_date,
+    resource_id,
+    resource_type,
+    product_instance_type,
+    product_volume_type
+)
+TO 's3://<bucket>/<environment>/daily/<year-month>/run=<run-timestamp>/'
+WITH (
+  format = 'JSON',
+  compression = 'NONE'
+);
+```

package/config.d.ts

@@ -0,0 +1,54 @@
+export interface Config {
+  costInsights?: {
+    /**
+     * Environment ids exposed to the UI and API.
+     * @example ['dev', 'stg', 'prod']
+     */
+    environments?: string[];
+
+    /**
+     * Default environment used when query param is omitted.
+     * Must exist in `costInsights.environments`.
+     * @example 'prod'
+     */
+    defaultEnvironment?: string;
+
+    /**
+     * HTTP auth behavior for cost-insights backend routes.
+     */
+    auth?: {
+      /**
+       * Allow unauthenticated access.
+       * Keep false by default for safer deployments.
+       * @default false
+       */
+      allowUnauthenticated?: boolean;
+    };
+
+    s3?: {
+      /**
+       * AWS region.
+       * @example 'ap-northeast-2'
+       */
+      region: string;
+
+      /**
+       * CUR result bucket name.
+       */
+      bucket: string;
+
+      /**
+       * Optional AWS profile for local/SSO usage.
+       * If omitted, default credential chain is used.
+       */
+      profile?: string;
+
+      /**
+       * Prefix template for daily files.
+       * Supported tokens: {environment}, {yearMonth}, {year}, {month}
+       * @default '{environment}/daily/{yearMonth}/'
+       */
+      dailyPrefixTemplate?: string;
+    };
+  };
+}

package/dist/index.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var plugin = require('./plugin.cjs.js');
+
+
+
+exports.default = plugin.costInsightsPlugin;
+//# 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,5 @@
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+
+declare const costInsightsPlugin: _backstage_backend_plugin_api.BackendFeature;
+
+export { costInsightsPlugin as default };

package/dist/plugin.cjs.js

@@ -0,0 +1,30 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var router = require('./service/router.cjs.js');
+
+const costInsightsPlugin = backendPluginApi.createBackendPlugin({
+  pluginId: "cost-insights",
+  register(env) {
+    env.registerInit({
+      deps: {
+        logger: backendPluginApi.coreServices.logger,
+        config: backendPluginApi.coreServices.rootConfig,
+        httpRouter: backendPluginApi.coreServices.httpRouter
+      },
+      async init({ logger, config, httpRouter }) {
+        const router$1 = await router.createRouter({ logger, config });
+        httpRouter.use(router$1);
+        const costInsightsConfig = config.getOptionalConfig("costInsights");
+        const allowUnauthenticated = costInsightsConfig?.getOptionalBoolean("auth.allowUnauthenticated") ?? false;
+        httpRouter.addAuthPolicy({
+          path: "/",
+          allow: allowUnauthenticated ? "unauthenticated" : "user-cookie"
+        });
+      }
+    });
+  }
+});
+
+exports.costInsightsPlugin = costInsightsPlugin;
+//# 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":["import {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\n\nexport const costInsightsPlugin = createBackendPlugin({\n  pluginId: 'cost-insights',\n  register(env) {\n    env.registerInit({\n      deps: {\n        logger: coreServices.logger,\n        config: coreServices.rootConfig,\n        httpRouter: coreServices.httpRouter,\n      },\n      async init({ logger, config, httpRouter }) {\n        const router = await createRouter({ logger, config });\n        httpRouter.use(router);\n\n        const costInsightsConfig = config.getOptionalConfig('costInsights');\n        const allowUnauthenticated =\n          costInsightsConfig?.getOptionalBoolean('auth.allowUnauthenticated') ??\n          false;\n\n        httpRouter.addAuthPolicy({\n          path: '/',\n          allow: allowUnauthenticated ? 'unauthenticated' : 'user-cookie',\n        });\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","coreServices","router","createRouter"],"mappings":";;;;;AAMO,MAAM,qBAAqBA,oCAAA,CAAoB;AAAA,EACpD,QAAA,EAAU,eAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,QAAQC,6BAAA,CAAa,MAAA;AAAA,QACrB,QAAQA,6BAAA,CAAa,UAAA;AAAA,QACrB,YAAYA,6BAAA,CAAa;AAAA,OAC3B;AAAA,MACA,MAAM,IAAA,CAAK,EAAE,MAAA,EAAQ,MAAA,EAAQ,YAAW,EAAG;AACzC,QAAA,MAAMC,WAAS,MAAMC,mBAAA,CAAa,EAAE,MAAA,EAAQ,QAAQ,CAAA;AACpD,QAAA,UAAA,CAAW,IAAID,QAAM,CAAA;AAErB,QAAA,MAAM,kBAAA,GAAqB,MAAA,CAAO,iBAAA,CAAkB,cAAc,CAAA;AAClE,QAAA,MAAM,oBAAA,GACJ,kBAAA,EAAoB,kBAAA,CAAmB,2BAA2B,CAAA,IAClE,KAAA;AAEF,QAAA,UAAA,CAAW,aAAA,CAAc;AAAA,UACvB,IAAA,EAAM,GAAA;AAAA,UACN,KAAA,EAAO,uBAAuB,iBAAA,GAAoB;AAAA,SACnD,CAAA;AAAA,MACH;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}

package/dist/service/S3CostDataClient.cjs.js

@@ -0,0 +1,285 @@
+'use strict';
+
+var clientS3 = require('@aws-sdk/client-s3');
+var credentialProviders = require('@aws-sdk/credential-providers');
+
+function streamToString(stream) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    stream.on("data", (chunk) => chunks.push(chunk));
+    stream.on("error", reject);
+    stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+  });
+}
+async function findLatestRunPrefix(params) {
+  const { s3, bucket, monthPrefix } = params;
+  const res = await s3.send(
+    new clientS3.ListObjectsV2Command({
+      Bucket: bucket,
+      Prefix: monthPrefix,
+      Delimiter: "/"
+      // List "folders" as CommonPrefixes
+    })
+  );
+  const runs = (res.CommonPrefixes ?? []).map((p) => p.Prefix).filter((p) => !!p).filter((p) => p.includes("run="));
+  if (runs.length === 0) {
+    throw new Error(
+      `No run prefixes found under: s3://${bucket}/${monthPrefix}`
+    );
+  }
+  runs.sort();
+  return runs[runs.length - 1];
+}
+async function findDataFileKeys(params) {
+  const { s3, bucket, runPrefix } = params;
+  const res = await s3.send(
+    new clientS3.ListObjectsV2Command({
+      Bucket: bucket,
+      Prefix: runPrefix
+    })
+  );
+  const dataFiles = (res.Contents ?? []).map((o) => o.Key).filter((k) => !!k).filter((k) => !k.endsWith("-manifest.csv")).filter((k) => !k.endsWith(".metadata")).filter((k) => !k.endsWith("/")).sort();
+  if (dataFiles.length === 0) {
+    throw new Error(
+      `No data files found under: s3://${bucket}/${runPrefix}`
+    );
+  }
+  return dataFiles;
+}
+function parseNdjsonDailyCostRows(ndjson) {
+  const rows = [];
+  for (const line of ndjson.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    const obj = JSON.parse(trimmed);
+    const totalCost = Number(obj.total_cost);
+    const usageAmount = Number(obj.usage_amount);
+    if (!Number.isFinite(totalCost) || !Number.isFinite(usageAmount)) {
+      continue;
+    }
+    rows.push({
+      usage_date: obj.usage_date,
+      resource_id: obj.resource_id,
+      resource_type: obj.resource_type,
+      product_instance_type: obj.product_instance_type ?? "",
+      product_volume_type: obj.product_volume_type ?? "",
+      total_cost: totalCost,
+      usage_amount: usageAmount
+    });
+  }
+  return rows;
+}
+function mapResourceType(s3Type) {
+  const normalized = s3Type.toLowerCase();
+  if (normalized.includes("instance") || normalized.includes("compute"))
+    return "instance";
+  if (normalized.includes("elastic-ip") || normalized.includes("ip address"))
+    return "elastic-ip";
+  if (normalized.includes("snapshot")) return "snapshot";
+  if (normalized.includes("volume") || normalized.includes("storage"))
+    return "volume";
+  if (normalized.includes("nat")) return "nat-gateway";
+  if (normalized.includes("transfer")) return "data-transfer";
+  if (normalized.includes("vpc") || normalized.includes("endpoint"))
+    return "vpc";
+  return "other";
+}
+class S3CostDataClient {
+  constructor(logger, config) {
+    this.logger = logger;
+    const credentialConfig = config.profile ? {
+      region: config.region,
+      credentials: credentialProviders.fromNodeProviderChain({
+        profile: config.profile
+      })
+    } : {
+      region: config.region
+    };
+    this.client = new clientS3.S3Client(credentialConfig);
+    this.bucket = config.bucket;
+    this.dailyPrefixTemplate = config.dailyPrefixTemplate || "{environment}/daily/{yearMonth}/";
+    const authMethod = config.profile ? `SSO Profile: ${config.profile}` : "Default credential chain (IRSA/EC2 instance profile)";
+    this.logger.info(
+      `[CostInsights] S3CostDataClient initialized successfully - Auth: ${authMethod}, Bucket: ${this.bucket}, Region: ${config.region}`
+    );
+  }
+  client;
+  bucket;
+  dailyPrefixTemplate;
+  buildDailyPrefix(params) {
+    const { environment, year, month } = params;
+    const paddedMonth = month.padStart(2, "0");
+    const yearMonth = `${year}-${paddedMonth}`;
+    return this.dailyPrefixTemplate.replace("{environment}", environment).replace("{yearMonth}", yearMonth).replace("{year}", year).replace("{month}", paddedMonth);
+  }
+  async queryEC2Resources(environment, year, month) {
+    const paddedMonth = month.padStart(2, "0");
+    const yearMonth = `${year}-${paddedMonth}`;
+    const monthPrefix = this.buildDailyPrefix({ environment, year, month });
+    this.logger.info(
+      `[CostInsights] Loading daily EC2 data from S3: ${environment}/${yearMonth}`
+    );
+    const runPrefix = await findLatestRunPrefix({
+      s3: this.client,
+      bucket: this.bucket,
+      monthPrefix
+    });
+    this.logger.debug(`[CostInsights] Found run prefix: ${runPrefix}`);
+    const dataFileKeys = await findDataFileKeys({
+      s3: this.client,
+      bucket: this.bucket,
+      runPrefix
+    });
+    this.logger.debug(
+      `[CostInsights] Found ${dataFileKeys.length} data files under ${runPrefix}`
+    );
+    const rowsByFile = await Promise.all(
+      dataFileKeys.map(async (dataFileKey) => {
+        const dataObj = await this.client.send(
+          new clientS3.GetObjectCommand({
+            Bucket: this.bucket,
+            Key: dataFileKey
+          })
+        );
+        if (!dataObj.Body) {
+          throw new Error(
+            `Data file has empty body: s3://${this.bucket}/${dataFileKey}`
+          );
+        }
+        const ndjson = await streamToString(dataObj.Body);
+        return parseNdjsonDailyCostRows(ndjson);
+      })
+    );
+    const dailyRows = rowsByFile.flat();
+    this.logger.info(
+      `[CostInsights] Loaded ${dailyRows.length} daily records from S3 for ${environment}/${yearMonth}`
+    );
+    const resourceMap = /* @__PURE__ */ new Map();
+    dailyRows.forEach((row) => {
+      const key = row.resource_id;
+      if (!resourceMap.has(key)) {
+        resourceMap.set(key, {
+          resourceType: row.resource_type,
+          instanceType: row.product_instance_type,
+          volumeType: row.product_volume_type,
+          totalCost: 0,
+          usageAmount: 0,
+          dailyCosts: []
+        });
+      }
+      const resource = resourceMap.get(key);
+      resource.totalCost += row.total_cost;
+      resource.usageAmount += row.usage_amount;
+      resource.dailyCosts.push({
+        date: row.usage_date,
+        cost: row.total_cost
+      });
+    });
+    const result = [];
+    resourceMap.forEach((data, resourceId) => {
+      result.push({
+        resourceId: resourceId || "Unknown",
+        resourceType: mapResourceType(data.resourceType),
+        instanceType: data.instanceType || void 0,
+        volumeType: data.volumeType || void 0,
+        totalCost: data.totalCost,
+        usageAmount: data.usageAmount,
+        dailyCosts: data.dailyCosts.sort((a, b) => a.date.localeCompare(b.date))
+      });
+    });
+    result.sort((a, b) => b.totalCost - a.totalCost);
+    this.logger.info(
+      `[CostInsights] Aggregated ${result.length} resources from ${dailyRows.length} daily records`
+    );
+    return result;
+  }
+  /**
+   * Query monthly EC2 costs for a specific environment
+   * Reads daily data for each month and aggregates by resource type
+   * @param environment - legacy, dev, or prd
+   * @param numMonths - number of months to look back (default: 6)
+   */
+  async queryMonthlyEC2Costs(environment, numMonths = 6) {
+    const now = /* @__PURE__ */ new Date();
+    const monthlyData = [];
+    this.logger.info(
+      `[CostInsights] Loading monthly costs for ${environment}, last ${numMonths} months`
+    );
+    for (let i = numMonths - 1; i >= 0; i--) {
+      const targetDate = new Date(
+        now.getFullYear(),
+        now.getMonth() - i,
+        1
+      );
+      const year = targetDate.getFullYear().toString();
+      const month = (targetDate.getMonth() + 1).toString();
+      const paddedMonth = month.padStart(2, "0");
+      const monthKey = `${year}-${paddedMonth}`;
+      try {
+        const resources = await this.queryEC2Resources(
+          environment,
+          year,
+          month
+        );
+        const monthData = {
+          month: monthKey,
+          instances: 0,
+          volume: 0,
+          elasticIp: 0,
+          natGateway: 0,
+          dataTransfer: 0,
+          vpc: 0,
+          total: 0
+        };
+        resources.forEach((resource) => {
+          switch (resource.resourceType) {
+            case "instance":
+              monthData.instances += resource.totalCost;
+              break;
+            case "volume":
+            case "snapshot":
+              monthData.volume += resource.totalCost;
+              break;
+            case "elastic-ip":
+              monthData.elasticIp += resource.totalCost;
+              break;
+            case "nat-gateway":
+              monthData.natGateway += resource.totalCost;
+              break;
+            case "data-transfer":
+              monthData.dataTransfer += resource.totalCost;
+              break;
+            case "vpc":
+              monthData.vpc += resource.totalCost;
+              break;
+            default:
+              break;
+          }
+          monthData.total += resource.totalCost;
+        });
+        monthlyData.push(monthData);
+        this.logger.debug(
+          `[CostInsights] Monthly data for ${monthKey}: $${monthData.total.toFixed(2)}`
+        );
+      } catch (error) {
+        this.logger.warn(
+          `[CostInsights] Failed to load data for ${environment}/${monthKey}: ${error}`
+        );
+        monthlyData.push({
+          month: monthKey,
+          instances: 0,
+          volume: 0,
+          elasticIp: 0,
+          natGateway: 0,
+          dataTransfer: 0,
+          vpc: 0,
+          total: 0
+        });
+      }
+    }
+    return monthlyData;
+  }
+}
+
+exports.S3CostDataClient = S3CostDataClient;
+//# sourceMappingURL=S3CostDataClient.cjs.js.map

package/dist/service/S3CostDataClient.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3CostDataClient.cjs.js","sources":["../../src/service/S3CostDataClient.ts"],"sourcesContent":["import {\n  S3Client,\n  ListObjectsV2Command,\n  GetObjectCommand,\n} from '@aws-sdk/client-s3';\nimport { fromNodeProviderChain } from '@aws-sdk/credential-providers';\nimport type { LoggerService } from '@backstage/backend-plugin-api';\nimport { Readable } from 'stream';\n\nexport interface EC2ResourceData {\n  resourceId: string;\n  resourceType:\n    | 'instance'\n    | 'elastic-ip'\n    | 'other'\n    | 'snapshot'\n    | 'volume'\n    | 'nat-gateway'\n    | 'data-transfer'\n    | 'vpc';\n  instanceType?: string;\n  volumeType?: string;\n  totalCost: number;\n  usageAmount: number;\n  dailyCosts: Array<{\n    date: string;\n    cost: number;\n  }>;\n}\n\nexport interface MonthlyCostData {\n  month: string;\n  instances: number;\n  volume: number;\n  elasticIp: number;\n  natGateway: number;\n  dataTransfer: number;\n  vpc: number;\n  total: number;\n}\n\ninterface S3DailyCostRow {\n  usage_date: string;\n  resource_id: string;\n  resource_type: string;\n  product_instance_type: string;\n  product_volume_type: string;\n  total_cost: number;\n  usage_amount: number;\n}\n\n/**\n * Convert S3 readable stream to string\n */\nfunction streamToString(stream: Readable): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    stream.on('data', (chunk: Buffer) => chunks.push(chunk));\n    stream.on('error', reject);\n    stream.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));\n  });\n}\n\n/**\n * Find the latest run prefix under a month prefix\n * Example: legacy/daily/2026-01/ -> legacy/daily/2026-01/run=2026-01-16T11-14-00/\n */\nasync function findLatestRunPrefix(params: {\n  s3: S3Client;\n  bucket: string;\n  monthPrefix: string;\n}): Promise<string> {\n  const { s3, bucket, monthPrefix } = params;\n\n  const res = await s3.send(\n    new ListObjectsV2Command({\n      Bucket: bucket,\n      Prefix: monthPrefix,\n      Delimiter: '/', // List \"folders\" as CommonPrefixes\n    }),\n  );\n\n  const runs = (res.CommonPrefixes ?? [])\n    .map(p => p.Prefix)\n    .filter((p): p is string => !!p)\n    .filter(p => p.includes('run=')); // Only run=YYYY-MM-DDTHH-mm-ss/\n\n  if (runs.length === 0) {\n    throw new Error(\n      `No run prefixes found under: s3://${bucket}/${monthPrefix}`,\n    );\n  }\n\n  runs.sort();\n  return runs[runs.length - 1];\n}\n\n/**\n * Find data files under a run prefix (without manifest)\n * Returns all data files found\n */\nasync function findDataFileKeys(params: {\n  s3: S3Client;\n  bucket: string;\n  runPrefix: string;\n}): Promise<string[]> {\n  const { s3, bucket, runPrefix } = params;\n\n  const res = await s3.send(\n    new ListObjectsV2Command({\n      Bucket: bucket,\n      Prefix: runPrefix,\n    }),\n  );\n\n  const dataFiles = (res.Contents ?? [])\n    .map(o => o.Key)\n    .filter((k): k is string => !!k)\n    .filter(k => !k.endsWith('-manifest.csv'))\n    .filter(k => !k.endsWith('.metadata'))\n    .filter(k => !k.endsWith('/'))\n    .sort();\n\n  if (dataFiles.length === 0) {\n    throw new Error(\n      `No data files found under: s3://${bucket}/${runPrefix}`,\n    );\n  }\n\n  return dataFiles;\n}\n\n/**\n * Parse NDJSON (JSON Lines) to S3DailyCostRow array\n */\nfunction parseNdjsonDailyCostRows(ndjson: string): S3DailyCostRow[] {\n  const rows: S3DailyCostRow[] = [];\n\n  for (const line of ndjson.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n\n    const obj = JSON.parse(trimmed);\n\n    const totalCost = Number(obj.total_cost);\n    const usageAmount = Number(obj.usage_amount);\n    if (!Number.isFinite(totalCost) || !Number.isFinite(usageAmount)) {\n      continue;\n    }\n\n    rows.push({\n      usage_date: obj.usage_date,\n      resource_id: obj.resource_id,\n      resource_type: obj.resource_type,\n      product_instance_type: obj.product_instance_type ?? '',\n      product_volume_type: obj.product_volume_type ?? '',\n      total_cost: totalCost,\n      usage_amount: usageAmount,\n    });\n  }\n\n  return rows;\n}\n\n/**\n * Map S3 resource_type to EC2ResourceData resourceType\n */\nfunction mapResourceType(s3Type: string): EC2ResourceData['resourceType'] {\n  const normalized = s3Type.toLowerCase();\n\n  if (normalized.includes('instance') || normalized.includes('compute'))\n    return 'instance';\n  if (normalized.includes('elastic-ip') || normalized.includes('ip address'))\n    return 'elastic-ip';\n  if (normalized.includes('snapshot')) return 'snapshot';\n  if (normalized.includes('volume') || normalized.includes('storage'))\n    return 'volume';\n  if (normalized.includes('nat')) return 'nat-gateway';\n  if (normalized.includes('transfer')) return 'data-transfer';\n  if (normalized.includes('vpc') || normalized.includes('endpoint'))\n    return 'vpc';\n\n  return 'other';\n}\n\nexport class S3CostDataClient {\n  private client: S3Client;\n  private bucket: string;\n  private dailyPrefixTemplate: string;\n\n  constructor(\n    private readonly logger: LoggerService,\n    config: {\n      region: string;\n      bucket: string;\n      profile?: string;\n      dailyPrefixTemplate?: string;\n    },\n  ) {\n    const credentialConfig = config.profile\n      ? {\n          region: config.region,\n          credentials: fromNodeProviderChain({\n            profile: config.profile,\n          }),\n        }\n      : {\n          region: config.region,\n        };\n\n    this.client = new S3Client(credentialConfig);\n    this.bucket = config.bucket;\n    this.dailyPrefixTemplate =\n      config.dailyPrefixTemplate || '{environment}/daily/{yearMonth}/';\n\n    const authMethod = config.profile\n      ? `SSO Profile: ${config.profile}`\n      : 'Default credential chain (IRSA/EC2 instance profile)';\n\n    this.logger.info(\n      `[CostInsights] S3CostDataClient initialized successfully - Auth: ${authMethod}, Bucket: ${this.bucket}, Region: ${config.region}`,\n    );\n  }\n\n  private buildDailyPrefix(params: {\n    environment: string;\n    year: string;\n    month: string;\n  }): string {\n    const { environment, year, month } = params;\n    const paddedMonth = month.padStart(2, '0');\n    const yearMonth = `${year}-${paddedMonth}`;\n\n    return this.dailyPrefixTemplate\n      .replace('{environment}', environment)\n      .replace('{yearMonth}', yearMonth)\n      .replace('{year}', year)\n      .replace('{month}', paddedMonth);\n  }\n\n  async queryEC2Resources(\n    environment: string,\n    year: string,\n    month: string,\n  ): Promise<EC2ResourceData[]> {\n    const paddedMonth = month.padStart(2, '0');\n    const yearMonth = `${year}-${paddedMonth}`;\n    const monthPrefix = this.buildDailyPrefix({ environment, year, month });\n\n    this.logger.info(\n      `[CostInsights] Loading daily EC2 data from S3: ${environment}/${yearMonth}`,\n    );\n\n    const runPrefix = await findLatestRunPrefix({\n      s3: this.client,\n      bucket: this.bucket,\n      monthPrefix,\n    });\n\n    this.logger.debug(`[CostInsights] Found run prefix: ${runPrefix}`);\n\n    const dataFileKeys = await findDataFileKeys({\n      s3: this.client,\n      bucket: this.bucket,\n      runPrefix,\n    });\n\n    this.logger.debug(\n      `[CostInsights] Found ${dataFileKeys.length} data files under ${runPrefix}`,\n    );\n\n    const rowsByFile = await Promise.all(\n      dataFileKeys.map(async dataFileKey => {\n        const dataObj = await this.client.send(\n          new GetObjectCommand({\n            Bucket: this.bucket,\n            Key: dataFileKey,\n          }),\n        );\n\n        if (!dataObj.Body) {\n          throw new Error(\n            `Data file has empty body: s3://${this.bucket}/${dataFileKey}`,\n          );\n        }\n\n        const ndjson = await streamToString(dataObj.Body as Readable);\n        return parseNdjsonDailyCostRows(ndjson);\n      }),\n    );\n    const dailyRows = rowsByFile.flat();\n\n    this.logger.info(\n      `[CostInsights] Loaded ${dailyRows.length} daily records from S3 for ${environment}/${yearMonth}`,\n    );\n\n    const resourceMap = new Map<string, {\n      resourceType: string;\n      instanceType: string;\n      volumeType: string;\n      totalCost: number;\n      usageAmount: number;\n      dailyCosts: Array<{ date: string; cost: number }>;\n    }>();\n\n    dailyRows.forEach(row => {\n      const key = row.resource_id;\n\n      if (!resourceMap.has(key)) {\n        resourceMap.set(key, {\n          resourceType: row.resource_type,\n          instanceType: row.product_instance_type,\n          volumeType: row.product_volume_type,\n          totalCost: 0,\n          usageAmount: 0,\n          dailyCosts: [],\n        });\n      }\n\n      const resource = resourceMap.get(key)!;\n      resource.totalCost += row.total_cost;\n      resource.usageAmount += row.usage_amount;\n      resource.dailyCosts.push({\n        date: row.usage_date,\n        cost: row.total_cost,\n      });\n    });\n\n    const result: EC2ResourceData[] = [];\n\n    resourceMap.forEach((data, resourceId) => {\n      result.push({\n        resourceId: resourceId || 'Unknown',\n        resourceType: mapResourceType(data.resourceType),\n        instanceType: data.instanceType || undefined,\n        volumeType: data.volumeType || undefined,\n        totalCost: data.totalCost,\n        usageAmount: data.usageAmount,\n        dailyCosts: data.dailyCosts.sort((a, b) => a.date.localeCompare(b.date)),\n      });\n    });\n\n    result.sort((a, b) => b.totalCost - a.totalCost);\n\n    this.logger.info(\n      `[CostInsights] Aggregated ${result.length} resources from ${dailyRows.length} daily records`,\n    );\n\n    return result;\n  }\n\n  /**\n   * Query monthly EC2 costs for a specific environment\n   * Reads daily data for each month and aggregates by resource type\n   * @param environment - legacy, dev, or prd\n   * @param numMonths - number of months to look back (default: 6)\n   */\n  async queryMonthlyEC2Costs(\n    environment: string,\n    numMonths: number = 6,\n  ): Promise<MonthlyCostData[]> {\n    const now = new Date();\n    const monthlyData: MonthlyCostData[] = [];\n\n    this.logger.info(\n      `[CostInsights] Loading monthly costs for ${environment}, last ${numMonths} months`,\n    );\n\n    for (let i = numMonths - 1; i >= 0; i--) {\n      const targetDate = new Date(\n        now.getFullYear(),\n        now.getMonth() - i,\n        1,\n      );\n      const year = targetDate.getFullYear().toString();\n      const month = (targetDate.getMonth() + 1).toString();\n      const paddedMonth = month.padStart(2, '0');\n      const monthKey = `${year}-${paddedMonth}`;\n\n      try {\n        const resources = await this.queryEC2Resources(\n          environment,\n          year,\n          month,\n        );\n\n        const monthData: MonthlyCostData = {\n          month: monthKey,\n          instances: 0,\n          volume: 0,\n          elasticIp: 0,\n          natGateway: 0,\n          dataTransfer: 0,\n          vpc: 0,\n          total: 0,\n        };\n\n        resources.forEach(resource => {\n          switch (resource.resourceType) {\n            case 'instance':\n              monthData.instances += resource.totalCost;\n              break;\n            case 'volume':\n            case 'snapshot':\n              monthData.volume += resource.totalCost;\n              break;\n            case 'elastic-ip':\n              monthData.elasticIp += resource.totalCost;\n              break;\n            case 'nat-gateway':\n              monthData.natGateway += resource.totalCost;\n              break;\n            case 'data-transfer':\n              monthData.dataTransfer += resource.totalCost;\n              break;\n            case 'vpc':\n              monthData.vpc += resource.totalCost;\n              break;\n            default:\n              break;\n          }\n          monthData.total += resource.totalCost;\n        });\n\n        monthlyData.push(monthData);\n\n        this.logger.debug(\n          `[CostInsights] Monthly data for ${monthKey}: $${monthData.total.toFixed(2)}`,\n        );\n      } catch (error) {\n        this.logger.warn(\n          `[CostInsights] Failed to load data for ${environment}/${monthKey}: ${error}`,\n        );\n        monthlyData.push({\n          month: monthKey,\n          instances: 0,\n          volume: 0,\n          elasticIp: 0,\n          natGateway: 0,\n          dataTransfer: 0,\n          vpc: 0,\n          total: 0,\n        });\n      }\n    }\n\n    return monthlyData;\n  }\n}\n"],"names":["ListObjectsV2Command","fromNodeProviderChain","S3Client","GetObjectCommand"],"mappings":"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"}

package/dist/service/S3CostInsightsClient.cjs.js

@@ -0,0 +1,94 @@
+'use strict';
+
+var luxon = require('luxon');
+
+const DEFAULT_DATE_FORMAT = "yyyy-LL-dd";
+class S3CostInsightsClient {
+  constructor(s3Client, logger) {
+    this.s3Client = s3Client;
+    this.logger = logger;
+  }
+  async getLastCompleteBillingDate() {
+    return luxon.DateTime.now().minus({ days: 1 }).toFormat(DEFAULT_DATE_FORMAT);
+  }
+  async getEC2Insights(intervals, environment) {
+    const [startDateStr, endDateStr] = intervals.split("/");
+    const startDate = luxon.DateTime.fromISO(startDateStr ?? "", { setZone: true });
+    const endDate = luxon.DateTime.fromISO(endDateStr ?? "", { setZone: true });
+    if (!startDate.isValid || !endDate.isValid) {
+      throw new Error(`Invalid intervals: ${intervals}`);
+    }
+    if (startDate > endDate) {
+      throw new Error(`Invalid intervals, start > end: ${intervals}`);
+    }
+    const months = [];
+    let cursor = startDate.startOf("month");
+    const last = endDate.startOf("month");
+    while (cursor <= last) {
+      months.push({
+        year: cursor.toFormat("yyyy"),
+        month: cursor.toFormat("M")
+      });
+      cursor = cursor.plus({ months: 1 });
+    }
+    this.logger.info(
+      `[CostInsights] Fetching EC2 resources for ${environment}, months=${months.length}, interval=${intervals}`
+    );
+    const monthlyResources = await Promise.all(
+      months.map(
+        ({ year, month }) => this.s3Client.queryEC2Resources(environment, year, month)
+      )
+    );
+    const merged = /* @__PURE__ */ new Map();
+    for (const resources of monthlyResources) {
+      for (const resource of resources) {
+        const key = resource.resourceId || "Unknown";
+        const existing = merged.get(key);
+        if (!existing) {
+          merged.set(key, {
+            ...resource,
+            dailyCosts: [...resource.dailyCosts]
+          });
+          continue;
+        }
+        existing.totalCost += resource.totalCost;
+        existing.usageAmount += resource.usageAmount;
+        existing.dailyCosts.push(...resource.dailyCosts);
+      }
+    }
+    const ec2Resources = Array.from(merged.values()).map((resource) => ({
+      ...resource,
+      dailyCosts: resource.dailyCosts.sort(
+        (a, b) => a.date.localeCompare(b.date)
+      )
+    })).sort((a, b) => b.totalCost - a.totalCost);
+    const totalCost = ec2Resources.reduce((sum, r) => sum + r.totalCost, 0);
+    const monthlyData = await this.s3Client.queryMonthlyEC2Costs(
+      environment,
+      12
+    );
+    const entities = ec2Resources.map((resource) => ({
+      id: resource.resourceId || "Unknown",
+      resourceId: resource.resourceId,
+      resourceType: resource.resourceType,
+      instanceType: resource.instanceType,
+      volumeType: resource.volumeType,
+      totalCost: resource.totalCost,
+      usageAmount: resource.usageAmount,
+      dailyCosts: resource.dailyCosts,
+      entities: {},
+      aggregation: [resource.totalCost, 0],
+      change: { ratio: 0, amount: 0 }
+    }));
+    return {
+      id: "ec2",
+      entities: { ec2: entities },
+      monthlyData,
+      aggregation: [totalCost, 0],
+      change: { ratio: 0, amount: 0 }
+    };
+  }
+}
+
+exports.S3CostInsightsClient = S3CostInsightsClient;
+//# sourceMappingURL=S3CostInsightsClient.cjs.js.map

package/dist/service/S3CostInsightsClient.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3CostInsightsClient.cjs.js","sources":["../../src/service/S3CostInsightsClient.ts"],"sourcesContent":["import type { LoggerService } from '@backstage/backend-plugin-api';\nimport { DateTime } from 'luxon';\nimport type { EC2ResourceData, S3CostDataClient } from './S3CostDataClient';\n\nconst DEFAULT_DATE_FORMAT = 'yyyy-LL-dd';\n\nexport class S3CostInsightsClient {\n  constructor(\n    private readonly s3Client: S3CostDataClient,\n    private readonly logger: LoggerService,\n  ) {}\n\n  async getLastCompleteBillingDate(): Promise<string> {\n    return DateTime.now().minus({ days: 1 }).toFormat(DEFAULT_DATE_FORMAT);\n  }\n\n  async getEC2Insights(\n    intervals: string,\n    environment: string,\n  ) {\n    const [startDateStr, endDateStr] = intervals.split('/');\n    const startDate = DateTime.fromISO(startDateStr ?? '', { setZone: true });\n    const endDate = DateTime.fromISO(endDateStr ?? '', { setZone: true });\n\n    if (!startDate.isValid || !endDate.isValid) {\n      throw new Error(`Invalid intervals: ${intervals}`);\n    }\n    if (startDate > endDate) {\n      throw new Error(`Invalid intervals, start > end: ${intervals}`);\n    }\n\n    const months: Array<{ year: string; month: string }> = [];\n    let cursor = startDate.startOf('month');\n    const last = endDate.startOf('month');\n    while (cursor <= last) {\n      months.push({\n        year: cursor.toFormat('yyyy'),\n        month: cursor.toFormat('M'),\n      });\n      cursor = cursor.plus({ months: 1 });\n    }\n\n    this.logger.info(\n      `[CostInsights] Fetching EC2 resources for ${environment}, months=${months.length}, interval=${intervals}`,\n    );\n\n    const monthlyResources = await Promise.all(\n      months.map(({ year, month }) =>\n        this.s3Client.queryEC2Resources(environment, year, month),\n      ),\n    );\n\n    const merged = new Map<string, EC2ResourceData>();\n    for (const resources of monthlyResources) {\n      for (const resource of resources) {\n        const key = resource.resourceId || 'Unknown';\n        const existing = merged.get(key);\n        if (!existing) {\n          merged.set(key, {\n            ...resource,\n            dailyCosts: [...resource.dailyCosts],\n          });\n          continue;\n        }\n\n        existing.totalCost += resource.totalCost;\n        existing.usageAmount += resource.usageAmount;\n        existing.dailyCosts.push(...resource.dailyCosts);\n      }\n    }\n\n    const ec2Resources = Array.from(merged.values())\n      .map(resource => ({\n        ...resource,\n        dailyCosts: resource.dailyCosts.sort((a, b) =>\n          a.date.localeCompare(b.date),\n        ),\n      }))\n      .sort((a, b) => b.totalCost - a.totalCost);\n\n    const totalCost = ec2Resources.reduce((sum, r) => sum + r.totalCost, 0);\n\n    // Always fetch 12 months for frontend flexibility (6/12 months toggle)\n    const monthlyData = await this.s3Client.queryMonthlyEC2Costs(\n      environment,\n      12,\n    );\n\n    const entities = ec2Resources.map(resource => ({\n      id: resource.resourceId || 'Unknown',\n      resourceId: resource.resourceId,\n      resourceType: resource.resourceType,\n      instanceType: resource.instanceType,\n      volumeType: resource.volumeType,\n      totalCost: resource.totalCost,\n      usageAmount: resource.usageAmount,\n      dailyCosts: resource.dailyCosts,\n      entities: {},\n      aggregation: [resource.totalCost, 0] as [number, number],\n      change: { ratio: 0, amount: 0 },\n    }));\n\n    return {\n      id: 'ec2',\n      entities: { ec2: entities },\n      monthlyData: monthlyData,\n      aggregation: [totalCost, 0] as [number, number],\n      change: { ratio: 0, amount: 0 },\n    };\n  }\n}\n"],"names":["DateTime"],"mappings":"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"}

package/dist/service/router.cjs.js

@@ -0,0 +1,101 @@
+'use strict';
+
+var express = require('express');
+var Router = require('express-promise-router');
+var luxon = require('luxon');
+var S3CostDataClient = require('./S3CostDataClient.cjs.js');
+var S3CostInsightsClient = require('./S3CostInsightsClient.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);
+
+async function createRouter(options) {
+  const { logger, config } = options;
+  const router = Router__default.default();
+  router.use(express__default.default.json());
+  const costInsightsConfig = config.getOptionalConfig("costInsights");
+  const s3Config = costInsightsConfig?.getOptionalConfig("s3");
+  if (!s3Config) {
+    logger.warn("[CostInsights] S3 configuration not found");
+    router.get("/health", (_, res) => {
+      res.json({ status: "ok", message: "S3 not configured" });
+    });
+    return router;
+  }
+  const environments = costInsightsConfig?.getOptionalStringArray("environments") ?? ["prd"];
+  const configuredDefaultEnvironment = costInsightsConfig?.getOptionalString("defaultEnvironment") ?? environments[0];
+  const defaultEnvironment = environments.includes(configuredDefaultEnvironment) ? configuredDefaultEnvironment : environments[0];
+  if (!environments.includes(configuredDefaultEnvironment)) {
+    logger.warn(
+      `[CostInsights] defaultEnvironment (${configuredDefaultEnvironment}) is not in environments list, fallback to ${defaultEnvironment}`
+    );
+  }
+  const s3DataClient = new S3CostDataClient.S3CostDataClient(logger, {
+    region: s3Config.getString("region"),
+    bucket: s3Config.getString("bucket"),
+    profile: s3Config.getOptionalString("profile"),
+    dailyPrefixTemplate: s3Config.getOptionalString("dailyPrefixTemplate")
+  });
+  const costInsightsClient = new S3CostInsightsClient.S3CostInsightsClient(s3DataClient, logger);
+  logger.info(`[CostInsights] Initialized S3 client for environments: ${environments.join(", ")}`);
+  router.get("/health", (_, res) => {
+    res.json({ status: "ok", environments });
+  });
+  router.get("/config", (_, res) => {
+    res.json({
+      environments,
+      defaultEnvironment
+    });
+  });
+  router.get("/last-complete-date", async (req, res) => {
+    const { environment = defaultEnvironment } = req.query;
+    if (!environments.includes(environment)) {
+      res.status(400).json({ error: `Invalid environment: ${environment}` });
+      return;
+    }
+    const date = await costInsightsClient.getLastCompleteBillingDate();
+    res.json({ date, environment });
+  });
+  router.get("/product/ec2/insights", async (req, res) => {
+    const { intervals, environment = defaultEnvironment } = req.query;
+    logger.info(`[CostInsights] GET /product/ec2/insights - intervals: ${intervals}, environment: ${environment}`);
+    if (!intervals) {
+      res.status(400).json({ error: "intervals parameter required" });
+      return;
+    }
+    const [startStr, endStr] = intervals.split("/");
+    const start = luxon.DateTime.fromISO(startStr ?? "", { setZone: true });
+    const end = luxon.DateTime.fromISO(endStr ?? "", { setZone: true });
+    if (!start.isValid || !end.isValid) {
+      res.status(400).json({ error: "intervals must be valid ISO interval: start/end" });
+      return;
+    }
+    if (start > end) {
+      res.status(400).json({ error: "interval start must be before or equal to end" });
+      return;
+    }
+    const monthDiff = Math.abs(
+      end.startOf("month").diff(start.startOf("month"), "months").months
+    );
+    if (monthDiff > 24) {
+      res.status(400).json({ error: "intervals range must be within 24 months" });
+      return;
+    }
+    if (!environments.includes(environment)) {
+      res.status(400).json({ error: `Invalid environment: ${environment}` });
+      return;
+    }
+    const insights = await costInsightsClient.getEC2Insights(
+      intervals,
+      environment
+    );
+    res.json({ ...insights, environment });
+  });
+  logger.info(`[CostInsights] Router initialized successfully for environments: ${environments.join(", ")}`);
+  return router;
+}
+
+exports.createRouter = createRouter;
+//# sourceMappingURL=router.cjs.js.map

package/dist/service/router.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.cjs.js","sources":["../../src/service/router.ts"],"sourcesContent":["import type { LoggerService } from '@backstage/backend-plugin-api';\nimport type { Config } from '@backstage/config';\nimport express from 'express';\nimport Router from 'express-promise-router';\nimport { DateTime } from 'luxon';\nimport { S3CostDataClient } from './S3CostDataClient';\nimport { S3CostInsightsClient } from './S3CostInsightsClient';\n\nexport interface RouterOptions {\n  logger: LoggerService;\n  config: Config;\n}\n\nexport async function createRouter(\n  options: RouterOptions,\n): Promise<express.Router> {\n  const { logger, config } = options;\n\n  const router = Router();\n  router.use(express.json());\n\n  const costInsightsConfig = config.getOptionalConfig('costInsights');\n  const s3Config = costInsightsConfig?.getOptionalConfig('s3');\n\n  if (!s3Config) {\n    logger.warn('[CostInsights] S3 configuration not found');\n    router.get('/health', (_, res) => {\n      res.json({ status: 'ok', message: 'S3 not configured' });\n    });\n    return router;\n  }\n\n  const environments =\n    costInsightsConfig?.getOptionalStringArray('environments') ?? ['prd'];\n  const configuredDefaultEnvironment =\n    costInsightsConfig?.getOptionalString('defaultEnvironment') ??\n    environments[0];\n  const defaultEnvironment = environments.includes(configuredDefaultEnvironment)\n    ? configuredDefaultEnvironment\n    : environments[0];\n\n  if (!environments.includes(configuredDefaultEnvironment)) {\n    logger.warn(\n      `[CostInsights] defaultEnvironment (${configuredDefaultEnvironment}) is not in environments list, fallback to ${defaultEnvironment}`,\n    );\n  }\n\n  const s3DataClient = new S3CostDataClient(logger, {\n    region: s3Config.getString('region'),\n    bucket: s3Config.getString('bucket'),\n    profile: s3Config.getOptionalString('profile'),\n    dailyPrefixTemplate: s3Config.getOptionalString('dailyPrefixTemplate'),\n  });\n\n  const costInsightsClient = new S3CostInsightsClient(s3DataClient, logger);\n\n  logger.info(`[CostInsights] Initialized S3 client for environments: ${environments.join(', ')}`)\n\n  router.get('/health', (_, res) => {\n    res.json({ status: 'ok', environments });\n  });\n\n  router.get('/config', (_, res) => {\n    res.json({\n      environments,\n      defaultEnvironment,\n    });\n  });\n\n  router.get('/last-complete-date', async (req, res) => {\n    const { environment = defaultEnvironment } = req.query as {\n      environment?: string;\n    };\n\n    if (!environments.includes(environment)) {\n      res.status(400).json({ error: `Invalid environment: ${environment}` });\n      return;\n    }\n\n    const date = await costInsightsClient.getLastCompleteBillingDate();\n    res.json({ date, environment });\n  });\n\n  router.get('/product/ec2/insights', async (req, res) => {\n    const { intervals, environment = defaultEnvironment } = req.query as {\n      intervals: string;\n      environment?: string;\n    };\n\n    logger.info(`[CostInsights] GET /product/ec2/insights - intervals: ${intervals}, environment: ${environment}`);\n\n    if (!intervals) {\n      res.status(400).json({ error: 'intervals parameter required' });\n      return;\n    }\n\n    const [startStr, endStr] = intervals.split('/');\n    const start = DateTime.fromISO(startStr ?? '', { setZone: true });\n    const end = DateTime.fromISO(endStr ?? '', { setZone: true });\n    if (!start.isValid || !end.isValid) {\n      res\n        .status(400)\n        .json({ error: 'intervals must be valid ISO interval: start/end' });\n      return;\n    }\n    if (start > end) {\n      res\n        .status(400)\n        .json({ error: 'interval start must be before or equal to end' });\n      return;\n    }\n    const monthDiff = Math.abs(\n      end.startOf('month').diff(start.startOf('month'), 'months').months,\n    );\n    if (monthDiff > 24) {\n      res\n        .status(400)\n        .json({ error: 'intervals range must be within 24 months' });\n      return;\n    }\n\n    if (!environments.includes(environment)) {\n      res.status(400).json({ error: `Invalid environment: ${environment}` });\n      return;\n    }\n\n    const insights = await costInsightsClient.getEC2Insights(\n      intervals,\n      environment,\n    );\n    res.json({ ...insights, environment });\n  });\n\n  logger.info(`[CostInsights] Router initialized successfully for environments: ${environments.join(', ')}`);\n\n  return router;\n}\n"],"names":["Router","express","S3CostDataClient","S3CostInsightsClient","DateTime"],"mappings":"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"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@letthem/backstage-plugin-aws-cost-insights-backend",
+  "version": "0.2.0",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/letthem/backstage-plugin-cost-insights.git",
+    "directory": "plugins/cost-insights-backend"
+  },
+  "bugs": {
+    "url": "https://github.com/letthem/backstage-plugin-cost-insights/issues"
+  },
+  "keywords": [
+    "backstage",
+    "plugin",
+    "backend",
+    "cost-insights",
+    "aws",
+    "s3",
+    "athena",
+    "finops"
+  ],
+  "homepage": "https://github.com/letthem/backstage-plugin-cost-insights#readme",
+  "backstage": {
+    "role": "backend-plugin",
+    "pluginId": "aws-cost-insights",
+    "pluginPackages": [
+      "@letthem/backstage-plugin-aws-cost-insights",
+      "@letthem/backstage-plugin-aws-cost-insights-backend"
+    ]
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test --passWithNoTests",
+    "clean": "backstage-cli package clean",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack"
+  },
+  "dependencies": {
+    "@aws-sdk/client-athena": "^3.700.0",
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@aws-sdk/credential-providers": "^3.967.0",
+    "@backstage/backend-plugin-api": "^1.5.0",
+    "@backstage/config": "^1.3.6",
+    "express": "^4.17.1",
+    "express-promise-router": "^4.1.0",
+    "luxon": "^3.0.0",
+    "node-fetch": "2",
+    "winston": "^3.2.1"
+  },
+  "devDependencies": {
+    "@backstage/cli": "^0.29.3",
+    "@types/express": "^4.17.6",
+    "@types/luxon": "^3.4.2",
+    "@types/node": "^18"
+  },
+  "files": [
+    "dist",
+    "config.d.ts"
+  ],
+  "typesVersions": {
+    "*": {
+      "index": [
+        "dist/index.d.ts"
+      ]
+    }
+  }
+}