admindb 2.3.1 → 2.4.1

package/dist/views/partials/navbar.hbs

@@ -1 +1 @@
-<div class="sticky top-0 z-30 border-b border-base-300/80 bg-base-100/85 backdrop-blur-md">
  <div class="navbar mx-auto w-full max-w-[1500px] px-4 sm:px-6 lg:px-8">
    <div class="flex-none lg:hidden">
      <label for="sidebar-toggle" class="btn btn-square btn-ghost" aria-label="open sidebar">
        {{{icon "menu" class="h-5 w-5"}}}
      </label>
    </div>
    <div class="flex flex-1 items-center gap-3">
      <a href="{{basePath}}/" class="flex items-center gap-2.5">
        <span class="font-headings text-lg font-bold tracking-tight text-base-content">Admin<span class="text-primary">DB</span></span>
      </a>
      {{#unless databasesMode}}
        {{#if isPostgres}}
          <span class="inline-flex items-center gap-1.5 rounded-lg border border-info/40 bg-info/10 px-2.5 py-0.5 text-xs font-semibold text-info" title="Engine: PostgreSQL ({{dbPath}})">
            <span class="h-2 w-2 rounded-full bg-info animate-pulse"></span>
            PostgreSQL
          </span>
        {{else}}
          <span class="inline-flex items-center gap-1.5 rounded-lg border border-emerald-500/40 bg-emerald-500/10 px-2.5 py-0.5 text-xs font-semibold text-emerald-600 dark:text-emerald-400" title="Engine: SQLite ({{dbPath}})">
            <span class="h-2 w-2 rounded-full bg-emerald-500 animate-pulse"></span>
            SQLite
          </span>
        {{/if}}
      {{/unless}}
    </div>
    <div class="flex items-center gap-1.5">
      {{#unless noSidebar}}
        {{#unless databasesMode}}
          {{#if databasesUrl}}
            <a href="{{databasesUrl}}" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
              {{{icon "database" class="h-4 w-4"}}}
              Databases
            </a>
          {{/if}}
          <a href="{{basePath}}/query" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
            {{{icon "query" class="h-4 w-4"}}}
            Query
          </a>
          {{#unless readonly}}
            <a href="{{basePath}}/designer" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
              {{{icon "plus" class="h-4 w-4"}}}
              New table
            </a>
          {{/unless}}
          <a href="{{basePath}}/export" class="btn btn-ghost btn-sm hidden gap-1.5 md:inline-flex">
            {{{icon "export" class="h-4 w-4"}}}
            Export
          </a>
        {{/unless}}
      {{/unless}}
      {{#if authEnabled}}
        {{#if authUser}}
          <div class="dropdown dropdown-end">
            <label tabindex="0" class="btn btn-ghost btn-sm gap-1.5 normal-case font-medium">
              {{{icon "user" class="h-4 w-4 text-base-content/70"}}}
              <span class="max-w-[120px] truncate text-xs">{{authUser}}</span>
            </label>
            <ul tabindex="0" class="dropdown-content menu p-2 shadow-soft bg-base-100 rounded-xl w-56 border border-base-300 z-50 mt-1 text-sm space-y-1">
              <li class="menu-title px-2 py-1 text-xs text-base-content/50">Signed in as <strong class="text-base-content">{{authUser}}</strong></li>
              {{#if isDefaultPassword}}
                <li class="rounded-lg bg-warning/10 p-2 text-[11px] text-warning border border-warning/20">
                  <div class="flex items-center gap-1.5 font-semibold p-0">
                    {{{icon "warning" class="h-3.5 w-3.5 shrink-0"}}}
                    <span>Default pass active (admin)</span>
                  </div>
                </li>
              {{/if}}
              <li>
                <form method="POST" action="{{basePath}}/logout" class="p-0">
                  <button type="submit" class="w-full text-left flex items-center gap-2 px-3 py-2 text-error hover:bg-error/10 rounded-lg">
                    {{{icon "logout" class="h-4 w-4"}}}
                    Sign out
                  </button>
                </form>
              </li>
            </ul>
          </div>
        {{/if}}
      {{/if}}
      <button id="theme-toggle" type="button" class="btn btn-square btn-ghost btn-sm" aria-label="Toggle dark mode" title="Toggle dark mode">
        {{{icon "moon" class="h-5 w-5"}}}
      </button>
    </div>
  </div>
+<div class="sticky top-0 z-30 border-b border-base-300/80 bg-base-100/85 backdrop-blur-md">
  <div class="navbar mx-auto w-full max-w-[1500px] px-4 sm:px-6 lg:px-8">
    <div class="flex-none lg:hidden">
      <label for="sidebar-toggle" class="btn btn-square btn-ghost" aria-label="open sidebar">
        {{{icon "menu" class="h-5 w-5"}}}
      </label>
    </div>
    <div class="flex flex-1 items-center gap-3">
      <a href="{{basePath}}/" class="flex items-center gap-2.5">
        <span class="font-headings text-lg font-bold tracking-tight text-base-content">Admin<span class="text-primary">DB</span></span>
      </a>
      {{#unless databasesMode}}
        {{#if isPostgres}}
          <span class="inline-flex items-center gap-1.5 rounded-lg border border-info/40 bg-info/10 px-2.5 py-0.5 text-xs font-semibold text-info" title="Engine: PostgreSQL ({{dbPath}})">
            <span class="h-2 w-2 rounded-full bg-info animate-pulse"></span>
            PostgreSQL
          </span>
        {{else}}
          <span class="inline-flex items-center gap-1.5 rounded-lg border border-emerald-500/40 bg-emerald-500/10 px-2.5 py-0.5 text-xs font-semibold text-emerald-600 dark:text-emerald-400" title="Engine: SQLite ({{dbPath}})">
            <span class="h-2 w-2 rounded-full bg-emerald-500 animate-pulse"></span>
            SQLite
          </span>
        {{/if}}
      {{/unless}}
    </div>
    <div class="flex items-center gap-1.5">
      {{#unless noSidebar}}
        {{#unless databasesMode}}
          {{#if databasesUrl}}
            <a href="{{databasesUrl}}" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
              {{{icon "database" class="h-4 w-4"}}}
              Databases
            </a>
          {{/if}}
          <a href="{{basePath}}/query/{{encodeUri dbId}}" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
            {{{icon "query" class="h-4 w-4"}}}
            Query
          </a>
          {{#unless readonly}}
            <a href="{{basePath}}/designer/{{encodeUri dbId}}" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
              {{{icon "plus" class="h-4 w-4"}}}
              New table
            </a>
          {{/unless}}
          <a href="{{basePath}}/export/{{encodeUri dbId}}" class="btn btn-ghost btn-sm hidden gap-1.5 md:inline-flex">
            {{{icon "export" class="h-4 w-4"}}}
            Export
          </a>
        {{/unless}}
      {{/unless}}
      {{#if authEnabled}}
        {{#if authUser}}
          <div class="dropdown dropdown-end">
            <label tabindex="0" class="btn btn-ghost btn-sm gap-1.5 normal-case font-medium">
              {{{icon "user" class="h-4 w-4 text-base-content/70"}}}
              <span class="max-w-[120px] truncate text-xs">{{authUser}}</span>
            </label>
            <ul tabindex="0" class="dropdown-content menu p-2 shadow-soft bg-base-100 rounded-xl w-56 border border-base-300 z-50 mt-1 text-sm space-y-1">
              <li class="menu-title px-2 py-1 text-xs text-base-content/50">Signed in as <strong class="text-base-content">{{authUser}}</strong></li>
              {{#if isDefaultPassword}}
                <li class="rounded-lg bg-warning/10 p-2 text-[11px] text-warning border border-warning/20">
                  <div class="flex items-center gap-1.5 font-semibold p-0">
                    {{{icon "warning" class="h-3.5 w-3.5 shrink-0"}}}
                    <span>Default pass active (admin)</span>
                  </div>
                </li>
              {{/if}}
              <li>
                <form method="POST" action="{{basePath}}/logout" class="p-0">
                  <button type="submit" class="w-full text-left flex items-center gap-2 px-3 py-2 text-error hover:bg-error/10 rounded-lg">
                    {{{icon "logout" class="h-4 w-4"}}}
                    Sign out
                  </button>
                </form>
              </li>
            </ul>
          </div>
        {{/if}}
      {{/if}}
      <button id="theme-toggle" type="button" class="btn btn-square btn-ghost btn-sm" aria-label="Toggle dark mode" title="Toggle dark mode">
        {{{icon "moon" class="h-5 w-5"}}}
      </button>
    </div>
  </div>

package/dist/views/partials/sidebar.hbs

@@ -1 +1 @@
-<aside class="flex h-full min-h-full w-72 flex-col bg-neutral text-neutral-content">
  <div class="flex items-center gap-2.5 px-5 pb-4 pt-5">
    <div class="w-full">
      <div class="flex items-center justify-between">
        <div class="font-headings text-base font-bold leading-tight">AdminDB <span style="font-size: x-small" class="font-sans font-normal opacity-70">{{#if version}}v{{version}}{{/if}}</span></div>
        {{#unless databasesMode}}
          {{#if isPostgres}}
            <span class="rounded bg-info/20 px-1.5 py-0.5 text-[10px] font-bold text-info">PostgreSQL</span>
          {{else}}
            <span class="rounded bg-emerald-500/20 px-1.5 py-0.5 text-[10px] font-bold text-emerald-400">SQLite</span>
          {{/if}}
        {{/unless}}
      </div>
      <div class="mt-0.5 text-[11px] text-neutral-content/50 truncate">{{#if databasesMode}}Database manager{{else}}{{dbId}}{{/if}}</div>
    </div>
  </div>
  {{#if databasesMode}}
  <nav class="flex-1 overflow-y-auto px-3 py-2">
    <ul class="space-y-0.5">
      <li>
        <a href="{{basePath}}/" class="side-link active">
          {{{icon "database" class="h-4 w-4"}}}
          Databases
        </a>
      </li>
    </ul>
  </nav>
  {{else}}
  <div class="px-4 pb-2">
    <label class="relative block">
      <span class="pointer-events-none absolute left-3 top-1/2 -translate-y-1/2 text-neutral-content/40">
        {{{icon "search" class="h-4 w-4"}}}
      </span>
      <input id="table-search" type="search" placeholder="Filter tables…" autocomplete="off"
        class="w-full rounded-lg border border-white/10 bg-white/[0.06] py-2 pl-9 pr-3 text-sm text-neutral-content outline-none transition placeholder:text-neutral-content/40 focus:border-primary/70 focus:ring-4 focus:ring-primary/20" />
    </label>
  </div>
  <nav class="flex-1 overflow-y-auto px-3 py-2">
    <ul class="space-y-0.5">
      {{#if databasesUrl}}
      <li>
        <a href="{{databasesUrl}}" class="side-link">
          {{{icon "database" class="h-4 w-4"}}}
          Databases
        </a>
      </li>
      {{/if}}
      <li>
        <a href="{{basePath}}/" class="side-link {{#if (eq currentPath '/')}}active{{/if}}">
          {{{icon "home" class="h-4 w-4"}}}
          Home
        </a>
      </li>
      <li>
        <a href="{{basePath}}/query" class="side-link {{#if (startsWith currentPath '/query')}}active{{/if}}">
          {{{icon "query" class="h-4 w-4"}}}
          Query editor
        </a>
      </li>
      <li>
        <a href="{{basePath}}/erd" class="side-link {{#if (startsWith currentPath '/erd')}}active{{/if}}">
          {{{icon "diagram" class="h-4 w-4"}}}
          ER Diagram
        </a>
      </li>
      <li>
        <a href="{{basePath}}/seed" class="side-link {{#if (startsWith currentPath '/seed')}}active{{/if}}">
          {{{icon "seed" class="h-4 w-4"}}}
          Seed generator
        </a>
      </li>
      <li>
        <a href="{{basePath}}/info" class="side-link {{#if (startsWith currentPath '/info')}}active{{/if}}">
          {{{icon "settings" class="h-4 w-4"}}}
          Info & Settings
        </a>
      </li>
      {{#unless readonly}}
      <li>
        <a href="{{basePath}}/designer" class="side-link {{#if (startsWith currentPath '/designer')}}active{{/if}}">
          {{{icon "plus" class="h-4 w-4"}}}
          New table
        </a>
      </li>
      {{/unless}}
    </ul>
    <div class="mb-2 mt-6 flex items-center justify-between px-3">
      <span class="text-[11px] font-semibold uppercase tracking-wider text-neutral-content/40">Tables</span>
      <span id="table-count" class="rounded-md bg-white/[0.06] px-1.5 py-0.5 text-[10px] font-semibold text-neutral-content/50">{{tables.length}}</span>
    </div>
    <ul id="table-list" class="space-y-0.5">
      {{#each tables}}
      <li class="table-item" data-name="{{this}}">
        <a href="{{../basePath}}/tables/{{this}}" class="side-link {{#if (eq ../currentTable this)}}active{{/if}}">
          <span class="table-icon">
            {{{icon "table" class="h-4 w-4"}}}
          </span>
          <span class="truncate">{{this}}</span>
        </a>
      </li>
      {{else}}
      <li class="px-3 py-2 text-xs text-neutral-content/40">No tables yet</li>
      {{/each}}
    </ul>
    {{#if internalTables.length}}
    <div class="mb-2 mt-6 px-3 text-[11px] font-semibold uppercase tracking-wider text-neutral-content/40">Internal</div>
    <ul class="space-y-0.5">
      {{#each internalTables}}
      <li>
        <a href="{{../basePath}}/tables/{{this}}" class="side-link {{#if (eq ../currentTable this)}}active{{/if}}">
          <span class="table-icon">
            {{{icon "book" class="h-4 w-4"}}}
          </span>
          <span class="truncate">{{this}}</span>
        </a>
      </li>
      {{/each}}
    </ul>
    {{/if}}
  </nav>
  {{/if}}
  {{#if isDefaultPassword}}
  <div class="border-t border-white/10 px-4 py-2 bg-warning/10">
    <div class="flex items-center justify-between text-warning text-xs font-semibold">
      <span class="flex items-center gap-1.5 font-mono text-[11px]">
        {{{icon "warning" class="h-3.5 w-3.5 shrink-0"}}}
        default pass active
      </span>
      <span class="badge badge-warning badge-xs font-mono font-bold">admin</span>
    </div>
  </div>
  {{/if}}
  <div class="border-t border-white/10 px-5 py-3">
    <div class="flex items-center justify-between">
      <div class="text-[11px] font-medium uppercase tracking-wider text-neutral-content/40">{{#if databasesMode}}Directory{{else}}Engine: {{dialectName}}{{/if}}</div>
      {{#unless databasesMode}}
        {{#if readonly}}
          <span class="rounded bg-warning/20 px-1.5 py-0.5 text-[9px] font-bold uppercase text-warning">Read-only</span>
        {{else}}
          <span class="rounded bg-success/20 px-1.5 py-0.5 text-[9px] font-bold uppercase text-success">Writable</span>
        {{/if}}
      {{/unless}}
    </div>
    <div class="mt-0.5 truncate font-mono text-[11px] text-neutral-content/60" title="{{dbPath}}">{{dbPath}}</div>
  </div>
+<aside class="flex h-full min-h-full w-72 flex-col bg-neutral text-neutral-content">
  <div class="flex items-center gap-2.5 px-5 pb-4 pt-5">
    <div class="w-full">
      <div class="flex items-center justify-between">
        <div class="font-headings text-base font-bold leading-tight">AdminDB <span style="font-size: x-small" class="font-sans font-normal opacity-70">{{#if version}}v{{version}}{{/if}}</span></div>
        {{#unless databasesMode}}
          {{#if isPostgres}}
            <span class="rounded bg-info/20 px-1.5 py-0.5 text-[10px] font-bold text-info">PostgreSQL</span>
          {{else}}
            <span class="rounded bg-emerald-500/20 px-1.5 py-0.5 text-[10px] font-bold text-emerald-400">SQLite</span>
          {{/if}}
        {{/unless}}
      </div>
      <div class="mt-0.5 text-[11px] text-neutral-content/50 truncate">{{#if databasesMode}}Database manager{{else}}{{dbId}}{{/if}}</div>
    </div>
  </div>
  {{#if databasesMode}}
  <nav class="flex-1 overflow-y-auto px-3 py-2">
    <ul class="space-y-0.5">
      <li>
        <a href="{{basePath}}/" class="side-link active">
          {{{icon "database" class="h-4 w-4"}}}
          Databases
        </a>
      </li>
    </ul>
  </nav>
  {{else}}
  <div class="px-4 pb-2">
    <label class="relative block">
      <span class="pointer-events-none absolute left-3 top-1/2 -translate-y-1/2 text-neutral-content/40">
        {{{icon "search" class="h-4 w-4"}}}
      </span>
      <input id="table-search" type="search" placeholder="Filter tables…" autocomplete="off"
        class="w-full rounded-lg border border-white/10 bg-white/[0.06] py-2 pl-9 pr-3 text-sm text-neutral-content outline-none transition placeholder:text-neutral-content/40 focus:border-primary/70 focus:ring-4 focus:ring-primary/20" />
    </label>
  </div>
  <nav class="flex-1 overflow-y-auto px-3 py-2">
    <ul class="space-y-0.5">
      {{#if databasesUrl}}
      <li>
        <a href="{{databasesUrl}}" class="side-link">
          {{{icon "database" class="h-4 w-4"}}}
          Databases
        </a>
      </li>
      {{/if}}
      <li>
        <a href="{{basePath}}/home/{{encodeUri dbId}}" class="side-link {{#if (startsWith currentPath '/home')}}active{{/if}}">
          {{{icon "home" class="h-4 w-4"}}}
          Home
        </a>
      </li>
      <li>
        <a href="{{basePath}}/query/{{encodeUri dbId}}" class="side-link {{#if (startsWith currentPath '/query')}}active{{/if}}">
          {{{icon "query" class="h-4 w-4"}}}
          Query editor
        </a>
      </li>
      <li>
        <a href="{{basePath}}/erd/{{encodeUri dbId}}" class="side-link {{#if (startsWith currentPath '/erd')}}active{{/if}}">
          {{{icon "diagram" class="h-4 w-4"}}}
          ER Diagram
        </a>
      </li>
      <li>
        <a href="{{basePath}}/seed/{{encodeUri dbId}}" class="side-link {{#if (startsWith currentPath '/seed')}}active{{/if}}">
          {{{icon "seed" class="h-4 w-4"}}}
          Seed generator
        </a>
      </li>
      <li>
        <a href="{{basePath}}/info/{{encodeUri dbId}}" class="side-link {{#if (startsWith currentPath '/info')}}active{{/if}}">
          {{{icon "settings" class="h-4 w-4"}}}
          Info & Settings
        </a>
      </li>
      {{#unless readonly}}
      <li>
        <a href="{{basePath}}/designer/{{encodeUri dbId}}" class="side-link {{#if (startsWith currentPath '/designer')}}active{{/if}}">
          {{{icon "plus" class="h-4 w-4"}}}
          New table
        </a>
      </li>
      {{/unless}}
    </ul>
    <div class="mb-2 mt-6 flex items-center justify-between px-3">
      <span class="text-[11px] font-semibold uppercase tracking-wider text-neutral-content/40">Tables</span>
      <span id="table-count" class="rounded-md bg-white/[0.06] px-1.5 py-0.5 text-[10px] font-semibold text-neutral-content/50">{{tables.length}}</span>
    </div>
    <ul id="table-list" class="space-y-0.5">
      {{#each tables}}
      <li class="table-item" data-name="{{tableName this}}">
        <a href="{{../basePath}}/tables/{{encodeUri ../dbId}}/{{encodeUri (tableName this)}}" class="side-link {{#if (eq ../currentTable (tableName this))}}active{{/if}}">
          <span class="table-icon">
            {{{icon "table" class="h-4 w-4"}}}
          </span>
          <span class="truncate">{{tableName this}}</span>
        </a>
      </li>
      {{else}}
      <li class="px-3 py-2 text-xs text-neutral-content/40">No tables yet</li>
      {{/each}}
    </ul>
    {{#if internalTables.length}}
    <div class="mb-2 mt-6 px-3 text-[11px] font-semibold uppercase tracking-wider text-neutral-content/40">Internal</div>
    <ul class="space-y-0.5">
      {{#each internalTables}}
      <li>
        <a href="{{../basePath}}/tables/{{encodeUri ../dbId}}/{{encodeUri this}}" class="side-link {{#if (eq ../currentTable this)}}active{{/if}}">
          <span class="table-icon">
            {{{icon "book" class="h-4 w-4"}}}
          </span>
          <span class="truncate">{{this}}</span>
        </a>
      </li>
      {{/each}}
    </ul>
    {{/if}}
  </nav>
  {{/if}}
  {{#if isDefaultPassword}}
  <div class="border-t border-white/10 px-4 py-2 bg-warning/10">
    <div class="flex items-center justify-between text-warning text-xs font-semibold">
      <span class="flex items-center gap-1.5 font-mono text-[11px]">
        {{{icon "warning" class="h-3.5 w-3.5 shrink-0"}}}
        default pass active
      </span>
      <span class="badge badge-warning badge-xs font-mono font-bold">admin</span>
    </div>
  </div>
  {{/if}}
  <div class="border-t border-white/10 px-5 py-3">
    <div class="flex items-center justify-between">
      <div class="text-[11px] font-medium uppercase tracking-wider text-neutral-content/40">{{#if databasesMode}}Directory{{else}}Engine: {{dialectName}}{{/if}}</div>
      {{#unless databasesMode}}
        {{#if readonly}}
          <span class="rounded bg-warning/20 px-1.5 py-0.5 text-[9px] font-bold uppercase text-warning">Read-only</span>
        {{else}}
          <span class="rounded bg-success/20 px-1.5 py-0.5 text-[9px] font-bold uppercase text-success">Writable</span>
        {{/if}}
      {{/unless}}
    </div>
    <div class="mt-0.5 truncate font-mono text-[11px] text-neutral-content/60" title="{{dbPath}}">{{dbPath}}</div>
  </div>

package/docs/API.md

@@ -1,72 +1,77 @@
 # AdminDB REST API
 
 Every route is under `basePath` and returns the consistent shape
-`{ success, data?, error? }`. In multi-db mode, every route is scoped under the
-database identifier, e.g. `/api/app.db/tables` or `/api/prod_pg/tables`.
+`{ success, data?, error? }`. All database-specific routes follow the uniform pattern
+`/<page>/<db>` and `/api/<resource>/<db>/...` (e.g. `/api/tables/app.db` or `/api/tables/prod_pg/users`).
 
 AdminDB supports both **SQLite** and **PostgreSQL** database backends seamlessly.
 
 ## Tables & rows
 
-| Method | Path                                     | Purpose                          |
-| ------ | ---------------------------------------- | -------------------------------- |
-| GET    | `/api/tables`                            | List tables                      |
-| GET    | `/api/tables/:table/info`                | Column + FK metadata, PK columns |
-| GET    | `/api/tables/:table/fk-options`          | Values for FK dropdowns          |
-| GET    | `/api/tables/:table/rows?page&limit&f`   | Paginated rows (`f` = URL-encoded JSON filters — legacy strings like `{"age":">35"}` or structured conditions like `{"balance":{"op":"gte","value":"100"}}`) |
-| GET    | `/api/tables/:table/rows/count?f=`       | Filtered row count               |
-| GET    | `/api/tables/:table/row/:id`             | Single row by (encoded) PK       |
-| GET    | `/api/tables/:table/rows/:id/references` | Rows in other tables whose foreign keys reference this row |
-| GET    | `/api/tables/:table/row/:id/blob/:column` | Stream binary BLOB / BYTEA with MIME detection (add `?download=1` to force download) |
-| GET    | `/api/tables/:table/row/:id/blob/:column/meta` | Inspect BLOB / BYTEA metadata, MIME sniffing & 3-column hex dump |
-| PUT    | `/api/tables/:table/row/:id/blob/:column` | Update binary value (`{ data: base64/hex, format?: 'base64'|'hex'|'text' }`) |
-| POST   | `/api/tables/:table/rows`                | Insert row (or batch of rows with `{ rows: [...] }`) |
-| POST   | `/api/tables/:table/rows/generate`       | Generate INSERT SQL (no execute) |
-| POST   | `/api/tables/:table/rows/import`         | Import CSV (`{ csv }`, header row must match columns) |
-| GET    | `/api/tables/:table/export?format=`      | Download all rows as `csv` or `json` |
-| PUT    | `/api/tables/:table/row/:id`             | Update row (`{ values, nulls? }` — `nulls` explicitly sets columns to NULL) |
-| PUT    | `/api/tables/:table/row/:id/generate`    | Generate UPDATE SQL (no execute) |
-| DELETE | `/api/tables/:table/row/:id`             | Delete row                       |
-| POST   | `/api/tables/:table/rows/bulk-impact`    | FK-impact preview: how many rows in other tables reference the selected rows |
-| POST   | `/api/tables/:table/rows/bulk-delete`    | Delete selected rows (`{ ids, confirmImpact }`; transactional) |
-| POST   | `/api/tables/:table/rows/bulk-export`    | Export only the selected rows as `csv`/`json` (`{ ids, format }`) |
-| POST   | `/api/tables/:table/rows/bulk-update`    | Apply staged inline edits (`{ updates: [{ id, values?, nulls? }] }`; transactional) |
-| GET    | `/api/tables/:table/seed/config`         | Per-column generator strategies + detected defaults |
-| GET    | `/api/tables/:table/seed/plan`           | Detect intelligent seed plan heuristics |
-| POST   | `/api/tables/:table/seed/preview`        | Generate preview sample rows for grid without executing |
-| POST   | `/api/tables/:table/seed/generate`       | Generate seed INSERT SQL without executing (`{ count, plan }`) |
-| POST   | `/api/tables/:table/seed`                | Generate and insert seed rows transactionally (`{ count, plan, truncate? }`) |
+| Method | Path                                          | Purpose                          |
+| ------ | --------------------------------------------- | -------------------------------- |
+| GET    | `/api/tables/:db`                             | List tables                      |
+| GET    | `/api/tables/:db/:table/info`                 | Column + FK metadata, PK columns |
+| GET    | `/api/tables/:db/:table/fk-options`           | Values for FK dropdowns          |
+| GET    | `/api/tables/:db/:table/rows?page&limit&f`    | Paginated rows (`f` = URL-encoded JSON filters — legacy strings like `{"age":">35"}` or structured conditions like `{"balance":{"op":"gte","value":"100"}}`) |
+| GET    | `/api/tables/:db/:table/rows/count?f=`        | Filtered row count               |
+| GET    | `/api/tables/:db/:table/row/:id`              | Single row by (encoded) PK       |
+| GET    | `/api/tables/:db/:table/rows/:id/references`  | Rows in other tables whose foreign keys reference this row |
+| GET    | `/api/tables/:db/:table/row/:id/blob/:column` | Stream binary BLOB / BYTEA with MIME detection (add `?download=1` to force download) |
+| GET    | `/api/tables/:db/:table/row/:id/blob/:column/meta` | Inspect BLOB / BYTEA metadata, MIME sniffing & 3-column hex dump |
+| PUT    | `/api/tables/:db/:table/row/:id/blob/:column` | Update binary value (`{ data: base64/hex, format?: 'base64'|'hex'|'text' }`) |
+| POST   | `/api/tables/:db/:table/rows`                 | Insert row (or batch of rows with `{ rows: [...] }`) |
+| POST   | `/api/tables/:db/:table/rows/generate`        | Generate INSERT SQL (no execute) |
+| POST   | `/api/tables/:db/:table/rows/import`          | Import CSV (`{ csv }`, header row must match columns) |
+| GET    | `/api/tables/:db/:table/export?format=`       | Download all rows as `csv` or `json` |
+| PUT    | `/api/tables/:db/:table/row/:id`              | Update row (`{ values, nulls? }` — `nulls` explicitly sets columns to NULL) |
+| PUT    | `/api/tables/:db/:table/row/:id/generate`     | Generate UPDATE SQL (no execute) |
+| DELETE | `/api/tables/:db/:table/row/:id`              | Delete row                       |
+| POST   | `/api/tables/:db/:table/rows/bulk-impact`     | FK-impact preview: how many rows in other tables reference the selected rows |
+| POST   | `/api/tables/:db/:table/rows/bulk-delete`     | Delete selected rows (`{ ids, confirmImpact }`; transactional) |
+| POST   | `/api/tables/:db/:table/rows/bulk-export`     | Export only the selected rows as `csv`/`json` (`{ ids, format }`) |
+| POST   | `/api/tables/:db/:table/rows/bulk-update`     | Apply staged inline edits (`{ updates: [{ id, values?, nulls? }] }`; transactional) |
+| GET    | `/api/tables/:db/:table/seed/config`          | Per-column generator strategies + detected defaults |
+| GET    | `/api/tables/:db/:table/seed/plan`            | Detect intelligent seed plan heuristics |
+| POST   | `/api/tables/:db/:table/seed/preview`         | Generate preview sample rows for grid without executing |
+| POST   | `/api/tables/:db/:table/seed/generate`        | Generate seed INSERT SQL without executing (`{ count, plan }`) |
+| POST   | `/api/tables/:db/:table/seed`                 | Generate and insert seed rows transactionally (`{ count, plan, truncate? }`) |
+| GET    | `/api/tables/:db/:table/seed/chain`           | Relational ER chain resolution and topological sort |
+| POST   | `/api/tables/:db/:table/seed/chain/generate`  | Generate ER chain seed SQL & preview rows |
+| POST   | `/api/tables/:db/:table/seed/chain`           | Execute atomic relational chain seeding |
+| POST   | `/api/seed/:db/validate`                      | Validate unified seed plan |
+| POST   | `/api/seed/:db/preview`                       | Preview unified multi-table seed rows |
+| POST   | `/api/seed/:db/execute`                       | Execute unified multi-table seed plan |
 
 ## Schema & indexes
 
-| Method | Path                                 | Purpose                          |
-| ------ | ------------------------------------ | -------------------------------- |
-| POST   | `/api/tables`                        | Create table                     |
-| POST   | `/api/tables/generate`               | Generate CREATE SQL (no execute) |
-| GET    | `/api/tables/:table/schema`          | Full schema (constraints, indexes, FK refs) |
-| GET    | `/api/tables/:table/ddl`             | Get formatted `CREATE TABLE` and `INDEX` DDL for a single table |
-| GET    | `/api/info/ddl`                      | Get formatted DDL for the entire database schema |
-
-| POST   | `/api/tables/:table/rename`          | Rename the table                 |
-| POST   | `/api/tables/:table/columns`         | Add a column                     |
-| PUT    | `/api/tables/:table/columns/:column` | Modify/rename a column           |
-| DELETE | `/api/tables/:table/columns/:column` | Drop a column (safety-checked)   |
-| DELETE | `/api/tables/:table`                 | Drop the table (safety-checked)  |
-| POST   | `/api/tables/bulk-drop`              | Drop multiple tables at once (`{ tables, force }`) |
-| POST   | `/api/tables/bulk-truncate`          | Truncate/empty multiple tables at once (`{ tables, force }`) |
-| POST   | `/api/tables/:table/indexes`         | Create an index (`{ name?, columns[], unique? }`) |
-| DELETE | `/api/tables/:table/indexes/:index`  | Drop an index (auto indexes refused) |
-| GET    | `/api/erd`                           | Full schema graph with columns & FK edges for ER Diagram |
+| Method | Path                                      | Purpose                          |
+| ------ | ----------------------------------------- | -------------------------------- |
+| POST   | `/api/tables/:db`                         | Create table                     |
+| POST   | `/api/tables/:db/generate`                | Generate CREATE SQL (no execute) |
+| GET    | `/api/tables/:db/:table/schema`           | Full schema (constraints, indexes, FK refs) |
+| GET    | `/api/tables/:db/:table/ddl`              | Get formatted `CREATE TABLE` and `INDEX` DDL for a single table |
+| GET    | `/api/info/:db/ddl`                       | Get formatted DDL for the entire database schema |
+| POST   | `/api/tables/:db/:table/rename`           | Rename the table                 |
+| POST   | `/api/tables/:db/:table/columns`          | Add a column                     |
+| PUT    | `/api/tables/:db/:table/columns/:column`  | Modify/rename a column           |
+| DELETE | `/api/tables/:db/:table/columns/:column`  | Drop a column (safety-checked)   |
+| DELETE | `/api/tables/:db/:table`                  | Drop the table (safety-checked)  |
+| POST   | `/api/tables/:db/bulk-drop`               | Drop multiple tables at once (`{ tables, force }`) |
+| POST   | `/api/tables/:db/bulk-truncate`           | Truncate/empty multiple tables at once (`{ tables, force }`) |
+| POST   | `/api/tables/:db/:table/indexes`          | Create an index (`{ name?, columns[], unique? }`) |
+| DELETE | `/api/tables/:db/:table/indexes/:index`   | Drop an index (auto indexes refused) |
+| GET    | `/api/erd/:db`                            | Full schema graph with columns & FK edges for ER Diagram |
 
 ## Queries
 
-| Method | Path              | Purpose                    |
-| ------ | ----------------- | -------------------------- |
-| POST   | `/api/query`      | Run arbitrary SQL          |
-| POST   | `/api/query/export` | Run a SELECT and download as `csv`/`json` |
-| GET    | `/api/queries`    | List saved queries         |
-| POST   | `/api/queries`    | Save a named query         |
-| DELETE | `/api/queries/:id`| Delete a saved query       |
+| Method | Path                 | Purpose                    |
+| ------ | -------------------- | -------------------------- |
+| POST   | `/api/query/:db`     | Run arbitrary SQL          |
+| POST   | `/api/query/:db/export` | Run a SELECT and download as `csv`/`json` |
+| GET    | `/api/queries/:db`   | List saved queries         |
+| POST   | `/api/queries/:db`   | Save a named query         |
+| DELETE | `/api/queries/:db/:id` | Delete a saved query     |
 
 ## Manager mode (databases landing page)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "admindb",
-  "version": "2.3.1",
+  "version": "2.4.1",
   "description": "Browser-based SQLite & PostgreSQL database administration tool — embed it in your Express app or run it standalone.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",