admindb 2.0.0 → 2.1.1

package/dist/views/pages/schema.hbs

@@ -1,7 +1,4 @@
-{{!-- Page: Table Schema & Structure Inspector · URL: /tables/:table/schema --}}
 <div class="space-y-6">
-
-  <!-- Header -->
   <div class="flex flex-wrap items-center justify-between gap-3">
     <div class="flex items-center gap-3.5">
       <a href="{{basePath}}/tables/{{table}}" class="btn btn-circle btn-ghost btn-sm" aria-label="Back to table">
@@ -23,8 +20,6 @@
       </a>
     </div>
   </div>
-
-  <!-- Rename table -->
   <div class="app-card p-5">
     <div class="flex flex-wrap items-end gap-3">
       <div class="w-full max-w-sm">
@@ -38,8 +33,6 @@
       {{#if isInternal}}<span class="mb-1 text-xs text-base-content/45">Internal tables cannot be renamed.</span>{{/if}}
     </div>
   </div>
-
-  <!-- Columns -->
   <div class="app-card overflow-hidden">
     <div class="flex flex-wrap items-center justify-between gap-2 border-b border-base-200 px-5 py-4">
       <h2 class="text-sm font-semibold uppercase tracking-wide text-base-content/45">
@@ -51,7 +44,6 @@
         Add column
       </button>
     </div>
-
     <div id="add-column-panel" class="hidden border-b border-base-200 p-4">
       <div class="mb-2 text-xs font-bold uppercase tracking-wider text-primary">Add New Column</div>
       <div id="add-column-form" class="grid grid-cols-2 items-end gap-2.5 sm:grid-cols-12"></div>
@@ -61,7 +53,6 @@
         <button id="add-column-cancel" type="button" class="btn btn-ghost btn-sm">Cancel</button>
       </div>
     </div>
-
     <div id="edit-column-panel" class="hidden border-b border-base-200 bg-base-200/30 p-4">
       <div class="mb-2.5 flex items-center justify-between">
         <div class="flex items-center gap-2">
@@ -77,7 +68,6 @@
         <button id="edit-column-cancel" type="button" class="btn btn-ghost btn-sm">Cancel</button>
       </div>
     </div>
-
     <div class="overflow-x-auto">
       <table class="table table-sm">
         <thead>
@@ -136,8 +126,6 @@
       </table>
     </div>
   </div>
-
-  <!-- Foreign keys -->
   {{#if schema.foreignKeys.length}}
     <div class="app-card overflow-hidden">
       <div class="border-b border-base-200 px-5 py-4">
@@ -167,8 +155,6 @@
       </div>
     </div>
   {{/if}}
-
-  <!-- Indexes -->
   <div class="app-card overflow-hidden">
     <div class="flex flex-wrap items-center justify-between gap-2 border-b border-base-200 px-5 py-4">
       <h2 class="text-sm font-semibold uppercase tracking-wide text-base-content/45">
@@ -180,7 +166,6 @@
         Add index
       </button>
     </div>
-
     <div id="add-index-panel" class="hidden border-b border-base-200 p-4">
       <div class="grid grid-cols-1 gap-3 sm:grid-cols-3">
         <div>
@@ -216,7 +201,6 @@
         <button id="add-index-cancel" type="button" class="btn btn-ghost btn-sm">Cancel</button>
       </div>
     </div>
-
     <div class="overflow-x-auto">
       {{#if schema.indexes.length}}
         <table class="table table-sm">
@@ -266,8 +250,6 @@
       {{/if}}
     </div>
   </div>
-
-  <!-- Referenced by -->
   {{#if schema.references.length}}
     <div class="app-card overflow-hidden">
       <div class="border-b border-base-200 px-5 py-4">
@@ -293,8 +275,6 @@
       </div>
     </div>
   {{/if}}
-
-  <!-- Danger zone -->
   {{#unless isInternal}}
     <div class="rounded-2xl border border-error/25 bg-error/[0.03] p-5">
       <h2 class="flex items-center gap-2 text-sm font-semibold uppercase tracking-wide text-error">

package/dist/views/pages/seed.hbs

@@ -1,7 +1,4 @@
-{{!-- Page: Mock & Seed Data Generator · URL: /tables/:table/seed --}}
 <div class="space-y-6">
-
-  <!-- Header -->
   <div class="flex flex-wrap items-center justify-between gap-4 border-b border-base-200 pb-5">
     <div class="flex items-center gap-3">
       <a href="{{basePath}}/tables/{{table}}" class="btn btn-circle btn-ghost btn-sm" aria-label="Back to table">
@@ -17,7 +14,6 @@
       </div>
     </div>
     <div class="flex flex-wrap items-center gap-2">
-      <!-- Presets dropdown -->
       <div class="dropdown dropdown-end">
         <button tabindex="0" type="button" class="btn btn-outline btn-sm gap-1.5">
           {{{icon "seed" class="h-4 w-4"}}}
@@ -34,12 +30,10 @@
           <li><button type="button" id="seed-import-config" class="py-2">📥 Import Plan JSON…</button></li>
         </ul>
       </div>
-
       <button id="seed-preview" type="button" class="btn btn-outline btn-sm gap-1.5">
         {{{icon "inspect" class="h-4 w-4 text-primary"}}}
         Preview Data
       </button>
-
       {{#unless readonly}}
         <button id="seed-insert" type="button" class="btn btn-primary btn-sm gap-1.5 shadow-sm">
           {{{icon "plus" class="h-4 w-4"}}}
@@ -53,11 +47,8 @@
       {{/unless}}
     </div>
   </div>
-
-  <!-- Configuration Bar -->
   <div class="app-card p-5 bg-base-100">
     <div class="grid grid-cols-1 gap-5 lg:grid-cols-12 lg:items-end">
-      <!-- Row count control -->
       <div class="lg:col-span-4 space-y-1.5">
         <label class="field-label !mb-0 font-medium" for="seed-count">
           <span>Rows to generate</span>
@@ -72,8 +63,6 @@
           </div>
         </div>
       </div>
-
-      <!-- Column Search Filter -->
       <div class="lg:col-span-4 space-y-1.5">
         <label class="field-label !mb-0 font-medium" for="seed-search">
           <span>Filter columns</span>
@@ -85,8 +74,6 @@
           <input id="seed-search" type="text" placeholder="Search column by name or type..." class="field-input pl-9 text-xs" />
         </div>
       </div>
-
-      <!-- Seeding options (truncate / clear) -->
       <div class="lg:col-span-4 flex flex-col justify-end space-y-2">
         {{#unless readonly}}
           <label class="cursor-pointer flex items-center gap-2 text-xs font-medium text-base-content/80 hover:text-base-content transition-colors">
@@ -101,8 +88,6 @@
       </div>
     </div>
   </div>
-
-  <!-- Column strategies section -->
   <div class="space-y-3">
     <div class="flex flex-wrap items-center justify-between gap-2">
       <div class="flex items-center gap-2">
@@ -124,18 +109,12 @@
         </button>
       </div>
     </div>
-
-    <!-- Cards Grid -->
     <div id="seed-columns" class="grid grid-cols-1 gap-3.5 md:grid-cols-2 2xl:grid-cols-3"></div>
     <div id="seed-empty-search" class="hidden p-8 text-center app-card">
       <p class="text-sm text-base-content/50">No columns match the current search query.</p>
     </div>
   </div>
-
-  <!-- Feedback / Warnings Alert -->
   <div id="seed-feedback" class="hidden"></div>
-
-  <!-- Interactive Dual-Mode Preview Section -->
   <div id="seed-preview-card" class="hidden app-card overflow-hidden transition-all duration-200">
     <div class="flex flex-wrap items-center justify-between border-b border-base-200 bg-base-200/40 px-5 py-3 gap-3">
       <div class="flex items-center gap-3">
@@ -151,7 +130,6 @@
         </div>
         <span id="preview-summary-badge" class="badge badge-sm badge-ghost font-mono"></span>
       </div>
-
       <div class="flex flex-wrap items-center gap-1.5">
         <button id="seed-export-csv" type="button" class="btn btn-ghost btn-xs gap-1 text-base-content/70 hover:text-primary">
           {{{icon "export" class="h-3.5 w-3.5"}}}
@@ -171,23 +149,17 @@
         </button>
       </div>
     </div>
-
-    <!-- View 1: Interactive Table View -->
     <div id="seed-table-view-container" class="overflow-x-auto max-h-[32rem]">
       <table class="table table-sm table-pin-rows table-zebra w-full text-xs">
         <thead id="seed-preview-thead" class="bg-base-200 font-mono text-[11px] text-base-content/70"></thead>
         <tbody id="seed-preview-tbody"></tbody>
       </table>
     </div>
-
-    <!-- View 2: SQL View -->
     <div id="seed-sql-view-container" class="hidden p-4">
       <pre class="code-panel max-h-[32rem] overflow-auto"><code id="seed-sql-code"></code></pre>
     </div>
   </div>
 </div>
-
-<!-- Config JSON Modal -->
 <dialog id="seed-config-dialog" class="modal">
   <div class="modal-box app-card max-w-lg">
     <h3 id="seed-config-dialog-title" class="text-base font-bold">Seed Plan Configuration</h3>
@@ -202,8 +174,6 @@
     <button>close</button>
   </form>
 </dialog>
-
-<!-- Truncate Confirmation Modal -->
 <dialog id="seed-truncate-dialog" class="modal">
   <div class="modal-box app-card max-w-md border border-error/30">
     <div class="flex items-center gap-3 text-error">
@@ -227,6 +197,5 @@
     <button>close</button>
   </form>
 </dialog>
-
 <script id="seed-config" type="application/json">{{{json seedConfig}}}</script>
 <script src="{{basePath}}/js/seed.js" defer></script>

package/dist/views/pages/table.hbs

@@ -1,7 +1,4 @@
-{{!-- Page: Table Records Browser & Pagination · URL: /tables/:table (or /{basePath}/tables/:table) --}}
 <div class="space-y-5">
-
-  <!-- Header -->
   <div class="flex flex-wrap items-center justify-between gap-3">
     <div class="flex items-center gap-3.5">
       <span class="grid h-12 w-12 place-items-center rounded-xl bg-primary/10 text-primary">
@@ -60,8 +57,6 @@
       {{/unless}}
     </div>
   </div>
-
-  <!-- Row filters -->
   <details class="app-card overflow-hidden" {{#if filterQS}}open{{/if}}>
     <summary class="group flex cursor-pointer list-none items-center justify-between gap-2 px-4 py-3 transition hover:bg-base-200/40 [&::-webkit-details-marker]:hidden">
       <span class="flex items-center gap-2 text-sm font-semibold uppercase tracking-wide text-base-content/45">
@@ -88,8 +83,6 @@
       </div>
     </form>
   </details>
-
-  <!-- CSV import -->
   <div id="import-panel" class="app-card hidden p-4">
     <div class="mb-3 flex items-center justify-between">
       <h2 class="text-sm font-semibold uppercase tracking-wide text-base-content/45">Import CSV into <span class="font-mono normal-case">{{table}}</span></h2>
@@ -107,10 +100,8 @@
       <p class="text-xs text-base-content/45">The first row must be column names matching this table. Empty cells are treated as “not set” so database defaults apply. The import is transactional — a failed row rolls back everything.</p>
     </div>
   </div>
-
   {{#if rows.length}}
     <div class="app-card overflow-hidden">
-      <!-- Toolbar -->
       <div class="flex flex-wrap items-center justify-between gap-2 border-b border-base-200 px-4 py-2.5">
         <div class="flex flex-wrap items-center gap-3">
           <span class="text-sm text-base-content/65">Showing <b class="tabular-nums font-bold text-base-content">{{firstRow}}</b>–<b class="tabular-nums font-bold text-base-content">{{lastRow}}</b> of <b class="tabular-nums font-bold text-base-content">{{count}}</b> rows</span>
@@ -127,8 +118,6 @@
           </label>
         </div>
       </div>
-
-      <!-- Bulk selection bar -->
       <div id="bulk-bar" class="hidden items-center justify-between gap-2 border-b border-base-200 bg-primary/[0.04] px-4 py-2">
         <span class="text-sm font-medium text-base-content/80">
           <b id="bulk-count" class="tabular-nums text-primary">0</b> row(s) selected
@@ -149,7 +138,6 @@
           <button id="bulk-clear" type="button" class="btn btn-ghost btn-xs text-base-content/60">Clear</button>
         </div>
       </div>
-
       <div class="overflow-x-auto">
         <table id="main-table" class="table table-compact table-pin-rows">
           <thead>
@@ -303,8 +291,6 @@
           </tbody>
         </table>
       </div>
-
-      <!-- Pagination -->
       {{#if (gt pages 1)}}
         <div class="flex flex-wrap items-center justify-between gap-2 border-t border-base-200 px-4 py-3">
           <span class="text-sm text-base-content/50">Page {{page}} of {{pages}}</span>

package/dist/views/partials/icon.hbs

@@ -1,2 +1 @@
-{{!-- Partial: Dynamic SVG Icon Renderer · Helper: {{{icon "name" class="..."}}} --}}
 {{{icon name class=class}}}

package/dist/views/partials/navbar.hbs

@@ -1,6 +1,4 @@
-{{!-- 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">
@@ -25,7 +23,6 @@
         {{/if}}
       {{/unless}}
     </div>
-
     <div class="flex items-center gap-1.5">
       {{#unless noSidebar}}
         {{#unless databasesMode}}
@@ -51,7 +48,6 @@
           </a>
         {{/unless}}
       {{/unless}}
-
       {{#if authEnabled}}
         {{#if authUser}}
           {{#if isDefaultPassword}}
@@ -79,11 +75,9 @@
           </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>

package/dist/views/partials/sidebar.hbs

@@ -1,6 +1,4 @@
-{{!-- 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">
     <div class="w-full">
       <div class="flex items-center justify-between">
@@ -16,7 +14,6 @@
       <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">
@@ -38,7 +35,6 @@
         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}}
@@ -70,12 +66,10 @@
       </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}}">
@@ -90,7 +84,6 @@
       <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">
@@ -108,7 +101,6 @@
     {{/if}}
   </nav>
   {{/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>

package/docs/API.md

@@ -0,0 +1,144 @@
+# 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`.
+
+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? }`) |
+
+## 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 |
+
+| 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/:table/indexes`         | Create an index (`{ name?, columns[], unique? }`) |
+| DELETE | `/api/tables/:table/indexes/:index`  | Drop an index (auto indexes refused) |
+
+## 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       |
+
+## Manager mode (databases landing page)
+
+These endpoints manage database files and power the filesystem browser:
+
+| Method | Path                            | Purpose                                     |
+| ------ | ------------------------------- | ------------------------------------------- |
+| GET    | `/api/databases`                | List managed databases                      |
+| POST   | `/api/databases`                | Create a new SQLite database (`{ name }`)   |
+| POST   | `/api/databases/connect-postgres` | Connect a PostgreSQL database (`{ name?, connectionString, readonly? }`) |
+| POST   | `/api/databases/:id/mode`       | Toggle/set database mode (`{ readonly: boolean }`) |
+| DELETE | `/api/databases/:id`            | Delete SQLite database file or disconnect PostgreSQL connection |
+| GET    | `/api/fs/list?path=`            | List subfolders + SQLite files under a path (sandboxed file browser) |
+| POST   | `/api/databases/open`           | Open/register an existing database file by path (`{ path, readonly? }`) |
+
+## Authentication & Sessions
+
+| Method | Path                  | Purpose                                     |
+| ------ | --------------------- | ------------------------------------------- |
+| GET    | `/login`              | Web UI login page                           |
+| POST   | `/login`              | Authenticate with `{ username, password }` and get session token |
+| POST   | `/logout`             | Terminate session and clear cookie          |
+| GET    | `/logout`             | Terminate session and redirect to `/login`  |
+
+All API endpoints accept:
+- **HTTP Basic Auth**: `Authorization: Basic <base64(username:password)>`
+- **Bearer Token**: `Authorization: Bearer <sessionToken>`
+- **Session Cookie**: `admindb_session=<sessionToken>`
+
+### Generating Password Hashes
+Generate salted `scrypt` password hashes for custom credentials:
+```bash
+npm run generatehash
+# Enter password -> outputs scrypt:<salt>:<hash>
+```
+
+Paste the generated hash into `ADMINDB_PASSWORD`, CLI `-P`, or `auth.password` option.
+
+### Disabling Native Authentication & Custom Application Auth
+Pass `auth: false`, CLI `--no-auth`, or `ADMINDB_AUTH=false` to turn off built-in authentication when integrating your own security layer.
+
+> [!WARNING]
+> **Security & Responsibility Notice**:
+> AdminDB's built-in authentication is designed for basic access control during local development. For production environments and internet-facing networks, **it is entirely the user's responsibility to protect AdminDB** by placing it behind your own application authentication (e.g. NextAuth, Passport, JWT, SSO/OAuth middleware), a VPN, an IP-allowlist reverse proxy (Nginx, Cloudflare Access), or HTTPS with rate limiting.
+
+
+## TypeScript API Types & Helpers
+
+All request and response types, data inspection helpers, and serverless handlers are exported by the package entry point:
+
+```ts
+import {
+  createRouter,
+  createServerlessHandler,
+  createLambdaHandler,
+  sniffMimeType,
+  generateHexDump,
+  analyzeBlob,
+  isJsonString,
+  formatJsonSafely,
+  type ApiResponse,
+  type GetRowsResponseData,
+  type BlobMetaResponseData,
+  type TableDdlResponseData,
+} from 'admindb';
+
+// 1. Sniff MIME type from binary magic bytes
+const analysis = sniffMimeType(imageBuffer);
+console.log(analysis.mime, analysis.ext, analysis.isImage);
+
+// 2. Generate a 3-column hex dump
+const dump = generateHexDump(binaryBuffer, 1024);
+dump.lines.forEach((l) => console.log(`${l.offset}  ${l.hex}  |${l.ascii}|`));
+
+// 3. Serverless request handler (Vercel, AWS Lambda, Cloudflare, etc.)
+export default createServerlessHandler({ dbPath: './app.db' });
+```
+
+