admindb 1.2.0 → 2.0.0

package/dist/views/partials/navbar.hbs

@@ -1,50 +1,89 @@
+{{!-- Partial: Top Navigation Bar Header --}}
 <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">
-        <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-          <path stroke-linecap="round" stroke-linejoin="round" d="M4 6h16M4 12h16M4 18h16" />
-        </svg>
+        {{{icon "menu" class="h-5 w-5"}}}
       </label>
     </div>
-    <div class="flex-1">
+    <div class="flex flex-1 items-center gap-3">
       <a href="{{basePath}}/" class="flex items-center gap-2.5">
-        <span class="grid h-9 w-9 place-items-center rounded-xl bg-gradient-to-br from-primary to-secondary text-white shadow-soft">
-          <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-            <path stroke-linecap="round" stroke-linejoin="round" d="M4 7v10c0 1.1.9 2 2 2h12a2 2 0 002-2V7M4 7c0-1.1.9-2 2-2h12a2 2 0 012 2M4 7c0 1.1.9 2 2 2h12a2 2 0 002-2" />
-          </svg>
-        </span>
-        <span class="text-lg font-bold tracking-tight">DB<span class="text-primary">Admin</span></span>
+        <span class="text-lg font-bold tracking-tight">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 databasesMode}}
-        {{#if databasesUrl}}
-          <a href="{{databasesUrl}}" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
-            <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M4 7v10c0 1.1.9 2 2 2h12a2 2 0 002-2V7M4 7c0-1.1.9-2 2-2h12a2 2 0 012 2M4 7c0 1.1.9 2 2 2h12a2 2 0 002-2" /></svg>
-            Databases
+      {{#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>
-        {{/if}}
-        <a href="{{basePath}}/query" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
-          <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M13 10V3L4 14h7v7l9-11h-7z" /></svg>
-          Query
-        </a>
-        {{#unless readonly}}
-          <a href="{{basePath}}/designer" class="btn btn-ghost btn-sm hidden gap-1.5 sm:inline-flex">
-            <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M12 4v16m8-8H4" /></svg>
-            New table
+          {{#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}}
-        <a href="{{basePath}}/export" class="btn btn-ghost btn-sm hidden gap-1.5 md:inline-flex">
-          <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" /></svg>
-          Export
-        </a>
       {{/unless}}
+
+      {{#if authEnabled}}
+        {{#if authUser}}
+          {{#if isDefaultPassword}}
+            <span class="badge badge-warning badge-sm gap-1 hidden sm:inline-flex font-mono text-[11px]" title="Using default password (admin). Set ADMINDB_PASSWORD in production.">
+              {{{icon "warning" class="h-3.5 w-3.5"}}}
+              default pass
+            </span>
+          {{/if}}
+          <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-48 border border-base-300 z-50 mt-1 text-sm">
+              <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>
+              <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">
-        <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-          <path stroke-linecap="round" stroke-linejoin="round" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z" />
-        </svg>
+        {{{icon "moon" class="h-5 w-5"}}}
       </button>
+
     </div>
   </div>
 </div>

package/dist/views/partials/sidebar.hbs

@@ -1,116 +1,125 @@
+{{!-- Partial: Left Navigation Sidebar --}}
 <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">
-    <span class="grid h-9 w-9 shrink-0 place-items-center rounded-xl bg-gradient-to-br from-primary to-secondary text-white shadow-soft">
-      <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-        <path stroke-linecap="round" stroke-linejoin="round" d="M4 7v10c0 1.1.9 2 2 2h12a2 2 0 002-2V7M4 7c0-1.1.9-2 2-2h12a2 2 0 012 2M4 7c0 1.1.9 2 2 2h12a2 2 0 002-2" />
-      </svg>
-    </span>
-    <div>
-      <div class="text-base font-bold leading-tight">AdminDB</div>
-      <div class="text-[11px] text-neutral-content/50">{{#if databasesMode}}Database manager{{else}}Database: {{dbId}}{{/if}}</div>
+    <div class="w-full">
+      <div class="flex items-center justify-between">
+        <div class="text-base font-bold leading-tight">AdminDB <span style="font-size: x-small">{{#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">
-            <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M4 7v10c0 1.1.9 2 2 2h12a2 2 0 002-2V7M4 7c0-1.1.9-2 2-2h12a2 2 0 012 2M4 7c0 1.1.9 2 2 2h12a2 2 0 002-2" /></svg>
-            Databases
-          </a>
-        </li>
-      </ul>
-    </nav>
+  <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">
-        <svg xmlns="http://www.w3.org/2000/svg" class="pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-neutral-content/40" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-          <path stroke-linecap="round" stroke-linejoin="round" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
-        </svg>
-        <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>
+  <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">
-              <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M4 7v10c0 1.1.9 2 2 2h12a2 2 0 002-2V7M4 7c0-1.1.9-2 2-2h12a2 2 0 012 2M4 7c0 1.1.9 2 2 2h12a2 2 0 002-2" /></svg>
-              Databases
-            </a>
-          </li>
-        {{/if}}
-        <li>
-          <a href="{{basePath}}/" class="side-link {{#if (eq currentPath '/')}}active{{/if}}">
-            <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6" /></svg>
-            Home
-          </a>
-        </li>
-        <li>
-          <a href="{{basePath}}/query" class="side-link {{#if (startsWith currentPath '/query')}}active{{/if}}">
-            <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M13 10V3L4 14h7v7l9-11h-7z" /></svg>
-            Query editor
-          </a>
-        </li>
-        {{#unless readonly}}
-          <li>
-            <a href="{{basePath}}/designer" class="side-link {{#if (startsWith currentPath '/designer')}}active{{/if}}">
-              <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M12 4v16m8-8H4" /></svg>
-              New table
-            </a>
-          </li>
-        {{/unless}}
-      </ul>
+  <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>
+      {{#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>
+    <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">
-                <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M3 10h18M3 14h18m-9-4v8m-7 0h14a2 2 0 002-2V8a2 2 0 00-2-2H5a2 2 0 00-2 2v8a2 2 0 002 2z" /></svg>
-              </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>
+    <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">
-                  <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253" /></svg>
-                </span>
-                <span class="truncate">{{this}}</span>
-              </a>
-            </li>
-          {{/each}}
-        </ul>
-      {{/if}}
-    </nav>
+    {{#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}}
 
   <div class="border-t border-white/10 px-5 py-3">
-    <div class="text-[11px] font-medium uppercase tracking-wider text-neutral-content/40">{{#if databasesMode}}Directory{{else}}Database{{/if}}</div>
+    <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>
-    {{#if readonly}}
-      <div class="mt-2 inline-flex items-center gap-1 rounded-md bg-warning/20 px-2 py-1 text-[10px] font-bold uppercase tracking-wider text-warning">
-        <svg xmlns="http://www.w3.org/2000/svg" class="h-3 w-3" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M12 15v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" /></svg>
-        Read-only
-      </div>
-    {{/if}}
   </div>
 </aside>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "admindb",
-  "version": "1.2.0",
-  "description": "Browser-based SQLite database administration tool — embed it in your Express app or run it standalone.",
+  "version": "2.0.0",
+  "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",
   "bin": {
@@ -32,10 +32,15 @@
     "dev": "concurrently -k -n server,css \"tsx watch src/cli.ts\" \"npm run dev:css\"",
     "dev:css": "cross-env BROWSERSLIST_IGNORE_OLD_DATA=1 tailwindcss -i ./src/public/css/input.css -o ./src/public/css/app.css --watch",
     "prepack": "npm run build",
-    "test": "npm run build && node --test dist/test/*.test.js"
+    "test": "tsx --test test/*.test.ts",
+    "test:smoke": "tsx --test test/smoke.test.ts",
+    "generatehash": "node scripts/generate-hash.mjs",
+    "lint": "tsc --noEmit"
   },
   "keywords": [
     "sqlite",
+    "postgres",
+    "postgresql",
     "admin",
     "database",
     "express",
@@ -50,14 +55,16 @@
   "dependencies": {
     "better-sqlite3": "^11.9.1",
     "express": "^5.1.0",
-    "express-handlebars": "^8.0.3"
+    "express-handlebars": "^8.0.3",
+    "pg": "^8.23.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^9.6.0",
     "@types/express": "^4.17.21",
     "@types/node": "^22.10.0",
+    "@types/pg": "^8.23.1",
     "concurrently": "^9.1.0",
-    "cross-env": "^10.1.0",
+    "cross-env": "^7.0.3",
     "daisyui": "^4.12.0",
     "tailwindcss": "^3.4.17",
     "tsx": "^4.19.0",

package/dist/args.d.ts

@@ -1,28 +0,0 @@
-import type { LogLevel } from './logger';
-export interface CliArgs {
-    help: boolean;
-    version: boolean;
-    /** Bind host/interface. */
-    host?: string;
-    /** Port to listen on. */
-    port?: number;
-    /** A single database file to open directly (`--open`/`--db`/`--file`). */
-    dbPath?: string;
-    /** Directory of database files to manage (`--dir`). */
-    dbDir?: string;
-    /** Explicit database file paths (`--files a.db,b.db`). */
-    dbFiles?: string[];
-    /** URL prefix to serve under (`--base-path`). */
-    basePath?: string;
-    logLevel?: LogLevel;
-    /** Open databases read-only (`--readonly`). */
-    readonly: boolean;
-}
-export declare function helpText(): string;
-/** The installed `admindb` package version (from package.json), or '' when unknown. */
-export declare function getPackageVersion(): string;
-export declare function versionText(): string;
-export declare function parseArgs(argv: string[]): {
-    args: CliArgs;
-    error?: string;
-};

package/dist/args.js

@@ -1,187 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.helpText = helpText;
-exports.getPackageVersion = getPackageVersion;
-exports.versionText = versionText;
-exports.parseArgs = parseArgs;
-/**
- * Command-line argument parsing for the standalone `admindb` server.
- *
- * The CLI supports flags to pick the port/host, open a single database file,
- * manage a folder of databases, and more. Every flag has a matching
- * environment variable; flags always win over the environment.
- */
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
-function helpText() {
-    return [
-        'AdminDB — browser-based SQLite administration tool.',
-        '',
-        'Usage:',
-        '  admindb [options] [path]',
-        '',
-        'Starts a local server and opens a web UI where you can browse, select and',
-        'manage SQLite databases (.db / .sqlite / .sqlite3).',
-        '',
-        'With no path or options it runs in "manager" mode: the landing page lets',
-        'you browse the filesystem and open any database file, or create new ones.',
-        '',
-        'Arguments:',
-        '  path                 Path to a database file (opens it directly) or to a',
-        '                       folder of databases (lists them). Default: the',
-        '                       current directory.',
-        '',
-        'Options:',
-        '  -p, --port <port>     Port to listen on (default: 3000)',
-        '  -H, --host <host>     Host/interface to bind (default: 0.0.0.0)',
-        '  -o, --open <file>     Open a single database file',
-        '  -d, --dir <dir>       Folder of database files to manage',
-        '      --files <list>    Comma-separated database file paths',
-        '  -b, --base-path <p>   URL prefix to serve under (default: /)',
-        '  -r, --readonly        Open databases read-only (all writes disabled)',
-        '  -l, --log-level <l>   debug | info | warn | error (default: info)',
-        '  -h, --help            Show this help',
-        '  -v, --version         Show the version',
-        '',
-        'Environment variables (used when the matching flag is not given):',
-        '  PORT, HOST, DB_PATH, DB_DIR, DB_FILES, BASE_PATH, READONLY, LOG_LEVEL',
-        '',
-        'Examples:',
-        '  admindb                          # manager UI on http://localhost:3000',
-        '  admindb -p 8080                  # same, on port 8080',
-        '  admindb ./data/app.db            # open a single database file',
-        '  admindb --open ~/notes.sqlite    # open a file (direct)',
-        '  admindb -d ./dbs                 # manage a folder of databases',
-        '  admindb --files a.db,b.db -r     # open two files read-only',
-    ].join('\n');
-}
-function packageVersion() {
-    try {
-        const raw = (0, node_fs_1.readFileSync)(node_path_1.default.join(__dirname, '..', 'package.json'), 'utf8');
-        const pkg = JSON.parse(raw);
-        return pkg.version ?? '';
-    }
-    catch {
-        return '';
-    }
-}
-/** The installed `admindb` package version (from package.json), or '' when unknown. */
-function getPackageVersion() {
-    return packageVersion();
-}
-function versionText() {
-    const v = packageVersion();
-    return v ? `admindb v${v}` : 'admindb';
-}
-/** True when a token is exactly a flag or `flag=value` (for long flags). */
-function isFlag(tok, ...names) {
-    return names.includes(tok) || names.some((n) => n.length > 2 && tok.startsWith(n + '='));
-}
-function parseArgs(argv) {
-    const args = { help: false, version: false, readonly: false };
-    const positional = [];
-    let i = 0;
-    const invalid = (error) => ({ args, error });
-    // Read the value for the current flag token; supports `--flag=value` and
-    // `--flag value`. Leaves `i` pointing at the value token so the loop can
-    // advance past it.
-    const takeValue = (flag) => {
-        const eq = argv[i].indexOf('=');
-        if (eq !== -1)
-            return argv[i].slice(eq + 1);
-        i += 1;
-        return argv[i];
-    };
-    while (i < argv.length) {
-        const tok = argv[i];
-        if (tok === '-h' || tok === '--help') {
-            args.help = true;
-        }
-        else if (tok === '-v' || tok === '--version') {
-            args.version = true;
-        }
-        else if (isFlag(tok, '-p', '--port')) {
-            const v = takeValue('--port');
-            if (v === undefined)
-                return invalid('Missing value for --port.');
-            const n = Number.parseInt(v, 10);
-            if (!Number.isFinite(n) || n <= 0)
-                return invalid(`Invalid port: "${v}".`);
-            args.port = n;
-        }
-        else if (isFlag(tok, '-H', '--host')) {
-            const v = takeValue('--host');
-            if (v === undefined)
-                return invalid('Missing value for --host.');
-            args.host = v;
-        }
-        else if (isFlag(tok, '-o', '--open', '--db', '-f', '--file')) {
-            const v = takeValue('--open');
-            if (v === undefined)
-                return invalid('Missing value for --open.');
-            args.dbPath = v;
-        }
-        else if (isFlag(tok, '-d', '--dir', '--folder')) {
-            const v = takeValue('--dir');
-            if (v === undefined)
-                return invalid('Missing value for --dir.');
-            args.dbDir = v;
-        }
-        else if (isFlag(tok, '--files')) {
-            const v = takeValue('--files');
-            if (v === undefined)
-                return invalid('Missing value for --files.');
-            args.dbFiles = v
-                .split(',')
-                .map((s) => s.trim())
-                .filter(Boolean);
-        }
-        else if (isFlag(tok, '-b', '--base-path', '--base')) {
-            const v = takeValue('--base-path');
-            if (v === undefined)
-                return invalid('Missing value for --base-path.');
-            args.basePath = v;
-        }
-        else if (isFlag(tok, '-l', '--log-level')) {
-            const v = takeValue('--log-level');
-            if (v === undefined)
-                return invalid('Missing value for --log-level.');
-            if (!LOG_LEVELS.includes(v)) {
-                return invalid(`Invalid log level: "${v}". Expected one of: ${LOG_LEVELS.join(', ')}.`);
-            }
-            args.logLevel = v;
-        }
-        else if (tok === '-r' || tok === '--readonly') {
-            args.readonly = true;
-        }
-        else if (tok.startsWith('-') && tok.length > 1) {
-            return invalid(`Unknown option: "${tok}".`);
-        }
-        else {
-            positional.push(tok);
-        }
-        i += 1;
-    }
-    if (positional.length > 1) {
-        return invalid(`Unexpected extra arguments: ${positional.slice(1).join(' ')}.`);
-    }
-    const p = positional[0];
-    if (p) {
-        const abs = node_path_1.default.resolve(p);
-        try {
-            if ((0, node_fs_1.statSync)(abs).isDirectory())
-                args.dbDir = p;
-            else
-                args.dbPath = p;
-        }
-        catch {
-            args.dbPath = p;
-        }
-    }
-    return { args };
-}
-//# sourceMappingURL=args.js.map

package/dist/args.js.map

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