@hienlh/ppm 0.6.1 → 0.6.3

package/src/server/routes/postgres.ts

@@ -0,0 +1,92 @@
+import { Hono } from "hono";
+import { postgresService } from "../../services/postgres.service.ts";
+import { ok, err } from "../../types/api.ts";
+
+export const postgresRoutes = new Hono();
+
+/** POST /postgres/test — body: { connectionString } */
+postgresRoutes.post("/test", async (c) => {
+  try {
+    const body = await c.req.json<{ connectionString: string }>();
+    if (!body.connectionString) return c.json(err("Missing connectionString"), 400);
+    const result = await postgresService.testConnection(body.connectionString);
+    return c.json(ok(result));
+  } catch (e) {
+    return c.json(err((e as Error).message), 500);
+  }
+});
+
+/** POST /postgres/tables — body: { connectionString } */
+postgresRoutes.post("/tables", async (c) => {
+  try {
+    const body = await c.req.json<{ connectionString: string }>();
+    if (!body.connectionString) return c.json(err("Missing connectionString"), 400);
+    const tables = await postgresService.getTables(body.connectionString);
+    return c.json(ok(tables));
+  } catch (e) {
+    return c.json(err((e as Error).message), 500);
+  }
+});
+
+/** POST /postgres/schema — body: { connectionString, table, schema? } */
+postgresRoutes.post("/schema", async (c) => {
+  try {
+    const body = await c.req.json<{ connectionString: string; table: string; schema?: string }>();
+    if (!body.connectionString || !body.table) return c.json(err("Missing connectionString or table"), 400);
+    const schema = await postgresService.getTableSchema(body.connectionString, body.table, body.schema);
+    return c.json(ok(schema));
+  } catch (e) {
+    return c.json(err((e as Error).message), 500);
+  }
+});
+
+/** POST /postgres/data — body: { connectionString, table, schema?, page?, limit?, orderBy?, orderDir? } */
+postgresRoutes.post("/data", async (c) => {
+  try {
+    const body = await c.req.json<{
+      connectionString: string; table: string; schema?: string;
+      page?: number; limit?: number; orderBy?: string; orderDir?: string;
+    }>();
+    if (!body.connectionString || !body.table) return c.json(err("Missing connectionString or table"), 400);
+    const limit = Math.min(body.limit ?? 100, 1000);
+    const data = await postgresService.getTableData(
+      body.connectionString, body.table, body.schema, body.page ?? 1, limit,
+      body.orderBy, (body.orderDir as "ASC" | "DESC") ?? "ASC",
+    );
+    return c.json(ok(data));
+  } catch (e) {
+    return c.json(err((e as Error).message), 500);
+  }
+});
+
+/** POST /postgres/query — body: { connectionString, sql } */
+postgresRoutes.post("/query", async (c) => {
+  try {
+    const body = await c.req.json<{ connectionString: string; sql: string }>();
+    if (!body.connectionString || !body.sql) return c.json(err("Missing connectionString or sql"), 400);
+    const result = await postgresService.executeQuery(body.connectionString, body.sql);
+    return c.json(ok(result));
+  } catch (e) {
+    return c.json(err((e as Error).message), 500);
+  }
+});
+
+/** POST /postgres/cell — body: { connectionString, table, schema?, pkColumn, pkValue, column, value } */
+postgresRoutes.post("/cell", async (c) => {
+  try {
+    const body = await c.req.json<{
+      connectionString: string; table: string; schema?: string;
+      pkColumn: string; pkValue: unknown; column: string; value: unknown;
+    }>();
+    if (!body.connectionString || !body.table || !body.pkColumn || !body.column) {
+      return c.json(err("Missing required fields"), 400);
+    }
+    await postgresService.updateCell(
+      body.connectionString, body.table, body.schema,
+      body.pkColumn, body.pkValue, body.column, body.value,
+    );
+    return c.json(ok({ updated: true }));
+  } catch (e) {
+    return c.json(err((e as Error).message), 500);
+  }
+});

package/src/server/routes/settings.ts

@@ -1,5 +1,6 @@
 import { Hono } from "hono";
 import { configService } from "../../services/config.service.ts";
+import { getConfigValue, setConfigValue } from "../../services/db.service.ts";
 import {
   validateAIProviderConfig,
   validateDefaultProvider,
@@ -102,3 +103,35 @@ settingsRoutes.put("/ai", async (c) => {
     return c.json(err((e as Error).message), 400);
   }
 });
+
+// ── Keybindings ──────────────────────────────────────────────────────
+
+const KEYBINDINGS_KEY = "keybindings";
+
+/** GET /settings/keybindings — return user overrides (partial) */
+settingsRoutes.get("/keybindings", (c) => {
+  const raw = getConfigValue(KEYBINDINGS_KEY);
+  const overrides: Record<string, string> = raw ? JSON.parse(raw) : {};
+  return c.json(ok(overrides));
+});
+
+/** PUT /settings/keybindings — save user overrides (partial, only changed keys) */
+settingsRoutes.put("/keybindings", async (c) => {
+  try {
+    const body = await c.req.json<Record<string, string | null>>();
+    // Merge with existing overrides
+    const raw = getConfigValue(KEYBINDINGS_KEY);
+    const current: Record<string, string> = raw ? JSON.parse(raw) : {};
+    for (const [actionId, combo] of Object.entries(body)) {
+      if (combo === null) {
+        delete current[actionId]; // reset to default
+      } else {
+        current[actionId] = combo;
+      }
+    }
+    setConfigValue(KEYBINDINGS_KEY, JSON.stringify(current));
+    return c.json(ok(current));
+  } catch (e) {
+    return c.json(err((e as Error).message), 400);
+  }
+});

package/src/services/db.service.ts

@@ -4,7 +4,7 @@ import { homedir } from "node:os";
 import { mkdirSync, existsSync } from "node:fs";
 
 const PPM_DIR = resolve(homedir(), ".ppm");
-const CURRENT_SCHEMA_VERSION = 1;
+const CURRENT_SCHEMA_VERSION = 2;
 
 let db: Database | null = null;
 let dbProfile: string | null = null;
@@ -121,6 +121,27 @@ function runMigrations(database: Database): void {
       PRAGMA user_version = 1;
     `);
   }
+
+  if (current < 2) {
+    database.exec(`
+      CREATE TABLE IF NOT EXISTS connections (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        type TEXT NOT NULL CHECK(type IN ('sqlite', 'postgres')),
+        name TEXT NOT NULL UNIQUE,
+        connection_config TEXT NOT NULL,
+        group_name TEXT,
+        color TEXT,
+        sort_order INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_connections_type ON connections(type);
+      CREATE INDEX IF NOT EXISTS idx_connections_group ON connections(group_name);
+
+      PRAGMA user_version = 2;
+    `);
+  }
 }
 
 // ---------------------------------------------------------------------------
@@ -299,5 +320,82 @@ export function getDbFilePath(): string {
   return getDbPath();
 }
 
+// ---------------------------------------------------------------------------
+// Connection helpers
+// ---------------------------------------------------------------------------
+
+export interface ConnectionRow {
+  id: number;
+  type: "sqlite" | "postgres";
+  name: string;
+  connection_config: string;
+  group_name: string | null;
+  color: string | null;
+  sort_order: number;
+  created_at: string;
+  updated_at: string;
+}
+
+/** Parsed config stored in connection_config JSON */
+export type ConnectionConfig =
+  | { type: "sqlite"; path: string }
+  | { type: "postgres"; connectionString: string };
+
+export function getConnections(): ConnectionRow[] {
+  return getDb().query(
+    "SELECT * FROM connections ORDER BY sort_order, id",
+  ).all() as ConnectionRow[];
+}
+
+export function getConnectionById(id: number): ConnectionRow | null {
+  return getDb().query("SELECT * FROM connections WHERE id = ?").get(id) as ConnectionRow | null;
+}
+
+export function getConnectionByName(name: string): ConnectionRow | null {
+  return getDb().query("SELECT * FROM connections WHERE name = ?").get(name) as ConnectionRow | null;
+}
+
+/** Resolve a connection by name or numeric ID */
+export function resolveConnection(nameOrId: string): ConnectionRow | null {
+  const asNum = Number(nameOrId);
+  if (!Number.isNaN(asNum) && Number.isInteger(asNum)) {
+    return getConnectionById(asNum) ?? getConnectionByName(nameOrId);
+  }
+  return getConnectionByName(nameOrId);
+}
+
+export function insertConnection(
+  type: "sqlite" | "postgres", name: string, config: ConnectionConfig,
+  groupName?: string | null, color?: string | null,
+): ConnectionRow {
+  const maxOrder = (getDb().query("SELECT COALESCE(MAX(sort_order), -1) as m FROM connections").get() as { m: number }).m;
+  getDb().query(
+    "INSERT INTO connections (type, name, connection_config, group_name, color, sort_order) VALUES (?, ?, ?, ?, ?, ?)",
+  ).run(type, name, JSON.stringify(config), groupName ?? null, color ?? null, maxOrder + 1);
+  return getConnectionByName(name)!;
+}
+
+export function deleteConnection(nameOrId: string): boolean {
+  const conn = resolveConnection(nameOrId);
+  if (!conn) return false;
+  getDb().query("DELETE FROM connections WHERE id = ?").run(conn.id);
+  return true;
+}
+
+export function updateConnection(
+  id: number, updates: { name?: string; config?: ConnectionConfig; groupName?: string | null; color?: string | null },
+): void {
+  const sets: string[] = [];
+  const vals: unknown[] = [];
+  if (updates.name !== undefined) { sets.push("name = ?"); vals.push(updates.name); }
+  if (updates.config !== undefined) { sets.push("connection_config = ?"); vals.push(JSON.stringify(updates.config)); }
+  if (updates.groupName !== undefined) { sets.push("group_name = ?"); vals.push(updates.groupName); }
+  if (updates.color !== undefined) { sets.push("color = ?"); vals.push(updates.color); }
+  if (sets.length === 0) return;
+  sets.push("updated_at = datetime('now')");
+  vals.push(id);
+  getDb().query(`UPDATE connections SET ${sets.join(", ")} WHERE id = ?`).run(...vals);
+}
+
 // Auto-close on process exit
 process.on("beforeExit", closeDb);

package/src/services/postgres.service.ts

@@ -0,0 +1,170 @@
+import postgres from "postgres";
+
+export interface PgTableInfo {
+  name: string;
+  schema: string;
+  rowCount: number;
+}
+
+export interface PgColumnInfo {
+  name: string;
+  type: string;
+  nullable: boolean;
+  pk: boolean;
+  defaultValue: string | null;
+}
+
+export interface PgQueryResult {
+  columns: string[];
+  rows: Record<string, unknown>[];
+  rowsAffected: number;
+  changeType: "select" | "modify";
+}
+
+/** Auto-close idle connections after 5 minutes */
+const IDLE_TIMEOUT_MS = 5 * 60 * 1000;
+
+interface CachedConn {
+  sql: postgres.Sql;
+  timer: ReturnType<typeof setTimeout>;
+}
+
+class PostgresService {
+  private cache = new Map<string, CachedConn>();
+
+  /** Get or create a cached connection */
+  private connect(connectionString: string): postgres.Sql {
+    const cached = this.cache.get(connectionString);
+    if (cached) {
+      clearTimeout(cached.timer);
+      cached.timer = setTimeout(() => this.disconnect(connectionString), IDLE_TIMEOUT_MS);
+      return cached.sql;
+    }
+    const sql = postgres(connectionString, { max: 3, idle_timeout: 60 });
+    const timer = setTimeout(() => this.disconnect(connectionString), IDLE_TIMEOUT_MS);
+    this.cache.set(connectionString, { sql, timer });
+    return sql;
+  }
+
+  /** Close and remove from cache */
+  private async disconnect(connectionString: string) {
+    const cached = this.cache.get(connectionString);
+    if (!cached) return;
+    clearTimeout(cached.timer);
+    try { await cached.sql.end(); } catch { /* already closed */ }
+    this.cache.delete(connectionString);
+  }
+
+  /** Test connection */
+  async testConnection(connectionString: string): Promise<{ ok: boolean; error?: string }> {
+    try {
+      const sql = this.connect(connectionString);
+      await sql`SELECT 1`;
+      return { ok: true };
+    } catch (e) {
+      return { ok: false, error: (e as Error).message };
+    }
+  }
+
+  /** List all user tables with row counts */
+  async getTables(connectionString: string): Promise<PgTableInfo[]> {
+    const sql = this.connect(connectionString);
+    const tables = await sql`
+      SELECT t.schemaname as schema, t.tablename as name,
+             COALESCE(s.n_live_tup, 0)::int as row_count
+      FROM pg_tables t
+      LEFT JOIN pg_stat_user_tables s ON t.schemaname = s.schemaname AND t.tablename = s.relname
+      WHERE t.schemaname NOT IN ('pg_catalog', 'information_schema')
+      ORDER BY t.schemaname, t.tablename
+    `;
+    return tables.map((t) => ({
+      name: t.name as string, schema: t.schema as string, rowCount: t.row_count as number,
+    }));
+  }
+
+  /** Get column schema for a table */
+  async getTableSchema(connectionString: string, table: string, schema = "public"): Promise<PgColumnInfo[]> {
+    const sql = this.connect(connectionString);
+    const cols = await sql`
+      SELECT c.column_name as name, c.data_type as type,
+             c.is_nullable = 'YES' as nullable, c.column_default as default_value,
+             COALESCE(tc.constraint_type = 'PRIMARY KEY', false) as pk
+      FROM information_schema.columns c
+      LEFT JOIN information_schema.key_column_usage kcu
+        ON c.table_schema = kcu.table_schema AND c.table_name = kcu.table_name AND c.column_name = kcu.column_name
+      LEFT JOIN information_schema.table_constraints tc
+        ON kcu.constraint_name = tc.constraint_name AND tc.constraint_type = 'PRIMARY KEY'
+      WHERE c.table_schema = ${schema} AND c.table_name = ${table}
+      ORDER BY c.ordinal_position
+    `;
+    return cols.map((c) => ({
+      name: c.name as string,
+      type: c.type as string,
+      nullable: c.nullable as boolean,
+      pk: c.pk as boolean,
+      defaultValue: c.default_value as string | null,
+    }));
+  }
+
+  /** Get paginated rows from a table */
+  async getTableData(
+    connectionString: string, table: string, schema = "public",
+    page = 1, limit = 100, orderBy?: string, orderDir: "ASC" | "DESC" = "ASC",
+  ): Promise<{ columns: string[]; rows: Record<string, unknown>[]; total: number; page: number; limit: number }> {
+    const sql = this.connect(connectionString);
+    const fullTable = sql(`${schema}.${table}`);
+
+    const [countRow] = await sql`SELECT COUNT(*)::int as cnt FROM ${fullTable}`;
+    const total = (countRow?.cnt as number) ?? 0;
+    const offset = (page - 1) * limit;
+
+    let rows: postgres.RowList<postgres.Row[]>;
+    if (orderBy) {
+      const orderCol = sql(orderBy);
+      rows = orderDir === "DESC"
+        ? await sql`SELECT * FROM ${fullTable} ORDER BY ${orderCol} DESC LIMIT ${limit} OFFSET ${offset}`
+        : await sql`SELECT * FROM ${fullTable} ORDER BY ${orderCol} ASC LIMIT ${limit} OFFSET ${offset}`;
+    } else {
+      rows = await sql`SELECT * FROM ${fullTable} LIMIT ${limit} OFFSET ${offset}`;
+    }
+
+    const columns = rows.length > 0 ? Object.keys(rows[0]!) : [];
+    return { columns, rows: rows as unknown as Record<string, unknown>[], total, page, limit };
+  }
+
+  /** Execute arbitrary SQL */
+  async executeQuery(connectionString: string, sqlText: string): Promise<PgQueryResult> {
+    const sql = this.connect(connectionString);
+    const trimmed = sqlText.trim().toUpperCase();
+    const isSelect = trimmed.startsWith("SELECT") || trimmed.startsWith("EXPLAIN") ||
+      trimmed.startsWith("SHOW") || trimmed.startsWith("\\D");
+
+    if (isSelect) {
+      const rows = await sql.unsafe(sqlText);
+      const columns = rows.length > 0 ? Object.keys(rows[0]!) : [];
+      return { columns, rows: rows as unknown as Record<string, unknown>[], rowsAffected: 0, changeType: "select" };
+    }
+
+    const result = await sql.unsafe(sqlText);
+    return { columns: [], rows: [], rowsAffected: result.count ?? 0, changeType: "modify" };
+  }
+
+  /** Update a single cell value */
+  async updateCell(
+    connectionString: string, table: string, schema = "public",
+    pkColumn: string, pkValue: unknown, column: string, value: unknown,
+  ): Promise<void> {
+    const sql = this.connect(connectionString);
+    await sql.unsafe(
+      `UPDATE "${schema}"."${table}" SET "${column}" = $1 WHERE "${pkColumn}" = $2`,
+      [value as never, pkValue as never],
+    );
+  }
+
+  /** Close all cached connections */
+  async closeAll() {
+    for (const key of this.cache.keys()) await this.disconnect(key);
+  }
+}
+
+export const postgresService = new PostgresService();

package/src/web/app.tsx

@@ -58,8 +58,13 @@ export function App() {
     }
   }, [theme]);
 
-  // Fetch server info on mount (before auth — shown on login screen)
-  useEffect(() => { fetchServerInfo(); }, [fetchServerInfo]);
+  // Fetch server info + keybindings on mount (before auth — shown on login screen)
+  useEffect(() => {
+    fetchServerInfo();
+    import("@/stores/keybindings-store").then(({ useKeybindingsStore }) => {
+      useKeybindingsStore.getState().loadFromServer();
+    });
+  }, [fetchServerInfo]);
 
   // Auth check on mount
   useEffect(() => {

package/src/web/components/layout/command-palette.tsx

@@ -5,6 +5,7 @@ import {
   GitBranch,
   GitCommitHorizontal,
   Settings,
+  Database,
   Search,
   FileCode,
   FolderOpen,
@@ -116,6 +117,7 @@ export function CommandPalette({ open, onClose, initialQuery = "" }: { open: boo
       { id: "terminal", label: "New Terminal", icon: Terminal, action: openNewTab("terminal", "Terminal"), keywords: "bash shell console", group: "action" },
       { id: "chat", label: "New AI Chat", icon: MessageSquare, action: openNewTab("chat", "AI Chat"), keywords: "ai assistant claude", group: "action" },
       { id: "git-graph", label: "Git Graph", icon: GitBranch, action: openNewTab("git-graph", "Git Graph"), keywords: "branch history log", group: "action" },
+      { id: "postgres", label: "PostgreSQL", icon: Database, action: openNewTab("postgres", "PostgreSQL"), keywords: "database pg sql query", group: "action" },
       { id: "git-status", label: "Git Status", icon: GitCommitHorizontal, action: () => { setSidebarActiveTab("git"); onClose(); }, keywords: "changes diff staged", group: "action" },
       {
         id: "settings", label: "Settings", icon: Settings,

package/src/web/components/layout/editor-panel.tsx

@@ -18,6 +18,7 @@ const TAB_COMPONENTS: Record<TabType, React.LazyExoticComponent<React.ComponentT
   chat: lazy(() => import("@/components/chat/chat-tab").then((m) => ({ default: m.ChatTab }))),
   editor: lazy(() => import("@/components/editor/code-editor").then((m) => ({ default: m.CodeEditor }))),
   sqlite: lazy(() => import("@/components/sqlite/sqlite-viewer").then((m) => ({ default: m.SqliteViewer }))),
+  postgres: lazy(() => import("@/components/postgres/postgres-viewer").then((m) => ({ default: m.PostgresViewer }))),
   "git-graph": lazy(() => import("@/components/git/git-graph").then((m) => ({ default: m.GitGraph }))),
   "git-diff": lazy(() => import("@/components/editor/diff-viewer").then((m) => ({ default: m.DiffViewer }))),
   settings: lazy(() => import("@/components/settings/settings-tab").then((m) => ({ default: m.SettingsTab }))),

package/src/web/components/layout/mobile-nav.tsx

@@ -21,7 +21,7 @@ const NEW_TAB_OPTIONS: { type: TabType; label: string }[] = [
 const NEW_TAB_LABELS: Partial<Record<TabType, string>> = Object.fromEntries(NEW_TAB_OPTIONS.map((o) => [o.type, o.label]));
 
 const TAB_ICONS: Record<TabType, React.ElementType> = {
-  terminal: Terminal, chat: MessageSquare, editor: FileCode, sqlite: Database,
+  terminal: Terminal, chat: MessageSquare, editor: FileCode, sqlite: Database, postgres: Database,
   "git-graph": GitBranch, "git-diff": FileDiff, settings: Settings,
 };
 

package/src/web/components/layout/tab-bar.tsx

@@ -23,6 +23,7 @@ const TAB_ICONS: Record<TabType, React.ElementType> = {
   chat: MessageSquare,
   editor: FileCode,
   sqlite: Database,
+  postgres: Database,
   "git-graph": GitBranch,
   "git-diff": FileDiff,
   settings: Settings,

package/src/web/components/layout/tab-content.tsx

@@ -23,6 +23,11 @@ const TAB_COMPONENTS: Record<TabType, React.LazyExoticComponent<React.ComponentT
       default: m.SqliteViewer,
     })),
   ),
+  postgres: lazy(() =>
+    import("@/components/postgres/postgres-viewer").then((m) => ({
+      default: m.PostgresViewer,
+    })),
+  ),
   "git-graph": lazy(() =>
     import("@/components/git/git-graph").then((m) => ({
       default: m.GitGraph,