postgresai 0.14.0-dev.37 → 0.14.0-dev.39

package/dist/lib/checkup.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Express checkup module - generates JSON reports directly from PostgreSQL
+ * without going through Prometheus.
+ *
+ * This module reuses the same SQL queries from metrics.yml but runs them
+ * directly against the target database.
+ */
+import { Client } from "pg";
+/**
+ * PostgreSQL version information
+ */
+export interface PostgresVersion {
+    version: string;
+    server_version_num: string;
+    server_major_ver: string;
+    server_minor_ver: string;
+}
+/**
+ * Setting information from pg_settings
+ */
+export interface SettingInfo {
+    setting: string;
+    unit: string;
+    category: string;
+    context: string;
+    vartype: string;
+    pretty_value: string;
+}
+/**
+ * Altered setting (A007) - subset of SettingInfo
+ */
+export interface AlteredSetting {
+    value: string;
+    unit: string;
+    category: string;
+    pretty_value: string;
+}
+/**
+ * Cluster metric (A004)
+ */
+export interface ClusterMetric {
+    value: string;
+    unit: string;
+    description: string;
+}
+/**
+ * Node result for reports
+ */
+export interface NodeResult {
+    data: Record<string, any>;
+    postgres_version?: PostgresVersion;
+}
+/**
+ * Report structure matching JSON schemas
+ */
+export interface Report {
+    version: string | null;
+    build_ts: string | null;
+    checkId: string;
+    checkTitle: string;
+    timestamptz: string;
+    nodes: {
+        primary: string;
+        standbys: string[];
+    };
+    results: Record<string, NodeResult>;
+}
+/**
+ * SQL queries derived from metrics.yml
+ * These are the same queries used by pgwatch to export metrics to Prometheus
+ */
+export declare const METRICS_SQL: {
+    settings: string;
+    alteredSettings: string;
+    version: string;
+    databaseSizes: string;
+    clusterStats: string;
+    connectionStates: string;
+    uptimeInfo: string;
+};
+/**
+ * Parse PostgreSQL version number into major and minor components
+ */
+export declare function parseVersionNum(versionNum: string): {
+    major: string;
+    minor: string;
+};
+/**
+ * Format bytes to human readable string
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Get PostgreSQL version information
+ */
+export declare function getPostgresVersion(client: Client): Promise<PostgresVersion>;
+/**
+ * Get all PostgreSQL settings
+ */
+export declare function getSettings(client: Client): Promise<Record<string, SettingInfo>>;
+/**
+ * Get altered (non-default) PostgreSQL settings
+ */
+export declare function getAlteredSettings(client: Client): Promise<Record<string, AlteredSetting>>;
+/**
+ * Get database sizes
+ */
+export declare function getDatabaseSizes(client: Client): Promise<Record<string, number>>;
+/**
+ * Get cluster general info metrics
+ */
+export declare function getClusterInfo(client: Client): Promise<Record<string, ClusterMetric>>;
+/**
+ * Create base report structure
+ */
+export declare function createBaseReport(checkId: string, checkTitle: string, nodeName: string): Report;
+/**
+ * Generate A002 report - Postgres major version
+ */
+export declare function generateA002(client: Client, nodeName?: string): Promise<Report>;
+/**
+ * Generate A003 report - Postgres settings
+ */
+export declare function generateA003(client: Client, nodeName?: string): Promise<Report>;
+/**
+ * Generate A004 report - Cluster information
+ */
+export declare function generateA004(client: Client, nodeName?: string): Promise<Report>;
+/**
+ * Generate A007 report - Altered settings
+ */
+export declare function generateA007(client: Client, nodeName?: string): Promise<Report>;
+/**
+ * Generate A013 report - Postgres minor version
+ */
+export declare function generateA013(client: Client, nodeName?: string): Promise<Report>;
+/**
+ * Available report generators
+ */
+export declare const REPORT_GENERATORS: Record<string, (client: Client, nodeName: string) => Promise<Report>>;
+/**
+ * Check IDs and titles
+ */
+export declare const CHECK_INFO: Record<string, string>;
+/**
+ * Generate all available reports
+ */
+export declare function generateAllReports(client: Client, nodeName?: string, onProgress?: (info: {
+    checkId: string;
+    checkTitle: string;
+    index: number;
+    total: number;
+}) => void): Promise<Record<string, Report>>;
+//# sourceMappingURL=checkup.d.ts.map

package/dist/lib/checkup.d.ts.map

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

package/dist/lib/checkup.js

@@ -0,0 +1,536 @@
+"use strict";
+/**
+ * Express checkup module - generates JSON reports directly from PostgreSQL
+ * without going through Prometheus.
+ *
+ * This module reuses the same SQL queries from metrics.yml but runs them
+ * directly against the target database.
+ */
+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.CHECK_INFO = exports.REPORT_GENERATORS = exports.METRICS_SQL = void 0;
+exports.parseVersionNum = parseVersionNum;
+exports.formatBytes = formatBytes;
+exports.getPostgresVersion = getPostgresVersion;
+exports.getSettings = getSettings;
+exports.getAlteredSettings = getAlteredSettings;
+exports.getDatabaseSizes = getDatabaseSizes;
+exports.getClusterInfo = getClusterInfo;
+exports.createBaseReport = createBaseReport;
+exports.generateA002 = generateA002;
+exports.generateA003 = generateA003;
+exports.generateA004 = generateA004;
+exports.generateA007 = generateA007;
+exports.generateA013 = generateA013;
+exports.generateAllReports = generateAllReports;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const pkg = __importStar(require("../package.json"));
+/**
+ * SQL queries derived from metrics.yml
+ * These are the same queries used by pgwatch to export metrics to Prometheus
+ */
+exports.METRICS_SQL = {
+    // From metrics.yml: settings metric
+    // Queries pg_settings for all configuration parameters
+    settings: `
+    SELECT
+      name,
+      setting,
+      COALESCE(unit, '') as unit,
+      category,
+      context,
+      vartype,
+      CASE
+        WHEN unit = '8kB' THEN pg_size_pretty(setting::bigint * 8192)
+        WHEN unit = 'kB' THEN pg_size_pretty(setting::bigint * 1024)
+        WHEN unit = 'MB' THEN pg_size_pretty(setting::bigint * 1024 * 1024)
+        WHEN unit = 'B' THEN pg_size_pretty(setting::bigint)
+        WHEN unit = 'ms' THEN setting || ' ms'
+        WHEN unit = 's' THEN setting || ' s'
+        WHEN unit = 'min' THEN setting || ' min'
+        ELSE setting
+      END as pretty_value,
+      source,
+      CASE WHEN source <> 'default' THEN 0 ELSE 1 END as is_default
+    FROM pg_settings
+    ORDER BY name
+  `,
+    // Altered settings - non-default values only (A007)
+    alteredSettings: `
+    SELECT
+      name,
+      setting,
+      COALESCE(unit, '') as unit,
+      category,
+      CASE
+        WHEN unit = '8kB' THEN pg_size_pretty(setting::bigint * 8192)
+        WHEN unit = 'kB' THEN pg_size_pretty(setting::bigint * 1024)
+        WHEN unit = 'MB' THEN pg_size_pretty(setting::bigint * 1024 * 1024)
+        WHEN unit = 'B' THEN pg_size_pretty(setting::bigint)
+        WHEN unit = 'ms' THEN setting || ' ms'
+        WHEN unit = 's' THEN setting || ' s'
+        WHEN unit = 'min' THEN setting || ' min'
+        ELSE setting
+      END as pretty_value
+    FROM pg_settings
+    WHERE source <> 'default'
+    ORDER BY name
+  `,
+    // Version info - extracts server_version and server_version_num
+    version: `
+    SELECT
+      name,
+      setting
+    FROM pg_settings
+    WHERE name IN ('server_version', 'server_version_num')
+  `,
+    // Database sizes (A004)
+    databaseSizes: `
+    SELECT
+      datname,
+      pg_database_size(datname) as size_bytes
+    FROM pg_database
+    WHERE datistemplate = false
+    ORDER BY size_bytes DESC
+  `,
+    // Cluster statistics (A004)
+    clusterStats: `
+    SELECT
+      sum(numbackends) as total_connections,
+      sum(xact_commit) as total_commits,
+      sum(xact_rollback) as total_rollbacks,
+      sum(blks_read) as blocks_read,
+      sum(blks_hit) as blocks_hit,
+      sum(tup_returned) as tuples_returned,
+      sum(tup_fetched) as tuples_fetched,
+      sum(tup_inserted) as tuples_inserted,
+      sum(tup_updated) as tuples_updated,
+      sum(tup_deleted) as tuples_deleted,
+      sum(deadlocks) as total_deadlocks,
+      sum(temp_files) as temp_files_created,
+      sum(temp_bytes) as temp_bytes_written
+    FROM pg_stat_database
+    WHERE datname IS NOT NULL
+  `,
+    // Connection states (A004)
+    connectionStates: `
+    SELECT
+      COALESCE(state, 'null') as state,
+      count(*) as count
+    FROM pg_stat_activity
+    GROUP BY state
+  `,
+    // Uptime info (A004)
+    uptimeInfo: `
+    SELECT
+      pg_postmaster_start_time() as start_time,
+      current_timestamp - pg_postmaster_start_time() as uptime
+  `,
+};
+/**
+ * Parse PostgreSQL version number into major and minor components
+ */
+function parseVersionNum(versionNum) {
+    if (!versionNum || versionNum.length < 6) {
+        return { major: "", minor: "" };
+    }
+    try {
+        const num = parseInt(versionNum, 10);
+        return {
+            major: Math.floor(num / 10000).toString(),
+            minor: (num % 10000).toString(),
+        };
+    }
+    catch {
+        return { major: "", minor: "" };
+    }
+}
+/**
+ * Format bytes to human readable string
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const units = ["B", "kB", "MB", "GB", "TB", "PB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return `${(bytes / Math.pow(1024, i)).toFixed(2)} ${units[i]}`;
+}
+/**
+ * Get PostgreSQL version information
+ */
+async function getPostgresVersion(client) {
+    const result = await client.query(exports.METRICS_SQL.version);
+    let version = "";
+    let serverVersionNum = "";
+    for (const row of result.rows) {
+        if (row.name === "server_version") {
+            version = row.setting;
+        }
+        else if (row.name === "server_version_num") {
+            serverVersionNum = row.setting;
+        }
+    }
+    const { major, minor } = parseVersionNum(serverVersionNum);
+    return {
+        version,
+        server_version_num: serverVersionNum,
+        server_major_ver: major,
+        server_minor_ver: minor,
+    };
+}
+/**
+ * Get all PostgreSQL settings
+ */
+async function getSettings(client) {
+    const result = await client.query(exports.METRICS_SQL.settings);
+    const settings = {};
+    for (const row of result.rows) {
+        settings[row.name] = {
+            setting: row.setting,
+            unit: row.unit,
+            category: row.category,
+            context: row.context,
+            vartype: row.vartype,
+            pretty_value: row.pretty_value,
+        };
+    }
+    return settings;
+}
+/**
+ * Get altered (non-default) PostgreSQL settings
+ */
+async function getAlteredSettings(client) {
+    const result = await client.query(exports.METRICS_SQL.alteredSettings);
+    const settings = {};
+    for (const row of result.rows) {
+        settings[row.name] = {
+            value: row.setting,
+            unit: row.unit,
+            category: row.category,
+            pretty_value: row.pretty_value,
+        };
+    }
+    return settings;
+}
+/**
+ * Get database sizes
+ */
+async function getDatabaseSizes(client) {
+    const result = await client.query(exports.METRICS_SQL.databaseSizes);
+    const sizes = {};
+    for (const row of result.rows) {
+        sizes[row.datname] = parseInt(row.size_bytes, 10);
+    }
+    return sizes;
+}
+/**
+ * Get cluster general info metrics
+ */
+async function getClusterInfo(client) {
+    const info = {};
+    // Get cluster statistics
+    const statsResult = await client.query(exports.METRICS_SQL.clusterStats);
+    if (statsResult.rows.length > 0) {
+        const stats = statsResult.rows[0];
+        info.total_connections = {
+            value: String(stats.total_connections || 0),
+            unit: "connections",
+            description: "Total active database connections",
+        };
+        info.total_commits = {
+            value: String(stats.total_commits || 0),
+            unit: "transactions",
+            description: "Total committed transactions",
+        };
+        info.total_rollbacks = {
+            value: String(stats.total_rollbacks || 0),
+            unit: "transactions",
+            description: "Total rolled back transactions",
+        };
+        const blocksHit = parseInt(stats.blocks_hit || "0", 10);
+        const blocksRead = parseInt(stats.blocks_read || "0", 10);
+        const totalBlocks = blocksHit + blocksRead;
+        const cacheHitRatio = totalBlocks > 0 ? ((blocksHit / totalBlocks) * 100).toFixed(2) : "0.00";
+        info.cache_hit_ratio = {
+            value: cacheHitRatio,
+            unit: "%",
+            description: "Buffer cache hit ratio",
+        };
+        info.blocks_read = {
+            value: String(blocksRead),
+            unit: "blocks",
+            description: "Total disk blocks read",
+        };
+        info.blocks_hit = {
+            value: String(blocksHit),
+            unit: "blocks",
+            description: "Total buffer cache hits",
+        };
+        info.tuples_returned = {
+            value: String(stats.tuples_returned || 0),
+            unit: "rows",
+            description: "Total rows returned by queries",
+        };
+        info.tuples_fetched = {
+            value: String(stats.tuples_fetched || 0),
+            unit: "rows",
+            description: "Total rows fetched by queries",
+        };
+        info.tuples_inserted = {
+            value: String(stats.tuples_inserted || 0),
+            unit: "rows",
+            description: "Total rows inserted",
+        };
+        info.tuples_updated = {
+            value: String(stats.tuples_updated || 0),
+            unit: "rows",
+            description: "Total rows updated",
+        };
+        info.tuples_deleted = {
+            value: String(stats.tuples_deleted || 0),
+            unit: "rows",
+            description: "Total rows deleted",
+        };
+        info.total_deadlocks = {
+            value: String(stats.total_deadlocks || 0),
+            unit: "deadlocks",
+            description: "Total deadlocks detected",
+        };
+        info.temp_files_created = {
+            value: String(stats.temp_files_created || 0),
+            unit: "files",
+            description: "Total temporary files created",
+        };
+        const tempBytes = parseInt(stats.temp_bytes_written || "0", 10);
+        info.temp_bytes_written = {
+            value: formatBytes(tempBytes),
+            unit: "bytes",
+            description: "Total temporary file bytes written",
+        };
+    }
+    // Get connection states
+    const connResult = await client.query(exports.METRICS_SQL.connectionStates);
+    for (const row of connResult.rows) {
+        const stateKey = `connections_${row.state.replace(/\s+/g, "_")}`;
+        info[stateKey] = {
+            value: String(row.count),
+            unit: "connections",
+            description: `Connections in '${row.state}' state`,
+        };
+    }
+    // Get uptime info
+    const uptimeResult = await client.query(exports.METRICS_SQL.uptimeInfo);
+    if (uptimeResult.rows.length > 0) {
+        const uptime = uptimeResult.rows[0];
+        info.start_time = {
+            value: uptime.start_time.toISOString(),
+            unit: "timestamp",
+            description: "PostgreSQL server start time",
+        };
+        info.uptime = {
+            value: uptime.uptime,
+            unit: "interval",
+            description: "Server uptime",
+        };
+    }
+    return info;
+}
+/**
+ * Create base report structure
+ */
+function createBaseReport(checkId, checkTitle, nodeName) {
+    const buildTs = resolveBuildTs();
+    return {
+        version: pkg.version || null,
+        build_ts: buildTs,
+        checkId,
+        checkTitle,
+        timestamptz: new Date().toISOString(),
+        nodes: {
+            primary: nodeName,
+            standbys: [],
+        },
+        results: {},
+    };
+}
+function readTextFileSafe(p) {
+    try {
+        const value = fs.readFileSync(p, "utf8").trim();
+        return value || null;
+    }
+    catch {
+        return null;
+    }
+}
+function resolveBuildTs() {
+    // Follow reporter.py approach: read BUILD_TS from filesystem, with env override.
+    // Default: /BUILD_TS (useful in container images).
+    const envPath = process.env.PGAI_BUILD_TS_FILE;
+    const p = (envPath && envPath.trim()) ? envPath.trim() : "/BUILD_TS";
+    const fromFile = readTextFileSafe(p);
+    if (fromFile)
+        return fromFile;
+    // Fallback for packaged CLI: allow placing BUILD_TS next to dist/ (package root).
+    // dist/lib/checkup.js => package root: dist/..
+    try {
+        const pkgRoot = path.resolve(__dirname, "..");
+        const fromPkgFile = readTextFileSafe(path.join(pkgRoot, "BUILD_TS"));
+        if (fromPkgFile)
+            return fromPkgFile;
+    }
+    catch {
+        // ignore
+    }
+    // Last resort: use package.json mtime as an approximation (non-null, stable-ish).
+    try {
+        const pkgJsonPath = path.resolve(__dirname, "..", "package.json");
+        const st = fs.statSync(pkgJsonPath);
+        return st.mtime.toISOString();
+    }
+    catch {
+        return new Date().toISOString();
+    }
+}
+/**
+ * Generate A002 report - Postgres major version
+ */
+async function generateA002(client, nodeName = "node-01") {
+    const report = createBaseReport("A002", "Postgres major version", nodeName);
+    const postgresVersion = await getPostgresVersion(client);
+    report.results[nodeName] = {
+        data: {
+            version: postgresVersion,
+        },
+    };
+    return report;
+}
+/**
+ * Generate A003 report - Postgres settings
+ */
+async function generateA003(client, nodeName = "node-01") {
+    const report = createBaseReport("A003", "Postgres settings", nodeName);
+    const settings = await getSettings(client);
+    const postgresVersion = await getPostgresVersion(client);
+    report.results[nodeName] = {
+        data: settings,
+        postgres_version: postgresVersion,
+    };
+    return report;
+}
+/**
+ * Generate A004 report - Cluster information
+ */
+async function generateA004(client, nodeName = "node-01") {
+    const report = createBaseReport("A004", "Cluster information", nodeName);
+    const generalInfo = await getClusterInfo(client);
+    const databaseSizes = await getDatabaseSizes(client);
+    const postgresVersion = await getPostgresVersion(client);
+    report.results[nodeName] = {
+        data: {
+            general_info: generalInfo,
+            database_sizes: databaseSizes,
+        },
+        postgres_version: postgresVersion,
+    };
+    return report;
+}
+/**
+ * Generate A007 report - Altered settings
+ */
+async function generateA007(client, nodeName = "node-01") {
+    const report = createBaseReport("A007", "Altered settings", nodeName);
+    const alteredSettings = await getAlteredSettings(client);
+    const postgresVersion = await getPostgresVersion(client);
+    report.results[nodeName] = {
+        data: alteredSettings,
+        postgres_version: postgresVersion,
+    };
+    return report;
+}
+/**
+ * Generate A013 report - Postgres minor version
+ */
+async function generateA013(client, nodeName = "node-01") {
+    const report = createBaseReport("A013", "Postgres minor version", nodeName);
+    const postgresVersion = await getPostgresVersion(client);
+    report.results[nodeName] = {
+        data: {
+            version: postgresVersion,
+        },
+    };
+    return report;
+}
+/**
+ * Available report generators
+ */
+exports.REPORT_GENERATORS = {
+    A002: generateA002,
+    A003: generateA003,
+    A004: generateA004,
+    A007: generateA007,
+    A013: generateA013,
+};
+/**
+ * Check IDs and titles
+ */
+exports.CHECK_INFO = {
+    A002: "Postgres major version",
+    A003: "Postgres settings",
+    A004: "Cluster information",
+    A007: "Altered settings",
+    A013: "Postgres minor version",
+};
+/**
+ * Generate all available reports
+ */
+async function generateAllReports(client, nodeName = "node-01", onProgress) {
+    const reports = {};
+    const entries = Object.entries(exports.REPORT_GENERATORS);
+    const total = entries.length;
+    let index = 0;
+    for (const [checkId, generator] of entries) {
+        index += 1;
+        onProgress?.({
+            checkId,
+            checkTitle: exports.CHECK_INFO[checkId] || checkId,
+            index,
+            total,
+        });
+        reports[checkId] = await generator(client, nodeName);
+    }
+    return reports;
+}
+//# sourceMappingURL=checkup.js.map