@pagopa/dx-savemoney 0.1.1

package/dist/azure/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Azure-specific types
+ */
+import type * as armResources from "@azure/arm-resources";
+import type { AnalysisResult, BaseConfig, CostRisk } from "../types.js";
+/**
+ * Azure configuration extending base config
+ */
+export type AzureConfig = BaseConfig & {
+    subscriptionIds: string[];
+    tenantId: string;
+    verbose?: boolean;
+};
+/**
+ * Detailed report for a single Azure resource with full resource object
+ */
+export type AzureDetailedResourceReport = {
+    analysis: AnalysisResult;
+    resource: armResources.GenericResource;
+};
+/**
+ * Summary report for a single Azure resource
+ */
+export type AzureResourceReport = {
+    costRisk: CostRisk;
+    location?: string;
+    name: string;
+    reason: string;
+    resourceGroup?: string;
+    subscriptionId: string;
+    suspectedUnused: boolean;
+    type: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/azure/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/azure/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,YAAY,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC,eAAe,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/azure/types.js

@@ -0,0 +1,5 @@
+/**
+ * Azure-specific types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/azure/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/azure/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/azure/utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Azure utility functions for debugging and metrics
+ */
+import type { MonitorClient } from "@azure/arm-monitor";
+import type { AnalysisResult } from "../types.js";
+/**
+ * Fetches a specific metric for a resource from Azure Monitor.
+ *
+ * @param monitorClient - The Azure Monitor client instance
+ * @param resourceId - The Azure resource ID
+ * @param metricName - The name of the metric to fetch (e.g., "Percentage CPU")
+ * @param aggregation - The aggregation type (e.g., "Average", "Total")
+ * @param timespanDays - Number of days to look back for metrics
+ * @returns The metric value or null if unavailable
+ */
+export declare function getMetric(monitorClient: MonitorClient, resourceId: string, metricName: string, aggregation: string, timespanDays: number): Promise<null | number>;
+/**
+ * Logs a verbose message, optionally with an object.
+ *
+ * @param verbose - Whether verbose logging is enabled
+ * @param message - The message to log
+ * @param object - Optional object to stringify and log
+ */
+export declare function verboseLog(verbose: boolean, message: string, object?: unknown): void;
+/**
+ * Logs the analysis result for a resource.
+ *
+ * @param verbose - Whether verbose logging is enabled
+ * @param result - The analysis result object
+ */
+export declare function verboseLogAnalysisResult(verbose: boolean, result: AnalysisResult): void;
+/**
+ * Logs a resource analysis header with visual separator.
+ *
+ * @param verbose - Whether verbose logging is enabled
+ * @param resourceName - Name of the resource being analyzed
+ * @param resourceType - Type of the resource
+ */
+export declare function verboseLogResourceStart(verbose: boolean, resourceName: string, resourceType: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/azure/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/azure/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAiDxB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,QAUjB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,cAAc,QAYvB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,QASrB"}

package/dist/azure/utils.js

@@ -0,0 +1,104 @@
+/**
+ * Azure utility functions for debugging and metrics
+ */
+import { getLogger } from "@logtape/logtape";
+/**
+ * Fetches a specific metric for a resource from Azure Monitor.
+ *
+ * @param monitorClient - The Azure Monitor client instance
+ * @param resourceId - The Azure resource ID
+ * @param metricName - The name of the metric to fetch (e.g., "Percentage CPU")
+ * @param aggregation - The aggregation type (e.g., "Average", "Total")
+ * @param timespanDays - Number of days to look back for metrics
+ * @returns The metric value or null if unavailable
+ */
+export async function getMetric(monitorClient, resourceId, metricName, aggregation, timespanDays) {
+    try {
+        const timespan = `P${timespanDays}D`;
+        const result = await monitorClient.metrics.list(resourceId, {
+            aggregation,
+            metricnames: metricName,
+            timespan,
+        });
+        const metricData = result.value[0]?.timeseries?.[0]?.data?.[0];
+        if (!metricData) {
+            return null;
+        }
+        const aggregationLower = aggregation.toLowerCase();
+        if (aggregationLower === "average" &&
+            typeof metricData.average === "number") {
+            return metricData.average;
+        }
+        if (aggregationLower === "total" && typeof metricData.total === "number") {
+            return metricData.total;
+        }
+        if (aggregationLower === "minimum" &&
+            typeof metricData.minimum === "number") {
+            return metricData.minimum;
+        }
+        if (aggregationLower === "maximum" &&
+            typeof metricData.maximum === "number") {
+            return metricData.maximum;
+        }
+        if (aggregationLower === "count" && typeof metricData.count === "number") {
+            return metricData.count;
+        }
+        return null;
+    }
+    catch (error) {
+        const logger = getLogger(["savemoney", "azure", "metrics"]);
+        logger.error(`Failed to fetch metric ${metricName} for resource ${resourceId}: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+/**
+ * Logs a verbose message, optionally with an object.
+ *
+ * @param verbose - Whether verbose logging is enabled
+ * @param message - The message to log
+ * @param object - Optional object to stringify and log
+ */
+export function verboseLog(verbose, message, object) {
+    if (verbose) {
+        const logger = getLogger(["savemoney", "azure", "verbose"]);
+        if (object !== undefined) {
+            logger.debug(`${message} ${JSON.stringify(object, null, 2)}`);
+        }
+        else {
+            logger.debug(message);
+        }
+    }
+}
+/**
+ * Logs the analysis result for a resource.
+ *
+ * @param verbose - Whether verbose logging is enabled
+ * @param result - The analysis result object
+ */
+export function verboseLogAnalysisResult(verbose, result) {
+    if (verbose) {
+        const logger = getLogger(["savemoney", "azure", "verbose"]);
+        logger.debug("\n📊 ANALYSIS RESULT:");
+        logger.debug(`   Cost Risk: ${result.costRisk.toUpperCase()}`);
+        logger.debug(`   Suspected Unused: ${result.suspectedUnused ? "YES" : "NO"}`);
+        logger.debug(`   Reason: ${result.reason || "No issues found"}`);
+        logger.debug("=".repeat(80) + "\n");
+    }
+}
+/**
+ * Logs a resource analysis header with visual separator.
+ *
+ * @param verbose - Whether verbose logging is enabled
+ * @param resourceName - Name of the resource being analyzed
+ * @param resourceType - Type of the resource
+ */
+export function verboseLogResourceStart(verbose, resourceName, resourceType) {
+    if (verbose) {
+        const logger = getLogger(["savemoney", "azure", "verbose"]);
+        logger.debug("\n" + "=".repeat(80));
+        logger.debug(`🔍 ANALYZING: ${resourceName}`);
+        logger.debug(`   Type: ${resourceType}`);
+        logger.debug("=".repeat(80));
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/azure/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/azure/utils.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SaveMoney Package
+ *
+ * A tool that analyzes cloud resources and reports potentially unused
+ * or cost-inefficient ones.
+ *
+ * Features:
+ * - Multi-cloud support (Azure, AWS planned)
+ * - Metric-based analysis
+ * - Multiple output formats (table, JSON, detailed-JSON)
+ * - Configurable via CLI options, environment variables, or config file
+ *
+ * This tool does NOT modify, tag, or delete any resources.
+ */
+export type { AzureConfig } from "./azure/types.js";
+export * from "./types.js";
+import * as azureModule from "./azure/index.js";
+export declare const azure: typeof azureModule;
+import type { AzureConfig } from "./azure/types.js";
+/**
+ * Loads configuration from file, environment variables, or interactive prompts.
+ *
+ * @param configPath - Optional path to JSON configuration file
+ * @returns Configuration object with subscription IDs and settings
+ */
+export declare function loadConfig(configPath?: string): Promise<AzureConfig>;
+/**
+ * Prompts user for input via stdin.
+ *
+ * @param question - The question to display to the user
+ * @returns User's input as a string
+ */
+export declare function prompt(question: string): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,cAAc,YAAY,CAAC;AAG3B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,eAAO,MAAM,KAAK,oBAAc,CAAC;AAOjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2C1E;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW9D"}

package/dist/index.js

@@ -0,0 +1,77 @@
+/**
+ * SaveMoney Package
+ *
+ * A tool that analyzes cloud resources and reports potentially unused
+ * or cost-inefficient ones.
+ *
+ * Features:
+ * - Multi-cloud support (Azure, AWS planned)
+ * - Metric-based analysis
+ * - Multiple output formats (table, JSON, detailed-JSON)
+ * - Configurable via CLI options, environment variables, or config file
+ *
+ * This tool does NOT modify, tag, or delete any resources.
+ */
+export * from "./types.js";
+// Export Azure module
+import * as azureModule from "./azure/index.js";
+export const azure = azureModule;
+import { getLogger } from "@logtape/logtape";
+// Utility imports for loadConfig and prompt functions
+import * as fs from "fs";
+import * as readline from "readline";
+/**
+ * Loads configuration from file, environment variables, or interactive prompts.
+ *
+ * @param configPath - Optional path to JSON configuration file
+ * @returns Configuration object with subscription IDs and settings
+ */
+export async function loadConfig(configPath) {
+    const logger = getLogger(["savemoney", "config"]);
+    if (configPath && fs.existsSync(configPath)) {
+        try {
+            const configContent = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(configContent);
+            // Validate required fields
+            if (!config.tenantId || !config.subscriptionIds) {
+                throw new Error("Config file must contain 'tenantId' and 'subscriptionIds'");
+            }
+            return {
+                ...config,
+                preferredLocation: config.preferredLocation || "italynorth",
+                timespanDays: config.timespanDays || 30,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to load config file: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    logger.info("Configuration file not found. Checking environment variables...");
+    const tenantId = process.env.ARM_TENANT_ID || (await prompt("Enter Tenant ID: "));
+    const subscriptionIds = process.env.ARM_SUBSCRIPTION_ID
+        ? process.env.ARM_SUBSCRIPTION_ID.split(",")
+        : (await prompt("Enter Subscription IDs (comma-separated): ")).split(",");
+    return {
+        preferredLocation: "italynorth",
+        subscriptionIds,
+        tenantId,
+        timespanDays: 30,
+    };
+}
+/**
+ * Prompts user for input via stdin.
+ *
+ * @param question - The question to display to the user
+ * @returns User's input as a string
+ */
+export async function prompt(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => rl.question(question, (answer) => {
+        rl.close();
+        resolve(answer);
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,cAAc,YAAY,CAAC;AAE3B,sBAAsB;AACtB,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,sDAAsD;AACtD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAIrC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAmB;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElD,IAAI,UAAU,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAEzC,2BAA2B;YAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,GAAG,MAAM;gBACT,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,YAAY;gBAC3D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;aACxC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CACT,iEAAiE,CAClE,CAAC;IAEF,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB;QACrD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC;QAC5C,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,4CAA4C,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5E,OAAO;QACL,iBAAiB,EAAE,YAAY;QAC/B,eAAe;QACf,QAAQ;QACR,YAAY,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7B,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;QAC/B,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Common types shared across all cloud providers
+ */
+export type AnalysisResult = {
+    costRisk: CostRisk;
+    reason: string;
+    suspectedUnused: boolean;
+};
+/**
+ * Base configuration interface that all cloud providers should extend
+ */
+export type BaseConfig = {
+    preferredLocation: string;
+    timespanDays: number;
+};
+export type CostRisk = "high" | "low" | "medium";
+/**
+ * Merges analysis results, preserving existing reasons and combining suspectedUnused flags.
+ */
+export declare function mergeResults(baseResult: AnalysisResult, specificResult: AnalysisResult): AnalysisResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEjD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,cAAc,EAC1B,cAAc,EAAE,cAAc,GAC7B,cAAc,CAOhB"}

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * Common types shared across all cloud providers
+ */
+/**
+ * Merges analysis results, preserving existing reasons and combining suspectedUnused flags.
+ */
+export function mergeResults(baseResult, specificResult) {
+    return {
+        costRisk: specificResult.costRisk,
+        reason: baseResult.reason + specificResult.reason,
+        suspectedUnused: baseResult.suspectedUnused || specificResult.suspectedUnused,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA0B,EAC1B,cAA8B;IAE9B,OAAO;QACL,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM;QACjD,eAAe,EACb,UAAU,CAAC,eAAe,IAAI,cAAc,CAAC,eAAe;KAC/D,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@pagopa/dx-savemoney",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Azure resource analyzer for finding unused or cost-inefficient resources.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pagopa/dx.git",
+    "directory": "packages/savemoney"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "keywords": [
+    "azure",
+    "typescript",
+    "finops",
+    "DX"
+  ],
+  "dependencies": {
+    "@azure/arm-appservice": "^17.0.0",
+    "@azure/arm-compute": "^23.1.0",
+    "@azure/arm-monitor": "^7.0.0",
+    "@azure/arm-network": "^34.1.0",
+    "@azure/arm-resources": "^7.0.0",
+    "@azure/identity": "^4.13.0",
+    "@logtape/logtape": "^1.1.2"
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "22.0.2",
+    "@types/node": "^22.16.2",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.30.0",
+    "prettier": "3.6.2",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.4",
+    "@pagopa/eslint-config": "^5.1.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint --fix .",
+    "lint:check": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest run --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/azure/analyzer.ts

@@ -0,0 +1,213 @@
+/**
+ * Azure resource analyzer - Main orchestration logic
+ */
+
+import { WebSiteManagementClient } from "@azure/arm-appservice";
+import { ComputeManagementClient } from "@azure/arm-compute";
+import { MonitorClient } from "@azure/arm-monitor";
+import { NetworkManagementClient } from "@azure/arm-network";
+import * as armResources from "@azure/arm-resources";
+import { DefaultAzureCredential } from "@azure/identity";
+import { getLogger } from "@logtape/logtape";
+
+import type { AzureConfig, AzureDetailedResourceReport } from "./types.js";
+
+import { type AnalysisResult, mergeResults } from "../types.js";
+import { generateReport } from "./report.js";
+import {
+  analyzeAppServicePlan,
+  analyzeDisk,
+  analyzeNic,
+  analyzePrivateEndpoint,
+  analyzePublicIp,
+  analyzeStorageAccount,
+  analyzeVM,
+} from "./resources/index.js";
+
+/**
+ * Analyzes resources in multiple Azure subscriptions and generates a report.
+ *
+ * @param config - Azure configuration with subscription IDs and settings
+ * @param format - Output format (table, json, or detailed-json)
+ */
+export async function analyzeAzureResources(
+  config: AzureConfig,
+  format: "detailed-json" | "json" | "table",
+) {
+  const logger = getLogger(["savemoney", "azure"]);
+  const credential = new DefaultAzureCredential();
+  const allReports: AzureDetailedResourceReport[] = [];
+
+  for (const subscriptionId of config.subscriptionIds) {
+    logger.info(`Analyzing subscription: ${subscriptionId}`);
+
+    const resourceClient = new armResources.ResourceManagementClient(
+      credential,
+      subscriptionId.trim(),
+    );
+    const monitorClient = new MonitorClient(credential, subscriptionId.trim());
+    const computeClient = new ComputeManagementClient(
+      credential,
+      subscriptionId.trim(),
+    );
+    const networkClient = new NetworkManagementClient(
+      credential,
+      subscriptionId.trim(),
+    );
+    const webSiteClient = new WebSiteManagementClient(
+      credential,
+      subscriptionId.trim(),
+    );
+
+    // Use the async iterator to avoid memory explosion for large environments
+    for await (const resource of resourceClient.resources.list()) {
+      const { costRisk, reason, suspectedUnused } = await analyzeResource(
+        resource,
+        monitorClient,
+        computeClient,
+        networkClient,
+        webSiteClient,
+        config.preferredLocation,
+        config.timespanDays,
+        config.verbose || false,
+      );
+
+      if (suspectedUnused) {
+        allReports.push({
+          analysis: {
+            costRisk,
+            reason: reason || "No specific findings.",
+            suspectedUnused,
+          },
+          resource: resource,
+        });
+      }
+    }
+  }
+
+  // Sort to make the output more readable
+  allReports.sort((a, b) => {
+    if (a.analysis.costRisk === b.analysis.costRisk)
+      return (a.resource.name ?? "").localeCompare(b.resource.name ?? "");
+    const order = { high: 0, low: 2, medium: 1 };
+    return order[a.analysis.costRisk] - order[b.analysis.costRisk];
+  });
+
+  await generateReport(allReports, format);
+}
+
+/**
+ * Analyzes a single Azure resource based on its type.
+ *
+ * @param resource - The Azure resource to analyze
+ * @param monitorClient - Azure Monitor client for metrics
+ * @param computeClient - Azure Compute client
+ * @param networkClient - Azure Network client
+ * @param webSiteClient - Azure Web Site client
+ * @param preferredLocation - Preferred Azure location
+ * @param timespanDays - Number of days to analyze metrics
+ * @param verbose - Whether verbose logging is enabled
+ * @returns Analysis result with cost risk and reason
+ */
+export async function analyzeResource(
+  resource: armResources.GenericResource,
+  monitorClient: MonitorClient,
+  computeClient: ComputeManagementClient,
+  networkClient: NetworkManagementClient,
+  webSiteClient: WebSiteManagementClient,
+  preferredLocation: string,
+  timespanDays: number,
+  verbose = false,
+): Promise<AnalysisResult> {
+  const type = resource.type?.toLowerCase() || "";
+  let result = {
+    costRisk: "low" as "high" | "low" | "medium",
+    reason: "",
+    suspectedUnused: false,
+  };
+
+  // Generic check: lack of tags is a common sign of unmanaged resources.
+  if (!resource.tags || Object.keys(resource.tags).length === 0) {
+    result.suspectedUnused = true;
+    result.reason += "No tags found. ";
+  }
+
+  // Route to type-specific analysis hooks
+  switch (type) {
+    case "microsoft.compute/disks": {
+      const diskResult = await analyzeDisk(resource, computeClient, verbose);
+      result = mergeResults(result, diskResult);
+      break;
+    }
+    case "microsoft.compute/virtualmachines": {
+      const vmResult = await analyzeVM(
+        resource,
+        monitorClient,
+        computeClient,
+        timespanDays,
+        verbose,
+      );
+      result = mergeResults(result, vmResult);
+      break;
+    }
+    case "microsoft.network/networkinterfaces": {
+      const nicResult = await analyzeNic(resource, networkClient, verbose);
+      result = mergeResults(result, nicResult);
+      break;
+    }
+    case "microsoft.network/privateendpoints": {
+      const peResult = await analyzePrivateEndpoint(
+        resource,
+        networkClient,
+        verbose,
+      );
+      result = mergeResults(result, peResult);
+      break;
+    }
+    case "microsoft.network/publicipaddresses": {
+      const pipResult = await analyzePublicIp(
+        resource,
+        networkClient,
+        monitorClient,
+        timespanDays,
+        verbose,
+      );
+      result = mergeResults(result, pipResult);
+      break;
+    }
+    case "microsoft.storage/storageaccounts": {
+      const storageResult = await analyzeStorageAccount(
+        resource,
+        monitorClient,
+        timespanDays,
+        verbose,
+      );
+      result = mergeResults(result, storageResult);
+      break;
+    }
+    case "microsoft.web/serverfarms": {
+      const aspResult = await analyzeAppServicePlan(
+        resource,
+        webSiteClient,
+        monitorClient,
+        timespanDays,
+        verbose,
+      );
+      result = mergeResults(result, aspResult);
+      break;
+    }
+    default:
+      result.reason += "No specific analysis for this resource type. ";
+      break;
+  }
+
+  // Generic check for location
+  if (
+    resource.location &&
+    !resource.location.toLowerCase().includes(preferredLocation.toLowerCase())
+  ) {
+    result.reason += `Resource not in preferred location (${preferredLocation}). `;
+  }
+
+  return { ...result, reason: result.reason.trim() };
+}