@pagopa/dx-savemoney 0.1.1

package/README.md

@@ -0,0 +1,233 @@
+# DX Save Money
+
+A TypeScript library for analyzing CSP (Cloud Service Provider) resources to identify potential cost inefficiencies and underutilized resources. It operates in read-only mode and does not modify, tag, or delete any resources; instead, it generates detailed reports to support FinOps decisions.
+
+## Supported Cloud Providers
+
+### ✅ Azure
+
+Full support for Azure resource analysis with intelligent detection and flexible reporting.
+
+### 🚧 AWS (Coming Soon)
+
+AWS support is planned for future releases. The architecture is designed to support multiple CSPs with provider-specific analyzers.
+
+## Installation
+
+```bash
+npm install @pagopa/dx-savemoney
+# or
+pnpm add @pagopa/dx-savemoney
+# or
+yarn add @pagopa/dx-savemoney
+```
+
+## Azure
+
+### Main Features
+
+- **Multi-Subscription Analysis**: Scans multiple Azure subscriptions in a single command.
+- **Intelligent Detection**: Uses Azure Monitor metrics (e.g. CPU, network traffic, transactions) to scientifically identify inactive resources.
+- **Orphaned Resource Identification**: Detects commonly "forgotten" resources like unattached disks, unassociated public IPs, and unused network interfaces.
+- **Flexible Reporting**: Offers multiple output formats:
+  - `table`: A human-readable summary for the terminal.
+  - `json`: Standard format for integration with other tools.
+  - `detailed-json`: A comprehensive output with all resource metadata, ideal for in-depth analysis via AI or custom scripts.
+- **Simplified Configuration**: Supports configuration via files, command-line options, environment variables, or an interactive prompt.
+
+### Analyzed Resources
+
+The tool analyzes the following Azure resource types with specific detection methods and risk levels:
+
+| Resource Type           | Detection Method        | Cost Risk | What's Checked                                                                          |
+| :---------------------- | :---------------------- | :-------: | :-------------------------------------------------------------------------------------- |
+| **Virtual Machines**    | Instance View + Metrics |  🔴 High  | Deallocated/stopped state, Low CPU usage (<1%), Low network traffic (<10MB)             |
+| **App Service Plans**   | API Details + Metrics   |  🔴 High  | No apps deployed, Very low CPU (<5%), Very low memory (<10%), Oversized Premium tier    |
+| **Managed Disks**       | API Details             | 🟡 Medium | Unattached state, No `managedBy` property                                               |
+| **Public IP Addresses** | API Details + Metrics   | 🟡 Medium | Not associated with any resource, Static IP not in use, Very low network traffic (<1MB) |
+| **Network Interfaces**  | API Details             | 🟡 Medium | Not attached to VM or Private Endpoint, No public IP assigned                           |
+| **Private Endpoints**   | API Details             | 🟡 Medium | No private link connections, Rejected/disconnected connections, No network interfaces   |
+| **Storage Accounts**    | Metrics                 | 🟡 Medium | Very low transaction count (<100 in timespan)                                           |
+
+#### Generic Checks
+
+All resources are also checked for:
+
+- **Missing tags**: Resources without tags are flagged as potentially unmanaged
+- **Location mismatch**: Resources not in the preferred location are reported
+
+### Prerequisites
+
+1. **Node.js**: Version 22 or higher.
+2. **Azure Credentials**: The library uses `DefaultAzureCredential` from `@azure/identity`, which supports various authentication methods:
+   - Azure CLI (`az login`)
+   - Managed Identity
+   - Environment variables
+   - Visual Studio Code
+   - And more...
+
+### Usage
+
+#### Quick Start
+
+```typescript
+import { azure, loadConfig } from "@pagopa/dx-savemoney";
+
+// Load configuration (from file, env vars, or interactive prompt)
+const config = await loadConfig("./config.json");
+
+// Run analysis and generate report
+await azure.analyzeAzureResources(config, "table");
+```
+
+#### Configuration Inputs
+
+The tool requires the following configuration:
+
+| Input               | Type       | Required | Default      | Description                                                  |
+| :------------------ | :--------- | :------: | :----------- | :----------------------------------------------------------- |
+| `tenantId`          | `string`   |    ✅    | -            | Azure Active Directory Tenant ID                             |
+| `subscriptionIds`   | `string[]` |    ✅    | -            | Array of Azure subscription IDs to analyze                   |
+| `preferredLocation` | `string`   |    ❌    | `italynorth` | Preferred Azure region (resources elsewhere will be flagged) |
+| `timespanDays`      | `number`   |    ❌    | `30`         | Number of days to look back for metrics analysis             |
+| `verbose`           | `boolean`  |    ❌    | `false`      | Enable detailed logging for each resource analyzed           |
+
+#### Output Formats
+
+The tool supports multiple output formats for different use cases:
+
+| Format          | Description                                     | Use Case                       |
+| :-------------- | :---------------------------------------------- | :----------------------------- |
+| `table`         | Human-readable table in terminal                | Quick visual inspection        |
+| `json`          | Structured JSON with resource summaries         | Integration with other tools   |
+| `detailed-json` | Complete JSON with full Azure resource metadata | AI analysis or deep inspection |
+
+#### How to Load Configuration
+
+The `loadConfig()` function loads configuration in the following priority order:
+
+1. **Configuration file** (pass file path as parameter)
+2. **Environment variables** (`ARM_TENANT_ID`, `ARM_SUBSCRIPTION_ID`)
+3. **Interactive prompt** (if no other configuration is found)
+
+**Example:**
+
+```typescript
+// From file
+const config1 = await loadConfig("./config.json");
+
+// From environment variables or prompt
+const config2 = await loadConfig();
+```
+
+#### Configuration File Example
+
+```json
+{
+  "tenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+  "subscriptionIds": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],
+  "preferredLocation": "italynorth",
+  "timespanDays": 30,
+  "verbose": false
+}
+```
+
+#### Usage Examples
+
+##### Basic Usage
+
+```typescript
+import { azure, loadConfig } from "@pagopa/dx-savemoney";
+
+// Load from config file
+const config = await loadConfig("./config.json");
+await azure.analyzeAzureResources(config, "table");
+```
+
+##### Custom Configuration
+
+```typescript
+import { azure } from "@pagopa/dx-savemoney";
+import type { AzureConfig } from "@pagopa/dx-savemoney";
+
+const config: AzureConfig = {
+  tenantId: "your-tenant-id",
+  subscriptionIds: ["sub-id-1", "sub-id-2"],
+  preferredLocation: "italynorth",
+  timespanDays: 30,
+  verbose: true,
+};
+
+await azure.analyzeAzureResources(config, "json");
+```
+
+##### Generate Detailed Report
+
+```typescript
+import { azure, loadConfig } from "@pagopa/dx-savemoney";
+
+const config = await loadConfig();
+// Generate detailed JSON with full resource metadata
+await azure.analyzeAzureResources(config, "detailed-json");
+```
+
+##### Using Environment Variables
+
+```typescript
+import { loadConfig, azure } from "@pagopa/dx-savemoney";
+
+// Set environment variables
+// ARM_TENANT_ID=xxx
+// ARM_SUBSCRIPTION_ID=sub1,sub2
+
+const config = await loadConfig(); // Will read from env vars
+await azure.analyzeAzureResources(config, "json");
+```
+
+## AWS (Coming Soon)
+
+AWS support is planned for future releases with similar capabilities:
+
+- Multi-account analysis
+- Resource-specific detection algorithms
+- Flexible reporting formats
+- AWS-specific configuration options
+
+The API will follow a similar pattern:
+
+```typescript
+import { aws, loadAwsConfig } from "@pagopa/dx-savemoney";
+
+const config = await loadAwsConfig("./aws-config.json");
+await aws.analyzeAwsResources(config, "table");
+```
+
+## Development
+
+### Type Checking
+
+```bash
+pnpm typecheck
+```
+
+### Linting
+
+```bash
+pnpm lint        # Auto-fix issues
+pnpm lint:check  # Check without fixing
+```
+
+### Testing
+
+```bash
+pnpm test              # Run tests
+pnpm test:watch        # Watch mode
+pnpm test:coverage     # With coverage report
+```
+
+### Formatting
+
+```bash
+pnpm format        # Format code
+pnpm format:check  # Check formatting
+```

package/dist/azure/analyzer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 type { AzureConfig } from "./types.js";
+import { type AnalysisResult } from "../types.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 declare function analyzeAzureResources(config: AzureConfig, format: "detailed-json" | "json" | "table"): Promise<void>;
+/**
+ * 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 declare function analyzeResource(resource: armResources.GenericResource, monitorClient: MonitorClient, computeClient: ComputeManagementClient, networkClient: NetworkManagementClient, webSiteClient: WebSiteManagementClient, preferredLocation: string, timespanDays: number, verbose?: boolean): Promise<AnalysisResult>;
+//# sourceMappingURL=analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/azure/analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,aAAa,CAAC;AAYhE;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO,iBA8D3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,CAAC,eAAe,EACtC,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,uBAAuB,EACtC,aAAa,EAAE,uBAAuB,EACtC,aAAa,EAAE,uBAAuB,EACtC,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,MAAM,EACpB,OAAO,UAAQ,GACd,OAAO,CAAC,cAAc,CAAC,CA4FzB"}

package/dist/azure/analyzer.js

@@ -0,0 +1,128 @@
+/**
+ * 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 { 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, format) {
+    const logger = getLogger(["savemoney", "azure"]);
+    const credential = new DefaultAzureCredential();
+    const allReports = [];
+    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, monitorClient, computeClient, networkClient, webSiteClient, preferredLocation, timespanDays, verbose = false) {
+    const type = resource.type?.toLowerCase() || "";
+    let result = {
+        costRisk: "low",
+        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() };
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/azure/analyzer.js.map

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

package/dist/azure/config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Azure configuration loading utilities
+ */
+import type { AzureConfig } from "./types.js";
+/**
+ * Loads Azure configuration from file, environment variables, or interactive prompts.
+ *
+ * @param configPath - Optional path to JSON configuration file
+ * @returns Azure configuration object with subscription IDs and settings
+ */
+export declare function loadAzureConfig(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=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/azure/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,CAAC,CA2CtB;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW9D"}

package/dist/azure/config.js

@@ -0,0 +1,62 @@
+/**
+ * Azure configuration loading utilities
+ */
+import { getLogger } from "@logtape/logtape";
+import * as fs from "fs";
+import * as readline from "readline";
+/**
+ * Loads Azure configuration from file, environment variables, or interactive prompts.
+ *
+ * @param configPath - Optional path to JSON configuration file
+ * @returns Azure configuration object with subscription IDs and settings
+ */
+export async function loadAzureConfig(configPath) {
+    if (configPath && fs.existsSync(configPath)) {
+        try {
+            const configContent = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(configContent);
+            if (!config.tenantId || !config.subscriptionIds) {
+                throw new Error("Config file must contain 'tenantId' and 'subscriptionIds'");
+            }
+            return {
+                ...config,
+                preferredLocation: config.preferredLocation || "italynorth",
+                subscriptionIds: config.subscriptionIds,
+                tenantId: config.tenantId,
+                timespanDays: config.timespanDays || 30,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to load config file: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    const logger = getLogger(["savemoney", "azure", "config"]);
+    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=config.js.map

package/dist/azure/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/azure/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAIrC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAmB;IAEnB,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,CAAyB,CAAC;YAEjE,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,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,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,MAAM,GAAG,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3D,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/azure/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Azure module - Entry point
+ *
+ * This module contains all Azure-specific logic for analyzing resources.
+ */
+export * from "./analyzer.js";
+export * from "./config.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/azure/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/azure/index.js

@@ -0,0 +1,9 @@
+/**
+ * Azure module - Entry point
+ *
+ * This module contains all Azure-specific logic for analyzing resources.
+ */
+export * from "./analyzer.js";
+export * from "./config.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/azure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/azure/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/azure/report.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Azure report generation
+ */
+import type { AzureDetailedResourceReport } from "./types.js";
+/**
+ * Generates a report from Azure resource analysis in the specified format.
+ *
+ * @param report - Array of detailed resource reports
+ * @param format - Output format (table, json, or detailed-json)
+ */
+export declare function generateReport(report: AzureDetailedResourceReport[], format: "detailed-json" | "json" | "table"): Promise<void>;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/azure/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,2BAA2B,EAAE,EACrC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO,iBAkC3C"}

package/dist/azure/report.js

@@ -0,0 +1,40 @@
+/**
+ * Azure report generation
+ */
+/**
+ * Generates a report from Azure resource analysis in the specified format.
+ *
+ * @param report - Array of detailed resource reports
+ * @param format - Output format (table, json, or detailed-json)
+ */
+export async function generateReport(report, format) {
+    if (format === "detailed-json") {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    // For other formats, we extract the summary data.
+    const summaryReport = report.map((r) => ({
+        costRisk: r.analysis.costRisk,
+        location: r.resource.location ?? "",
+        name: r.resource.name ?? "unknown",
+        reason: r.analysis.reason,
+        resourceGroup: r.resource.id?.split("/")[4],
+        subscriptionId: r.resource.id?.split("/")[2] ?? "unknown",
+        suspectedUnused: r.analysis.suspectedUnused,
+        type: r.resource.type ?? "unknown",
+    }));
+    if (format === "json") {
+        console.log(JSON.stringify(summaryReport, null, 2));
+    }
+    else {
+        console.table(summaryReport.map((r) => ({
+            Name: r.name,
+            Reason: r.reason,
+            "Resource Group": r.resourceGroup || "N/A",
+            Risk: r.costRisk,
+            Type: r.type,
+            Unused: r.suspectedUnused ? "Yes" : "No",
+        })), ["Name", "Type", "Resource Group", "Risk", "Unused", "Reason"]);
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/azure/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/azure/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAqC,EACrC,MAA0C;IAE1C,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,kDAAkD;IAClD,MAAM,aAAa,GAA0B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ;QAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE;QACnC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,SAAS;QAClC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM;QACzB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3C,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS;QACzD,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe;QAC3C,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,SAAS;KACnC,CAAC,CAAC,CAAC;IAEJ,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,gBAAgB,EAAE,CAAC,CAAC,aAAa,IAAI,KAAK;YAC1C,IAAI,EAAE,CAAC,CAAC,QAAQ;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;SACzC,CAAC,CAAC,EACH,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/azure/resources/app-service.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Azure App Service Plan analysis
+ */
+import type { WebSiteManagementClient } from "@azure/arm-appservice";
+import type { MonitorClient } from "@azure/arm-monitor";
+import * as armResources from "@azure/arm-resources";
+import type { AnalysisResult } from "../../types.js";
+/**
+ * Analyzes an Azure App Service Plan for potential cost optimization.
+ *
+ * @param resource - The Azure resource object
+ * @param webSiteClient - Azure Web Site client for App Service Plan details
+ * @param monitorClient - Azure Monitor client for metrics
+ * @param timespanDays - Number of days to analyze metrics
+ * @returns Analysis result with cost risk and reason
+ */
+export declare function analyzeAppServicePlan(resource: armResources.GenericResource, webSiteClient: WebSiteManagementClient, monitorClient: MonitorClient, timespanDays: number, verbose?: boolean): Promise<AnalysisResult>;
+//# sourceMappingURL=app-service.d.ts.map

package/dist/azure/resources/app-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-service.d.ts","sourceRoot":"","sources":["../../../src/azure/resources/app-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,YAAY,MAAM,sBAAsB,CAAC;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AASrD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,YAAY,CAAC,eAAe,EACtC,aAAa,EAAE,uBAAuB,EACtC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,UAAQ,GACd,OAAO,CAAC,cAAc,CAAC,CAmFzB"}