npm - pgserve - Versions diffs - 2.2.1 → 2.2.2 - Mend

pgserve 2.2.1 → 2.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/CHANGELOG.md +48 -0
package/console/dist/app.js +121 -0
package/console/dist/index.html +13 -0
package/package.json +8 -4
package/src/cli-ui.cjs +19 -2
package/console/README.md +0 -131
package/console/api.js +0 -173
package/console/app.jsx +0 -483
package/console/components.jsx +0 -167
package/console/data.jsx +0 -350
package/console/index.html +0 -31
package/console/screens/databases.jsx +0 -5
package/console/screens/health.jsx +0 -5
package/console/screens/ingress.jsx +0 -5
package/console/screens/optimizer.jsx +0 -5
package/console/screens/rlm-sim.jsx +0 -5
package/console/screens/rlm-trace.jsx +0 -5
package/console/screens/security.jsx +0 -5
package/console/screens/settings.jsx +0 -611
package/console/screens/sql.jsx +0 -5
package/console/screens/sync.jsx +0 -5
package/console/screens/tables.jsx +0 -5
package/console/tweaks-panel.jsx +0 -425
/package/console/{colors_and_type.css → dist/colors_and_type.css} +0 -0
/package/console/{console.css → dist/console.css} +0 -0

package/console/dist/index.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en" data-theme="mdr" data-screen-label="autopg console">
+<head>
+<meta charset="utf-8" />
+<title>autopg · console</title>
+<link rel="stylesheet" href="colors_and_type.css" />
+<link rel="stylesheet" href="console.css?v=settings1" />
+</head>
+<body>
+<div id="root"></div>
+<script type="module" src="./app.js"></script>
+</body>
+</html>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "pgserve",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Embedded PostgreSQL server with true concurrent connections - zero config, auto-provision databases",
   "main": "src/index.js",
   "type": "module",
@@ -11,7 +11,7 @@
   "files": [
     "bin/",
     "src/",
-    "console/",
+    "console/dist/",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
@@ -26,12 +26,14 @@
     "start": "bun bin/postgres-server.js",
     "build": "bun build --compile bin/postgres-server.js --outfile dist/pgserve",
     "build:all": "make build-all",
+    "console:build": "bun build console/src/main.jsx --target browser --minify --define 'process.env.NODE_ENV=\"production\"' --outfile console/dist/app.js && cp console/src/index.html console/dist/index.html && cp console/src/*.css console/dist/",
+    "console:dev": "bun build console/src/main.jsx --target browser --define 'process.env.NODE_ENV=\"development\"' --watch --outfile console/dist/app.js",
     "lint": "eslint src/ bin/",
     "lint:fix": "eslint src/ bin/ --fix",
     "deadcode": "knip",
     "test:npx": "scripts/test-npx.sh",
     "test:bun-self-heal": "scripts/test-bun-self-heal.sh",
-    "prepublishOnly": "npm run lint && npm run deadcode && npm run test:npx && npm run test:bun-self-heal",
+    "prepublishOnly": "npm run console:build && npm run lint && npm run deadcode && npm run test:npx && npm run test:bun-self-heal",
     "prepare": "husky",
     "postinstall": "node scripts/postinstall.cjs"
   },
@@ -76,6 +78,8 @@
     ]
   },
   "dependencies": {
-    "bun": "^1.3.4"
+    "bun": "^1.3.4",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
   }
 }

package/src/cli-ui.cjs CHANGED Viewed

@@ -142,8 +142,25 @@ function listenWithFallback(server, host, preferredPort) {
  * via npm the `files` allowlist preserves the layout.
  */
 function resolveConsoleRoot() {
-  // src/ → repo root → console/
-  return path.resolve(__dirname, '..', 'console');
+  // After autopg-console-dist (v2.2.2): the SPA ships pre-bundled in
+  // console/dist/ instead of as flat .jsx files at console/. Prefer dist/;
+  // fall back to console/src/ for repo-checkout dev mode (where dist/ is
+  // gitignored and only built on demand).
+  const consoleParent = path.resolve(__dirname, '..', 'console');
+  const distRoot = path.join(consoleParent, 'dist');
+  if (fs.existsSync(distRoot)) return distRoot;
+  const srcRoot = path.join(consoleParent, 'src');
+  if (fs.existsSync(srcRoot)) {
+    process.stderr.write(
+      'autopg ui: running unbuilt sources from console/src/ — run `bun run console:build` for production behavior\n',
+    );
+    return srcRoot;
+  }
+  throw new Error(
+    'console assets not found: expected console/dist/ (run `bun run console:build`) or console/src/ (repo checkout)',
+  );
 }
 /**

package/console/README.md DELETED Viewed

@@ -1,131 +0,0 @@
-# `console/` — autopg console
-Local web console served by `autopg ui`. React + Babel via CDN, no build
-step. Single-user dev tool — binds 127.0.0.1 only, no auth, no TLS.
-## Run
-```bash
-autopg ui                 # walks 8433–8533 picking the first free port
-autopg ui --port 8500     # bind exactly 8500 or fail
-autopg ui --no-open       # skip browser launch (CI / headless)
-```
-`pgserve ui …` is a forever alias of the same command.
-The server boots in-process via `node:http` and serves this directory as
-its document root. Four helper endpoints are mounted alongside the static
-assets — every mutation shells out to the CLI rather than calling the
-daemon directly, so the console works with or without a running daemon.
-| Endpoint | Backed by |
-|----------|-----------|
-| `GET /api/settings` | `loadEffectiveConfig()` → `{ settings, sources, etag }` |
-| `PUT /api/settings` | `writeSettings(body, { ifMatch })` (409 on stale `If-Match`) |
-| `POST /api/restart` | `cli-restart.cjs` (pm2-aware) |
-| `GET /api/status`   | shells out to `autopg status --json` |
-## Layout
-```
-console/
-├── README.md                   # this file
-├── index.html                  # entry — pinned React + Babel CDN scripts
-├── app.jsx                     # shell + sidebar router (11 routes)
-├── api.js                      # fetch wrapper, holds latest etag, surfaces ETAG_MISMATCH
-├── components.jsx              # shared widgets (Seg, Toggle, Field, …)
-├── data.jsx                    # demo data fixtures (used by placeholder screens)
-├── tweaks-panel.jsx            # theme/phosphor/density/CRT toggles (persists to settings.ui)
-├── colors_and_type.css         # design tokens
-├── console.css                 # layout + screen styles
-└── screens/
-    ├── settings.jsx            # ✅ functional — 6-section schema editor
-    ├── databases.jsx           # [ coming soon ]
-    ├── tables.jsx              # [ coming soon ]
-    ├── sql.jsx                 # [ coming soon ]
-    ├── optimizer.jsx           # [ coming soon ]
-    ├── security.jsx            # [ coming soon ]
-    ├── ingress.jsx             # [ coming soon ]
-    ├── health.jsx              # [ coming soon ] — next wish
-    ├── sync.jsx                # [ coming soon ]
-    ├── rlm-trace.jsx           # [ coming soon ]
-    └── rlm-sim.jsx             # [ coming soon ]
-```
-## Screen rollout
-| Screen | Status | Notes |
-|--------|--------|-------|
-| Settings | ✅ functional | 6 sections, type-aware controls, raw GUC passthrough, etag concurrency, env-override chip |
-| Health | 🟡 next | Live cluster health metrics — next wish |
-| Databases | ⚪ placeholder | List + create + drop |
-| Tables | ⚪ placeholder | Per-DB table inspector |
-| SQL | ⚪ placeholder | Ad-hoc query runner |
-| Optimizer | ⚪ placeholder | Plan inspector / GUC tuner suggestions |
-| Security | ⚪ placeholder | Roles, RLS, audit log |
-| Ingress | ⚪ placeholder | Listener / TLS / token surface |
-| Sync | ⚪ placeholder | Replication-slot status |
-| RLM-trace | ⚪ placeholder | RLM agent trace viewer (depends on rlmx) |
-| RLM-sim | ⚪ placeholder | RLM scenario simulator (depends on rlmx) |
-## Local dev loop
-The console is shipped as static files — no build, no bundler. Edit the
-`.jsx` files in place; refresh the browser tab to pick up the change
-(Babel transpiles in the browser at load time). The CDN scripts are
-pinned with SRI integrity hashes — bumping React or Babel requires
-re-pinning the matching `integrity="sha384-…"` attribute in
-[`index.html`](./index.html).
-```bash
-autopg ui --no-open --port 8500 &
-open http://127.0.0.1:8500
-# … edit screens/settings.jsx, refresh browser …
-kill %1
-```
-The Settings screen reads live state from `~/.autopg/settings.json`
-through the helper endpoints, so changes survive reload and round-trip
-through `autopg config get` from another shell.
-### Concurrency model
-`api.js` stores the etag returned by every successful GET and sends it
-back as `If-Match` on the next PUT. If a parallel `autopg config set` (or
-another browser tab) drifts the file, the PUT comes back as
-`409 ETAG_MISMATCH` with a fresh `currentEtag`. The Settings screen
-catches this and shows a "settings changed, reload?" banner instead of
-overwriting the operator's other changes.
-### Env-override chip
-`GET /api/settings` returns a `sources` map (one entry per leaf:
-`'default' | 'file' | 'env:<NAME>'`). Rows whose source starts with
-`env:` render a yellow `OVERRIDDEN BY ENV` chip — Save still writes the
-file, but `loadEffectiveConfig()` will keep returning the env value
-until the env var is unset or the daemon is restarted with a clean
-environment.
-## Design system
-The console UI is derived from the `pgserve-console` design kit at
-`namastex-design-system/ui_kits/pgserve-console`. The CSS files
-(`colors_and_type.css`, `console.css`) and the shared widgets
-(`components.jsx`, `tweaks-panel.jsx`) are copied verbatim — the
-soft rename only touches the topbar identity (`pgserve` → `autopg`)
-and the Settings screen, which was rewritten to match the
-6-section schema documented in
-[`docs/settings-schema.md`](../docs/settings-schema.md).
-## What's deliberately not here
-- **No build step.** Pre-bundling is a future optimization. The CDN +
-  Babel-in-browser path is intentional for v1 — zero infrastructure.
-- **No daemon HTTP API.** The CLI is the source of truth; every UI
-  mutation shells out. This means the UI works ahead of `autopg
-  install` (you can configure before the daemon ever runs) and
-  cannot leak privileges through a long-lived listening socket.
-- **No multi-user / multi-machine access.** 127.0.0.1 only, by
-  design.
-- **No telemetry, no analytics.** Static page + four endpoints, all
-  local.

package/console/api.js DELETED Viewed

@@ -1,173 +0,0 @@
-/* autopg console · API client.
- *
- * Wraps the four helper endpoints exposed by `autopg ui`:
- *   GET  /api/settings   →  { settings, sources, etag, path }
- *   PUT  /api/settings   →  { ok, etag } | { error: { code, message, field? } }
- *   POST /api/restart    →  { ok } | { error }
- *   GET  /api/status     →  whatever `pgserve status --json` returns
- *
- * The latest etag from a successful GET is cached on the module so PUTs can
- * send `If-Match` without the caller threading it through manually. PUT
- * replies update the cached etag too so successive saves chain cleanly.
- *
- * Errors from the server come back as `{ error: { code, message, field? } }`.
- * The wrapper raises a structured `ApiError` (with `.code`, `.field`,
- * `.message`, `.status`, `.currentEtag?`) so screens can branch on the code
- * without parsing strings. ETAG_MISMATCH is surfaced as a normal rejection
- * with `error.code === 'ETAG_MISMATCH'` plus `error.currentEtag` so the
- * Settings screen can show a "settings changed, reload?" banner.
- */
-(function (root) {
-  'use strict';
-  const STATE = { etag: null };
-  class ApiError extends Error {
-    constructor({ code, message, field, status, currentEtag }) {
-      super(message || code || 'api error');
-      this.name = 'ApiError';
-      this.code = code || 'UNKNOWN';
-      if (field) this.field = field;
-      if (typeof status === 'number') this.status = status;
-      if (currentEtag) this.currentEtag = currentEtag;
-    }
-  }
-  async function parseJson(res) {
-    const text = await res.text();
-    if (!text) return {};
-    try {
-      return JSON.parse(text);
-    } catch {
-      return { _raw: text };
-    }
-  }
-  async function getSettings() {
-    const res = await fetch('/api/settings', {
-      method: 'GET',
-      headers: { accept: 'application/json' },
-      cache: 'no-store',
-    });
-    const body = await parseJson(res);
-    if (!res.ok) {
-      throw new ApiError({
-        code: body?.error?.code,
-        message: body?.error?.message,
-        field: body?.error?.field,
-        status: res.status,
-      });
-    }
-    if (body && body.etag) STATE.etag = body.etag;
-    return body;
-  }
-  async function putSettings(patch, { ifMatch } = {}) {
-    const etag = ifMatch ?? STATE.etag;
-    if (!etag) {
-      throw new ApiError({
-        code: 'PRECONDITION_REQUIRED',
-        message: 'no etag cached — call getSettings() before putSettings()',
-        status: 428,
-      });
-    }
-    const res = await fetch('/api/settings', {
-      method: 'PUT',
-      headers: {
-        'content-type': 'application/json',
-        'if-match': etag,
-        accept: 'application/json',
-      },
-      body: JSON.stringify(patch ?? {}),
-    });
-    const body = await parseJson(res);
-    if (res.status === 409) {
-      // Update the cached etag so the next reload has the latest.
-      if (body && body.currentEtag) STATE.etag = body.currentEtag;
-      throw new ApiError({
-        code: body?.error?.code || 'ETAG_MISMATCH',
-        message: body?.error?.message || 'settings changed on disk',
-        status: 409,
-        currentEtag: body?.currentEtag,
-      });
-    }
-    if (!res.ok) {
-      throw new ApiError({
-        code: body?.error?.code,
-        message: body?.error?.message,
-        field: body?.error?.field,
-        status: res.status,
-      });
-    }
-    if (body && body.etag) STATE.etag = body.etag;
-    return body;
-  }
-  async function restart() {
-    const res = await fetch('/api/restart', {
-      method: 'POST',
-      headers: { accept: 'application/json' },
-    });
-    const body = await parseJson(res);
-    if (!res.ok) {
-      throw new ApiError({
-        code: body?.error?.code,
-        message: body?.error?.message,
-        status: res.status,
-      });
-    }
-    return body;
-  }
-  async function getStatus() {
-    const res = await fetch('/api/status', {
-      method: 'GET',
-      headers: { accept: 'application/json' },
-      cache: 'no-store',
-    });
-    const body = await parseJson(res);
-    if (!res.ok) {
-      throw new ApiError({
-        code: body?.error?.code,
-        message: body?.error?.message,
-        status: res.status,
-      });
-    }
-    return body;
-  }
-  // Live pgserve stats — connections + databases. Always returns a body
-  // (status 200) even when the daemon is unreachable; check `body.ok`.
-  // Safe to poll from the topbar without try/catch error handling.
-  async function getStats() {
-    try {
-      const res = await fetch('/api/stats', {
-        method: 'GET',
-        headers: { accept: 'application/json' },
-        cache: 'no-store',
-      });
-      return await parseJson(res);
-    } catch (err) {
-      return { ok: false, reason: 'fetch-failed', message: err.message };
-    }
-  }
-  function getCachedEtag() {
-    return STATE.etag;
-  }
-  function setCachedEtag(etag) {
-    STATE.etag = etag || null;
-  }
-  root.AutopgApi = {
-    getSettings,
-    putSettings,
-    restart,
-    getStatus,
-    getStats,
-    getCachedEtag,
-    setCachedEtag,
-    ApiError,
-  };
-})(typeof window !== 'undefined' ? window : globalThis);