postgresai 0.16.0-rc.4 → 0.16.0

package/lib/metrics-loader.ts

@@ -1,134 +0,0 @@
-/**
- * Metrics loader for express checkup reports
- *
- * Loads SQL queries from embedded metrics data (generated from metrics.yml at build time).
- * Provides version-aware query selection and row transformation utilities.
- */
-
-import { METRICS, MetricDefinition } from "./metrics-embedded";
-
-/**
- * Get SQL query for a specific metric, selecting the appropriate version.
- *
- * @param metricName - Name of the metric (e.g., "settings", "db_stats")
- * @param pgMajorVersion - PostgreSQL major version (default: 16)
- * @returns SQL query string
- * @throws Error if metric not found or no compatible version available
- */
-export function getMetricSql(metricName: string, pgMajorVersion: number = 16): string {
-  const metric = METRICS[metricName];
-
-  if (!metric) {
-    throw new Error(`Metric "${metricName}" not found. Available metrics: ${Object.keys(METRICS).join(", ")}`);
-  }
-
-  // Find the best matching version: highest version <= pgMajorVersion
-  const availableVersions = Object.keys(metric.sqls)
-    .map(v => parseInt(v, 10))
-    .sort((a, b) => b - a); // Sort descending
-
-  const matchingVersion = availableVersions.find(v => v <= pgMajorVersion);
-
-  if (matchingVersion === undefined) {
-    throw new Error(
-      `No compatible SQL version for metric "${metricName}" with PostgreSQL ${pgMajorVersion}. ` +
-      `Available versions: ${availableVersions.join(", ")}`
-    );
-  }
-
-  return metric.sqls[matchingVersion];
-}
-
-/**
- * Get metric definition including all metadata.
- *
- * @param metricName - Name of the metric
- * @returns MetricDefinition or undefined if not found
- */
-export function getMetricDefinition(metricName: string): MetricDefinition | undefined {
-  return METRICS[metricName];
-}
-
-/**
- * List all available metric names.
- */
-export function listMetricNames(): string[] {
-  return Object.keys(METRICS);
-}
-
-/**
- * Metric names that correspond to express report checks.
- * Maps check IDs and logical names to metric names in the METRICS object.
- */
-export const METRIC_NAMES = {
-  // Index health checks
-  H001: "pg_invalid_indexes",
-  H002: "unused_indexes",
-  H004: "redundant_indexes",
-  // Dead tuples and per-table autovacuum overrides
-  F003: "pg_dead_tuples",
-  // Bloat estimation
-  F004: "pg_table_bloat",
-  F005: "pg_btree_bloat",
-  // Settings and version info (A002, A003, A007, A013)
-  settings: "settings",
-  // Database statistics (A004)
-  dbStats: "db_stats",
-  dbSize: "db_size",
-  // Stats reset info (H002)
-  statsReset: "stats_reset",
-  // I/O statistics (I001) - PostgreSQL 16+
-  I001: "pg_stat_io",
-} as const;
-
-/**
- * Transform a row from metrics query output to JSON report format.
- * Metrics use `tag_` prefix for dimensions; we strip it for JSON reports.
- * Also removes Prometheus-specific fields like epoch_ns, num, tag_datname.
- */
-export function transformMetricRow(row: Record<string, unknown>): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-
-  for (const [key, value] of Object.entries(row)) {
-    // Skip Prometheus-specific fields
-    if (key === "epoch_ns" || key === "num" || key === "tag_datname") {
-      continue;
-    }
-
-    // Strip tag_ prefix
-    const newKey = key.startsWith("tag_") ? key.slice(4) : key;
-    result[newKey] = value;
-  }
-
-  return result;
-}
-
-/**
- * Transform settings metric row to the format expected by express reports.
- * The settings metric returns one row per setting with tag_setting_name as key.
- */
-export function transformSettingsRow(row: Record<string, unknown>): {
-  name: string;
-  setting: string;
-  unit: string;
-  category: string;
-  vartype: string;
-  is_default: boolean;
-} {
-  return {
-    name: String(row.tag_setting_name || ""),
-    setting: String(row.tag_setting_value || ""),
-    unit: String(row.tag_unit || ""),
-    category: String(row.tag_category || ""),
-    vartype: String(row.tag_vartype || ""),
-    is_default: row.is_default === 1 || row.is_default === true,
-  };
-}
-
-// Re-export types for convenience
-export type { MetricDefinition } from "./metrics-embedded";
-
-// Legacy export for backward compatibility
-export function loadMetricsYml(): { metrics: Record<string, unknown> } {
-  return { metrics: METRICS };
-}

package/lib/pkce.ts

@@ -1,79 +0,0 @@
-import * as crypto from "crypto";
-
-/**
- * PKCE parameters for OAuth 2.0 Authorization Code Flow with PKCE
- */
-export interface PKCEParams {
-  codeVerifier: string;
-  codeChallenge: string;
-  codeChallengeMethod: "S256";
-  state: string;
-}
-
-/**
- * Generate a cryptographically random string for PKCE
- * @param length - Length of the string (43-128 characters per RFC 7636)
- * @returns Base64URL-encoded random string
- */
-function generateRandomString(length: number = 64): string {
-  const bytes = crypto.randomBytes(length);
-  return base64URLEncode(bytes);
-}
-
-/**
- * Base64URL encode (without padding)
- * @param buffer - Buffer to encode
- * @returns Base64URL-encoded string
- */
-function base64URLEncode(buffer: Buffer): string {
-  return buffer
-    .toString("base64")
-    .replace(/\+/g, "-")
-    .replace(/\//g, "_")
-    .replace(/=/g, "");
-}
-
-/**
- * Generate PKCE code verifier
- * @returns Random code verifier (43-128 characters)
- */
-export function generateCodeVerifier(): string {
-  return generateRandomString(32); // 32 bytes = 43 chars after base64url encoding
-}
-
-/**
- * Generate PKCE code challenge from verifier
- * Uses S256 method (SHA256)
- * @param verifier - Code verifier string
- * @returns Base64URL-encoded SHA256 hash of verifier
- */
-export function generateCodeChallenge(verifier: string): string {
-  const hash = crypto.createHash("sha256").update(verifier).digest();
-  return base64URLEncode(hash);
-}
-
-/**
- * Generate random state for CSRF protection
- * @returns Random state string
- */
-export function generateState(): string {
-  return generateRandomString(16); // 16 bytes = 22 chars
-}
-
-/**
- * Generate complete PKCE parameters
- * @returns Object with verifier, challenge, challengeMethod, and state
- */
-export function generatePKCEParams(): PKCEParams {
-  const verifier = generateCodeVerifier();
-  const challenge = generateCodeChallenge(verifier);
-  const state = generateState();
-
-  return {
-    codeVerifier: verifier,
-    codeChallenge: challenge,
-    codeChallengeMethod: "S256",
-    state: state,
-  };
-}
-

package/lib/reports.ts

@@ -1,373 +0,0 @@
-import { formatHttpError, maskSecret, normalizeBaseUrl } from "./util";
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export interface CheckupReport {
-  id: number;
-  org_id: number;
-  org_name: string;
-  project_id: number;
-  project_name: string;
-  created_at: string;
-  created_formatted: string;
-  epoch: number;
-  status: string;
-}
-
-export interface CheckupReportFile {
-  id: number;
-  checkup_report_id: number;
-  filename: string;
-  check_id: string;
-  type: "json" | "md";
-  created_at: string;
-  created_formatted: string;
-  project_id: number;
-  project_name: string;
-}
-
-export interface CheckupReportFileData extends CheckupReportFile {
-  data: string;
-}
-
-// ============================================================================
-// Date parsing
-// ============================================================================
-
-/**
- * Parse a date string in various formats into an ISO 8601 string.
- * Supported formats:
- *   YYYY-MM-DD            2025-01-15
- *   YYYY-MM-DDTHH:mm:ss   2025-01-15T10:30:00
- *   YYYY-MM-DD HH:mm:ss   2025-01-15 10:30:00
- *   YYYY-MM-DD HH:mm      2025-01-15 10:30
- *   DD.MM.YYYY             15.01.2025
- *   DD.MM.YYYY HH:mm      15.01.2025 10:30
- *   DD.MM.YYYY HH:mm:ss   15.01.2025 10:30:00
- */
-export function parseFlexibleDate(input: string): string {
-  const s = input.trim();
-
-  // DD.MM.YYYY [HH:mm[:ss]]
-  const dotMatch = s.match(/^(\d{1,2})\.(\d{1,2})\.(\d{4})(?:\s+(\d{1,2}):(\d{2})(?::(\d{2}))?)?$/);
-  if (dotMatch) {
-    const [, dd, mm, yyyy, hh, min, ss] = dotMatch;
-    const iso = `${yyyy}-${mm.padStart(2, "0")}-${dd.padStart(2, "0")}T${(hh ?? "00").padStart(2, "0")}:${(min ?? "00").padStart(2, "0")}:${(ss ?? "00").padStart(2, "0")}Z`;
-    const d = new Date(iso);
-    if (isNaN(d.getTime())) throw new Error(`Invalid date: ${input}`);
-    return d.toISOString();
-  }
-
-  // YYYY-MM-DD[T ]HH:mm[:ss] or YYYY-MM-DD
-  const isoMatch = s.match(/^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?$/);
-  if (isoMatch) {
-    const [, yyyy, mm, dd, hh, min, ss] = isoMatch;
-    const iso = `${yyyy}-${mm}-${dd}T${hh ?? "00"}:${min ?? "00"}:${ss ?? "00"}Z`;
-    const d = new Date(iso);
-    if (isNaN(d.getTime())) throw new Error(`Invalid date: ${input}`);
-    return d.toISOString();
-  }
-
-  throw new Error(`Unrecognized date format: ${input}. Use YYYY-MM-DD or DD.MM.YYYY`);
-}
-
-// ============================================================================
-// Params
-// ============================================================================
-
-export interface FetchReportsParams {
-  apiKey: string;
-  apiBaseUrl: string;
-  projectId?: number;
-  status?: string;
-  limit?: number;
-  beforeDate?: string;
-  /** @internal Used by fetchAllReports for keyset pagination */
-  beforeId?: number;
-  debug?: boolean;
-}
-
-export interface FetchReportFilesParams {
-  apiKey: string;
-  apiBaseUrl: string;
-  reportId?: number;
-  type?: "json" | "md";
-  checkId?: string;
-  debug?: boolean;
-}
-
-export interface FetchReportFileDataParams {
-  apiKey: string;
-  apiBaseUrl: string;
-  reportId?: number;
-  type?: "json" | "md";
-  checkId?: string;
-  debug?: boolean;
-}
-
-// ============================================================================
-// API functions
-// ============================================================================
-
-export async function fetchReports(params: FetchReportsParams): Promise<CheckupReport[]> {
-  const { apiKey, apiBaseUrl, projectId, status, limit = 20, beforeDate, beforeId, debug } = params;
-  if (!apiKey) {
-    throw new Error("API key is required");
-  }
-
-  const base = normalizeBaseUrl(apiBaseUrl);
-  const url = new URL(`${base}/checkup_reports`);
-  url.searchParams.set("order", "id.desc");
-  url.searchParams.set("limit", String(limit));
-  if (typeof projectId === "number") {
-    url.searchParams.set("project_id", `eq.${projectId}`);
-  }
-  if (status) {
-    url.searchParams.set("status", `eq.${status}`);
-  }
-  if (beforeDate) {
-    url.searchParams.set("created_at", `lt.${beforeDate}`);
-  }
-  if (typeof beforeId === "number") {
-    url.searchParams.set("id", `lt.${beforeId}`);
-  }
-
-  const headers: Record<string, string> = {
-    "access-token": apiKey,
-    "Prefer": "return=representation",
-    "Content-Type": "application/json",
-    "Connection": "close",
-  };
-
-  if (debug) {
-    const debugHeaders: Record<string, string> = { ...headers, "access-token": maskSecret(apiKey) };
-    console.error(`Debug: Resolved API base URL: ${base}`);
-    console.error(`Debug: GET URL: ${url.toString()}`);
-    console.error(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
-  }
-
-  const response = await fetch(url.toString(), { method: "GET", headers });
-
-  if (debug) {
-    console.error(`Debug: Response status: ${response.status}`);
-  }
-
-  const data = await response.text();
-
-  if (response.ok) {
-    try {
-      return JSON.parse(data) as CheckupReport[];
-    } catch {
-      throw new Error(`Failed to parse reports response: ${data}`);
-    }
-  } else {
-    throw new Error(formatHttpError("Failed to fetch reports", response.status, data));
-  }
-}
-
-const MAX_ALL_REPORTS = 10000;
-
-export async function fetchAllReports(params: Omit<FetchReportsParams, "beforeId" | "beforeDate">): Promise<CheckupReport[]> {
-  const pageSize = params.limit ?? 100;
-  const all: CheckupReport[] = [];
-  let beforeId: number | undefined;
-
-  while (true) {
-    const page = await fetchReports({ ...params, limit: pageSize, beforeId });
-    if (page.length === 0) break;
-    all.push(...page);
-    if (all.length >= MAX_ALL_REPORTS) {
-      console.warn(`Warning: reached maximum of ${MAX_ALL_REPORTS} reports, stopping pagination`);
-      break;
-    }
-    beforeId = page[page.length - 1].id;
-    if (page.length < pageSize) break;
-  }
-
-  return all;
-}
-
-export async function fetchReportFiles(params: FetchReportFilesParams): Promise<CheckupReportFile[]> {
-  const { apiKey, apiBaseUrl, reportId, type, checkId, debug } = params;
-  if (!apiKey) {
-    throw new Error("API key is required");
-  }
-  if (reportId === undefined && !checkId) {
-    throw new Error("Either reportId or checkId is required");
-  }
-
-  const base = normalizeBaseUrl(apiBaseUrl);
-  const url = new URL(`${base}/checkup_report_files`);
-  if (typeof reportId === "number") {
-    url.searchParams.set("checkup_report_id", `eq.${reportId}`);
-  }
-  url.searchParams.set("order", "id.asc");
-  if (type) {
-    url.searchParams.set("type", `eq.${type}`);
-  }
-  if (checkId) {
-    url.searchParams.set("check_id", `eq.${checkId}`);
-  }
-
-  const headers: Record<string, string> = {
-    "access-token": apiKey,
-    "Prefer": "return=representation",
-    "Content-Type": "application/json",
-    "Connection": "close",
-  };
-
-  if (debug) {
-    const debugHeaders: Record<string, string> = { ...headers, "access-token": maskSecret(apiKey) };
-    console.error(`Debug: Resolved API base URL: ${base}`);
-    console.error(`Debug: GET URL: ${url.toString()}`);
-    console.error(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
-  }
-
-  const response = await fetch(url.toString(), { method: "GET", headers });
-
-  if (debug) {
-    console.error(`Debug: Response status: ${response.status}`);
-  }
-
-  const data = await response.text();
-
-  if (response.ok) {
-    try {
-      return JSON.parse(data) as CheckupReportFile[];
-    } catch {
-      throw new Error(`Failed to parse report files response: ${data}`);
-    }
-  } else {
-    throw new Error(formatHttpError("Failed to fetch report files", response.status, data));
-  }
-}
-
-export async function fetchReportFileData(params: FetchReportFileDataParams): Promise<CheckupReportFileData[]> {
-  const { apiKey, apiBaseUrl, reportId, type, checkId, debug } = params;
-  if (!apiKey) {
-    throw new Error("API key is required");
-  }
-  if (reportId === undefined && !checkId) {
-    throw new Error("Either reportId or checkId is required");
-  }
-
-  const base = normalizeBaseUrl(apiBaseUrl);
-  const url = new URL(`${base}/checkup_report_file_data`);
-  if (typeof reportId === "number") {
-    url.searchParams.set("checkup_report_id", `eq.${reportId}`);
-  }
-  url.searchParams.set("order", "id.asc");
-  if (type) {
-    url.searchParams.set("type", `eq.${type}`);
-  }
-  if (checkId) {
-    url.searchParams.set("check_id", `eq.${checkId}`);
-  }
-
-  const headers: Record<string, string> = {
-    "access-token": apiKey,
-    "Prefer": "return=representation",
-    "Content-Type": "application/json",
-    "Connection": "close",
-  };
-
-  if (debug) {
-    const debugHeaders: Record<string, string> = { ...headers, "access-token": maskSecret(apiKey) };
-    console.error(`Debug: Resolved API base URL: ${base}`);
-    console.error(`Debug: GET URL: ${url.toString()}`);
-    console.error(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
-  }
-
-  const response = await fetch(url.toString(), { method: "GET", headers });
-
-  if (debug) {
-    console.error(`Debug: Response status: ${response.status}`);
-  }
-
-  const data = await response.text();
-
-  if (response.ok) {
-    try {
-      return JSON.parse(data) as CheckupReportFileData[];
-    } catch {
-      throw new Error(`Failed to parse report file data response: ${data}`);
-    }
-  } else {
-    throw new Error(formatHttpError("Failed to fetch report file data", response.status, data));
-  }
-}
-
-// ============================================================================
-// Lightweight markdown terminal renderer
-// ============================================================================
-
-export function renderMarkdownForTerminal(md: string): string {
-  if (!md) return "";
-
-  const RESET = "\x1b[0m";
-  const BOLD = "\x1b[1m";
-  const BOLD_UNDERLINE = "\x1b[1;4m";
-  const DIM = "\x1b[2m";
-  const ITALIC = "\x1b[3m";
-  const CYAN = "\x1b[36m";
-
-  const lines = md.split("\n");
-  const output: string[] = [];
-  let inCodeBlock = false;
-
-  for (const line of lines) {
-    // Code block toggle
-    if (line.trimStart().startsWith("```")) {
-      inCodeBlock = !inCodeBlock;
-      if (inCodeBlock) {
-        output.push(`${DIM}${"─".repeat(40)}${RESET}`);
-      } else {
-        output.push(`${DIM}${"─".repeat(40)}${RESET}`);
-      }
-      continue;
-    }
-
-    // Inside code block — dim output
-    if (inCodeBlock) {
-      output.push(`${DIM}  ${line}${RESET}`);
-      continue;
-    }
-
-    // Horizontal rule
-    if (/^-{3,}$/.test(line.trim()) || /^\*{3,}$/.test(line.trim()) || /^_{3,}$/.test(line.trim())) {
-      output.push(`${DIM}${"─".repeat(60)}${RESET}`);
-      continue;
-    }
-
-    // Headings
-    const headingMatch = line.match(/^(#{1,6})\s+(.*)/);
-    if (headingMatch) {
-      const level = headingMatch[1].length;
-      const text = headingMatch[2];
-      if (level === 1) {
-        output.push(`${BOLD_UNDERLINE}${text}${RESET}`);
-      } else {
-        output.push(`${BOLD}${text}${RESET}`);
-      }
-      continue;
-    }
-
-    // Inline formatting
-    let formatted = line;
-    // Bold: **text** or __text__
-    formatted = formatted.replace(/\*\*(.+?)\*\*/g, `${BOLD}$1${RESET}`);
-    formatted = formatted.replace(/__(.+?)__/g, `${BOLD}$1${RESET}`);
-    // Italic: *text* (only single, not inside **)
-    formatted = formatted.replace(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, `${ITALIC}$1${RESET}`);
-    // Italic: _text_ — only at word boundaries (not inside identifiers like foo_bar_baz)
-    formatted = formatted.replace(/(?<=^|[\s(])_([^\s_](?:.*?[^\s_])?)_(?=$|[\s),.:;!?])/g, `${ITALIC}$1${RESET}`);
-    // Inline code: `text`
-    formatted = formatted.replace(/`([^`]+)`/g, `${CYAN}$1${RESET}`);
-
-    output.push(formatted);
-  }
-
-  return output.join("\n");
-}