@deniscuciuc/compose-analyzer 1.0.0

package/dist/src/reporters/report-generator.js

@@ -0,0 +1,326 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportGenerator = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const print_1 = require("../utils/print");
+const html_reporter_1 = require("./html-reporter");
+class ReportGenerator {
+    outputDir;
+    constructor(outputDir = "./reports", _options = {}) {
+        this.outputDir = outputDir;
+    }
+    async generateFullReport(report, timestamp) {
+        const ts = timestamp ?? new Date().toISOString().replace(/[:.]/g, "-");
+        const filename = `compose-analysis-${ts}.md`;
+        const filepath = path.join(this.outputDir, filename);
+        await this.ensureOutputDir();
+        fs.writeFileSync(filepath, this.buildMarkdownReport(report));
+        return filepath;
+    }
+    async generateJsonReport(report, timestamp) {
+        const ts = timestamp ?? new Date().toISOString().replace(/[:.]/g, "-");
+        const filename = `compose-analysis-${ts}.json`;
+        const filepath = path.join(this.outputDir, filename);
+        await this.ensureOutputDir();
+        fs.writeFileSync(filepath, JSON.stringify(report, null, 2));
+        return filepath;
+    }
+    async generateHtmlReport(report, timestamp) {
+        const ts = timestamp ?? new Date().toISOString().replace(/[:.]/g, "-");
+        const filename = `compose-analysis-${ts}.html`;
+        const filepath = path.join(this.outputDir, filename);
+        await this.ensureOutputDir();
+        fs.writeFileSync(filepath, html_reporter_1.HtmlReporter.generate(report));
+        return filepath;
+    }
+    printSummary(report) {
+        (0, print_1.printSection)("Compose Analysis Summary");
+        (0, print_1.printRow)("Health score", `${report.healthScore}/100 ${(0, print_1.healthEmoji)(report.healthScore)} ${(0, print_1.healthLabel)(report.healthScore)}`);
+        (0, print_1.printRow)("Compose file", report.composeFile);
+        (0, print_1.printRow)("Compose version", report.version ?? "not declared");
+        (0, print_1.printRow)("Services", report.metrics.totalServices);
+        (0, print_1.printRow)("Issues", report.metrics.totalIssues);
+        (0, print_1.printRow)("Critical / high", `${report.metrics.criticalIssues} / ${report.metrics.highIssues}`);
+        if (report.allIssues.length === 0) {
+            (0, print_1.printBullet)("No issues detected.");
+            return;
+        }
+        (0, print_1.printBullet)(`Top issues (${Math.min(report.allIssues.length, 5)} shown):`);
+        for (const issue of report.allIssues.slice(0, 5)) {
+            (0, print_1.printSubBullet)(`[${issue.severity}] ${issue.service} — ${issue.title}`);
+        }
+    }
+    async ensureOutputDir() {
+        if (!fs.existsSync(this.outputDir)) {
+            fs.mkdirSync(this.outputDir, { recursive: true });
+        }
+    }
+    buildMarkdownReport(report) {
+        return [
+            this.buildHeader(report),
+            this.buildExecutiveSummary(report),
+            this.buildMetricsSection(report),
+            this.buildIssuesSection(report),
+            this.buildImageSection(report),
+            this.buildSecuritySection(report),
+            this.buildReliabilitySection(report),
+            this.buildResourceSection(report),
+            this.buildNetworkSection(report),
+            this.buildDockerRuntimeSection(report),
+            this.buildRecommendationsSection(report),
+        ]
+            .filter(Boolean)
+            .join("\n\n");
+    }
+    buildHeader(report) {
+        return `# Compose Analysis Report
+
+**Compose file:** ${report.composeFile}
+**Generated:** ${new Date(report.generatedAt).toISOString()}
+**Tool:** Compose Analyzer
+
+---`;
+    }
+    buildExecutiveSummary(report) {
+        const findings = [
+            report.metrics.criticalIssues > 0
+                ? `- **${report.metrics.criticalIssues}** critical issues need immediate attention`
+                : "- No critical issues detected",
+            report.metrics.highIssues > 0
+                ? `- **${report.metrics.highIssues}** high-severity issues should be prioritized`
+                : "- No high-severity issues detected",
+            report.images.unpinnedImages.length > 0
+                ? `- **${report.images.unpinnedImages.length}** services use unpinned images`
+                : "- All image references are pinned or build-only",
+            report.resources.missingLimits.length > 0
+                ? `- **${report.resources.missingLimits.length}** services are missing resource limits`
+                : "- All services define CPU and memory limits",
+        ];
+        return `## Executive Summary
+
+### Health Score: ${report.healthScore}/100 ${(0, print_1.healthEmoji)(report.healthScore)}
+
+### Key Findings
+${findings.join("\n")}
+
+### Quick Stats
+| Metric | Value |
+| --- | --- |
+| Compose version | ${report.version ?? "not declared"} |
+| Services | ${report.metrics.totalServices} |
+| Services with build | ${report.metrics.servicesWithBuild} |
+| Named volumes | ${report.metrics.namedVolumes} |
+| Total issues | ${report.metrics.totalIssues} |
+| Critical issues | ${report.metrics.criticalIssues} |
+| High issues | ${report.metrics.highIssues} |`;
+    }
+    buildMetricsSection(report) {
+        return `## Metrics
+
+| Metric | Value |
+| --- | --- |
+| Total services | ${report.metrics.totalServices} |
+| Services with build contexts | ${report.metrics.servicesWithBuild} |
+| Named volumes | ${report.metrics.namedVolumes} |
+| Total issues | ${report.metrics.totalIssues} |
+| Critical issues | ${report.metrics.criticalIssues} |
+| High issues | ${report.metrics.highIssues} |`;
+    }
+    buildIssuesSection(report) {
+        if (report.allIssues.length === 0) {
+            return "## Issues\n\nNo issues detected.";
+        }
+        const rows = report.allIssues
+            .map((issue) => {
+            const fix = issue.fix ? issue.fix.replaceAll("\n", "<br />") : "—";
+            return `| ${issue.severity} | ${issue.service} | ${issue.category} | ${issue.title} | ${issue.detail} | ${fix} |`;
+        })
+            .join("\n");
+        return `## Issues\n\n| Severity | Service | Category | Title | Detail | Fix |
+| --- | --- | --- | --- | --- | --- |
+${rows}`;
+    }
+    buildImageSection(report) {
+        const lines = [
+            `## Image Analysis`,
+            ``,
+            `### Unpinned Images (${report.images.unpinnedImages.length})`,
+        ];
+        if (report.images.unpinnedImages.length === 0) {
+            lines.push("No unpinned images found.");
+        }
+        else {
+            lines.push(`| Service | Image | Recommendation |`, `| --- | --- | --- |`);
+            for (const entry of report.images.unpinnedImages) {
+                lines.push(`| ${entry.service} | ${entry.image} | ${entry.recommendation} |`);
+            }
+        }
+        lines.push("", `### :latest Tags (${report.images.latestTagImages.length})`);
+        if (report.images.latestTagImages.length === 0) {
+            lines.push("No :latest tags found.");
+        }
+        else {
+            lines.push(`| Service | Image |`, `| --- | --- |`);
+            for (const entry of report.images.latestTagImages) {
+                lines.push(`| ${entry.service} | ${entry.image} |`);
+            }
+        }
+        return lines.join("\n");
+    }
+    buildSecuritySection(report) {
+        return [
+            `## Security Analysis`,
+            ``,
+            `### Secrets in Environment (${report.security.secretsInEnv.length})`,
+            report.security.secretsInEnv.length === 0
+                ? "No suspicious plain-text environment secrets found."
+                : [
+                    `| Service | Variable | Pattern |`,
+                    `| --- | --- | --- |`,
+                    ...report.security.secretsInEnv.map((entry) => `| ${entry.service} | ${entry.variable} | ${entry.pattern} |`),
+                ].join("\n"),
+            ``,
+            `### Privileged Services (${report.security.privilegedServices.length})`,
+            report.security.privilegedServices.length === 0
+                ? "No privileged containers found."
+                : report.security.privilegedServices
+                    .map((entry) => `- ${entry.service}`)
+                    .join("\n"),
+            ``,
+            `### Exposed Sensitive Ports (${report.security.exposedDatabases.length})`,
+            report.security.exposedDatabases.length === 0
+                ? "No exposed database or broker ports found."
+                : [
+                    `| Service | Image | Port | Bind Address |`,
+                    `| --- | --- | --- | --- |`,
+                    ...report.security.exposedDatabases.map((entry) => `| ${entry.service} | ${entry.image} | ${entry.port} | ${entry.bindAddr} |`),
+                ].join("\n"),
+        ].join("\n");
+    }
+    buildReliabilitySection(report) {
+        return [
+            `## Reliability Analysis`,
+            ``,
+            `### Missing Healthchecks (${report.reliability.missingHealthcheck.length})`,
+            report.reliability.missingHealthcheck.length === 0
+                ? "All services define healthchecks."
+                : report.reliability.missingHealthcheck
+                    .map((entry) => `- ${entry.service}`)
+                    .join("\n"),
+            ``,
+            `### Unsafe depends_on (${report.reliability.unsafeDepends.length})`,
+            report.reliability.unsafeDepends.length === 0
+                ? "No unsafe depends_on conditions found."
+                : [
+                    `| Service | Dependency | Condition |`,
+                    `| --- | --- | --- |`,
+                    ...report.reliability.unsafeDepends.map((entry) => `| ${entry.service} | ${entry.dependency} | ${entry.condition} |`),
+                ].join("\n"),
+            ``,
+            `### Missing Restart Policies (${report.reliability.missingRestart.length})`,
+            report.reliability.missingRestart.length === 0
+                ? "All services define a restart policy."
+                : report.reliability.missingRestart
+                    .map((entry) => `- ${entry.service}`)
+                    .join("\n"),
+        ].join("\n");
+    }
+    buildResourceSection(report) {
+        return [
+            `## Resource Analysis`,
+            ``,
+            `### Services Missing Limits (${report.resources.missingLimits.length})`,
+            report.resources.missingLimits.length === 0
+                ? "All services define CPU and memory limits."
+                : [
+                    `| Service | Missing |`,
+                    `| --- | --- |`,
+                    ...report.resources.missingLimits.map((entry) => `| ${entry.service} | ${entry.missing.join(", ")} |`),
+                ].join("\n"),
+        ].join("\n");
+    }
+    buildNetworkSection(report) {
+        return [
+            `## Network Analysis`,
+            ``,
+            `### Services on Default Network (${report.networks.servicesOnDefaultNetwork.length})`,
+            report.networks.servicesOnDefaultNetwork.length === 0
+                ? "No default-network usage detected."
+                : report.networks.servicesOnDefaultNetwork
+                    .map((entry) => `- ${entry.service}`)
+                    .join("\n"),
+            ``,
+            `### Random Host Bindings (${report.networks.exposedInternalPorts.length})`,
+            report.networks.exposedInternalPorts.length === 0
+                ? "No random host bindings detected."
+                : [
+                    `| Service | Port | Note |`,
+                    `| --- | --- | --- |`,
+                    ...report.networks.exposedInternalPorts.map((entry) => `| ${entry.service} | ${entry.port} | ${entry.note} |`),
+                ].join("\n"),
+        ].join("\n");
+    }
+    buildDockerRuntimeSection(report) {
+        if (!report.dockerRuntime) {
+            return "";
+        }
+        if (!report.dockerRuntime.available) {
+            return `## Docker Runtime\n\n${report.dockerRuntime.error ?? "Docker runtime unavailable."}`;
+        }
+        return [
+            `## Docker Runtime`,
+            ``,
+            `| Service | Container | State | Status | Health | Image |`,
+            `| --- | --- | --- | --- | --- | --- |`,
+            ...report.dockerRuntime.services.map((service) => `| ${service.service} | ${service.containerName ?? "—"} | ${service.state ?? "—"} | ${service.status ?? "—"} | ${service.health ?? "—"} | ${service.image ?? "—"} |`),
+        ].join("\n");
+    }
+    buildRecommendationsSection(report) {
+        if (report.recommendations.length === 0) {
+            return "## Recommendations\n\nNo recommendations.";
+        }
+        return `## Recommendations\n\n${report.recommendations
+            .map((recommendation) => {
+            const fix = recommendation.fix
+                ? `\n  - Fix: ${recommendation.fix}`
+                : "";
+            return `- **${recommendation.priority.toUpperCase()}** ${recommendation.service}: ${recommendation.message}${fix}`;
+        })
+            .join("\n")}`;
+    }
+}
+exports.ReportGenerator = ReportGenerator;

package/dist/src/types.d.ts

@@ -0,0 +1,198 @@
+export interface ComposeService {
+    name?: string;
+    image?: string;
+    build?: string | {
+        context?: string;
+        dockerfile?: string;
+    };
+    ports?: Array<string | {
+        target: number;
+        published?: number | string;
+        host_ip?: string;
+        protocol?: string;
+    }>;
+    environment?: Record<string, string | null> | string[];
+    env_file?: string | string[];
+    volumes?: Array<string | {
+        type?: string;
+        source?: string;
+        target?: string;
+    }>;
+    networks?: string[] | Record<string, unknown>;
+    depends_on?: string[] | Record<string, {
+        condition?: string;
+    }>;
+    healthcheck?: {
+        test: string | string[];
+        interval?: string;
+        timeout?: string;
+        retries?: number;
+        start_period?: string;
+        disable?: boolean;
+    };
+    restart?: string;
+    deploy?: {
+        resources?: {
+            limits?: {
+                cpus?: string;
+                memory?: string;
+            };
+            reservations?: {
+                cpus?: string;
+                memory?: string;
+            };
+        };
+    };
+    mem_limit?: string;
+    mem_reservation?: string;
+    cpus?: number | string;
+    user?: string;
+    privileged?: boolean;
+    cap_add?: string[];
+    cap_drop?: string[];
+    secrets?: string[];
+    labels?: Record<string, string> | string[];
+}
+export interface ComposeFile {
+    version?: string;
+    services: Record<string, ComposeService>;
+    networks?: Record<string, unknown>;
+    volumes?: Record<string, unknown>;
+    secrets?: Record<string, unknown>;
+}
+export type ComposeSeverity = "critical" | "high" | "medium" | "low";
+export type ComposeCategory = "image" | "security" | "reliability" | "resources" | "network";
+export interface ComposeIssue {
+    service: string;
+    severity: ComposeSeverity;
+    category: ComposeCategory;
+    title: string;
+    detail: string;
+    fix?: string;
+}
+export interface ImageAnalysis {
+    unpinnedImages: {
+        service: string;
+        image: string;
+        recommendation: string;
+    }[];
+    latestTagImages: {
+        service: string;
+        image: string;
+    }[];
+    issues: ComposeIssue[];
+}
+export interface SecurityAnalysis {
+    secretsInEnv: {
+        service: string;
+        variable: string;
+        pattern: string;
+    }[];
+    privilegedServices: {
+        service: string;
+    }[];
+    exposedDatabases: {
+        service: string;
+        image: string;
+        port: string;
+        bindAddr: string;
+    }[];
+    issues: ComposeIssue[];
+}
+export interface ReliabilityAnalysis {
+    missingHealthcheck: {
+        service: string;
+    }[];
+    unsafeDepends: {
+        service: string;
+        dependency: string;
+        condition: string;
+    }[];
+    missingRestart: {
+        service: string;
+    }[];
+    insecureRestartPolicy: {
+        service: string;
+        policy: string;
+    }[];
+    issues: ComposeIssue[];
+}
+export interface ResourceAnalysis {
+    missingLimits: {
+        service: string;
+        missing: string[];
+    }[];
+    issues: ComposeIssue[];
+}
+export interface NetworkAnalysis {
+    servicesOnDefaultNetwork: {
+        service: string;
+    }[];
+    exposedInternalPorts: {
+        service: string;
+        port: string;
+        note: string;
+    }[];
+    issues: ComposeIssue[];
+}
+export interface ComposeMetrics {
+    totalServices: number;
+    servicesWithBuild: number;
+    namedVolumes: number;
+    totalIssues: number;
+    criticalIssues: number;
+    highIssues: number;
+}
+export interface Recommendation {
+    priority: ComposeSeverity;
+    service: string;
+    message: string;
+    fix?: string;
+}
+export interface DockerRuntimeService {
+    service: string;
+    containerName?: string;
+    image?: string;
+    state?: string;
+    status?: string;
+    health?: string;
+}
+export interface DockerRuntimeSummary {
+    available: boolean;
+    error?: string;
+    services: DockerRuntimeService[];
+}
+export interface FullComposeReport {
+    generatedAt: Date;
+    composeFile: string;
+    version?: string;
+    healthScore: number;
+    metrics: ComposeMetrics;
+    images: ImageAnalysis;
+    security: SecurityAnalysis;
+    reliability: ReliabilityAnalysis;
+    resources: ResourceAnalysis;
+    networks: NetworkAnalysis;
+    allIssues: ComposeIssue[];
+    recommendations: Recommendation[];
+    dockerRuntime?: DockerRuntimeSummary;
+}
+export interface NormalizedPort {
+    raw: string;
+    hostIp?: string;
+    published?: string;
+    target: string;
+    protocol: string;
+    exposesToAllInterfaces: boolean;
+    randomHostBinding: boolean;
+}
+export interface AnalyzerOptions {
+    outputDir?: string;
+    withDocker?: boolean;
+    quiet?: boolean;
+    html?: boolean;
+}
+export interface AnalyzerConfig {
+    output?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/utils/format.d.ts

@@ -0,0 +1,6 @@
+export declare function formatBytes(bytes: number): string;
+export declare function formatDuration(ms: number): string;
+export declare function formatMs(ms: number): string;
+export declare function formatNumber(value: number): string;
+export declare function formatPercent(value: number, decimals?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/src/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAEjE"}

package/dist/src/utils/format.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBytes = formatBytes;
+exports.formatDuration = formatDuration;
+exports.formatMs = formatMs;
+exports.formatNumber = formatNumber;
+exports.formatPercent = formatPercent;
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1_048_576)
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    if (bytes < 1_073_741_824)
+        return `${(bytes / 1_048_576).toFixed(2)} MB`;
+    return `${(bytes / 1_073_741_824).toFixed(2)} GB`;
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms.toFixed(0)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(2)}s`;
+    return `${(ms / 60_000).toFixed(2)}m`;
+}
+function formatMs(ms) {
+    return formatDuration(ms);
+}
+function formatNumber(value) {
+    return value.toLocaleString("en-US");
+}
+function formatPercent(value, decimals = 2) {
+    return `${value.toFixed(decimals)}%`;
+}

package/dist/src/utils/print.d.ts

@@ -0,0 +1,8 @@
+export declare function printSection(title: string): void;
+export declare function printRow(label: string, value: string | number): void;
+export declare function printBullet(line: string): void;
+export declare function printSubBullet(line: string): void;
+export declare function printSeparator(): void;
+export declare function healthEmoji(score: number): string;
+export declare function healthLabel(score: number): string;
+//# sourceMappingURL=print.d.ts.map

package/dist/src/utils/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../../src/utils/print.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/src/utils/print.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printSection = printSection;
+exports.printRow = printRow;
+exports.printBullet = printBullet;
+exports.printSubBullet = printSubBullet;
+exports.printSeparator = printSeparator;
+exports.healthEmoji = healthEmoji;
+exports.healthLabel = healthLabel;
+function printSection(title) {
+    console.log(`\n━━━ ${title} ━━━`);
+}
+function printRow(label, value) {
+    console.log(`  ${label}: ${value}`);
+}
+function printBullet(line) {
+    console.log(`  • ${line}`);
+}
+function printSubBullet(line) {
+    console.log(`    ${line}`);
+}
+function printSeparator() {
+    console.log("");
+}
+function healthEmoji(score) {
+    if (score >= 90)
+        return "🟢";
+    if (score >= 70)
+        return "🟡";
+    if (score >= 50)
+        return "🟠";
+    return "🔴";
+}
+function healthLabel(score) {
+    if (score >= 90)
+        return "Excellent";
+    if (score >= 70)
+        return "Good";
+    if (score >= 50)
+        return "Warning";
+    return "Critical";
+}