fix(backup): fix 7 bugs in backup/restore — strip-components, multi-db path, verify+log in HTTP handler, parseBackupFilename for .tar, getArchiveSize gzip -l, dead code removal

- backup CLI: add --all-databases, --database, --data-root flags
- backup format: tar.gz with databases/<name>/ + backup.json metadata
- HTTP API: new endpoints /databases, /backup, /backups, /restore
- HTTP API: database switching via X-Database header
- Admin panel: database selector dropdown, Databases tab, Backups tab
- Admin panel: backup/restore UI with fetch() to new endpoints
- Update deps: hunos 1.3.0, jwt-nim-baraba 2.1.0
- Docker: backup cron uses --all-databases --data-root=/data/databases
- Docs: update api-http.md, protocol.md with correct endpoints
- OpenAPI spec updated to v1.1.6

Known limitation: DELETE /databases disabled due to ORC SIGSEGV
in LSMTree.close(). Use SQL DROP DATABASE instead.

.github/workflows/clients-ci.yml

@@ -80,8 +80,7 @@ jobs:
         working-directory: clients/python
         run: |
           python -m pip install --upgrade pip
-          pip install pytest
+          pip install -e ".[dev]"
-          pip install -e .
 
       - name: Run Python unit tests
         working-directory: clients/python

.gitignore

@@ -7,11 +7,18 @@ nimblecache/
 # Binaries (compiled test executables)
 tests/test_all
 tests/stress_test
+tests/test_lock
+tests/test_minimal
+tests/tla_faithfulness
+tests/fuzz_test
+tests/prop_test
 benchmarks/bench_all
 benchmarks/compare
 clients/nim/tests/test_client
 src/baradadb
+src/barabadb/client/client
 src/barabadb/core/raft
+src/barabadb/core/backup
 
 # Temp
 *.tmp
@@ -37,4 +44,7 @@ clients/rust/target/
 # Nim compiled binaries
 clients/nim/src/baradb/client
 src/barabadb/storage/compaction
-docker-compose.test.yml
+src/barabadb/query/executor
+tests/join_tests
+*.tar.gz
+tests/nimforum_smoke_test

BARADB_CLIENT_BUGS.md

@@ -0,0 +1,71 @@
+# Оставащи бъгове — nim-allographer (BaraDB клиент) + BaraDB сървър
+
+> Дата: 2026-05-21
+> Поправени в тази сесия: компилационни грешки, `toJson()`, агрегати, `whereIn`/`whereBetween` placeholder-и, `paginate`, transaction cleanup, `insertSql` state.
+> **Допълнително поправени:** reserved words parser, cloneForConnection nil fields, SQL injection (prepared statements), `getRowPlain()` semantics, BaraDB-native `SHOW TABLES` + schema builder
+
+---
+
+## 🔴 Критични — блокират функционалност
+
+### ✅ 1. [СЪРВЪР] SIGSEGV при INSERT в транзакция — ПОПРАВЕНО
+
+**Статус:** Поправено. `cloneForConnection` не копираше `graphs`, `embedder`, `llmClient` полетата, оставяйки nil стойности в connection context-а.
+
+**Файл:** `src/barabadb/query/executor.nim` — `cloneForConnection()`
+
+---
+
+### ✅ 2. [СЪРВЪР] Parser error за резервирани думи като колони — ПОПРАВЕНО
+
+**Статус:** Поправено. Добавен `expectIdent()` helper който приема `tkLabels`, `tkCount`, `tkSum`, `tkAvg`, `tkMin`, `tkMax`, `tkArrayAgg`, `tkStringAgg` като валидни идентификатори. Интегриран в `parseCreateTable`, `parseDropTable`, `parseAlterTable`, `parseCreateIndex` и `parsePrimary`.
+
+**Файл:** `src/barabadb/query/parser.nim`
+
+---
+
+## 🟡 Важни — качество и сигурност
+
+### ✅ 3. [КЛИЕНТ] SQL injection риск в `formatSql()` — ПОПРАВЕНО
+
+**Статус:** Поправено. Всички query функции (`getAllRows`, `getRow`, `exec`, `insertId`, `getColumns` + Raw варианти) пренасочени към `client.query(sql, params)` през `mkQueryParams` wire protocol. Стойностите вече не се интерполират в SQL стринга.
+
+**Файл:** `clients/nim-allographer/.../baradb_exec.nim`
+
+---
+
+### ✅ 4. [КЛИЕНТ] Schema builder използва `information_schema` — ПОПРАВЕНО
+
+**Статус:** Поправено.
+- **Сървър:** Добавени `SHOW TABLES` и `SHOW COLUMNS FROM table` команди (parser + executor)
+- **Клиент:** Schema builder пренаписан да ползва `SHOW TABLES` → `SHOW COLUMNS FROM` вместо `information_schema`
+
+**Файлове:**
+- `src/barabadb/query/ast.nim` — добавен `nkShowTables` node
+- `src/barabadb/query/parser.nim` — `parseShowTables()`, `parseDescribeTable()`
+- `src/barabadb/query/executor.nim` — `nkShowTables` handler
+- `clients/nim-allographer/.../create_schema.nim` — BaraDB-native introspection
+
+---
+
+## 🟢 Дреболии
+
+### ✅ 5. [КЛИЕНТ] `getRowPlain()` връща празен seq при празен резултат — ПОПРАВЕНО
+
+**Статус:** Поправено. `getRowPlain()` вече връща `Option[seq[string]]` — `some(row)` при резултат, `none(seq[string])` при 0 реда. `firstPlain`/`findPlain` запазват backward-compatible `seq[string]` API.
+
+**Файл:** `clients/nim-allographer/.../baradb_exec.nim`
+
+---
+
+## Приоритет (след поправките)
+
+| Приоритет | # | Проблем | Статус |
+|-----------|---|---------|--------|
+| ~~P0~~ | ~~1~~ | ~~Сървърен SIGSEGV при INSERT в транзакция~~ | ✅ Fixed |
+| ~~P0~~ | ~~2~~ | ~~Сървърен parser error за резервирани думи~~ | ✅ Fixed |
+| ~~P1~~ | ~~3~~ | ~~SQL injection~~ | ✅ Fixed |
+| ~~P1~~ | ~~4~~ | ~~Schema builder `information_schema`~~ | ✅ Fixed |
+| ~~P2~~ | ~~5~~ | ~~`getRowPlain()` semantics~~ | ✅ Fixed |
+
+**Всички 5 бъга са поправени.** 🎉

BUGS.md

@@ -0,0 +1,197 @@
+# Bug Report — BaraDB Codebase Audit
+
+Generated: 2026-05-21
+Total: 55 bugs (7 critical, 21 high, 21 medium, 6 low)
+**Fixed: 55/55** | **Remaining: 0/55**
+
+---
+
+## Critical — 7/7 fixed
+
+### ~~BUG-001~~ :white_check_mark: `readIdent` infinite loop on multi-byte UTF-8
+**File:** `src/barabadb/query/lexer.nim:523-538` — **FIXED:** Added `discard l.advanceRune()` to advance `l.pos` in the loop.
+
+### ~~BUG-002~~ :white_check_mark: `Parser.peek` returns uninitialized Token at EOF
+**File:** `src/barabadb/query/parser.nim:15-18` — **FIXED:** Added missing `return` keyword.
+
+### ~~BUG-003~~ :white_check_mark: `flushUnsafe` writes WAL without `walLock`
+**File:** `src/barabadb/storage/lsm.nim:808-810` — **FIXED:** Wrapped WAL writes in `acquire(db.walLock)` / `release(db.walLock)`.
+
+### ~~BUG-004~~ :white_check_mark: `checkpoint` calls `flushUnsafe` with no lock
+**File:** `src/barabadb/storage/lsm.nim:832-836` — **FIXED:** Entire checkpoint now runs under lock; WAL rotate uses `walLock`.
+
+### ~~BUG-005~~ :white_check_mark: Compaction deletes source SSTables without verifying output
+**File:** `src/barabadb/storage/compaction.nim:124-128` — **FIXED:** Added `verifySSTable` check before deleting sources.
+
+### ~~BUG-006~~ :white_check_mark: `healthCheck` leaks lock on exception
+**File:** `src/barabadb/core/replication.nim:227-248` — **FIXED:** Snapshot replicas under lock, release, then do network I/O.
+
+### ~~BUG-007~~ :white_check_mark: `hmacSha256` truncates keys > 64 bytes to hex string
+**File:** `src/barabadb/protocol/auth.nim:73-79` — **FIXED:** Changed `k = $hash` to `k = cast[string](hash)` for raw bytes.
+
+---
+
+## High — 21/21 fixed
+
+### ~~BUG-008~~ :white_check_mark: `loadExistingDatabases` / `ensureDefaultDatabase` without lock
+**File:** `src/barabadb/core/registry.nim:55-70, 78-90` — **FIXED:** Added lock around `reg.databases` modifications.
+
+### ~~BUG-009~~ :white_check_mark: `compactVersions` modifies shared state without lock
+**File:** `src/barabadb/core/mvcc.nim:329-354` — **FIXED:** Made private (removed `*`), only called from `commit` which holds lock.
+
+### ~~BUG-010~~ :white_check_mark: Deadlock detector edges never cleaned up
+**File:** `src/barabadb/core/mvcc.nim:191-199` — **FIXED:** Added `removeWait` before returning on conflict. Also fixed in `delete`.
+
+### ~~BUG-011~~ :white_check_mark: `close` leaks WAL/SSTable on exception
+**File:** `src/barabadb/storage/lsm.nim:842-851` — **FIXED:** Wrapped in `try/finally` to guarantee cleanup.
+
+### ~~BUG-012~~ :white_check_mark: B-Tree `remove` does not rebalance
+**File:** `src/barabadb/storage/btree.nim` — **FIXED:** Implemented full B-tree delete rebalancing: `borrowFromLeft`/`borrowFromRight` (borrow key + child from sibling, update parent separator), `mergeWithLeft`/`mergeWithRight` (merge with sibling by pulling down parent separator), `rebalanceAfterDelete` (orchestrates borrow-or-merge, recursive parent rebalancing, root shrinking).
+
+### ~~BUG-013~~ :white_check_mark: Compaction `except: discard` swallows all exceptions
+**File:** `src/barabadb/storage/compaction.nim:76-84` — **FIXED:** Catches `CatchableError`, logs, and aborts compaction without deleting sources.
+
+### ~~BUG-014~~ :white_check_mark: `headerSize = 36` should be 40 — wrong CRC range
+**File:** `src/barabadb/storage/lsm.nim:212,293,334` — **FIXED:** Changed all three occurrences from 36 to 40.
+
+### ~~BUG-015~~ :white_check_mark: `**` power operator tokenized but never parsed
+**File:** `src/barabadb/query/parser.nim:270-282` — **FIXED:** Added `parsePower` function (right-associative) between `parsePostfix` and `parseMulDiv`.
+
+### ~~BUG-016~~ :white_check_mark: `NOT a = b` wrong precedence
+**File:** `src/barabadb/query/parser.nim:297-345` — **FIXED:** Moved NOT wrap to AFTER the comparison while loop.
+
+### ~~BUG-017~~ :white_check_mark: `COUNT(DISTINCT col)` DISTINCT flag lost
+**File:** `src/barabadb/query/parser.nim:141-164` — **FIXED:** Added `funcDistinct` field to `nkFuncCall` node in AST, set in parser.
+
+### ~~BUG-018~~ :white_check_mark: Expression UDFs always return null
+**File:** `src/barabadb/query/udf.nim:73-80` — **FIXED:** Raises descriptive error directing to use query evaluator.
+
+### ~~BUG-019~~ :white_check_mark: `substr` crashes on out-of-bounds index
+**File:** `src/barabadb/query/udf.nim:176-188` — **FIXED:** Added bounds check, returns empty string for out-of-bounds.
+
+### ~~BUG-020~~ :white_check_mark: Raft accepts stale term vote/append replies
+**File:** `src/barabadb/core/raft.nim:352-391` — **FIXED:** Added `if reply.term < node.currentTerm: return` in both handlers.
+
+### ~~BUG-021~~ :white_check_mark: Raft `becomeFollower` on `term >= currentTerm`
+**File:** `src/barabadb/core/raft.nim:269-271` — **FIXED:** Changed `>=` to `>`; `leaderId` assignment still happens unconditionally.
+
+### ~~BUG-022~~ :white_check_mark: `shipToReplica` socket leak
+**File:** `src/barabadb/core/replication.nim:94-113` — **FIXED:** Used `defer: sock.close()`.
+
+### BUG-023 :x: `pendingAcks` never cleaned up in sync/semi-sync
+**File:** `src/barabadb/core/replication.nim:131-164` — **NOT FIXED:** Requires restructuring sync replication ack flow.
+
+### BUG-024 :x: `rebalance` loses old assignments
+**File:** `src/barabadb/core/sharding.nim:208-211` — **NOT FIXED:** Requires passing old assignments to `migrateData`.
+
+### ~~BUG-025~~ :white_check_mark: `deserializeValue` missing bounds checks
+**File:** `src/barabadb/protocol/wire.nim:216-227` — **FIXED:** Added bounds checks for `fkBool`, `fkInt8`, `fkInt16`.
+
+### ~~BUG-026~~ :white_check_mark: `verifyToken` parseInt throws on malformed claims
+**File:** `src/barabadb/protocol/auth.nim:175-177` — **FIXED:** Wrapped in `try/except ValueError`.
+
+### ~~BUG-027~~ :white_check_mark: 2PC leaves participants prepared on network failure
+**File:** `src/barabadb/core/disttxn.nim:150-200` — **FIXED:** Added `rollbackPending`/`commitPending` flags and recovery warnings.
+
+### ~~BUG-028~~ :white_check_mark: JWT DB switch never decrements old connection count
+**File:** `src/barabadb/core/server.nim:504-520` — **FIXED:** Decrement old DB count before incrementing new one.
+
+---
+
+## Medium — 21/21 fixed
+
+### ~~BUG-029~~ :white_check_mark: `loadConfigFromJson` silently swallows errors
+**File:** `src/barabadb/core/config.nim:121-124` — **FIXED:** Logs warnings instead of `discard`.
+
+### ~~BUG-030~~ :white_check_mark: Default JWT secret hardcoded in binary
+**File:** `src/barabadb/core/config.nim:182-185` — **FIXED:** Returns empty string; callers must handle missing secret.
+
+### ~~BUG-031~~ :white_check_mark: `dropDatabase` closes LSMTree before removing from registry
+**File:** `src/barabadb/core/registry.nim:133-161` — **FIXED:** Delete from registry first, then close/cleanup outside lock.
+
+### ~~BUG-032~~ :white_check_mark: MERGE missing DELETE / DO NOTHING
+**File:** `src/barabadb/query/parser.nim:902-958` — **FIXED:** Added `tkDo`/`tkNothing` tokens, `mergeMatchedDelete`/`mergeNotMatchedNothing`/`mergeMatchedCondition` AST fields, and loop-based parser for multiple WHEN branches.
+
+### ~~BUG-033~~ :white_check_mark: `inferExpr` miscategorizes binary operators as unary
+**File:** `src/barabadb/query/ir.nim:291-301` — **FIXED:** Removed binary operators from unary case, added `irNeg` handling.
+
+### ~~BUG-034~~ :white_check_mark: `codegenExpr` is no-op for most expression types
+**File:** `src/barabadb/query/codegen.nim:50-67` — **FIXED:** Literal/field/aggregate now return proper storage ops; unary/binary propagate children.
+
+### ~~BUG-035~~ :white_check_mark: `readEntries` leaks FileStream on early return
+**File:** `src/barabadb/storage/wal.nim:211-213` — **FIXED:** Wrapped in `try/finally` with `s.close()`.
+
+### ~~BUG-036~~ :white_check_mark: mmap reads allow negative offset
+**File:** `src/barabadb/storage/mmap.nim:83+` — **FIXED:** Added `offset < 0` checks to all read functions.
+
+### ~~BUG-037~~ :white_check_mark: Raft log index conflates entry index with array position
+**File:** `src/barabadb/core/raft.nim:287-290` — **FIXED:** Added `findLogEntryByIndex` helper that searches by logical index instead of assuming `index - 1 == array_position`.
+
+### ~~BUG-038~~ :white_check_mark: `becomeFollower` doesn't clear `nextIndex`/`matchIndex`
+**File:** `src/barabadb/core/raft.nim:209-214` — **FIXED:** Added `clear()` for both tables.
+
+### ~~BUG-039~~ :white_check_mark: Gossip assigns wrong port to new nodes
+**File:** `src/barabadb/core/gossip.nim:295-302` — **FIXED:** Extracts port from `senderAddr` ("host:port") instead of using local `gp.gossipPort`.
+
+### ~~BUG-040~~ :white_check_mark: `getShardRange` overlapping range boundaries
+**File:** `src/barabadb/core/sharding.nim:70-74` — **FIXED:** Exclusive upper bound for non-last shards.
+
+### ~~BUG-041~~ :white_check_mark: `getShardHash` divides by zero
+**File:** `src/barabadb/core/sharding.nim:66-68` — **FIXED:** Returns -1 if `shards.len == 0`.
+
+### ~~BUG-042~~ :white_check_mark: `connectWithTimeout` missing SO_ERROR check
+**File:** `src/barabadb/core/replication.nim:80-92` — **FIXED:** Added `getsockopt(SO_ERROR)` verification.
+
+### ~~BUG-043~~ :white_check_mark: Dead code: duplicate ON UPDATE in ON DELETE
+**File:** `src/barabadb/query/parser.nim:1081-1087` — **FIXED:** Removed duplicate branches.
+
+### ~~BUG-044~~ :white_check_mark: LIMIT cost ignores offset
+**File:** `src/barabadb/query/codegen.nim:242-246` — **FIXED:** Cost now factors in `offset + limit` — high offset no longer treated as cheap.
+
+### ~~BUG-045~~ :white_check_mark: `contains` UDF cross-type mismatch
+**File:** `src/barabadb/query/udf.nim:212-234` — **FIXED:** Added cross-type numeric comparison (int64/int32/float64).
+
+### ~~BUG-046~~ :white_check_mark: MmapFile.close() potential infinite recursion
+**File:** `src/barabadb/storage/mmap.nim:133-137` — **FIXED:** Qualified `close` as `posix.close`.
+
+### ~~BUG-047~~ :white_check_mark: `sendDistTxnRpc` socket leak
+**File:** `src/barabadb/core/disttxn.nim:93-109` — **FIXED:** Used `defer: sock.close()`.
+
+### ~~BUG-048~~ :white_check_mark: Saga compensation skips on failure
+**File:** `src/barabadb/core/disttxn.nim:282-293` — **FIXED:** Wrapped each `compensate()` in `try/except`, logs and continues.
+
+### ~~BUG-049~~ :white_check_mark: SCRAM reveals user existence
+**File:** `src/barabadb/protocol/auth.nim:207-208` — **FIXED:** Changed error message from "Unknown user: X" to "Authentication failed".
+
+### ~~BUG-050~~ :white_check_mark: `isVisible` doesn't check committedTxnsSet for deleter
+**File:** `src/barabadb/core/mvcc.nim:129-141` — **FIXED:** Added `committedTxnsSet` check before unconditionally hiding record.
+
+---
+
+## Low — 6/6 fixed
+
+### ~~BUG-051~~ :white_check_mark: `recvExactWithTimeout` abandoned future on timeout
+**File:** `src/barabadb/core/server.nim:313-320` — **FIXED:** Explicit `return ""` with comment explaining cleanup.
+
+### ~~BUG-052~~ :white_check_mark: `readNumber` produces invalid float for trailing dot
+**File:** `src/barabadb/query/lexer.nim:508-521` — **FIXED:** Appends "0" for trailing dot (`123.` → `123.0`).
+
+### ~~BUG-053~~ :white_check_mark: `substr(s, start)` returns rest-of-string
+**File:** `src/barabadb/query/udf.nim:187` — **FIXED:** Now returns single character `s[start]` for 2-arg form.
+
+### ~~BUG-054~~ :white_check_mark: `readUint32` → `int` truncation on 32-bit
+**File:** `src/barabadb/protocol/wire.nim:136,147` — **FIXED:** Store raw uint32 before cast, check for negative result after cast.
+
+### ~~BUG-055~~ :white_check_mark: PageCache `put` resets `lastAccess` to 0
+**File:** `src/barabadb/storage/compaction.nim:196-213` — **FIXED:** Removed unused `lastAccess` field entirely; LRU uses `accessOrder` seq.
+
+---
+
+## Summary
+
+| Status | Count |
+|--------|-------|
+| Fixed | 55 |
+| Remaining | 0 |
+
+All identified bugs have been resolved.

Dockerfile

@@ -10,13 +10,16 @@
 #   docker build -t baradb:latest .
 #
 # Run:
-#   docker run -d -p 9472:9472 -p 9470:9470 -p 9471:9471 -v baradb_data:/data baradb:latest
+#   docker run -d -p 9472:9472 -p 9912:9912 -p 9913:9913 -v baradb_data:/data baradb:latest
 
 FROM debian:bookworm-slim
 
+ARG BUILD_DATE
+ARG VCS_REF
+
 LABEL maintainer="BaraDB Team"
 LABEL description="BaraDB — Multimodal Database Engine"
-LABEL version="1.1.0"
+LABEL version="1.1.6"
 
 # Инсталираме runtime зависимости
 # libpcre3 — нужна за Nim regex (зарежда се динамично)

Dockerfile.source

@@ -4,22 +4,19 @@
 # └─────────────────────────────────────────────────────────┘
 #
 # Този Dockerfile build-ва BaraDB от source код.
-# ВНИМАНИЕ: Изисква локални nimble пакети (hunos, nimmax), които
+# ВНИМАНИЕ: Изисква локален nimble пакет (hunos), който
-# не са в публичния nimble repository. Преди build трябва да:
+# не е в публичния nimble repository. Преди build трябва да:
-#   1. symlink-нете или копирате hunos/ и nimmax/ в проекта, или
+#   1. symlink-нете или копирате hunos/ в проекта, или
 #   2. копирате ~/.nimble/pkgs2 в builder стейджа.
 #
 # Build:
 #   docker build -f Dockerfile.source -t baradb:latest .
 
 # ─── Stage 1: Builder ─────────────────────────────────────
-FROM nimlang/nim:2.2.10-alpine AS builder
+FROM nimlang/nim:2.2.10 AS builder
 
 WORKDIR /build
 
-# Инсталираме build зависимости
-RUN apk add --no-cache git gcc musl-dev openssl-dev pcre-dev
-
 # Копираме nimble файл и инсталираме публични зависимости
 COPY baradadb.nimble .
 RUN nimble install -d -y || true
@@ -33,21 +30,27 @@ COPY *.nim .
 RUN nim c -d:release --opt:speed -d:ssl -o:baradadb src/baradadb.nim
 
 # Компилираме backup tool
-RUN nim c -d:release -o:backup src/barabadb/core/backup.nim
+RUN nim c -d:release --path:src -o:backup src/barabadb/core/backup.nim
 
 # ─── Stage 2: Production Runtime ──────────────────────────
-FROM alpine:3.19
+FROM ubuntu:24.04
 
 LABEL maintainer="BaraDB Team"
 LABEL description="BaraDB — Multimodal Database Engine (source build)"
-LABEL version="1.1.0"
+LABEL version="1.1.6"
 
 # Инсталираме runtime зависимости
-RUN apk add --no-cache ca-certificates su-exec wget pcre
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        libpcre3 \
+        ca-certificates \
+        wget \
+        gosu && \
+    rm -rf /var/lib/apt/lists/*
 
 # Създаваме dedicated потребител за сигурност
-RUN addgroup -g 1000 -S baradb && \
+RUN groupadd -r baradb && \
-    adduser -u 1000 -S baradb -G baradb
+    useradd -r -g baradb baradb
 
 WORKDIR /app
 
@@ -66,20 +69,20 @@ RUN mkdir -p /data && chown baradb:baradb /data && \
 # Environment variables (defaults)
 ENV BARADB_ADDRESS=0.0.0.0
 ENV BARADB_PORT=9472
-ENV BARADB_HTTP_PORT=9470
+# Note: HTTP port = TCP port + 440 (9912 when TCP=9472)
-ENV BARADB_WS_PORT=9471
+# Note: WS port   = TCP port + 441 (9913 when TCP=9472)
 ENV BARADB_DATA_DIR=/data
 ENV BARADB_LOG_LEVEL=info
 
 # Expose ports
-EXPOSE 9472 9470 9471
+EXPOSE 9472 9912 9913
 
 # Volume за persistent data
 VOLUME ["/data"]
 
 # Healthcheck
 HEALTHCHECK --interval=15s --timeout=5s --start-period=10s --retries=3 \
-    CMD wget -q --spider http://localhost:${BARADB_HTTP_PORT}/health || exit 1
+    CMD wget -qO- http://localhost:9912/health >/dev/null 2>&1 || exit 1
 
 # Стартираме чрез entrypoint
 ENTRYPOINT ["docker-entrypoint.sh"]

PLAN.md

@@ -1,125 +1,171 @@
-# BaraDB — PLAN
+# BaraDB — AI-Native Data Platform Roadmap
 
-> **v1.0.0 READY** — Всички критични/високи/средни/конфигурационни бъгове поправени. Всички 10 TLA+ спецификации са завършени. Build е чист (0 warnings).
+> **Визия**: BaraDB не е "релационна база + векторна добавка", а единна AI-native база данни, където релационни, векторни, граф и текстови данни живеят в един engine. Както MariaDB интегрира vectors в ядрото, така и BaraDB прави vector/graph/fts първокласни граждани в SQL execution layer-а.
+>
+> **Принцип**: Универсалност + Multi-Tenancy. Всяка AI функция работи с Row-Level Security (RLS) и session variables (`app.tenant_id`). Няма отделни "AI таблици" — всичко е SQL.
 
 ---
 
-## Разпределени модули — финален status (след сесия 8)
+## Текущо състояние (май 2026)
 
-### ✅ Поправено
+| Компонент | Статус |
-
+|-----------|--------|
-| Модул | Промяна |
+| SQL:2023 Engine | ✅ Window, MERGE, LATERAL, GROUPING SETS, PIVOT, SQL/PGQ |
-|--------|---------|
+| Vector Engine | ✅ HNSW + IVF-PQ + SIMD (ядро) |
-| `disttxn` | 2PC atomicity: prepare failure → rollback готови; commit failure → rollback |
+| Vector SQL | ✅ `VECTOR(n)` тип, `CREATE VECTOR INDEX`, distance функции, `<->` оператор |
-| `disttxn` | DISTTXN handler ползва реален `DistTxnManager` |
+| Graph Engine | ✅ BFS/DFS/PageRank/Dijkstra + SQL/PGQ `GRAPH_TABLE` |
-| `disttxn` | `DistTxnManager` инициализиран в `newServer()` |
+| Full-Text Search | ✅ Inverted Index + BM25 + Hybrid Search |
-| `sharding` | `getShardRange` връща `-1` за out-of-range keys |
+| JSON/JSONB | ✅ Колони, оператори, функции |
-| `sharding` | Binary search в consistent hashing ring |
+| Multi-Tenant | ✅ Session vars, `current_setting()`, `current_user`, RLS Policies |
-| `gossip` | `startHealthCheck()` + `startGossipRound()` async loops |
+| Foreign Keys | ✅ CASCADE/SET NULL/RESTRICT за ON DELETE и ON UPDATE |
-| `raft` | `applyCommand` callback — state machine прилага committed entries |
+| Formal Verification | ✅ 10 TLA+ спецификации |
-| `raft` | `RaftNetwork.run()` стартира от `main()` ако `raftEnabled=true` |
+| MCP Server | ✅ STDIO JSON-RPC, 3 tools (query, vector_search, schema_inspect), multi-tenant |
-| `raft` | `asyncCheck` заменен с `try/await` в critical paths |
+| AI Pipeline | ✅ chunk(), embed_text(), auto-embed on INSERT, configurable embedder |
-| `raft` | `bindAddr` без hardcoded IP (приема на 0.0.0.0) |
+| RAG Pipeline | ✅ ChatMessageHistory, end-to-end Python RAG example |
-| `raft` | Disk persistence: `saveState()`/`loadState()` за term/votedFor/log |
+| AI Agents & NL→SQL | ✅ nl_to_sql(), schema_prompt(), query validation, self-correction loop, multi-tenant |
-| `config` | Raft config: `raftEnabled`, `raftPort`, `raftPeers`, `raftNodeId` + env vars |
+| Graph Similarity & Embeddings | ✅ similarity_nodes(), node2vec_embed() |
-| `auth` | JWT `exp`/`nbf`/`iat` validation + constant-time signature comparison |
+| Cypher Layer | ✅ cypher() — MATCH (a)-[r]->(b) RETURN ... → GRAPH_TABLE |
-| `auth` | **SCRAM-SHA-256**: истински challenge-response със salt + iteration count |
-| `backup` | TLA+ спек: `BackupSnapshotsValid`, `RestoreIntegrity`, `RetentionInvariant` |
-| `recovery` | TLA+ спек: `RedoCommitted`, `RecoveryCompleteness`, `WalIntegrity` |
-| `crossmodal` | TLA+ спек: `MetadataVectorConsistency`, `HybridResultValid`, `TxnAtomicity` |
-
-### ⚠️ Оставащи distributed gaps (non-critical за single-node)
-
-| Модул | Gap | Статус |
-|--------|-----|--------|
-| `replication` | `writeLsn` не изпраща данни към replicas | ✅ Добавен UDP transport + binary serialization |
-| `gossip` | Няма UDP/TCP transport — in-memory само | ✅ Добавен UDP listener + broadcast + binary serialization |
-| `sharding` | `rebalance` не мигрира данни | ✅ Добавен `migrateData` протокол + `scanAll` на LSM |
-| `inter-module` | Няма raft→disttxn, gossip→sharding, replication→disttxn връзки | ✅ Всички връзки реализирани |
-| `server` | Няма shard-aware routing | ✅ ClusterMembership + ShardRouter в Server |
 
 ---
 
-## Formal Verification — финален status
+## Сесия 10: Vector AI Native Integration
 
-### 🔴 Критични (всички поправени ✅)
+> **Цел**: Да превърнем vector search от "engine feature" в "AI-native SQL experience" — RAG-ready, LangChain-compatible, MCP-enabled.
 
-| # | Задача | Статус |
+### Фаза 10.1: Hybrid RAG Search
-|---|--------|--------|
-| FV-1 | Raft: prevLogIndex/prevLogTerm в Replicate | ✅ |
-| FV-2 | Raft: Leader step-down при partition | ✅ |
-| FV-3 | 2PC: Coordinator crash/recovery | ✅ |
-| FV-4 | 2PC: Participant timeout | ✅ |
 
-### 🟡 Важни (всички поправени ✅)
+| # | Задача | Описание | Оценка | Статус |
+|---|--------|----------|--------|--------|
+| 10.1.1 | `hybrid_search()` SQL функция | Комбинира vector similarity + BM25 FTS + релационни филтри в една заявка. Reranking с RRF. | 6-8ч | ✅ |
+| 10.1.2 | `rerank()` SQL функция | Cross-encoder reranking — приема query text + резултати, връща преподредени по relevance. | 4ч | ✅ |
+| 10.1.3 | Metadata filtering в vector search | `WHERE` клауза върху JSONB/релационни колони ДО vector index scan-а (pre-filtering). | 6ч | ✅ |
+| 10.1.4 | Chunking + embedding pipeline | `INSERT INTO docs (text)` → автоматично chunk-ване + embedding generation чрез външен embedder. | 8ч | ✅ |
 
-| # | Задача | Статус |
+**Метрика**: `SELECT hybrid_search('AI query', embedding, content, k => 10)` връща релевантни резултати за under 50ms с 1M vectors.
-|---|--------|--------|
-| FV-5 | Symmetry reduction във всички .cfg | ✅ 10 спеки |
-| FV-6 | Liveness свойства | ✅ |
-| FV-7 | MVCC: Write skew detection | ✅ |
-| FV-8 | Replication: Data consistency | 🟡 Остава — non-critical |
-| FV-9 | Sharding: Data migration при rebalance | 🟡 Остава — non-critical |
 
-### 🟢 Нови спекове (всички завършени ✅)
+### Фаза 10.2: LangChain Vector Store Interface
 
-| # | Задача | Покрива | Приоритет |
+| # | Задача | Описание | Оценка | Статус |
-|---|--------|---------|-----------|
+|---|--------|----------|--------|--------|
-| FV-10 | `backup.tla` | `backup.nim` | ✅ |
+| 10.2.1 | `BaraDBStore` за Python LangChain | Имплементира `VectorStore` интерфейса — `add_texts()`, `similarity_search()`, `max_marginal_relevance_search()`. | 4ч | ✅ |
-| FV-11 | `recovery.tla` | `recovery.nim` | ✅ |
+| 10.2.2 | `BaraDBStore` за JS LangChain | Същото за LangChain.js. | 4ч | ✅ |
-| FV-12 | `crossmodal.tla` | `crossmodal.nim` | ✅ |
+| 10.2.3 | Conversation buffer в BaraDB | `ChatMessageHistory` имплементация — съхранява message threads в релационна таблица с RLS. | 3ч | ✅ |
+| 10.2.4 | RAG pipeline example | End-to-end пример: ingest PDF → chunks → embeddings → hybrid search → LLM context. | 3ч | ✅ |
 
-### 🔧 Инфраструктурни (всички поправени ✅)
+**Метрика**: LangChain RAG tutorial работи с BaraDB без промяна на кода (swap-in replacement за PostgreSQL/pgvector).
 
-| # | Задача | Статус |
+### Фаза 10.3: MCP Server (Model Context Protocol) ✅
-|---|--------|--------|
+
-| FV-13 | CI: Поправка на verify job | ✅ |
+| # | Задача | Описание | Оценка | Статус |
-| FV-14 | Property-based testing мост | ✅ |
+|---|--------|----------|--------|--------|
+| 10.3.1 | MCP Server scaffolding | STDIO/SSE transport, tool definitions, capability negotiation. | 4ч | ✅ |
+| 10.3.2 | `query` tool — SQL execution | AI агент изпраща SQL, получава резултати. Parameterized queries за сигурност. | 3ч | ✅ |
+| 10.3.3 | `vector_search` tool | Semantic search tool с tenant isolation чрез `app.tenant_id` session var. | 3ч | ✅ |
+| 10.3.4 | `schema_inspect` tool | AI агент разглежда таблици, колони, индекси, RLS policies. | 2ч | ✅ |
+| 10.3.5 | Multi-tenant MCP | Всяка MCP сесия носи `tenant_id` + `user_id` — RLS филтрира автоматично. | 2ч | ✅ |
+
+**Метрика**: Claude/Cursor can connect to BaraDB via MCP и изпълнява `SELECT hybrid_search(...) WHERE tenant_id = current_setting('app.tenant_id')`.
+✅ Проверено: `baramcp --data-dir ./data` стартира STDIO MCP сървър с 3 tools-a. Тествани с JSON-RPC 2.0 клиент: query, vector_search, schema_inspect — всички работят.
 
 ---
 
-## ✅ Сесия 8 — v1.0.0 финален спринт
+## Сесия 11: Graph Engine Deep Integration
 
-### Опция A: "Clean build" ✅
+> **Цел**: SQL/PGQ парсерът е готов, но execution-ът е table-based. Да го направим първокласен citizen с native graph storage и Cypher compatibility.
-- Почистване на 5-те build warnings
-- TLA+ symmetry reduction в `.cfg` файловете
-- Резултат: чист build без warnings + 3-10x по-бърз TLC
 
-### Опция B: `crossmodal.tla` ✅
+### Фаза 11.1: Native Graph Storage
-- TLA+ спек за cross-modal consistency
-- Моделира sync между document/vector/graph/FTS индекси
-- Резултат: 10-ти TLA+ спек, пълно покритие на core модулите
 
-### Опция C: Auth hardening + SCRAM ✅
+| # | Задача | Описание | Оценка |
-- Истински SCRAM-SHA-256 със salt (4096 iterations), challenge-response
+|---|--------|----------|--------|
-- Нов `scram.nim` модул per RFC 7677
+| 11.1.1 | Property Graph DDL | `CREATE GRAPH g`, `CREATE NODE TABLE`, `CREATE EDGE TABLE` — native graph schema. | 4ч |
-- HTTP endpoints: `/auth/scram/start` + `/auth/scram/finish`
+| 11.1.2 | Adjacency list storage | Ребрата се пазят като adjacency lists (не като отделни LSM редове) за O(1) neighbors access. | 6ч |
-- Резултат: production-grade auth
+| 11.1.3 | Graph indexes | Index на `source→targets` и `target→sources` за bidirectional traversal. | 4ч |
+| 11.1.4 | Graph + RLS integration | `CREATE POLICY` върху graph nodes/edges — tenant isolation за граф данни. | 3ч |
+
+### Фаза 11.2: Advanced Graph Algorithms
+
+| # | Задача | Описание | Оценка | Статус |
+|---|--------|----------|--------|--------|
+| 11.2.1 | `shortest_path()` SQL функция | Dijkstra/A* между два node-а, връща path като JSON array. | 3ч | ✅ |
+| 11.2.2 | `community_detection()` SQL функция | Louvain algorithm, връща community ID за всеки node. | 6ч | ✅ |
+| 11.2.3 | `similarity_nodes()` SQL функция | Jaccard/Adamic-Adar similarity между neighbors. | 3ч | ✅ |
+| 11.2.4 | Vector + Graph hybrid | Node embeddings + graph structure: `node2vec` inference. | 8ч | ✅ |
+
+### Фаза 11.3: Cypher Compatibility Layer
+
+| # | Задача | Описание | Оценка | Статус |
+|---|--------|----------|--------|--------|
+| 11.3.1 | Cypher parser (subset) | `MATCH (a)-[r]->(b) WHERE a.name = 'X' RETURN b` → BaraQL AST. | 6ч | ✅ |
+| 11.3.2 | Cypher → SQL/PGQ translation | `MATCH` → `GRAPH_TABLE(... MATCH ...)` за съвместимост със съществуващ executor. | 4ч | ✅ |
+| 11.3.3 | APOC-style functions | `apoc.path.expand()`, `apoc.coll.*` — полезни utility функции. | 4ч | ✅ |
+
+**Метрика**: Neo4j `movies` example работи с BaraDB Cypher layer без промяна.
 
 ---
 
-## Финални метрики
+## Сесия 12: AI Agents & Natural Language → SQL
 
-| Метрика | Стойност |
+> **Цел**: No-code / low-code AI агенти, които работят директно с BaraDB.
-|---------|----------|
+
-| **Тестове** | 294 — 0 failures ✅ |
+### Фаза 12.1: NL → SQL Agent
-| **Критични бъгове** | 0 ✅ |
+
-| **Високи бъгове** | 0 ✅ |
+| # | Задача | Описание | Оценка | Статус |
-| **Средни бъгове** | 0 ✅ |
+|---|--------|----------|--------|--------|
-| **TLA+ спецификации** | 10 — всички с symmetry reduction ✅ |
+| 12.1.1 | Schema-aware prompt template | Prompt който вкарва `CREATE TABLE` дефиниции + sample data + RLS policies. | 2ч | ✅ |
-| **Build warnings** | 0 ✅ |
+| 12.1.2 | `nl_to_sql()` SQL функция | `SELECT nl_to_sql('Show me top 5 customers by revenue')` → generated SQL string. | 4ч | ✅ |
-| **Security audit** | Всички 🔴 и 🟠 поправени ✅ |
+| 12.1.3 | Query validation layer | Генерираният SQL минава през sandbox execution с `LIMIT 1` + explain plan. | 3ч | ✅ |
-| **Общ брой поправени бъгове** | 32 (9 критични + 7 високи + 12 средни + 4 конфигурационни) |
+| 12.1.4 | Self-correction loop | Ако SQL-ът фейлва, агентът получава error message и генерира fix. | 3ч | ✅ |
-| **Общ брой сесии** | 8 |
+
+### Фаза 12.2: Multi-Tenant AI Agent ✅
+
+| # | Задача | Описание | Оценка | Статус |
+|---|--------|----------|--------|--------|
+| 12.2.1 | Per-tenant schema views | AI агентът вижда само таблици/колони, достъпни за текущия tenant. | 2ч | ✅ |
+| 12.2.2 | Tenant-aware NL → SQL | `app.tenant_id` се инжектира автоматично в генерирания SQL. | 2ч | ✅ |
+| 12.2.3 | Agent memory per tenant | Conversation history се изолира по tenant_id + user_id. | 2ч | ✅ |
 
 ---
 
-## Оставащи задачи (post-v1.0.0, non-critical)
+## Приоритети и зависимости
 
-| # | Задача | Оценка |
+```
-|---|--------|--------|
+Сесия 10 (Vector AI) ──→ Сесия 12 (AI Agents)
-| 1 | Property-based / fuzz tests | 2-4 часа |
+       │                      │
-| 2 | Threadpool deprecation → malebolgia/taskpools | 1-2 часа |
+       ↓                      ↓
+Сесия 11 (Graph) ──────→ Hybrid Vector+Graph
+```
 
-**BaraDB v1.0.0 е production-ready за blogs, e-commerce и small ERP системи.**
+**Препоръчителен ред:**
-**Всички distributed gaps са запълнени: replication, gossip transport, sharding migration, inter-module wiring.**
+1. **Сесия 10.1** — Hybrid RAG Search (най-висок business value)
+2. **Сесия 10.2** — LangChain интеграция (екосистемна съвместимост)
+3. **Сесия 10.3** — MCP Server (AI агенти могат да работят веднага)
+4. **Сесия 11.1** — Native Graph Storage (performance foundation)
+5. **Сесия 11.2** — Advanced Graph Algorithms (feature completeness)
+6. **Сесия 12** — NL → SQL (user-facing wow factor)
+
+---
+
+## Какво остава от старите планове
+
+| Стар план | Статус |
+|-----------|--------|
+| `PLAN_old_1.md` — Base SQL + MVCC + Raft | ✅ Завършен |
+| `PLAN_old_2.md` — Production Roadmap | ✅ Завършен |
+| `PLAN_old_3.md` — Stabilization Sprint (сесия 9) | ✅ Завършен |
+| `PLAN_SQL_ADVANCED.md` — Window Functions, MERGE, etc. | ✅ Завършен |
+| `PLAN_ID_GENERATORS.md` — AUTO_INCREMENT, Sequences, FK | ✅ Завършен |
+| **Този план** — Сесии 10, 11, 12 | ✅ Завършен |
+
+---
+
+## Философия
+
+> BaraDB не добавя "AI модули" — BaraDB става AI-native като вгради embeddings, similarity search, graph traversal и natural language интерфейси в съществуващия SQL engine. Всяка нова функция работи с:
+> - **MVCC транзакции**
+> - **RLS + Multi-tenancy**
+> - **WAL + Replication**
+> - **Nim performance**
+
+---
+
+*План версия: 2026-05-17*

PLAN_DONE.md

@@ -1,190 +0,0 @@
-# BaraDB — Production Roadmap (Minimalist)
-
-> **Goal:** Get BaraDB to production-ready state without feature creep. Only fix what blocks real usage.
-
----
-
-## What Works Now (v0.2.0)
-
-**Core:**
-- CREATE TABLE / INDEX / VIEW / TRIGGER / USER / POLICY
-- SELECT / INSERT / UPDATE / DELETE with WHERE
-- JOIN (inner, left, right, full, cross) — fully tested and executed
-- GROUP BY / HAVING / ORDER BY / LIMIT / OFFSET
-- Aggregate functions (COUNT, SUM, AVG, MIN, MAX)
-- CTE (WITH clause) — parsed; non-recursive execution via subqueries
-- Constraints (PK, FK, UNIQUE, NOT NULL, CHECK, DEFAULT)
-- B-Tree indexes + query planner + index point-read optimization + range scans (BETWEEN, >, <, >=, <=)
-- MVCC transactions (BEGIN / COMMIT / ROLLBACK / savepoints)
-- Deadlock detection (wait-for graph, auto-abort victim) — wired into TxnManager
-- WAL crash recovery (REDO + UNDO)
-- SSTable compaction (manual + background loop) — started on server boot
-
-**Connectivity:**
-- TCP wire protocol with typed binary values (int/float/bool/string/null)
-- HTTP REST API (query, health, metrics, auth)
-- WebSocket real-time (SUBSCRIBE / broadcasts)
-- JWT authentication (HTTP + TCP + WebSocket handshake)
-- Admin Dashboard (SQL playground, table browser, live events, metrics)
-- TLS/SSL for TCP (OpenSSL-backed, self-signed cert generation)
-- Connection limits (max connections enforced + idle timeout)
-- Slow query log (configurable threshold, file-based)
-
-**Operations:**
-- Config file loading (`baradb.json`) + environment variables
-- Structured JSON logging with configurable level/file/format
-- Docker + Docker Compose (dev + production)
-- Backup/restore via tar.gz
-
-**Advanced:**
-- Row-Level Security (policies, GRANT/REVOKE)
-- Schema migrations (UP/DOWN, checksums, locking, dry-run)
-- UTF-8 identifiers + data
-- Nim/Python/Rust/JS client SDKs with full DATA decoding
-- Prepared statements / parameterized queries (placeholder + wire protocol params)
-
----
-
-## Phase A: Critical SQL Execution ✅
-
-### A.1 JOIN Execution ✅
-- JOIN chain built in `lowerSelect`, executed as nested-loop in `executePlan`
-- Inner / left / right / full / cross all supported and tested
-- Aliased column projection + JOIN with aggregates tested
-
-### A.2 CTE Execution 🟡
-- WITH clause is parsed and stored in AST
-- Non-recursive CTE works via subquery execution path
-- Recursive CTE execution not yet implemented
-
----
-
-## Phase B: Production Safety ✅
-
-### B.1 TLS/SSL ✅
-- Real OpenSSL-backed TLS (not mock)
-- `protocol/ssl.nim` uses Nim's `SslContext` (`newContext`, `wrapConnectedSocket`)
-- Self-signed cert generation via openssl CLI
-- Certificate validation (fingerprint, expiry, info parsing)
-
-### B.2 Prepared Statements / Parameterized Queries ✅
-- `nkPlaceholder` in parser/lexer
-- `bindParams` in executor replaces placeholders with typed WireValues
-- Wire protocol `mkQueryParams (0x03)` sends query + typed params
-- Tested: SELECT with placeholders, INSERT with placeholders, multiple placeholders
-
-### B.3 Deadlock Detection Wiring ✅
-- `deadlock.nim` imported into `mvcc.nim`
-- Wait-for graph built on write-write conflict
-- `hasDeadlock()` / `findDeadlockVictim()` called; victim auto-aborted
-- Cleanup on commit / abort
-
----
-
-## Phase C: Operational Stability ✅
-
-### C.1 Background Compaction Scheduling ✅
-- `CompactionManager` wired into `main()` via `asyncCheck cm.startCompactionLoop()`
-- Size-tiered compaction strategy with periodic ticks
-
-### C.2 Connection Limits + Timeouts ✅
-- `maxConnections` enforced in `server.run()` accept loop
-- `activeConnections` tracked (increment on connect, decrement on disconnect)
-- Idle timeout: `recvExactWithTimeout` wraps header/payload reads
-- Config: `idleTimeoutMs` (default 5 min), `queryTimeoutMs` (reserved for async queries)
-
-### C.3 Slow Query Log ✅
-- `slowQueryThresholdMs` config (default 1000ms)
-- `slowQueryLogPath` config (empty = disabled)
-- Queries exceeding threshold logged to file with timestamp, client ID, duration, query text
-
-### C.4 Config File Loading ✅
-- `baradb.json` support with nested sections (server, storage, tls, auth, logging, performance)
-- Environment variable overrides (`BARADB_ADDRESS`, `BARADB_PORT`, `BARADB_DATA_DIR`, etc.)
-- Priority: defaults → JSON file → env vars
-
-### C.5 Structured JSON Logging ✅
-- `logging.nim` module with `debug/info/warn/error` levels
-- Configurable via `logLevel`, `logFile`, `logFormat`
-- Integrated into `server.nim` and `baradadb.nim`
-
----
-
-## Phase D: Nice-to-Have (Post-Production)
-
-| Feature | Why Skip for Now |
-|---------|-----------------|
-| Partitioning | Complex, small DBs don't need it |
-| Full-text search SQL | Engine exists; can use `LIKE` for MVP |
-| Point-in-time recovery | Backup/restore covers 90% of cases |
-| Kubernetes Helm | Docker Compose is enough for solo-dev target |
-| OpenTelemetry tracing | Logs + metrics are enough for v1 |
-| Multi-column indexes | Point reads cover most web queries |
-| Covering index optimization | Premature optimization |
-| Recursive CTE | Rarely used in web apps |
-
----
-
-## Honest Assessment
-
-**Current score: 9.7/10** — all production blockers resolved.
-
-**Remaining polish items (not blockers):**
-1. Recursive CTE execution (WITH RECURSIVE)
-2. Column type metadata in wire protocol serialization (currently inferred heuristically)
-
-**Total estimated work: ~1 focused session.**
-
-BaraDB is production-ready for blogs, e-commerce, and small ERP systems.
-262 tests across 56 suites — all passing. Stress test: 10000 ops, 0 errors, 555K ops/sec.
-
----
-
-## 2026-05-07: Formal Verification v1.0.0
-
-### TLA+ Спецификации (7 спека, 11.6M състояния, 0 грешки)
-- `raft.tla` — Raft consensus (election safety, leader append-only, state-machine safety)
-- `twopc.tla` — Two-Phase Commit (atomicity, coordinator consistency, no orphan blocks)
-- `mvcc.tla` — MVCC/Snapshot Isolation (no dirty reads, read-own-writes, write-write conflict)
-- `replication.tla` — Replication modes (monotonic LSN, sync durability, semi-sync quorum)
-- `gossip.tla` — SWIM Gossip (alive-not-falsely-dead, incarnation monotonicity)
-- `deadlock.tla` — Deadlock Detection (graph integrity, no self-loops)
-- `sharding.tla` — Consistent Hash Sharding (virtual node mapping, assignment consistency)
-
-### Оставащи FV задачи (виж `PLAN.md`)
-- Raft: prevLogIndex/prevLogTerm + LogMatching (критичен gap в модела)
-- 2PC: Coordinator crash/recovery + participant timeout
-- MVCC: Write skew detection
-- Нови спекове: backup.tla, recovery.tla, crossmodal.tla
-- CI: Поправка на verify job (container → setup-java)
-- Symmetry reduction + Liveness properties
-
----
-
-## 2026-05-07: Medium Priority Batch
-
-### JSON/JSONB Types ✅
-- `validateType` валидира JSON при INSERT/UPDATE
-- `fkJson = 0x0D` добавен в `FieldKind`
-- `valueToWire` връща `fkJson` за JSON/JSONB колони
-- Всички 4 клиента обновени за JSON сериализация
-
-### Column Type Metadata в Wire Protocol ✅
-- `typeToFieldKind` helper в `server.nim`
-- `serializeResult` изпраща `colType` bytes след имената на колоните
-- Клиентите четат и пазят `columnTypes`
-
-### Multi-Column Indexes ✅
-- Parser: `CREATE INDEX idx ON t(a, b)` чете списък от колони
-- AST: `nkCreateIndex.ciColumns: seq[string]`
-- Executor: ключ `table.col1.col2`, стойност `val1|val2`
-- INSERT/UPDATE поддържат composite keys
-- SELECT: multi-column exact match за AND chain
-
-### CTE Execution (non-recursive) ✅
-- `tkRecursive` токен в lexer
-- `parseWith` поддържа `WITH RECURSIVE`
-- AST: `selWith: seq[(string, Node, bool)]`
-- Executor: materialization в `ctx.cteTables`
-- `execScan` проверява CTE store преди LSM
-- `defer: ctx.cteTables.clear()` за cleanup

PLAN_old_1.md

@@ -1,155 +0,0 @@
-# План за подобряване на BaraDB
-
-## Цел
-Превърне BaraDB от добър proof-of-concept в солиден, изпълним проект с реална дълбочина на критичните компоненти.
-
----
-
-## Фаза 1: Честност и стабилна основа (1–2 седмици) ✅ ЗАВЪРШЕНА
-
-### 1.1 Поправи `README.md` да отразява реалното състояние
-- ✅ Добавена секция **"Current Status / Limitations"** с конкретни бележки:
-  - LSM-Tree SSTable четене е placeholder
-  - HNSW search е линейно сканиране (O(N))
-  - TCP сървърът връща само "OK", без execution
-  - Raft няма мрежов транспорт
-  - Graph/FTS/Columnar са in-memory само
-- ✅ Променена сравнителната таблица с EdgeDB — маркиран като "в разработка / експериментален"
-
-### 1.2 Поправи компилацията на benchmark-ите
-- ✅ В `benchmarks/bench_all.nim`: заменено `(getMonoTime() - start).ticks` с `(getMonoTime() - start).inNanoseconds`
-- ✅ Добавен `import std/times`
-- ✅ Benchmark-ът се компилира и изпълнява успешно
-
-### 1.3 Имплементирай реално SSTable четене в `storage/lsm.nim`
-**Беше:** `db.get()` намираше ключа в `sst.index`, но връщаше `(true, @[])` — празен масив.
-
-**Сега:**
-- ✅ Дефиниран бинарен SSTable формат (Header → Data Block → Index Block → Bloom Filter Block)
-- ✅ Имплементиран `writeSSTable()` — сериализира MemTable към `.sst` файл
-- ✅ Имплементиран `loadSSTable()` — зарежда съществуващ `.sst` файл чрез `mmap`
-- ✅ Имплементиран `readSSTableEntry()` — чете конкретен ключ от mmap-нат файл
-- ✅ `flush()` вече наистина пише SSTable файл
-- ✅ `newLSMTree()` вече зарежда съществуващи SSTables при стартиране
-- ✅ Добавени `serialize`/`deserialize` на `BloomFilter` за персистентност
-- ✅ Поправен `mmap.nim` да използва `posix.open` вместо грешния `system.open`
-- ✅ Всички 214 теста минават
-- ✅ Persistence тест: write → flush → close → reopen → read работи коректно
-
----
-
-## Фаза 2: Дълбочина на core engine-ите (2–4 седмици)
-
-### 2.1 Реализирай истински HNSW search в `vector/engine.nim` ✅ ЗАВЪРШЕНА
-**Беше:** `search()` правеше линейно сканиране на всички нодове.
-
-**Резултат:**
-- ✅ Имплементиран `randomLevel()` с геометрично разпределение
-- ✅ Имплементиран `searchLayer()` — жадно разширяване на кандидати с `ef` лъч
-- ✅ Имплементиран `selectNeighbors()` + `addBidirectionalLink()` с degree pruning
-- ✅ `insert()` изгражда йерархичен граф ниво по ниво
-- ✅ `search()` слиза от `maxLevel` до 0, рефинирайки entry point
-- ✅ `searchWithFilter()` с пост-филтриране на метаданни
-- ✅ Тестовете за HNSW (insert/search/filter) минават; benchmark-ът с 10K вектора работи
-
-### 2.2 Интегрирай wire protocol в TCP сървъра ✅ ЗАВЪРШЕНА
-**Беше:** `core/server.nim` връщаше `"OK\n"` за всяка заявка.
-
-**Резултат:**
-- ✅ Сървърът чете 12-byte бинарен header (`kind`, `length`, `requestId`) и payload
-- ✅ Имплементиран `recvExact` за надеждно message framing
-- ✅ SELECT: point read (WHERE key = '...') и full memTable scan
-- ✅ INSERT: парсва EdgeDB-style синтаксис и записва в LSM-Tree
-- ✅ DELETE: извлича ключ от WHERE и извиква `db.delete()`
-- ✅ Отговори чрез `mkData`, `mkComplete`, `mkError`, `mkPong`
-- ✅ Добавен `scanMemTable()` в LSM-Tree за пълни сканирания
-- ✅ Всички тестове минават (214+)
-
-### 2.3 Добави персистентност на поне един от Graph/FTS/Columnar ✅ ЗАВЪРШЕНА
-**Изпълнено за Graph engine.**
-
-**Резултат:**
-- ✅ Дефиниран бинарен формат с magic bytes (`BGRF`) и version
-- ✅ `saveToFile(path)` сериализира nodes, edges, properties, weights, next IDs
-- ✅ `loadFromFile(path)` реконструира графа и adjacency lists от edges
-- ✅ Тест "Save and load graph": 3 nodes, 2 edges, properties, shortest path — round-trip успешен
-- ✅ Всички тестове минават (215+)
-
----
-
-## Фаза 3: Production hardening (2–3 седмици)
-
-### 3.1 Thread-safety и concurrency ✅ ЗАВЪРШЕНА
-- ✅ LSM-Tree: конвертиран от `object` на `ref object`, добавен `std/locks.Lock`
-  - Всички публични операции (`put`, `delete`, `get`, `contains`, `flush`, `close`, `scanMemTable`) са опаковани с `acquire`/`release`
-  - Премахнато неизползваното `readLocks: int` поле
-  - Поправени сигнатури в `core/server.nim` от `var LSMTree` на `LSMTree`
-- ✅ Graph: добавен `std/locks.Lock` в `Graph` (вече беше `ref object`)
-  - Всички публични операции (`addNode`, `addEdge`, `removeNode`, `getNode`, `getEdge`, `neighbors`, `inNeighbors`, `bfs`, `dfs`, `shortestPath`, `dijkstra`, `pageRank`, `nodeCount`, `edgeCount`, `saveToFile`) са опаковани с `acquire`/`release`
-  - Поправени вътрешни deadlock-ове (напр. `bfs`/`dfs`/`shortestPath` вече не извикват `neighbors`, а директен достъп до `adjacency`)
-- ✅ Stress тестът (`tests/stress_test.nim`) вече използва `std/threadpool` с `spawn` за паралелни worker-и
-  - 10 worker-а × 1000 ops, 0 грешки, ~833K ops/sec
-
-### 3.2 Raft мрежов транспорт ✅ ЗАВЪРШЕНА
-- ✅ Добавен `RaftNetwork` тип в `core/raft.nim` с `asyncdispatch` + `asyncnet`:
-  - `run()` — слуша за входящи Raft RPC връзки на `raftPort`
-  - `send(peerId, msg)` — изпраща сериализирано съобщение към пиър с persistent TCP socket
-  - `broadcast(msgs)` — изпраща на всички пиъри
-  - `receiveLoop(client)` — framed read (4-byte big-endian length + payload), диспатчва към `handleRequestVote`/`handleAppendEntries`
-  - `heartbeatLoop()` — лидер изпраща `AppendEntries` heartbeat на всеки `heartbeatTimeout`
-  - `stop()` — graceful shutdown
-- ✅ Бинарна сериализация на `RaftMessage` с magic bytes (`RAFT`) + version
-  - `serialize()` / `deserializeRaftMessage()` чрез `std/streams`
-  - Поддържа `LogEntry`, `seq[LogEntry]`, всички reply полета
-- ✅ Peer addressing: `RaftNode.peerAddrs: Table[string, (host, port)]` + `raftPort`
-- ✅ Интеграция с `ElectionTimer`:
-  - `tick(timer, net)` приема optional `RaftNetwork`
-  - При follower/candidate timeout се изпращат реални `RequestVote` съобщения по TCP
-- ✅ Тест "3-node election over TCP" — 3 нода на портове 19001/19002/19003, проверява че точно 1 става лидер
-
-### 3.3 CI/CD и качество ✅ ЗАВЪРШЕНА
-- ✅ Създаден `.github/workflows/ci.yml`:
-  - Пуска `nim c --path:src -r tests/test_all.nim` на всеки push/PR
-  - Компилира `benchmarks/bench_all.nim` в release режим
-  - Компилира и пуска `tests/stress_test.nim`
-  - Проверява за `XDeclaredButNotUsed` и `UnusedImport` като GitHub Actions annotations
-- ✅ Създаден `tests/stress_test.nim`:
-  - 10 worker-а, всеки прави 1000 произволни put/get/delete операции
-  - Всеки worker използва собствена LSMTree инстанция (до Phase 3.1 за thread-safety)
-  - Проверка за data corruption — 0 грешки при 10 000 ops (~143K ops/sec)
-
-### 3.4 Изчисти проекта ✅ ЗАВЪРШЕНА
-- ✅ Изтрити broken/unused файлове:
-  - `src/barabadb/protocol/http.nim` (unused, 5 compile errors)
-  - `src/barabadb/protocol/tls.nim` (unused, 25 errors, overlaps with `ssl.nim`)
-  - `src/barabadb/protocol/websocket.nim` (unused, 14 errors)
-  - `src/barabadb.nim` (6-line dead re-export stub)
-- ✅ Премахнати ~20 unused imports от `src/` модулите
-- ✅ Добавени build artifacts в `.gitignore` (`*.out`, тест/бенчмарк бинарни файлове)
-
----
-
-## Приоритетна матрица
-
-| Задача | Влияние | Трудност | Приоритет |
-|--------|---------|----------|-----------|
-| SSTable реално четене | Критично | Средна | P0 ✅ |
-| README честност | Високо | Ниска | P0 ✅ |
-| HNSW истински search | Високо | Висока | P1 ✅ |
-| Wire protocol в сървъра | Високо | Средна | P1 ✅ |
-| Benchmark fix | Ниско | Ниска | P2 ✅ |
-| Graph персистентност | Средно | Ниска | P2 ✅ |
-| Raft мрежа | Средно | Висока | P2 ✅ |
-| Thread-safety | Средно | Средна | P2 ✅ |
-| CI/CD | Средно | Ниска | P3 ✅ |
-| Изчистване на проекта | Ниско | Ниска | P3 ✅ |
-
----
-
-## Очакван резултат след изпълнение
-
-- **Фаза 1:** Проектът е честен, стабилен и benchmark-ите работят. LSM-Tree е валиден key-value store. ✅
-- **Фаза 2:** HNSW работи с реален approximate search. Сървърът изпълнява заявки. Има персистентност. ✅
-- **Фаза 3:** Многонишкова безопасност, CI, по-чист код. ✅
-
-**Крайна оценка след плана:** от 6.5/10 към 8.5/10.

PLAN_old_2.md

@@ -1,355 +0,0 @@
-# BaraDB — Production Roadmap (Web & ERP)
-
-## Vision
-BaraDB as a production-ready database for:
-- **Web applications** (blogs, e-commerce, SaaS)
-- **Small ERP systems** (CRM, warehouse, accounting, invoicing)
-
-> Target user: solo-dev / small team wanting a fast local DB without PostgreSQL/MySQL dependency.
-
----
-
-## Current State (Baseline)
-
-| Component | Status |
-|-----------|--------|
-| LSM-Tree KV store | Stable, thread-safe, persistent |
-| HNSW vector search | Working, recall > 0.9 |
-| TCP wire protocol | Binary, SELECT/INSERT/DELETE |
-| Raft consensus | TCP transport, leader election |
-| Graph engine | In-memory + persistence |
-| CI/CD | GitHub Actions |
-| Test suite | 60 suites, ~250 tests |
-
-**Critical gaps for production:**
-- Server bypasses IR/codegen/MVCC/schema — `executeQuery()` does lex→parse→raw LSMTree calls
-- INSERT parser incomplete (no VALUES, column list, RETURNING)
-- No CREATE TABLE/ALTER TABLE/DROP TABLE in parser
-- MVCC not wired to query path (no BEGIN/COMMIT/ROLLBACK in server)
-- B-Tree indexes not integrated with LSM-Tree
-- SQL schema system not connected (EdgeQL types only)
-- No HTTP REST API
-- Auth not wired to server
-- No UTF-8 support for identifiers
-
----
-
-## Phase 0: Pipeline Integration & Parser Completion ✅ DONE
-
-### 0.1 Complete DML parser (INSERT/UPDATE/DELETE)
-- INSERT with column list: `INSERT INTO t (c1, c2) VALUES (v1, v2)` ✅
-- INSERT with RETURNING clause ✅ (parsed, executor returns data)
-- UPDATE with RETURNING clause ✅ (parsed)
-- DELETE with RETURNING clause ✅ (parsed)
-- Multiple VALUES rows: `VALUES (v1), (v2), ...` ✅
-
-### 0.2 Add SQL DDL to parser
-- `CREATE TABLE` with column definitions, constraints (PK, FK, UNIQUE, NOT NULL, CHECK, DEFAULT) ✅
-- `ALTER TABLE ADD COLUMN` ✅
-- `DROP TABLE` ✅
-- `CREATE INDEX` / `CREATE UNIQUE INDEX` ✅
-- Tokens: tkCreate, tkTable, tkAlter, tkColumn, tkPrimary, tkKey, tkForeign, tkReferences, tkCascade, tkUnique, tkNotNull, tkCheck, tkDefault, tkRename, tkAdd, tkDrop ✅
-
-### 0.3 SQL-compatible schema system
-- SQL table catalog (separate from EdgeQL type system) ✅
-- Store schema in LSM-Tree (`_schema:migrations:*`) ✅
-- Column type enforcement during INSERT ✅ (INTEGER, FLOAT, BOOLEAN, TIMESTAMP)
-- Schema validation on CREATE TABLE ✅
-
-### 0.4 AST → IR lowering pass
-- Convert Select AST nodes to IR plans (scan → filter → project → sort → limit) ✅
-- Convert Insert AST nodes to IR plans ✅
-- Convert Update/Delete AST nodes to IR plans ✅ (direct execution with WHERE filter)
-- CTE AST nodes ❌ **Parsed but not executed**
-- Lower JOINs to IR join nodes ❌ **Parsed but not lowered**
-
-### 0.5 Codegen → Storage execution
-- Execute StorageOp tree against LSM-Tree ✅ (via executePlan)
-- sokScan: full table scan via `scanMemTable()` ✅
-- sokPointRead: key-based lookup ✅
-- sokFilter: evaluate IR expressions against rows ✅
-- sokProject: column selection ✅
-- sokSort: in-memory sort ✅
-- sokLimit: slice results ✅
-- sokGroupBy: row grouping with count(*) aggregation ✅
-
-### 0.6 Wire server to use pipeline
-- Replace `execSelect/execInsert/execDelete` with pipeline-based execution ✅
-- Server flow: lex → parse → AST→IR lower → executePlan → LSM ✅
-- Keep backward-compatible wire protocol ✅
-- All 56 existing tests still pass ✅
-
----
-
-## Phase 1: Schema & Indexes ✅ DONE
-
-### 1.1 SQL type system
-- `INTEGER`, `BIGINT`, `SMALLINT`, `SERIAL` ✅ (validated on INSERT)
-- `FLOAT`, `REAL`, `DOUBLE PRECISION`, `NUMERIC` ✅ (validated on INSERT)
-- `BOOLEAN` ✅ (validated: true/false/1/0/t/f/yes/no)
-- `TIMESTAMP`, `DATE` ✅ (minimal format validation)
-- `VARCHAR(n)`, `TEXT` ⚠️ (stored, no length enforcement)
-- `JSON`, `JSONB` ❌ **Stored as string**
-- `UUID` (v4 generation) ❌
-
-### 1.2 Constraints enforcement
-- PRIMARY KEY: unique index + NOT NULL ✅
-- FOREIGN KEY: checks referenced row exists on INSERT ✅
-- UNIQUE: unique index via B-Tree ✅
-- NOT NULL: check on INSERT ✅
-- CHECK: parsed ✅ **Expression evaluated on INSERT and UPDATE**
-- DEFAULT: fill missing values on INSERT ✅ (works for all literal types)
-
-### 1.3 B-Tree index integration
-- `CREATE INDEX idx_name ON table(column)` ✅
-- `CREATE UNIQUE INDEX` ✅
-- B-Tree indexes created per PK/UNIQUE column ✅
-- Query planner uses B-Tree for WHERE clauses ✅ (point reads)
-- Range scans via B-Tree leaf linked list ❌ **Not implemented**
-
-### 1.4 Query planner
-- Choose index scan vs full scan based on WHERE clause ✅
-- Multi-column index support ❌
-- Covering index optimization ❌
-- `EXPLAIN` output ✅ (returns plan description with index info)
-- Adaptive query reoptimization ❌ **Module exists, not wired**
-
----
-
-## Phase 2: Transactions ✅ DONE
-
-### 2.1 Wire MVCC into server pipeline
-- `BEGIN`, `COMMIT`, `ROLLBACK` commands ✅
-- Server tracks per-connection Transaction state ✅
-- All reads/writes through TxnManager ✅ (INSERT/DELETE)
-- Isolation: Read Committed ✅
-
-### 2.2 WAL crash recovery
-- Implement REDO: replay committed WAL entries ✅
-- Implement UNDO: skip uncommitted entries ✅
-- Checkpoint markers in WAL ⚠️ (WAL commit markers on flush)
-- Point-in-time recovery ❌
-
-### 2.3 Compaction
-- Implement actual SSTable merge ✅ (reads entries, merges by key, deduplicates, removes tombstones)
-- Level-based compaction strategy ⚠️ (structure exists, manual trigger)
-- Background compaction scheduling ❌
-
-### 2.4 Deadlock detection wiring
-- Wire deadlock detection into TxnManager ❌ **Module exists, never imported**
-
----
-
-## Phase 3: HTTP REST API & Authentication ✅ DONE
-
-### 3.1 HTTP server (hunos)
-- Multi-threaded HTTP/1.1 + HTTP/2 server via hunos ✅
-- `POST /query` — execute SQL, return JSON ✅
-- `GET /health` — readiness/liveness ✅
-- `GET /metrics` — Prometheus format ✅
-- `POST /auth` — JWT login endpoint ✅
-- `GET /api` — OpenAPI 3.0 spec ✅
-- CORS via hunos corsMiddleware ✅
-- Rate limiting via hunos ratelimit ✅
-
-### 3.2 Authentication (jwt-nim-baraba)
-- JWT token creation with HMAC-SHA256 (BearSSL) ✅
-- JWT token verification with time claims ✅
-- `Authorization: Bearer <token>` in HTTP headers ✅
-- `CREATE USER` / `DROP USER` SQL ✅
-- Password hashing with argon2 ❌
-- Per-user namespace isolation ❌
-
-### 3.3 Authorization
-- `GRANT` / `REVOKE` for table-level privileges ✅ (parsed, persisted)
-- Row-Level Security (RLS) ✅ (CREATE/DROP POLICY, ENABLE/DISABLE RLS, policy evaluation in executor)
-- Wire auth into both HTTP and TCP protocol paths ⚠️ **HTTP only**
-
-### 3.4 TLS
-- Wire TLS/SSL ❌ **Mock only, no OpenSSL FFI**
-- Self-signed cert generation ✅ (shells to openssl CLI)
-
----
-
-## Phase 4: WebSocket & Real-time ✅ DONE
-
-### 4.1 WebSocket server
-- `ws://host:port/live` — subscribe to table changes ✅
-- `SUBSCRIBE table_name` / `UNSUBSCRIBE table_name` ✅
-- Push notifications on INSERT/UPDATE/DELETE ✅ **(onChange callback wired to WsServer.broadcastToTable)**
-- `NOTIFY` / `LISTEN` analogue ❌
-
-### 4.2 CORS & HTTP hardening
-- CORS headers for browser access ✅ (via hunos middleware)
-- Request size limits ✅ (via hunos maxBodyLen)
-- HTTP/2 readiness ✅ (via hunos h2c support)
-
----
-
-## Phase 4.5: UTF-8 Support ✅ DONE
-
-### 4.5.1 Storage
-- String values stored as raw bytes ✅ (UTF-8 data transparently stored/retrieved)
-- Wire protocol uses byte-count lengths ✅ (UTF-8 safe)
-
-### 4.5.2 Lexer & Parser
-- UTF-8 identifiers (table names, column names) ✅
-- `std/unicode` with `Rune` based tokenization ✅
-- Multi-byte characters in string literals ✅ (preserved as raw bytes)
-
-### 4.5.3 HTTP
-- `charset=utf-8` in all Content-Type headers ✅
-- `/metrics` → `text/plain; charset=utf-8`
-- `/admin` → `text/html; charset=utf-8`
-- `/query` → `application/json; charset=utf-8` (via hunos)
-
----
-
-## Phase 5: ERP Features ❌ MOSTLY NOT DONE
-
-### 5.1 Schema migrations
-- `CREATE MIGRATION` → `APPLY MIGRATION` ✅ **SQL syntax exists**
-- Versioned schema in `_schema_version` table ⚠️ **Uses _schema:migrations:applied: prefix for tracking**
-- Up/down migration scripts ❌
-- Dry-run mode ❌
-- CLI: `baradadb migrate status|up|down` ❌
-
-### 5.2 Views
-- `CREATE VIEW` — virtual table ✅ **Parsed, executable, persisted to LSM-Tree**
-- `CREATE MATERIALIZED VIEW` ❌
-
-### 5.3 Triggers & stored functions
-- `CREATE TRIGGER` ✅ (BEFORE/AFTER/INSTEAD OF, INSERT/UPDATE/DELETE, persisted to LSM-Tree)
-- `DROP TRIGGER` ✅
-- Trigger firing in executor ✅ (fires in execInsert/execUpdate/execDelete)
-- Stored functions ❌
-- ERP helper functions ❌
-
-### 5.4 Full-text search for ERP documents
-- `CREATE FULLTEXT INDEX ON table(column)` ❌ **FTS engine exists, not wired to SQL**
-- `WHERE content @@ 'search query'` ❌
-
-### 5.5 Partitioning
-- `CREATE TABLE (...) PARTITION BY RANGE (col)` ❌
-
----
-
-## Phase 6: Production Readiness ⚠️ PARTIALLY DONE
-
-### 6.1 Backup & Restore
-- `baradadb backup --output backup.tar.gz` ✅
-- `baradadb restore --input backup.tar.gz` ✅
-- Incremental backup via WAL archiving ❌
-- Point-in-time recovery (PITR) ❌
-
-### 6.2 Docker & deployment
-- `Dockerfile` — multi-stage build with Nim ✅
-- `docker-compose.yml` — single node ✅ (healthcheck via wget)
-- `docker-compose.raft.yml` — 3-node cluster ❌
-- Environment-based config ✅
-
-### 6.3 Monitoring
-- Structured JSON logging ❌ **Uses echo**
-- Prometheus `/metrics` ✅ (basic counters)
-- Slow query log ❌
-- OpenTelemetry tracing ❌
-
-### 6.4 Admin dashboard
-- Inline HTML dashboard ✅ (SQL Playground, Tables browser, Schema, Live WebSocket, Metrics, Cluster)
-- JWT login gate ✅ (localStorage token, auto-login)
-- WebSocket real-time events ✅ (auto-connect, reconnect)
-- Metrics charts ✅ (6 stat boxes + raw Prometheus, auto-refresh)
-- Static file serving ❌
-
-### 6.5 Client SDK improvements
-- Nim client: DATA row decoding ✅, all WireValue types ✅, sync + async ✅
-- Python client: DATA row decoding ✅, all WireValue types ✅
-- Rust client: DATA row decoding ✅, all WireValue types ✅
-- JavaScript client: DATA row decoding ✅, all WireValue types ✅ (ready for socket integration)
-- Go client: ❌ **Removed**
-
----
-
-## Priority Matrix
-
-| Task | Impact | Difficulty | Priority |
-|------|--------|-----------|----------|
-| Pipeline integration (Phase 0) | Critical | High | **P0 ✅** |
-| SQL DDL parser (Phase 0) | Critical | Medium | **P0 ✅** |
-| AST→IR lowering (Phase 0) | Critical | High | **P0 ✅** |
-| Codegen execution (Phase 0) | Critical | High | **P0 ✅** |
-| SQL schema system (Phase 1) | Critical | High | **P0 ✅** |
-| B-Tree index integration (Phase 1) | High | Medium | **P1 ✅** |
-| Constraint enforcement (Phase 1) | High | Medium | **P1 ✅** |
-| MVCC wiring (Phase 2) | Critical | High | **P0 ✅** |
-| WAL recovery (Phase 2) | High | Medium | **P1 ✅** |
-| SSTable compaction (Phase 2) | High | Medium | **P1 ✅** |
-| HTTP REST API (Phase 3) | Critical | Medium | **P0 ✅** |
-| JWT Auth (Phase 3) | High | Medium | **P1 ✅** |
-| WebSocket real-time (Phase 4) | Medium | Medium | **P2 ✅** |
-| Schema migrations (Phase 5) | High | Medium | P1 ✅ |
-| Backup/Restore (Phase 6) | Medium | Medium | **P2 ✅** |
-| Docker + Compose (Phase 6) | Medium | Low | **P2 ✅** |
-| Admin Dashboard (Phase 6) | Medium | High | P2 ✅ |
-| Views + Triggers (Phase 5) | Low | Medium | P3 ✅ |
-| UTF-8 Support | Medium | Low | P2 ✅ |
-| RLS (Phase 3) | High | High | P1 ✅ |
-| Client SDK (Phase 6) | Medium | High | P2 ✅ |
-| Kubernetes Helm (Phase 6) | Low | Medium | P3 ❌ |
-
----
-
-## What Actually Works (Honest)
-
-**Production-ready NOW:**
-- CREATE TABLE with PK, FK, UNIQUE, NOT NULL, DEFAULT, type enforcement
-- CREATE INDEX / CREATE UNIQUE INDEX
-- INSERT INTO ... VALUES with column list, validation, type checking
-- SELECT with WHERE filter (real evaluation), ORDER BY (real sorting), GROUP BY, LIMIT/OFFSET
-- UPDATE with WHERE clause (real row modification)
-- DELETE with WHERE clause (real row deletion with filter)
-- BEGIN / COMMIT / ROLLBACK transactions (MVCC)
-- B-Tree index creation, population, and point reads
-- FOREIGN KEY enforcement (checks referenced row exists)
-- Type enforcement (INTEGER, FLOAT, BOOLEAN, TIMESTAMP validated)
-- LIKE pattern matching (regex)
-- EXPLAIN output with index usage info
-- HTTP REST API via hunos (multi-threaded, CORS, rate limiting)
-- JWT authentication via jwt-nim-baraba (HS256 BearSSL)
-- WebSocket SUBSCRIBE/UNSUBSCRIBE with broadcast on data changes
-- Schema persistence + auto-restore on restart
-- WAL crash recovery (REDO committed, UNDO uncommitted)
-- SSTable compaction (real merge, dedup, tombstone cleanup)
-- Docker + docker-compose deployment
-- Backup/restore via tar.gz
-- OpenAPI 3.0 spec at GET /api
-
-**Partially working:**
-- ALTER TABLE ADD COLUMN (basic, no DROP/RENAME)
-- CTE (WITH clause) — parsed but not executed
-- JOINs — parsed but not executed
-- CHECK constraints — parsed and evaluated on INSERT/UPDATE
-- GRANT/REVOKE — parsed and persisted, but no runtime privilege enforcement (RLS policies work)
-
-**Not yet working:**
-- Schema migrations via SQL (parsed, but no up/down scripts or CLI)
-- WAL point-in-time recovery
-- Background compaction scheduling
-- Deadlock detection wiring
-- TLS/SSL (mock only)
-- Full-text search via SQL
-- Partitioning
-- Prepared statements / parameterized queries in clients
-
----
-
-## Dependencies
-
-| Package | Version | Purpose |
-|---------|---------|---------|
-| [hunos](https://github.com/katehonz/hunos) | >= 1.2.0 | Multi-threaded HTTP/WebSocket server |
-| [jwt-nim-baraba](https://github.com/katehonz/jwt-nim-baraba) | >= 2.1.0 | JWT authentication (HS256 BearSSL) |
-
----
-
-**Honest score: 9.2/10 — production-ready foundation with HTTP server, JWT auth, WAL recovery, compaction, WebSocket real-time, admin dashboard, RLS, triggers, views, UTF-8 support, and working client SDKs. Remaining gaps: CTE execution, JOIN lowering, TLS, full-text search SQL integration, partitioning.**

README.md

@@ -4,17 +4,20 @@
 
 **A multimodal database engine written in Nim — 100% native, zero dependencies.**
 
-[![Version](https://img.shields.io/badge/version-1.1.0-blue.svg)](baradadb.nimble)
+[![Version](https://img.shields.io/badge/version-1.1.6-blue.svg)](baradadb.nimble)
-[![Documentation](https://img.shields.io/badge/docs-7_languages-blue.svg)](docs/index.md)
+[![Documentation](https://img.shields.io/badge/docs-2_languages-blue.svg)](docs/index.md)
+[![Stars](https://img.shields.io/github/stars/katehonz/barabaDB?style=social)](https://github.com/katehonz/barabaDB)
 
 ## Documentation
 
-📖 **[Read the documentation in your language](docs/index.md)** — English, Български, Русский, فارسی, 中文, Türkçe, العربية
+📖 **[Read the documentation in your language](docs/index.md)** — English, Български
 
 BaraDB combines document, graph, vector, columnar, and full-text search storage
 in a single engine with a unified query language (BaraQL). It compiles to a
 single 3.3MB binary with no runtime dependencies.
 
+⭐ Thank you to everyone who continues to star and support BaraDB on [GitHub](https://github.com/katehonz/barabaDB)!
+
 > **Current Status:** BaraDB is a production-ready multimodal database engine.
 > All core storage engines, query processing, and protocol layers are fully
 > implemented and tested. See [Limitations](#current-limitations) below for
@@ -27,8 +30,13 @@ single 3.3MB binary with no runtime dependencies.
 | Core language | Python + Cython + Rust | **100% Nim** |
 | Storage backend | PostgreSQL only | **Native multi-engine** |
 | Vector search | pgvector extension | **Built-in HNSW/IVF-PQ** |
-| Graph algorithms | None | **BFS, DFS, Dijkstra, PageRank, Louvain** |
+| Hybrid RAG search | None | **Vector + FTS + RRF reranking** |
+| Graph algorithms | None | **BFS, DFS, Dijkstra, PageRank, Louvain + Cypher** |
+| Graph SQL integration | None | **CREATE GRAPH, GRAPH_TABLE(), SQL-native** |
 | Full-text search | PG FTS extension | **Built-in BM25 + TF-IDF** |
+| AI Agents / NL→SQL | None | **Built-in `nl_to_sql()`, `schema_prompt()`** |
+| MCP Server | None | **STDIO JSON-RPC for AI tools** |
+| LangChain integration | External adapters | **Native Vector Store (Python + JS)** |
 | Embedded mode | No | **Yes (SQLite-like)** |
 | Binary size | ~50MB+ | **3.3MB** |
 | Dependencies | PostgreSQL, Python, many libs | **Zero** |
@@ -104,7 +112,7 @@ nimble bench
 
 ## BaraQL — Query Language
 
-BaraQL is SQL-compatible with extensions for graph, vector, and document queries.
+BaraQL implements partial SQL:2023 coverage with extensions for graph, vector, and document queries.
 
 ### Basic Queries
 
@@ -285,8 +293,23 @@ let range = btree.scan("key_a", "key_z")
 
 ### Vector Engine
 
-Native HNSW and IVF-PQ indexes for similarity search.
+Native HNSW and IVF-PQ indexes for similarity search with full SQL integration.
 
+```sql
+-- SQL vector search
+CREATE TABLE items (id INT PRIMARY KEY, embedding VECTOR(768));
+INSERT INTO items (id, embedding) VALUES (1, '[0.1, 0.2, 0.3, ...]');
+
+-- Nearest neighbor search
+SELECT id FROM items
+ORDER BY cosine_distance(embedding, '[0.1, 0.2, 0.3, ...]') ASC
+LIMIT 10;
+
+-- With HNSW index
+CREATE INDEX idx_vec ON items(embedding) USING hnsw;
+```
+
+Native Nim API:
 ```nim
 import barabadb/vector/engine
 
@@ -301,12 +324,38 @@ let filtered = idx.searchWithFilter(queryVector, k = 10,
 ```
 
 Features:
-- **HNSW** — hierarchical navigable small world graph
+- **SQL vector types** — `VECTOR(n)` with dimension validation
+- **SQL distance functions** — `cosine_distance()`, `euclidean_distance()`, `inner_product()`, `l1_distance()`, `l2_distance()`
+- **`<->` operator** — Euclidean distance nearest-neighbor shorthand
+- **HNSW index** — `CREATE INDEX ... USING hnsw` with automatic maintenance
 - **IVF-PQ** — inverted file index with product quantization
 - **Distance metrics** — cosine, euclidean, dot product, Manhattan
 - **Quantization** — scalar 8-bit/4-bit, product, binary
 - **Metadata filtering** — filter results by key-value pairs
 
+### Hybrid RAG Search
+
+Combine vector similarity with full-text search and reciprocal rank fusion (RRF):
+
+```sql
+-- Hybrid search: vector + FTS reranked with RRF
+SELECT hybrid_search('articles', 'embedding', 'body',
+                     'machine learning', '[0.1, 0.2, ...]', 10) AS results;
+
+-- With metadata pre-filtering (tenant isolation)
+SELECT hybrid_search_filtered('articles', 'embedding', 'body',
+                              'AI trends', '[0.1, 0.2, ...]', 10,
+                              'tenant_id', 'company-a') AS results;
+
+-- Re-rank existing results
+SELECT rerank('machine learning', '[{"id":"1","score":"0.9"}, ...]') AS boosted;
+```
+
+Features:
+- **Reciprocal Rank Fusion** — merges HNSW vector and BM25 FTS rankings
+- **Metadata pre-filtering** — HNSW search with relational column filters
+- **SQL functions** — `hybrid_search()`, `hybrid_search_ids()`, `hybrid_search_filtered()`, `rerank()`
+
 ### Graph Engine
 
 Adjacency list storage with built-in algorithms.
@@ -332,6 +381,158 @@ Algorithms:
 - **PageRank** — node importance ranking
 - **Louvain** — community detection
 - **Pattern matching** — subgraph isomorphism search
+- **Similarity** — Jaccard / Adamic-Adar node similarity
+- **node2vec** — random-walk graph embeddings
+
+### Graph SQL Integration
+
+Graph data is queryable directly through BaraQL with `CREATE GRAPH`, `GRAPH_TABLE()`, and Cypher translation:
+
+```sql
+-- Create a native graph
+CREATE GRAPH social_network;
+
+-- Query via GRAPH_TABLE with algorithms
+SELECT * FROM GRAPH_TABLE(
+  social_network,
+  MATCH (u:User)-[:KNOWS]->(f:User)
+  ALGORITHM BFS
+  START u.id = 1
+  MAXDEPTH 3
+);
+
+-- Translate Cypher to BaraQL SQL
+SELECT cypher('MATCH (u:User)-[:KNOWS]->(f) RETURN f.name') AS result;
+```
+
+Features:
+- **Native graph DDL** — `CREATE GRAPH` / `DROP GRAPH`
+- **SQL GRAPH_TABLE** — `MATCH`, `ALGORITHM`, `START`, `END`, `MAXDEPTH`
+- **Auto-sync** — INSERT into `_nodes` / `_edges` syncs adjacency lists
+- **Cypher layer** — `cypher()` SQL function translates `MATCH...RETURN` to BaraQL
+
+## AI-Native Data Platform
+
+BaraDB is the first database engine with built-in AI primitives — not bolted-on, but native to the query engine. RAG pipelines, LLM integration, and AI agent tools run inside the database with full multi-tenant RLS isolation.
+
+### Natural Language → SQL
+
+Ask questions in plain English (or any language) and get executable BaraQL:
+
+```sql
+-- Generate SQL from natural language
+SELECT nl_to_sql('Show me the top 5 customers by total orders') AS query;
+
+-- Schema-aware prompt for LLM context
+SELECT schema_prompt('orders') AS context;
+```
+
+Features:
+- **Schema-aware** — includes table definitions, indexes, RLS policies in the prompt
+- **Validation layer** — wraps generated SQL in `LIMIT 0` to verify syntax before returning
+- **Self-correction** — on error, feeds the error back to the LLM for an automatic fix
+- **Tenant-aware** — respects `app.tenant_id` session variables
+- **OpenAI + Ollama** — configurable via `BARADB_LLM_ENDPOINT`, `BARADB_LLM_MODEL`, `BARADB_LLM_API_KEY`
+
+### Text Chunking & Auto-Embedding
+
+Built-in text chunking and embedding generation for RAG pipelines:
+
+```sql
+-- Chunk text into overlapping pieces
+SELECT chunk(long_article, 1024, 128) AS chunks;
+
+-- Generate embeddings via external API (OpenAI / Ollama)
+SELECT embed_text('Hello world') AS vector;
+```
+
+Features:
+- **chunk() SQL function** — recursive splitting by paragraph, sentence, or fixed size
+- **embed_text() SQL function** — HTTP embedding client with configurable endpoint
+- **Auto-embedding on INSERT** — when a `VECTOR` column is NULL but `TEXT` is present, embeddings generate automatically
+- **Configurable** via `BARADB_EMBED_ENDPOINT`, `BARADB_EMBED_MODEL`, `BARADB_EMBED_API_KEY`
+
+### MCP Server (Model Context Protocol)
+
+BaraDB exposes an MCP server over STDIO for AI agent integration:
+
+```bash
+./build/baramcp
+```
+
+Tools available to AI agents:
+- **query** — execute parameterized BaraQL with RLS isolation
+- **vector_search** — semantic HNSW search with metadata filtering
+- **schema_inspect** — explore tables, columns, indexes, and RLS policies
+
+```json
+{
+  "name": "vector_search",
+  "arguments": {
+    "table": "docs",
+    "column": "embedding",
+    "query_vector": [0.1, 0.2, ...],
+    "k": 10,
+    "tenant_id": "company-a"
+  }
+}
+```
+
+### LangChain Integration
+
+Native Vector Store implementations for Python and JavaScript:
+
+**Python:**
+```python
+from baradb.langchain_store import BaraDBStore
+
+store = BaraDBStore(
+    client=client,
+    table="docs",
+    embedding_function=OpenAIEmbeddings().embed_query,
+    tenant_id="company-a"
+)
+await store.add_texts(["hello world", "quick brown fox"])
+results = await store.similarity_search("hello", k=5)
+```
+
+**JavaScript:**
+```javascript
+const { BaraDBStore } = require('./baradb_langchain');
+
+const store = new BaraDBStore({
+  client,
+  table: 'docs',
+  embeddingFunction: async (text) => [...],
+  tenantId: 'company-a'
+});
+await store.addDocuments([{ pageContent: 'hello world' }]);
+const results = await store.similaritySearch('hello', 5);
+```
+
+Features:
+- **Hybrid search** — uses `hybrid_search()` / `hybrid_search_filtered()` under the hood
+- **MMR reranking** — `max_marginal_relevance_search()` for diverse results
+- **Multi-tenant** — respects `tenant_id` with RLS isolation
+- **Metadata filters** — pre-filter vector search by relational columns
+
+### Chat Message History
+
+Store conversation threads in BaraDB with RLS isolation:
+
+```python
+from baradb.chat_history import BaraDBChatHistory
+
+history = BaraDBChatHistory(
+    client=client,
+    session_id="session-123",
+    tenant_id="company-a",
+    user_id="user-42"
+)
+history.add_user_message("Hello, AI!")
+history.add_ai_message("Hello, how can I help?")
+messages = history.messages
+```
 
 ### Full-Text Search
 
@@ -606,6 +807,23 @@ See [docs/en/docker.md](docs/en/docker.md) for full Docker documentation.
 | `BARADB_CERT_FILE` | — | TLS certificate path |
 | `BARADB_KEY_FILE` | — | TLS private key path |
 
+## Built with BaraDB
+
+### NodeBara
+
+**[NodeBara](https://codeberg.org/baraDB/nodebara)** is the first large-scale application running on BaraDB — a modern forum platform forked from NodeBB and fully adapted for BaraDB's native multimodal engine.
+
+- **Concurrent query safety** — TCP request queue in the JS client handles NodeBara's parallel startup queries without frame corruption
+- **Numeric accuracy** — Big-endian float serialization guarantees correct zset scores, timestamps, and rankings across platforms
+- **Non-blocking cluster gossip** — Async UDP sockets keep the event loop free under load
+
+```bash
+git clone https://codeberg.org/baraDB/nodebara
+cd nodebara
+npm install
+npm run setup   # uses BaraDB as the default database
+```
+
 ## Client SDKs
 
 BaraDB provides official clients for multiple languages:
@@ -1189,7 +1407,13 @@ src/barabadb/
 ├── graph/
 │   ├── engine.nim        # Adjacency-list graph + BFS/DFS/Dijkstra/PageRank
 │   ├── community.nim     # Louvain community detection
-│   └── cypher.nim        # Cypher-like graph query parser
+│   └── cypher.nim        # Cypher-to-SQL translator + query parser
+├── ai/
+│   ├── llm.nim           # LLM client for NL→SQL (OpenAI / Ollama)
+│   ├── chunk.nim         # Text chunking for RAG pipelines
+│   └── embed.nim         # HTTP embedding client (OpenAI / Ollama)
+├── mcp/
+│   └── server.nim        # MCP STDIO server (JSON-RPC 2.0 AI tools)
 ├── fts/
 │   ├── engine.nim        # Inverted index + BM25 + TF-IDF
 │   └── multilang.nim     # Tokenizers for EN, BG, DE, FR, RU
@@ -1214,7 +1438,7 @@ src/barabadb/
 ## Tests
 
 ```bash
-# Run all tests (262 tests, 56 suites)
+# Run all tests (340+ tests, 60+ suites)
 nim c --path:src -r tests/test_all.nim
 
 # Run benchmarks
@@ -1232,6 +1456,7 @@ nim c -d:release -r benchmarks/bench_all.nim
 | Protocol (binary + HTTP + WS + pool + auth + ratelimit) | ✅ | 100% | v1.0.0 |
 | Schema (inheritance + computed + migrations) | ✅ | 100% | v1.0.0 |
 | Vector engine (HNSW + IVF-PQ + quant + SIMD + metadata) | ✅ | 100% | v1.0.0 |
+| Vector SQL Integration (VECTOR type, distance functions, <->, HNSW indexes) | ✅ | 100% | v1.1.6 |
 | Graph engine (all algorithms + pattern matching) | ✅ | 100% | v1.0.0 |
 | FTS (BM25 + TF-IDF + fuzzy + regex + multi-language) | ✅ | 100% | v1.0.0 |
 | CLI shell | ✅ | 100% | v1.0.0 |
@@ -1239,6 +1464,13 @@ nim c -d:release -r benchmarks/bench_all.nim
 | Cross-modal queries | ✅ | 100% | v1.0.0 |
 | Backup & Recovery | ✅ | 100% | v1.0.0 |
 | Client SDKs (JS, Python, Nim, Rust) | ✅ | 100% | v1.0.0 |
+| Graph SQL Integration (CREATE GRAPH, GRAPH_TABLE, Cypher) | ✅ | 100% | v1.1.6 |
+| Hybrid RAG Search (vector + FTS + RRF reranking) | ✅ | 100% | v1.1.6 |
+| AI Chunking & Auto-Embedding (`chunk()`, `embed_text()`) | ✅ | 100% | v1.1.6 |
+| NL→SQL (`nl_to_sql()`, `schema_prompt()`) | ✅ | 100% | v1.1.6 |
+| MCP Server (STDIO JSON-RPC for AI agents) | ✅ | 100% | v1.1.6 |
+| LangChain Vector Store (Python + JS) | ✅ | 100% | v1.1.6 |
+| Production Hardening (prop tests, fuzz tests, thread safety) | ✅ | 100% | v1.1.6 |
 
 ## Current Limitations
 

ROADMAP.md

@@ -1,202 +0,0 @@
-# BaraDB — Мултимодална база данни на Nim
-
-> По-добра от GEL (EdgeDB) — нативна мултимодалност, без Python, без PostgreSQL зависимост
-
-## Защо BaraDB > GEL?
-
-| Критерий | GEL (EdgeDB) | BaraDB |
-|---|---|---|
-| Език на ядрото | Python + Cython + Rust | **100% Nim** |
-| Storage backend | Само PostgreSQL | **Нативен multi-engine** |
-| Векторно търсене | pgvector (разширение) | **Нативен HNSW/IVF-PQ** |
-| Graph алгоритми | Няма | **Нативни (BFS, PageRank, ...)** |
-| Full-Text Search | pg FTS (разширение) | **Нативен инвертиран индекс** |
-| Embedded режим | Не | **Да (като SQLite)** |
-| Кompилация към WASM | Не | **Да** |
-| Транзакции cross-modal | Чрез PG | **Нативен 2PC** |
-| Протокол | Binary + PG wire + HTTP | **Binary + HTTP/WS + gRPC** |
-| Schema миграции | Декларативни (тежки) | **Автоматични + версия** |
-
----
-
-## Архитектура
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                     КЛИЕНТСКИ СЛОЙ                          │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐ │
-│  │ Binary   │  │ HTTP/REST│  │WebSocket │  │  Embedded   │ │
-│  │ Protocol │  │ JSON API │  │  Stream  │  │  (in-proc)  │ │
-│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────┬──────┘ │
-├───────┼──────────────┼────────────┼────────────────┼────────┤
-│                ЗАПИТЕН СЛОЙ (BaraQL)                         │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐ │
-│  │ Лексер   │──│ Парсер   │──│ Анализ   │──│ Оптимизатор │ │
-│  │          │  │ (AST)    │  │ (IR)     │  │ (Plan)      │ │
-│  └──────────┘  └──────────┘  └──────────┘  └─────────────┘ │
-├─────────────────────────────────────────────────────────────┤
-│                ИЗПЪЛНИТЕЛЕН ДВИГАТЕЛ                         │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐ │
-│  │ Document │  │  Graph   │  │  Vector  │  │  Columnar   │ │
-│  │ Engine   │  │  Engine  │  │  Engine  │  │  Engine     │ │
-│  │ (JSON/B) │  │ (AdjList)│  │ (HNSW)  │  │ (Arrow)     │ │
-│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────┬──────┘ │
-├───────┼──────────────┼────────────┼────────────────┼────────┤
-│                STORAGE СЛОЙ                                 │
-│  ┌─────────────────────────────────────────────────────────┐│
-│  │  LSM-Tree Storage Engine                                ││
-│  │  ┌────────┐  ┌────────┐  ┌────────┐  ┌──────────────┐ ││
-│  │  │MemTable│  │WAL     │  │SSTable │  │Bloom Filter  │ ││
-│  │  └────────┘  └────────┘  └────────┘  └──────────────┘ ││
-│  └─────────────────────────────────────────────────────────┘│
-│  ┌─────────────────────────────────────────────────────────┐│
-│  │  Транзакции: MVCC + 2PC + Deadlock Detection            ││
-│  └─────────────────────────────────────────────────────────┘│
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Пътна карта (Roadmap)
-
-### Фаза 1: Ядро на базата данни ✅
-- [x] LSM-Tree storage engine (MemTable, WAL, SSTable)
-- [x] Bloom filter за бързо отхвърляне
-- [x] Типова система (int, float, string, bool, bytes, uuid, datetime, json, vector)
-- [x] Сериялизация на записите
-- [x] B-Tree индекс за точкови заявки
-- [x] Компактиране на SSTable (compaction strategies)
-- [x] Page cache и buffer pool (LRU)
-
-### Фаза 2: Език за заявки — BaraQL 🟡
-- [x] Лексер с Unicode поддръжка
-- [x] Рекурсивен парсер → AST
-- [x] SELECT, INSERT, UPDATE, DELETE
-- [x] WHERE, ORDER BY, LIMIT, OFFSET
-- [x] Бинарни оператори (+, -, *, /, =, !=, <, >, AND, OR, NOT)
-- [x] Подзаявки и EXISTS
-- [x] Array литерали
-- [x] Типов анализатор (type checker)
-- [x] IR (Intermediate Representation)
-- [x] Оптимизатор на заявки (predicate pushdown, projection pushdown)
-- [x] GROUP BY, HAVING
-- [x] JOIN (inner, left, right, full, cross)
-- [x] CTE (WITH)
-- [x] Агрегатни функции (count, sum, avg, min, max)
-- [x] Codegen — IR → storage операции (predicate pushdown, cost estimation)
-- [x] Потребителски функции (UDF) — stdlib + custom
-
-### Фаза 3: Мултимодален storage 🟡
-- [x] Документен engine — вложени JSON документи, масиви, вложени обекти
-- [x] Граф engine — adjacency list, edge properties, incident index
-- [x] Векторен engine — float32 arrays, distance metrics
-- [x] Колонен engine — column-oriented storage за analytics (RLE, dict encoding, GroupBy)
-- [x] Унифициран query interface през BaraQL (CrossModalEngine)
-- [x] Cross-modal заявки (document + vector + graph в една заявка) — hybridSearch
-
-### Фаза 4: Транзакции и ACID ✅
-- [x] WAL (Write-Ahead Log) за durability
-- [x] MVCC (Multi-Version Concurrency Control)
-- [x] Snapshot isolation
-- [x] Deadlock detection (wait-for graph)
-- [x] Savepoints и вложени транзакции
-- [x] 2PC за cross-modal транзакции (TPCTransaction)
-- [x] Recovery при crash (REDO/UNDO) — WAL replay + analysis
-
-### Фаза 5: Мрежов протокол ✅
-- [x] TCP сървър с async I/O
-- [x] Binary протокол (BaraDB Wire Protocol)
-- [x] HTTP/REST API (JSON)
-- [x] Connection pooling
-- [x] Authentication (JWT, SCRAM-SHA-256)
-- [x] WebSocket за streaming
-- [x] Rate limiting (token bucket, sliding window)
-- [x] TLS/SSL (certificate management, self-signed generation)
-
-### Фаза 6: Schema система ✅
-- [x] Декларативна schema (SDL)
-- [x] Object types с properties
-- [x] Links между типове (1:1, 1:N, N:M)
-- [x] Наследоване и mixins
-- [x] Constraints (unique, check, required)
-- [x] Computed properties
-- [x] Автоматични миграции (schema diff)
-- [x] Версиониране на schema
-
-### Фаза 7: Векторен engine ✅
-- [x] HNSW индекс (Hierarchical Navigable Small World)
-- [x] IVF-PQ индекс (Inverted File + Product Quantization)
-- [x] Дистанционни метрики (cosine, euclidean, dot product, Manhattan)
-- [x] Квантизация (scalar 8-bit/4-bit, product, binary)
-- [x] Metadata filtering при vector search
-- [x] Batch insert/update (batchInsert, batchSearch)
-- [x] Автоматичен index rebuild при threshold (IndexWatcher)
-
-### Фаза 8: Graph engine ✅
-- [x] Adjacency list storage
-- [x] Edge properties и weights
-- [x] BFS (Breadth-First Search)
-- [x] DFS (Depth-First Search)
-- [x] Най-къс път (Dijkstra)
-- [x] PageRank
-- [x] Community detection (Louvain)
-- [x] Pattern matching (subgraph isomorphism)
-- [x] Cypher-подобен query syntax (parseCypher, executeCypher)
-
-### Фаза 9: Full-Text Search ✅
-- [x] Инвертиран индекс
-- [x] Токенизация (Unicode, stemming, stop words)
-- [x] BM25 ранкиране
-- [x] Highlight на резултати
-- [x] TF-IDF ранкиране
-- [x] Fuzzy matching (Levenshtein)
-- [x] Regex търсене (wildcard patterns)
-- [x] Многоезикова поддръжка (EN, BG, DE, FR, RU)
-
-### Фаза 10: Клиентски библиотеки и CLI ✅
-- [x] CLI tool (bara shell) — интерактивен shell + autocomplete
-- [x] Nim client library (standalone nimble package — async/sync, query builder)
-- [x] Python client library (clients/python/baradb.py — binary protocol)
-- [x] JavaScript/TypeScript client library (clients/javascript/baradb.js)
-- [x] Rust client library (clients/rust/)
-- [x] Import/Export (JSON, CSV, NDJSON)
-
-### Фаза 11: Кластеризация и разпределение ✅
-- [x] Raft консенсус протокол (leader election + log replication)
-- [x] Sharding (hash-based, range-based, consistent hashing)
-- [x] Replication (sync, async, semi-sync)
-- [x] Gossip protocol за membership (GossipProtocol)
-- [x] Distributed transactions (DistTxnManager + Saga pattern)
-- [x] Auto-rebalancing (ClusterMembership — onNodeJoin/Leave/Fail)
-- [x] Leader election timer loop (ElectionTimer — tick/check/reset)
-
-### Фаза 12: Оптимизации, бенчмаркове, документация ✅
-- [x] SIMD оптимизации за vector operations (unrolled loops, batch distance)
-- [x] Memory-mapped I/O (mmap + madvise hints)
-- [x] Zero-copy serialization (ZeroBuf + ZcSchema)
-- [x] Adaptive query execution (AdaptivePlanner + ExecutionContext)
-- [x] Бенчмаркове vs PostgreSQL, Redis, MongoDB (benchmarks/compare.nim)
-- [x] API документация (README.md — full API reference with examples)
-- [x] Архитектурна документация (docs/ARCHITECTURE.md)
-- [x] Tutorial и примери (examples/tutorial.nim — 8 tutorials)
-
----
-
-## Статус
-
-| Фаза | Статус | Напредък |
-|------|--------|----------|
-| 1. Ядро | ✅ | 100% |
-| 2. BaraQL | ✅ | 100% |
-| 3. Мултимодален storage | ✅ | 100% |
-| 4. Транзакции | ✅ | 100% |
-| 5. Протокол | ✅ | 100% |
-| 6. Schema | ✅ | 100% |
-| 7. Векторен engine | ✅ | 100% |
-| 8. Graph engine | ✅ | 100% |
-| 9. FTS | ✅ | 100% |
-| 10. Клиенти и CLI | ✅ | 100% |
-| 11. Кластер | ✅ | 100% |
-| 12. Оптимизации | ✅ | 100% |
-
-**Легенда:** ⬜ Не стартирана | 🟡 В процес | ✅ Завършена

adaptors/nim/baradb_sqlite.nim

@@ -0,0 +1,176 @@
+## BaraDB adapter mimicking db_sqlite API for NimForum
+
+import std/strutils, std/parseutils, std/times
+import ../../clients/nim/src/baradb/client as baradb_client
+
+type
+  DbError* = object of CatchableError
+  SqlQuery* = distinct string
+  DbConn* = distinct pointer
+
+proc sql*(query: string): SqlQuery =
+  SqlQuery(query)
+
+proc dbError*(msg: string) {.noreturn.} =
+  var e: ref DbError
+  new(e)
+  e.msg = msg
+  raise e
+
+proc dbQuote*(s: string): string =
+  result = "'"
+  for c in items(s):
+    if c == '\'': add(result, "''")
+    else: add(result, c)
+  add(result, '\'')
+
+proc preprocessQuery(q: string): string =
+  ## Replace SQLite-specific expressions with BaraDB-compatible equivalents.
+  result = q
+  let nowStr = format(now(), "yyyy-MM-dd HH:mm:ss")
+  result = result.replace("TIMESTAMP", "DATETIME")
+  result = result.replace("timestamp", "DATETIME")
+  result = result.replace("DATETIME('now')", "'" & nowStr & "'")
+  result = result.replace("datetime('now')", "'" & nowStr & "'")
+  result = result.replace("INET", "STRING")
+  result = result.replace("inet", "STRING")
+
+proc dbFormat*(formatstr: SqlQuery, args: varargs[string]): string =
+  var res = ""
+  var a = 0
+  for c in items(string(formatstr)):
+    if c == '?':
+      if a == args.len:
+        dbError("""The number of \"?\" given exceeds the number of parameters present in the query.""")
+      add(res, dbQuote(args[a]))
+      inc(a)
+    else:
+      add(res, c)
+  result = preprocessQuery(res)
+
+proc toClient(db: DbConn): SyncClient =
+  cast[SyncClient](db)
+
+proc open*(connection, user, password, database: string): DbConn =
+  var config = defaultConfig()
+  if connection.contains(':'):
+    let parts = connection.split(':')
+    config.host = parts[0]
+    config.port = parseInt(parts[1])
+  elif connection.len > 0 and not connection.endsWith(".db"):
+    config.host = connection
+  config.database = database
+  config.username = user
+  config.password = password
+  var client = newSyncClient(config)
+  client.connect()
+  GC_ref(client)
+  return cast[DbConn](client)
+
+proc close*(db: DbConn) =
+  let client = toClient(db)
+  baradb_client.close(client)
+  GC_unref(client)
+
+proc exec*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]) =
+  let client = toClient(db)
+  let q = dbFormat(query, args)
+  discard client.query(q)
+
+proc tryExec*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): bool =
+  try:
+    let client = toClient(db)
+    let q = dbFormat(query, args)
+    discard client.query(q)
+    return true
+  except:
+    return false
+
+proc getRow*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): seq[string] =
+  let client = toClient(db)
+  let q = dbFormat(query, args)
+  let qr = client.query(q)
+  if qr.rows.len > 0:
+    return qr.rows[0]
+  else:
+    return @[]
+
+proc getAllRows*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): seq[seq[string]] =
+  let client = toClient(db)
+  let q = dbFormat(query, args)
+  let qr = client.query(q)
+  return qr.rows
+
+proc getValue*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): string =
+  let row = getRow(db, query, args)
+  if row.len > 0: return row[0]
+  return ""
+
+iterator fastRows*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): seq[string] =
+  let client = toClient(db)
+  let q = dbFormat(query, args)
+  let qr = client.query(q)
+  for row in qr.rows:
+    yield row
+
+iterator rows*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): seq[string] =
+  for r in fastRows(db, query, args): yield r
+
+proc insertID*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): int64 =
+  let client = toClient(db)
+  let q = dbFormat(query, args)
+  discard client.query(q)
+  let sqlStr = string(query).strip().toLower()
+  var tableName = ""
+  if sqlStr.startsWith("insert into "):
+    let rest = sqlStr[12..^1]
+    let spacePos = rest.find(' ')
+    if spacePos > 0:
+      tableName = rest[0..<spacePos]
+  if tableName.len > 0:
+    let idQr = client.query("SELECT max(id) FROM " & tableName)
+    if idQr.rows.len > 0 and idQr.rows[0].len > 0:
+      let val = idQr.rows[0][0]
+      if val.len > 0 and val != "\\N":
+        try:
+          return parseInt(val).int64
+        except:
+          discard
+  return -1
+
+proc tryInsertID*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): int64 =
+  try:
+    return insertID(db, query, args)
+  except:
+    return -1
+
+proc nextId*(db: DbConn, tableName: string): int64 =
+  let client = toClient(db)
+  let qr = client.query("SELECT max(id) FROM " & tableName)
+  if qr.rows.len > 0 and qr.rows[0].len > 0:
+    let val = qr.rows[0][0]
+    if val.len > 0 and val != "\\N":
+      try:
+        let current = parseInt(val)
+        return current.int64 + 1
+      except:
+        return 1
+  return 1
+
+proc execAffectedRows*(db: DbConn, query: SqlQuery, args: varargs[string, `$`]): int64 =
+  let client = toClient(db)
+  let q = dbFormat(query, args)
+  let qr = client.query(q)
+  return qr.affectedRows.int64
+
+proc dbBegin*(db: DbConn) =
+  let client = toClient(db)
+  discard client.query("BEGIN")
+
+proc dbCommit*(db: DbConn) =
+  let client = toClient(db)
+  discard client.query("COMMIT")
+
+proc dbRollback*(db: DbConn) =
+  let client = toClient(db)
+  discard client.query("ROLLBACK")

adaptors/nim/test_baradb_adapter.nim

@@ -0,0 +1,21 @@
+import baradb_sqlite
+
+var db = open("127.0.0.1:9472", "", "", "default")
+
+db.exec(sql"CREATE TABLE test_adapter (id INT PRIMARY KEY, name STRING)")
+db.exec(sql"INSERT INTO test_adapter (id, name) VALUES (1, 'hello')")
+db.exec(sql"INSERT INTO test_adapter (id, name) VALUES (2, 'world')")
+
+let rows = db.getAllRows(sql"SELECT * FROM test_adapter")
+echo "All rows: ", rows
+
+let row = db.getRow(sql"SELECT * FROM test_adapter WHERE id = 1")
+echo "Row 1: ", row
+
+let val = db.getValue(sql"SELECT name FROM test_adapter WHERE id = 2")
+echo "Value: ", val
+
+let cnt = db.getValue(sql"SELECT count(*) FROM test_adapter")
+echo "Count: ", cnt
+
+db.close()

baradadb.nimble

@@ -1,27 +1,29 @@
 # Package
-version       = "1.1.0"
+version       = "1.1.6"
 author        = "BaraDB Team"
 description   = "BaraDB — Multimodal database written in Nim"
 license       = "Apache-2.0"
 srcDir        = "src"
-bin           = @["baradadb"]
+bin           = @["baradadb", "baramcp"]
 binDir        = "build"
 
 # Dependencies
 requires "nim >= 2.2.0"
-requires "https://github.com/katehonz/hunos >= 1.2.0"
+requires "https://github.com/katehonz/hunos >= 1.3.0"
-requires "jwt >= 0.3.0"
+requires "https://github.com/katehonz/jwt-nim-baraba >= 2.1.0"
 requires "checksums >= 0.2.0"
 
 # Tasks
 task build_debug, "Build debug version":
-  exec "nim c -d:ssl --threads:on --debugger:native --linedir:on -o:build/baradadb src/baradadb.nim"
+  exec "nim c --debugger:native --linedir:on -o:build/baradadb src/baradadb.nim"
+  exec "nim c --debugger:native --linedir:on -o:build/baramcp src/baramcp.nim"
 
 task build_release, "Build release version":
-  exec "nim c -d:ssl --threads:on -d:release --opt:speed -o:build/baradadb src/baradadb.nim"
+  exec "nim c -d:release --opt:speed -o:build/baradadb src/baradadb.nim"
+  exec "nim c -d:release --opt:speed -o:build/baramcp src/baramcp.nim"
 
 task test, "Run all tests":
-  exec "nim c --path:src -d:ssl --threads:on -r tests/test_all.nim"
+  exec "nim c -r tests/test_all.nim"
 
 task bench, "Run benchmarks":
-  exec "nim c --path:src -d:ssl --threads:on -d:release -r benchmarks/bench_all.nim"
+  exec "nim c -d:release -r benchmarks/bench_all.nim"

benchmarks/bench_all.nim

@@ -1,9 +1,11 @@
 ## BaraDB Benchmarks — performance tests for all engines
 import std/monotimes
 import std/times
-import std/tables
 import std/random
 import std/strutils
+import std/os
+import std/osproc
+import std/json
 import ../src/barabadb/storage/lsm
 import ../src/barabadb/storage/btree
 import ../src/barabadb/vector/engine as vengine
@@ -11,6 +13,89 @@ import ../src/barabadb/vector/simd
 import ../src/barabadb/fts/engine as fts
 import ../src/barabadb/graph/engine as gengine
 
+# ═══════════════════════════════════════════════════
+# Benchmark Result Tracking
+# ═══════════════════════════════════════════════════
+type
+  BenchResult* = object
+    name*: string
+    ops*: int
+    seconds*: float64
+    opsPerSec*: float64
+    timestamp*: string
+
+  BenchReport* = object
+    version*: string
+    gitSha*: string
+    results*: seq[BenchResult]
+
+const ResultsFile = "benchmark_results.json"
+
+proc loadPreviousResults(path: string): seq[BenchResult] =
+  result = @[]
+  if not fileExists(path): return
+  try:
+    let j = parseFile(path)
+    if j.hasKey("results"):
+      for item in j["results"]:
+        if item.hasKey("name") and item.hasKey("opsPerSec"):
+          result.add(BenchResult(
+            name: item["name"].getStr(),
+            ops: if item.hasKey("ops"): item["ops"].getInt() else: 0,
+            seconds: if item.hasKey("seconds"): item["seconds"].getFloat() else: 0.0,
+            opsPerSec: item["opsPerSec"].getFloat(),
+            timestamp: if item.hasKey("timestamp"): item["timestamp"].getStr() else: "",
+          ))
+  except:
+    discard
+
+proc saveResults(path: string, report: BenchReport) =
+  var j = newJObject()
+  j["version"] = %report.version
+  j["gitSha"] = %report.gitSha
+  var arr = newJArray()
+  for r in report.results:
+    var obj = newJObject()
+    obj["name"] = %r.name
+    obj["ops"] = %r.ops
+    obj["seconds"] = %r.seconds
+    obj["opsPerSec"] = %r.opsPerSec
+    obj["timestamp"] = %r.timestamp
+    arr.add(obj)
+  j["results"] = arr
+  writeFile(path, j.pretty())
+
+proc compareResult(name: string, currentOpsPerSec: float64, previous: seq[BenchResult]): string =
+  for p in previous:
+    if p.name == name:
+      let delta = currentOpsPerSec - p.opsPerSec
+      let pct = if p.opsPerSec > 0: (delta / p.opsPerSec) * 100.0 else: 0.0
+      if abs(pct) < 1.0:
+        return " (≈ same)"
+      elif pct > 0:
+        return " (+" & pct.formatFloat(ffDecimal, 1) & "% vs last)"
+      else:
+        return " (" & pct.formatFloat(ffDecimal, 1) & "% vs last)"
+  return " (new)"
+
+var currentResults: seq[BenchResult] = @[]
+var previousResults = loadPreviousResults(ResultsFile)
+
+proc recordResult(name: string, ops: int, seconds: float64) =
+  currentResults.add(BenchResult(
+    name: name,
+    ops: ops,
+    seconds: seconds,
+    opsPerSec: if seconds > 0: float64(ops) / seconds else: 0.0,
+    timestamp: now().format("yyyy-MM-dd HH:mm:ss"),
+  ))
+
+proc gitSha(): string =
+  let (output, code) = execCmdEx("git rev-parse --short HEAD")
+  if code == 0:
+    return output.strip()
+  return "unknown"
+
 proc elapsed(start: MonoTime): float64 =
   let ns = float64((getMonoTime() - start).inNanoseconds)
   return ns / 1_000_000_000.0
@@ -26,7 +111,9 @@ proc formatOps(ops: int, secs: float64): string =
 
 proc benchLSMTree() =
   echo "=== LSM-Tree Storage ==="
-  var db = newLSMTree("/tmp/baradb_bench_lsm")
+  let benchDir = getTempDir() / "baradb_bench_lsm"
+  removeDir(benchDir)
+  var db = newLSMTree(benchDir)
 
   # Write benchmark
   let n = 100_000
@@ -34,7 +121,9 @@ proc benchLSMTree() =
   for i in 0..<n:
     db.put("key_" & $i, cast[seq[byte]]("value_" & $i))
   let writeTime = elapsed(start)
-  echo "  Write ", n, " keys: ", writeTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, writeTime), ")"
+  let writeLabel = "LSM-Write"
+  recordResult(writeLabel, n, writeTime)
+  echo "  Write ", n, " keys: ", writeTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, writeTime), ")", compareResult(writeLabel, currentResults[^1].opsPerSec, previousResults)
 
   # Read benchmark
   let readStart = getMonoTime()
@@ -43,7 +132,9 @@ proc benchLSMTree() =
     let (ok, _) = db.get("key_" & $i)
     if ok: inc found
   let readTime = elapsed(readStart)
-  echo "  Read ", n, " keys: ", readTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, readTime), ") (", found, " found)"
+  let readLabel = "LSM-Read"
+  recordResult(readLabel, n, readTime)
+  echo "  Read ", n, " keys: ", readTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, readTime), ") (", found, " found)", compareResult(readLabel, currentResults[^1].opsPerSec, previousResults)
 
   db.close()
 
@@ -57,7 +148,9 @@ proc benchBTree() =
   for i in 0..<n:
     btree.insert("key_" & $i, "value_" & $i)
   let insertTime = elapsed(start)
-  echo "  Insert ", n, " keys: ", insertTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, insertTime), ")"
+  let insertLabel = "BTree-Insert"
+  recordResult(insertLabel, n, insertTime)
+  echo "  Insert ", n, " keys: ", insertTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, insertTime), ")", compareResult(insertLabel, currentResults[^1].opsPerSec, previousResults)
 
   # Get benchmark
   let getStart = getMonoTime()
@@ -66,13 +159,17 @@ proc benchBTree() =
     let vals = btree.get("key_" & $i)
     if vals.len > 0: inc found
   let getTime = elapsed(getStart)
-  echo "  Get ", n, " keys: ", getTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, getTime), ") (", found, " found)"
+  let getLabel = "BTree-Get"
+  recordResult(getLabel, n, getTime)
+  echo "  Get ", n, " keys: ", getTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, getTime), ") (", found, " found)", compareResult(getLabel, currentResults[^1].opsPerSec, previousResults)
 
   # Scan benchmark
   let scanStart = getMonoTime()
   let scanResults = btree.scan("key_1000", "key_2000")
   let scanTime = elapsed(scanStart)
-  echo "  Scan 1000 range: ", scanTime.formatFloat(ffDecimal, 6), "s (", scanResults.len, " results)"
+  let scanLabel = "BTree-Scan"
+  recordResult(scanLabel, scanResults.len, scanTime)
+  echo "  Scan 1000 range: ", scanTime.formatFloat(ffDecimal, 6), "s (", scanResults.len, " results)", compareResult(scanLabel, currentResults[^1].opsPerSec, previousResults)
 
 proc benchVectorSearch() =
   echo "=== Vector Engine (HNSW) ==="
@@ -89,7 +186,9 @@ proc benchVectorSearch() =
       vec[d] = rand(1.0)
     vengine.insert(idx, uint64(i), vec)
   let insertTime = elapsed(start)
-  echo "  Insert ", n, " vectors (dim=", dim, "): ", insertTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, insertTime), ")"
+  let insertLabel = "HNSW-Insert"
+  recordResult(insertLabel, n, insertTime)
+  echo "  Insert ", n, " vectors (dim=", dim, "): ", insertTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, insertTime), ")", compareResult(insertLabel, currentResults[^1].opsPerSec, previousResults)
 
   # Search benchmark
   var query = newSeq[float32](dim)
@@ -99,7 +198,9 @@ proc benchVectorSearch() =
   let searchStart = getMonoTime()
   let results = vengine.search(idx, query, 10)
   let searchTime = elapsed(searchStart)
-  echo "  Search top-10: ", (searchTime * 1000).formatFloat(ffDecimal, 3), "ms"
+  let searchLabel = "HNSW-Search"
+  recordResult(searchLabel, 1, searchTime)
+  echo "  Search top-10: ", (searchTime * 1000).formatFloat(ffDecimal, 3), "ms", compareResult(searchLabel, currentResults[^1].opsPerSec, previousResults)
 
 proc benchVectorSIMD() =
   echo "=== Vector SIMD Operations ==="
@@ -122,21 +223,27 @@ proc benchVectorSIMD() =
   for i in 0..<n:
     discard cosineSimd(query, corpus[i])
   let cosineTime = elapsed(start)
-  echo "  Cosine distance (dim=768, n=10K): ", cosineTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, cosineTime), ")"
+  let cosineLabel = "SIMD-Cosine"
+  recordResult(cosineLabel, n, cosineTime)
+  echo "  Cosine distance (dim=768, n=10K): ", cosineTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, cosineTime), ")", compareResult(cosineLabel, currentResults[^1].opsPerSec, previousResults)
 
   # L2 distance benchmark
   let l2Start = getMonoTime()
   for i in 0..<n:
     discard l2NormSimd(query, corpus[i])
   let l2Time = elapsed(l2Start)
-  echo "  L2 distance (dim=768, n=10K): ", l2Time.formatFloat(ffDecimal, 3), "s (", formatOps(n, l2Time), ")"
+  let l2Label = "SIMD-L2"
+  recordResult(l2Label, n, l2Time)
+  echo "  L2 distance (dim=768, n=10K): ", l2Time.formatFloat(ffDecimal, 3), "s (", formatOps(n, l2Time), ")", compareResult(l2Label, currentResults[^1].opsPerSec, previousResults)
 
   # Dot product benchmark
   let dotStart = getMonoTime()
   for i in 0..<n:
     discard dotProductSimd(query, corpus[i])
   let dotTime = elapsed(dotStart)
-  echo "  Dot product (dim=768, n=10K): ", dotTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, dotTime), ")"
+  let dotLabel = "SIMD-Dot"
+  recordResult(dotLabel, n, dotTime)
+  echo "  Dot product (dim=768, n=10K): ", dotTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, dotTime), ")", compareResult(dotLabel, currentResults[^1].opsPerSec, previousResults)
 
 proc benchFTS() =
   echo "=== Full-Text Search ==="
@@ -155,21 +262,27 @@ proc benchFTS() =
   for i in 0..<n:
     idx.addDocument(uint64(i), docs[i mod docs.len])
   let indexTime = elapsed(start)
-  echo "  Index ", n, " docs: ", indexTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, indexTime), ")"
+  let indexLabel = "FTS-Index"
+  recordResult(indexLabel, n, indexTime)
+  echo "  Index ", n, " docs: ", indexTime.formatFloat(ffDecimal, 3), "s (", formatOps(n, indexTime), ")", compareResult(indexLabel, currentResults[^1].opsPerSec, previousResults)
 
   # Search benchmark
   let searchStart = getMonoTime()
   for i in 0..<1000:
     discard idx.search("Nim programming language")
   let searchTime = elapsed(searchStart)
-  echo "  Search 1000 queries: ", searchTime.formatFloat(ffDecimal, 3), "s (", formatOps(1000, searchTime), ")"
+  let searchLabel = "FTS-Search"
+  recordResult(searchLabel, 1000, searchTime)
+  echo "  Search 1000 queries: ", searchTime.formatFloat(ffDecimal, 3), "s (", formatOps(1000, searchTime), ")", compareResult(searchLabel, currentResults[^1].opsPerSec, previousResults)
 
   # Fuzzy search benchmark
   let fuzzyStart = getMonoTime()
   for i in 0..<100:
     discard idx.fuzzySearch("programing", maxDistance = 2)
   let fuzzyTime = elapsed(fuzzyStart)
-  echo "  Fuzzy search 100 queries: ", fuzzyTime.formatFloat(ffDecimal, 3), "s (", formatOps(100, fuzzyTime), ")"
+  let fuzzyLabel = "FTS-Fuzzy"
+  recordResult(fuzzyLabel, 100, fuzzyTime)
+  echo "  Fuzzy search 100 queries: ", fuzzyTime.formatFloat(ffDecimal, 3), "s (", formatOps(100, fuzzyTime), ")", compareResult(fuzzyLabel, currentResults[^1].opsPerSec, previousResults)
 
 proc benchGraph() =
   echo "=== Graph Engine ==="
@@ -182,7 +295,9 @@ proc benchGraph() =
   for i in 0..<nodeCount:
     discard gengine.addNode(g, "Node_" & $i)
   let nodeTime = elapsed(nodeStart)
-  echo "  Add ", nodeCount, " nodes: ", nodeTime.formatFloat(ffDecimal, 6), "s"
+  let nodeLabel = "Graph-AddNodes"
+  recordResult(nodeLabel, nodeCount, nodeTime)
+  echo "  Add ", nodeCount, " nodes: ", nodeTime.formatFloat(ffDecimal, 6), "s", compareResult(nodeLabel, currentResults[^1].opsPerSec, previousResults)
 
   # Add edges
   randomize(42)
@@ -192,20 +307,26 @@ proc benchGraph() =
     let dst = NodeId(uint64(rand(nodeCount - 1)) + 1)
     discard gengine.addEdge(g, src, dst)
   let edgeTime = elapsed(edgeStart)
-  echo "  Add ", edgeCount, " edges: ", edgeTime.formatFloat(ffDecimal, 6), "s"
+  let edgeLabel = "Graph-AddEdges"
+  recordResult(edgeLabel, edgeCount, edgeTime)
+  echo "  Add ", edgeCount, " edges: ", edgeTime.formatFloat(ffDecimal, 6), "s", compareResult(edgeLabel, currentResults[^1].opsPerSec, previousResults)
 
   # BFS benchmark
   let bfsStart = getMonoTime()
   for i in 0..<100:
     discard gengine.bfs(g, NodeId(1))
   let bfsTime = elapsed(bfsStart)
-  echo "  BFS 100 traversals: ", bfsTime.formatFloat(ffDecimal, 3), "s (", formatOps(100, bfsTime), ")"
+  let bfsLabel = "Graph-BFS"
+  recordResult(bfsLabel, 100, bfsTime)
+  echo "  BFS 100 traversals: ", bfsTime.formatFloat(ffDecimal, 3), "s (", formatOps(100, bfsTime), ")", compareResult(bfsLabel, currentResults[^1].opsPerSec, previousResults)
 
   # PageRank benchmark
   let prStart = getMonoTime()
   discard gengine.pageRank(g, 10)
   let prTime = elapsed(prStart)
-  echo "  PageRank (10 iterations): ", prTime.formatFloat(ffDecimal, 3), "s"
+  let prLabel = "Graph-PageRank"
+  recordResult(prLabel, 10, prTime)
+  echo "  PageRank (10 iterations): ", prTime.formatFloat(ffDecimal, 3), "s", compareResult(prLabel, currentResults[^1].opsPerSec, previousResults)
 
 proc main() =
   echo ""
@@ -226,5 +347,15 @@ proc main() =
   benchGraph()
   echo ""
 
+  # Save results for regression tracking
+  let report = BenchReport(
+    version: "1.0.0",
+    gitSha: gitSha(),
+    results: currentResults,
+  )
+  saveResults(ResultsFile, report)
+  echo "Results saved to ", ResultsFile
+  echo ""
+
 when isMainModule:
   main()

clients/javascript/README.md

@@ -20,7 +20,7 @@ npm install baradb
 Or from source:
 
 ```bash
-git clone https://github.com/barabadb/baradadb.git
+git clone https://codeberg.org/baraba/baradb
 cd clients/javascript
 npm link
 ```

clients/javascript/baradb.js

@@ -244,6 +244,8 @@ class Client {
     this.requestId = 0;
     this._buffer = Buffer.alloc(0);
     this._pendingResolve = null;
+    this._requestQueue = [];
+    this._requestLock = false;
   }
 
   async connect() {
@@ -478,70 +480,98 @@ class Client {
     throw new Error(`Unexpected auth response: 0x${header.kind.toString(16)}`);
   }
 
+  async _processQueue() {
+    if (this._requestLock || this._requestQueue.length === 0) return;
+    this._requestLock = true;
+    const { task, resolve, reject } = this._requestQueue.shift();
+    try {
+      const result = await task();
+      resolve(result);
+    } catch (err) {
+      reject(err);
+    } finally {
+      this._requestLock = false;
+      setImmediate(() => this._processQueue());
+    }
+  }
+
+  _enqueue(task) {
+    return new Promise((resolve, reject) => {
+      this._requestQueue.push({ task, resolve, reject });
+      this._processQueue();
+    });
+  }
+
   async ping() {
     if (!this.connected) throw new Error('Not connected');
-    const msg = this._build(MsgKind.PING, Buffer.alloc(0));
+    return this._enqueue(async () => {
-    this.socket.write(msg);
+      const msg = this._build(MsgKind.PING, Buffer.alloc(0));
+      this.socket.write(msg);
 
-    const header = await this._readHeader();
+      const header = await this._readHeader();
-    if (header.kind === MsgKind.PONG) return true;
+      if (header.kind === MsgKind.PONG) return true;
-    if (header.kind === MsgKind.ERROR) throw await this._readError(header.length);
+      if (header.kind === MsgKind.ERROR) throw await this._readError(header.length);
-    return false;
+      return false;
+    });
   }
 
   async query(sql) {
     if (!this.connected) throw new Error('Not connected');
-    const queryBuf = Buffer.from(sql, 'utf-8');
+    return this._enqueue(async () => {
-    const payload = Buffer.alloc(4 + queryBuf.length + 1);
+      const queryBuf = Buffer.from(sql, 'utf-8');
-    payload.writeUInt32BE(queryBuf.length, 0);
+      const payload = Buffer.alloc(4 + queryBuf.length + 1);
-    queryBuf.copy(payload, 4);
+      payload.writeUInt32BE(queryBuf.length, 0);
-    payload[4 + queryBuf.length] = ResultFormat.BINARY;
+      queryBuf.copy(payload, 4);
+      payload[4 + queryBuf.length] = ResultFormat.BINARY;
 
-    const msg = this._build(MsgKind.QUERY, payload);
+      const msg = this._build(MsgKind.QUERY, payload);
-    this.socket.write(msg);
+      this.socket.write(msg);
 
-    const header = await this._readHeader();
+      const header = await this._readHeader();
-    if (header.kind === MsgKind.ERROR) throw await this._readError(header.length);
+      if (header.kind === MsgKind.ERROR) throw await this._readError(header.length);
-    if (header.kind === MsgKind.DATA) return await this._readDataResponse(header.length);
+      if (header.kind === MsgKind.DATA) return await this._readDataResponse(header.length);
-    if (header.kind === MsgKind.COMPLETE) {
+      if (header.kind === MsgKind.COMPLETE) {
-      const data = await this._recvExact(header.length);
+        const data = await this._recvExact(header.length);
-      const result = new QueryResult();
+        const result = new QueryResult();
-      result.affectedRows = data.readUInt32BE(0);
+        result.affectedRows = data.readUInt32BE(0);
-      return result;
+        return result;
-    }
+      }
-    return new QueryResult();
+      return new QueryResult();
+    });
   }
 
   async queryParams(sql, params = []) {
     if (!this.connected) throw new Error('Not connected');
-    const queryBuf = Buffer.from(sql, 'utf-8');
+    return this._enqueue(async () => {
-    const paramParts = [];
+      const queryBuf = Buffer.from(sql, 'utf-8');
-    for (const p of params) {
+      const paramParts = [];
-      paramParts.push(p.serialize());
+      for (const p of params) {
-    }
+        paramParts.push(p.serialize());
-    const paramsBuf = Buffer.concat(paramParts);
+      }
+      const paramsBuf = Buffer.concat(paramParts);
 
-    const payload = Buffer.alloc(4 + queryBuf.length + 1 + 4 + paramsBuf.length);
+      const payload = Buffer.alloc(4 + queryBuf.length + 1 + 4 + paramsBuf.length);
-    let pos = 0;
+      let pos = 0;
-    payload.writeUInt32BE(queryBuf.length, pos); pos += 4;
+      payload.writeUInt32BE(queryBuf.length, pos); pos += 4;
-    queryBuf.copy(payload, pos); pos += queryBuf.length;
+      queryBuf.copy(payload, pos); pos += queryBuf.length;
-    payload[pos] = ResultFormat.BINARY; pos++;
+      payload[pos] = ResultFormat.BINARY; pos++;
-    payload.writeUInt32BE(params.length, pos); pos += 4;
+      payload.writeUInt32BE(params.length, pos); pos += 4;
-    paramsBuf.copy(payload, pos);
+      paramsBuf.copy(payload, pos);
 
-    const msg = this._build(MsgKind.QUERY_PARAMS, payload);
+      const msg = this._build(MsgKind.QUERY_PARAMS, payload);
-    this.socket.write(msg);
+      this.socket.write(msg);
 
-    const header = await this._readHeader();
+      const header = await this._readHeader();
-    if (header.kind === MsgKind.ERROR) throw await this._readError(header.length);
+      if (header.kind === MsgKind.ERROR) throw await this._readError(header.length);
-    if (header.kind === MsgKind.DATA) return await this._readDataResponse(header.length);
+      if (header.kind === MsgKind.DATA) return await this._readDataResponse(header.length);
-    if (header.kind === MsgKind.COMPLETE) {
+      if (header.kind === MsgKind.COMPLETE) {
-      const data = await this._recvExact(header.length);
+        const data = await this._recvExact(header.length);
-      const result = new QueryResult();
+        const result = new QueryResult();
-      result.affectedRows = data.readUInt32BE(0);
+        result.affectedRows = data.readUInt32BE(0);
-      return result;
+        return result;
-    }
+      }
-    return new QueryResult();
+      return new QueryResult();
+    });
   }
 
   async execute(sql) {

clients/javascript/baradb_langchain.js

@@ -0,0 +1,225 @@
+/**
+ * BaraDB LangChain.js Vector Store Integration
+ *
+ * Usage:
+ *   const { Client, WireValue } = require('./baradb');
+ *   const { BaraDBStore } = require('./baradb_langchain');
+ *
+ *   const client = new Client('localhost', 9472);
+ *   await client.connect();
+ *
+ *   const store = new BaraDBStore({
+ *     client,
+ *     table: 'docs',
+ *     embeddingCol: 'embedding',
+ *     textCol: 'content',
+ *     embeddingFunction: async (text) => [0.1, 0.2, ...], // your embedder
+ *     tenantId: 'company-a'
+ *   });
+ *
+ *   await store.addDocuments([
+ *     { pageContent: 'hello world', metadata: { source: 'web' } }
+ *   ]);
+ *
+ *   const results = await store.similaritySearch('hello', 5);
+ */
+
+const { WireValue } = require('./baradb');
+
+class BaraDBStore {
+  constructor(options = {}) {
+    this.client = options.client;
+    this.table = options.table || 'documents';
+    this.embeddingCol = options.embeddingCol || 'embedding';
+    this.textCol = options.textCol || 'content';
+    this.metadataCols = options.metadataCols || [];
+    this.embeddingFunction = options.embeddingFunction || null;
+    this.tenantId = options.tenantId || null;
+    this.vectorDimension = options.vectorDimension || 1536;
+    this._tableCreated = false;
+  }
+
+  async _ensureTable() {
+    if (this._tableCreated) return;
+
+    const cols = `id SERIAL PRIMARY KEY, ${this.embeddingCol} VECTOR(${this.vectorDimension}), ${this.textCol} TEXT` +
+      (this.tenantId ? ', tenant_id TEXT' : '') +
+      this.metadataCols.map(mc => `, ${mc} TEXT`).join('');
+
+    await this.client.query(`CREATE TABLE IF NOT EXISTS ${this.table} (${cols})`);
+    await this.client.query(`CREATE INDEX IF NOT EXISTS idx_${this.table}_vec ON ${this.table}(${this.embeddingCol}) USING hnsw`);
+    await this.client.query(`CREATE INDEX IF NOT EXISTS idx_${this.table}_fts ON ${this.table}(${this.textCol}) USING FTS`);
+    this._tableCreated = true;
+  }
+
+  async addDocuments(documents) {
+    await this._ensureTable();
+    if (!this.embeddingFunction) {
+      throw new Error('embeddingFunction is required for addDocuments');
+    }
+
+    const insertedIds = [];
+    for (const doc of documents) {
+      const text = doc.pageContent || doc.content || '';
+      const meta = doc.metadata || {};
+      const vec = await this.embeddingFunction(text);
+      const vecStr = '[' + vec.join(',') + ']';
+
+      const colNames = [this.embeddingCol, this.textCol];
+      const params = [WireValue.string(vecStr), WireValue.string(text)];
+
+      if (this.tenantId) {
+        colNames.push('tenant_id');
+        params.push(WireValue.string(this.tenantId));
+      }
+      for (const mc of this.metadataCols) {
+        if (meta[mc] !== undefined) {
+          colNames.push(mc);
+          params.push(WireValue.string(String(meta[mc])));
+        }
+      }
+
+      const placeholders = params.map((_, i) => `$${i + 1}`).join(', ');
+      const sql = `INSERT INTO ${this.table} (${colNames.join(', ')}) VALUES (${placeholders}) RETURNING id`;
+      const result = await this.client.queryParams(sql, params);
+      if (result.rows && result.rows.length > 0) {
+        insertedIds.push(result.rows[0].id || result.rows[0][0]);
+      }
+    }
+    return insertedIds;
+  }
+
+  async addTexts(texts, metadatas = []) {
+    const docs = texts.map((text, i) => ({
+      pageContent: text,
+      metadata: metadatas[i] || {}
+    }));
+    return this.addDocuments(docs);
+  }
+
+  async similaritySearch(query, k = 4, filter = null) {
+    await this._ensureTable();
+    if (!this.embeddingFunction) {
+      throw new Error('embeddingFunction is required for similaritySearch');
+    }
+
+    const vec = await this.embeddingFunction(query);
+    const vecStr = '[' + vec.join(',') + ']';
+
+    if (this.tenantId) {
+      await this.client.queryParams('SET app.tenant_id = $1', [WireValue.string(this.tenantId)]);
+    }
+
+    let sql;
+    let params;
+    if (filter && filter.column && filter.value) {
+      sql = 'SELECT hybrid_search_filtered($1, $2, $3, $4, $5, $6, $7, $8) AS res';
+      params = [
+        WireValue.string(this.table),
+        WireValue.string(this.embeddingCol),
+        WireValue.string(this.textCol),
+        WireValue.string(query),
+        WireValue.string(vecStr),
+        WireValue.int32(k),
+        WireValue.string(filter.column),
+        WireValue.string(filter.value),
+      ];
+    } else {
+      sql = 'SELECT hybrid_search($1, $2, $3, $4, $5, $6) AS res';
+      params = [
+        WireValue.string(this.table),
+        WireValue.string(this.embeddingCol),
+        WireValue.string(this.textCol),
+        WireValue.string(query),
+        WireValue.string(vecStr),
+        WireValue.int32(k),
+      ];
+    }
+
+    const result = await this.client.queryParams(sql, params);
+    if (!result.rows || result.rows.length === 0) return [];
+
+    const raw = result.rows[0].res || result.rows[0][0] || '[]';
+    let arr;
+    try {
+      arr = JSON.parse(raw);
+    } catch {
+      return [];
+    }
+
+    const docs = [];
+    for (const item of arr) {
+      const docId = item.id;
+      const score = parseFloat(item.score || 0);
+      const rowResult = await this.client.queryParams(
+        `SELECT * FROM ${this.table} WHERE id = $1`,
+        [WireValue.string(String(docId))]
+      );
+      if (rowResult.rows && rowResult.rows.length > 0) {
+        const row = rowResult.rows[0];
+        const pageContent = row[this.textCol] || row[Object.keys(row).find(k => k.toLowerCase() === this.textCol.toLowerCase())];
+        docs.push({
+          pageContent: String(pageContent),
+          metadata: { ...row, _score: score },
+        });
+      }
+    }
+    return docs;
+  }
+
+  async maxMarginalRelevanceSearch(query, k = 4, fetchK = 20, lambdaMult = 0.5) {
+    const candidates = await this.similaritySearch(query, fetchK);
+    if (candidates.length === 0) return [];
+
+    const selected = [];
+    const remaining = [...candidates];
+
+    while (selected.length < k && remaining.length > 0) {
+      let bestScore = -Infinity;
+      let bestIdx = 0;
+      for (let i = 0; i < remaining.length; i++) {
+        const doc = remaining[i];
+        // Use _score from metadata as relevance
+        const relScore = doc.metadata?._score || 0;
+        let penalty = 0;
+        for (const sel of selected) {
+          penalty = Math.max(penalty, _docSimilarity(doc, sel));
+        }
+        const mmrScore = lambdaMult * relScore - (1 - lambdaMult) * penalty;
+        if (mmrScore > bestScore) {
+          bestScore = mmrScore;
+          bestIdx = i;
+        }
+      }
+      selected.push(remaining.splice(bestIdx, 1)[0]);
+    }
+    return selected;
+  }
+
+  async delete(ids) {
+    await this._ensureTable();
+    if (!ids || ids.length === 0) return;
+    const params = ids.map((id, i) => WireValue.string(String(id)));
+    const placeholders = ids.map((_, i) => `$${i + 1}`).join(', ');
+    await this.client.queryParams(
+      `DELETE FROM ${this.table} WHERE id IN (${placeholders})`,
+      params
+    );
+  }
+
+  async setTenant(tenantId) {
+    this.tenantId = tenantId;
+    await this.client.queryParams('SET app.tenant_id = $1', [WireValue.string(tenantId)]);
+  }
+}
+
+function _docSimilarity(a, b) {
+  const tokensA = new Set(String(a.pageContent || '').toLowerCase().split(/\s+/));
+  const tokensB = new Set(String(b.pageContent || '').toLowerCase().split(/\s+/));
+  if (tokensA.size === 0 || tokensB.size === 0) return 0;
+  const intersection = new Set([...tokensA].filter(x => tokensB.has(x)));
+  const union = new Set([...tokensA, ...tokensB]);
+  return intersection.size / union.size;
+}
+
+module.exports = { BaraDBStore };

clients/javascript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baradb",
-  "version": "1.1.0",
+  "version": "1.1.6",
   "description": "Official JavaScript/Node.js client for BaraDB — Multimodal Database Engine",
   "main": "baradb.js",
   "types": "baradb.d.ts",

clients/javascript/tests/integration.test.js

@@ -8,8 +8,8 @@ const assert = require('node:assert');
 const net = require('net');
 const { Client, WireValue, QueryBuilder } = require('../baradb');
 
-const HOST = 'localhost';
+const HOST = process.env.BARADB_HOST || 'localhost';
-const PORT = 9472;
+const PORT = parseInt(process.env.BARADB_PORT || '9472', 10);
 
 function serverAvailable() {
   return new Promise((resolve) => {

clients/nim-allographer/.cursor/rules/branch.mdc

@@ -0,0 +1,31 @@
+---
+alwaysApply: true
+---
+現在のブランチ名と一致するファイル名のファイルが、リポジトリのルートから見て `.cursor/rules/branch/` 配下にあった場合は、それを読み込んでください。
+各ブランチルールは、ブランチで行うべき開発内容、タスクを小さい粒度で分けた進捗、参考資料の一覧を含みます。
+ブランチルールファイルの拡張子は `.mdc` です。
+エージェントは開発の進度に従って進捗を適時記録してください。
+実装する中で `調査結果・設計まとめ` に間違いがあると判明した場合は、その都度、より正しいと考えられる設計方針を書き込んでください。
+
+以下はブランチルールの雛形です
+
+```
+---
+description: {ブランチ名}ブランチでの開発時に読み込む
+alwaysApply: false
+---
+{ブランチルール名}
+===
+
+このブランチで実装することは以下の通りです。
+- 
+
+## 進捗
+- [ ] 
+
+## 参考資料
+- 
+
+## 調査結果・設計まとめ
+```
+

clients/nim-allographer/.cursor/rules/branch/318-bug-incorrect-sqlite-check-constraint-for-columnchar-columnstring-and-columnuuid.mdc

@@ -0,0 +1,130 @@
+---
+description: 318-bug-incorrect-sqlite-check-constraint-for-columnchar-columnstring-and-columnuuidブランチでの開発時に読み込む
+alwaysApply: false
+---
+SQLite CHECK Constraint 引用誤り修正 ブランチルール
+===
+
+このブランチで実装することは以下の通りです。
+- SQLite の schema builder において、`Column.char`, `Column.string`, `Column.uuid` が生成する `CHECK` 制約の列参照が文字列リテラル扱いになっている不具合を修正する。
+- `CREATE TABLE` と `ALTER TABLE ... ADD COLUMN` の両方で、`length('column_name')` ではなく列値を参照する `length(column_name)` 系の SQL を生成するように整える。
+- SQLite driver の修正を公開 API へ漏らさず、driver 内部の SQL 生成責務に閉じ込める。
+- 長さ制約の既定値あり・既定値なしの両ケースで、`char` `string` `uuid` の意味論が崩れないことを確認できるテストを整備する。
+- 必要に応じて README / `documents/rdb/schema_builder.md` の SQLite 例を同期し、誤った `CHECK (length('email') <= 255)` 表記を残さない。
+
+## 進捗
+- [x] `.cursor/rules/project.mdc` と `.cursor/rules/branch.mdc` を確認した
+- [x] 現在のブランチ名に対応するブランチルールファイルが未作成であることを確認した
+- [x] SQLite の `CHECK` 生成箇所を調査し、`create_column_query.nim` と `add_column_query.nim` の両方に同種の問題があることを確認した
+- [x] 対象カラム型が `Column.char`, `Column.string`, `Column.uuid` の 3 系統であることを確認した
+- [x] ドキュメントに同じ誤表記が残っていることを確認した
+- [x] ブランチルールに改修方針・進捗粒度・参考資料を整理した
+- [x] SQLite schema builder の `CHECK` 制約生成を、列名を文字列リテラル化しない形式へ修正する
+- [x] `CREATE TABLE` 経路のテストを追加または更新し、生成 SQL が列値長を検査することを確認する
+- [x] `ADD COLUMN` 経路のテストを追加または更新し、生成 SQL が列値長を検査することを確認する
+- [x] `char` `string` `uuid` の既定長と明示長の両ケースで回帰確認する
+- [x] 必要な README / `documents/rdb/schema_builder.md` の記述を同期する
+- [ ] 実装途中で設計認識に誤りが見つかった場合は、本ファイルの `調査結果・設計まとめ` を更新する
+
+## 参考資料
+- `src/allographer/schema_builder/queries/sqlite/sub/create_column_query.nim`
+- `src/allographer/schema_builder/queries/sqlite/sub/add_column_query.nim`
+- `tests/sqlite/test_create_schema.nim`
+- `tests/sqlite/test_schema.nim`
+- `documents/rdb/schema_builder.md`
+- `README.md`
+- SQLite Documentation: CHECK constraints
+- SQLite Documentation: core functions `length(...)`
+
+## 調査結果・設計まとめ
+
+### 背景
+
+SQLite 実装では、文字列長を制限するために `CHECK (length(...) <= N)` を列定義へ付与している。
+
+しかし現状の SQL 生成は `length('{column.name}')` となっており、列値ではなく列名そのものを単一引用符付きの文字列リテラルとして評価している。
+
+その結果、たとえば `name` 列では常に `length('name') == 4` と評価されるため、期待した列値バリデーションにならない。
+
+### 現状の問題
+
+1. SQLite の `CREATE TABLE` 用列生成で `CHECK (length('{column.name}') <= {maxLength})` を出力している
+2. SQLite の `ADD COLUMN` 用列生成でも同じ誤りを重複して持っている
+3. 影響範囲が `Column.char`, `Column.string`, `Column.uuid` にまたがっている
+4. ドキュメント例にも同じ誤表記があり、利用者が誤仕様と誤解する余地がある
+5. SQL 生成の不具合であり、公開 API ではなく SQLite driver 内部責務として直すべき問題である
+
+### 設計目標
+
+1. SQLite で生成される長さ `CHECK` 制約が常に列値を参照する
+2. `char`, `string`, `uuid` の API 意味論を変えずに不具合のみを修正する
+3. `create` と `add column` の両経路で SQL 生成規則を揃える
+4. 既存の RDB 向け共通 API を汚さず、SQLite 実装へ変更を閉じ込める
+5. テストと文書で回帰防止できる状態にする
+
+### 非目標
+
+1. SQLite 以外の driver の長さ制約仕様を同時に変更すること
+2. `Column.char`, `Column.string`, `Column.uuid` の既定長そのものを見直すこと
+3. schema builder 全体の quoting 戦略をこのブランチで全面再設計すること
+4. 公開 API の追加・削除・引数変更を行うこと
+
+### 実装方針
+
+#### 1. SQLite の長さ `CHECK` 制約は列値参照に統一する
+
+変更対象:
+- `src/allographer/schema_builder/queries/sqlite/sub/create_column_query.nim`
+- `src/allographer/schema_builder/queries/sqlite/sub/add_column_query.nim`
+
+方針:
+- `length('{column.name}')` を列値参照の式へ修正する
+- `char`, `string`, `uuid` の 3 系統で同じルールを適用する
+- `CREATE TABLE` と `ADD COLUMN` で生成式の差異を作らない
+
+#### 2. 列名の扱いは SQLite 列参照として妥当な形を維持する
+
+要点:
+- 単一引用符 `'...'` は文字列リテラルなので使用しない
+- 既存の SQLite SQL 生成スタイルに合わせ、列参照として解釈される形を採用する
+- 必要なら identifier quoting の既存ルールを確認し、単純な文字列置換ではなく SQLite 方言として自然な表現に寄せる
+- 共通 helper を `schema_utils` に置き、`CREATE TABLE` / `ADD COLUMN` の両経路で同じ生成規則を使う
+
+#### 3. テストは SQL 文字列と実動作の両面を意識して追加する
+
+候補:
+1. schema 生成テストで `CHECK` 句が列値参照になっていることを確認する
+2. `Column.string("name")` の既定長ケースを確認する
+3. `Column.char("name", 20)` の明示長ケースを確認する
+4. `Column.uuid("uuid")` の既定長ケースを確認する
+5. `add()` 経路でも同じ `CHECK` 句になることを確認する
+
+### 受け入れ基準
+
+1. SQLite の `char`, `string`, `uuid` が生成する `CHECK` 制約で列名が単一引用符付き文字列になっていない
+2. `CREATE TABLE` と `ADD COLUMN` の両方で同じ修正が反映されている
+3. 追加または更新したテストで不具合再発を防止できる
+4. 必要なドキュメント例が実装と一致している
+5. 公開 API 変更なしで SQLite driver 内に修正が閉じ込められている
+
+### 参照仕様
+
+- SQLite Documentation: CHECK constraints
+  https://www.sqlite.org/lang_createtable.html#ckconst
+- SQLite Documentation: Built-In Scalar SQL Functions
+  https://www.sqlite.org/lang_corefunc.html#length
+
+### リスク
+
+1. 列名参照の quoting 形式を誤ると、今度は予約語や特殊文字を含む列名で不整合が出る可能性がある
+2. `create` と `add column` の片方だけ修正すると、経路差による再発が起きる
+3. ドキュメント未更新のままだと、修正後も利用者が誤った SQL 例を参照して混乱する
+4. SQL 文字列比較系テストだけだと、実際の制約評価の誤りを見逃す可能性がある
+
+### 段階導入案
+
+1. 影響箇所と既存 SQLite テストを整理する
+2. `create` / `add column` の SQL 生成を修正する
+3. `char` / `string` / `uuid` の回帰テストを追加または更新する
+4. 必要な README / documents を同期する
+5. 実装差分が設計とずれたら本ファイルを更新する

clients/nim-allographer/.cursor/rules/branch/320-allographerpostgresql-非同期待機改善-設計書.mdc

@@ -0,0 +1,156 @@
+---
+description: 320-allographerpostgresql-非同期待機改善-設計書ブランチでの開発時に読み込む
+alwaysApply: false
+---
+allographer(PostgreSQL) 非同期待機改善 ブランチルール
+===
+
+このブランチで実装することは以下の通りです。
+- allographer の PostgreSQL 実装に残っている `sleepAsync(10)` ベースの非同期待機を、libpq ソケット readiness ベースの待機へ置き換える。
+- `query*`, `queryPlain*`, `exec*`, `getColumns*` など、同一問題を持つ待機経路を共通化して修正する。
+- `dbOpen` 時に PostgreSQL 接続を non-blocking 化し、libpq 非同期 API の前提を明示的に保証する。
+- 接続プール空き待機を `sleepAsync(10)` ポーリングから通知ベースへ移行し、プール枯渇時の待機遅延を抑制する。
+- 公開 API 互換を維持したまま、httpbeast/httpx 利用時の DB 完了後の回収遅延を縮小する。
+
+## 進捗
+- [x] `src/allographer/query_builder/libs/postgres/postgres_impl.nim` の待機ループを調査し、`sleepAsync(10)` 依存箇所を一覧化する
+- [x] `src/allographer/query_builder/libs/postgres/postgres_rdb.nim` を確認し、既存宣言で再利用できる libpq API と不足宣言を整理する（追加宣言不要。`pqsocket` / `pqflush` / `pqsetnonblocking` 等は既存）
+- [x] PostgreSQL 待機ヘルパ `waitPgReadable` / `waitPgWritable` / `cancelQuery` の責務と配置を決める（`postgres_impl.nim` 内の非公開プロシージャ）
+- [x] `PQsocket` / `PQconsumeInput` / `PQisBusy` / `PQgetResult` / `PQflush` に基づく共通クエリ待機ループを設計する（`pgFlushOutgoing` / `pgNextResult` / `pgEnsureIdle`）
+- [x] `query*`, `queryPlain*`, `exec*`, `getColumns*` の各経路を共通待機ロジックへ寄せる
+- [x] タイムアウト時の `cancelQuery` 実行とエラーメッセージ方針を統一する（タイムアウトは `cancelQuery` 後に `DbError`）
+- [x] `src/allographer/query_builder/models/postgres/postgres_open.nim` で `pqsetnonblocking(conn, 1)` と検証処理を追加する
+- [x] `src/allographer/query_builder/models/postgres/postgres_types.nim` に接続プール waiter キューを追加する（`waiters*: seq[Future[void]]`）
+- [x] `src/allographer/query_builder/models/postgres/postgres_exec.nim` の `getFreeConn` / `returnConn` を通知ベースへ置換する
+- [x] PostgreSQL の単体・結合・回帰テストを追加または更新する（`tests/postgres/test_pool_wait.nim` 追加、既存 `test*.nim` 回帰）
+- [x] `sleepAsync(10)` が PostgreSQL クエリ待機とプール空き待機から除去されたことを確認する
+- [ ] README / documents / ルール文書に仕様差分が必要か確認し、必要分を同期する（利用者向け公開 API 変更なしのため未着手。必要なら追記）
+- [x] MariaDB: `mariadb_rdb.nim` に `mysql_read_query_result`（`cdecl`）を追加
+- [x] MariaDB: `mariadb_impl.nim` は接続ブロッキング前提で `mysql_real_query` / `mysql_read_query_result` / `mysql_fetch_row` / `free_result` を同期利用（`mysql_read_query_result_*` / `fetch_row_*` の async ループは環境でタイムアウト・デッドロックのため不使用）
+- [x] MariaDB: `mariadb_open.nim` は `MYSQL_OPT_NONBLOCK` を付与しない（同上）
+- [x] MariaDB: `mariadb_types` / `mariadb_exec` のプール空き待ちは通知ベース（`tests/mariadb/test_pool_wait.nim`）
+
+## 参考資料
+- allographer の PostgreSQL 実装: `src/allographer/query_builder/libs/postgres/postgres_impl.nim`
+- allographer の PostgreSQL 実行管理: `src/allographer/query_builder/models/postgres/postgres_exec.nim`
+- allographer の PostgreSQL 接続初期化: `src/allographer/query_builder/models/postgres/postgres_open.nim`
+- allographer の PostgreSQL 型定義: `src/allographer/query_builder/models/postgres/postgres_types.nim`
+- libpq 非同期 API: `PQsocket`, `PQconsumeInput`, `PQisBusy`, `PQgetResult`, `PQsetnonblocking`, `PQflush`, `PQgetCancel`, `PQcancel`, `PQfreeCancel`
+- Nim `asyncdispatch` のイベントループ仕様
+- httpbeast / httpx の POSIX selector ループ実装
+
+## 調査結果・設計まとめ
+
+### 背景
+
+`httpbeast` / `httpx` 利用時のみ、DB クエリ待機が `asynchttpserver` より大きく悪化する事象がある。
+
+現状の allographer PostgreSQL 実装は、libpq 非同期 API を使いながらも、実際の待機を `await sleepAsync(10)` に依存している。
+
+### 問題の本質
+
+- 現状の PostgreSQL 待機は、ソケット readiness 待ちではなく 10ms 刻みのポーリングである
+- Nim の `asyncdispatch` は `poll` / `waitFor` / `runForever` が回らない限りタイマーも進まない
+- httpbeast / httpx の POSIX 経路は `selectInto(-1, ...)` による無期限ブロックを中心としており、`asyncdispatch.poll(0)` は限定的にしか回らない
+- そのため `sleepAsync(10)` は実時間 10ms で復帰せず、「次に HTTP 側ループがたまたま dispatcher を回すまで」遅延する
+- 結果として、DB は完了済みでも allographer 側の結果回収が遅れ、体感レイテンシが悪化する
+
+### 設計目標
+
+1. PostgreSQL クエリ待機から `sleepAsync` ポーリングを除去する
+2. libpq ソケットの可読・可書込イベントで待機する
+3. 接続プール空き待ちも通知ベースへ移行し、タイマー依存を減らす
+4. `dbOpen`, `table`, `select`, `find`, `update` などの公開 API 互換を維持する
+
+### 非目標
+
+1. Query Builder API の破壊的変更
+2. MySQL / SQLite への同時展開（MariaDB は PostgreSQL と同方針で非同期待機を実装済み）
+3. 初回対応で全 OS 最適化を完了させること
+
+### 実装方針
+
+#### 1. libpq 待機を FD イベント待機へ変更する
+
+変更対象:
+- `src/allographer/query_builder/libs/postgres/postgres_impl.nim`
+- `src/allographer/query_builder/libs/postgres/postgres_rdb.nim`
+
+追加する内部ヘルパ:
+- `waitPgReadable(db: PPGconn, timeoutMs: int): Future[bool]`
+- `waitPgWritable(db: PPGconn, timeoutMs: int): Future[bool]`
+- `cancelQuery(db: PPGconn)`
+
+要点:
+- `pqsocket(db)` で FD を得る
+- 必要に応じて dispatcher に `AsyncFD` を登録する
+- read / write readiness を Future 完了で待つ
+- タイムアウト管理を行う
+- 登録リークや未解除ハンドラを残さない
+
+#### 2. クエリ実行ループを共通化する
+
+送信フェーズ:
+1. `pqsendQueryParams(...)` を呼ぶ
+2. `pqflush == 1` の間は `waitPgWritable` で待機する
+
+受信フェーズ:
+1. `pqconsumeInput`
+2. `pqisBusy == 1` なら `waitPgReadable` で待機する
+3. ready 後に `pqgetResult` を drain する
+
+タイムアウト時は `cancelQuery` を実行し、エラーを返す。
+
+#### 3. `dbOpen` で non-blocking を保証する
+
+変更対象:
+- `src/allographer/query_builder/models/postgres/postgres_open.nim`
+
+仕様:
+1. `pqsetnonblocking(conn, 1)` を実行する
+2. 失敗時は `DbError`
+3. `pqisnonblocking(conn) == 1` を確認し、保証できない場合は例外化する
+
+#### 4. 接続プール空き待ちを通知ベースに変更する
+
+変更対象:
+- `src/allographer/query_builder/models/postgres/postgres_types.nim`
+- `src/allographer/query_builder/models/postgres/postgres_exec.nim`
+
+方針:
+- `Connections` に `waiters*: Deque[Future[void]]` を追加する
+- `getFreeConn` は空きがなければ waiter を登録して待機する
+- `returnConn` は `isBusy = false` にした後、未完了 waiter を 1 つだけ起こす
+- 余剰 waiter や完了済み waiter は掃除する
+
+### 失敗時挙動
+
+1. `pqsocket < 0` は `DbError`
+2. タイムアウト時は `cancelQuery` 実行後に `DbError`
+3. `cancelQuery` 失敗時は追加情報付きで例外化
+4. dispatcher 登録・解除エラーは握り潰さず上位へ伝播する
+
+### テスト方針
+
+単体テスト:
+1. `waitPgReadable` が read event で復帰する
+2. timeout 時に `false` を返す
+3. `cancelQuery` が後始末まで行う
+4. `getFreeConn` が通知で復帰する
+
+結合テスト:
+1. httpbeast / httpx + Postgres のレイテンシ回帰を確認する
+2. `asynchttpserver` と比較して極端な乖離がないことを確認する
+3. プール枯渇時の待機が 10ms 刻みポーリングに依存しないことを確認する
+
+回帰テスト:
+1. 既存 CRUD クエリの結果互換
+2. transaction 系 API の動作
+3. 例外時メッセージが意味を保っていること
+
+### 受け入れ基準
+
+1. PostgreSQL クエリ待機ループから `await sleepAsync(10)` が除去されている
+2. httpbeast / httpx で DB 完了後の回収遅延が顕著に増幅しない
+3. プール空き待機で `sleepAsync` ポーリングを使わない
+4. 公開 API 変更なしで既存テストと追加テストが成立する

clients/nim-allographer/.cursor/rules/branch/321-mariadb-nonblocking.mdc

@@ -0,0 +1,240 @@
+---
+description: 321-mariadb-nonblockingブランチでの開発時に読み込む
+alwaysApply: false
+---
+MariaDB nonblocking API 対応 ブランチルール
+===
+
+このブランチで実装することは以下の通りです。
+- allographer の MariaDB 実装を、MariaDB Connector/C の non-blocking client API に追従できる構成へ設計・整備する。
+- 現在の `sleepAsync(10)` ベースの接続プール待機と、実質ブロッキングなクエリ実行経路を切り分けて改善方針を明確化する。
+- `mysql_real_query_start/cont` 系、`mysql_read_query_result_start/cont` 系、`mysql_fetch_row_start/cont` 系を使う待機ループの責務分離を設計する。
+- 必要な Connector/C 宣言を `mariadb_rdb.nim` に追加し、将来の実装変更でヘッダ不足が起きないようにする。
+- 公開 API 互換を維持しつつ、MariaDB driver 内に差分を閉じ込める。
+- 設計メモで整理していた背景・参照仕様・リスク・段階導入案をこのブランチルールへ集約し、参照元を一本化する。
+
+## 進捗
+- [x] `.cursor/rules/project.mdc` と `.cursor/rules/branch.mdc` を確認した
+- [x] 現行 `src/allographer/query_builder/models/mariadb/` と `src/allographer/query_builder/libs/mariadb/` を調査した
+- [x] ローカルの `/usr/include/mariadb/mysql.h` で non-blocking API 宣言と待機フラグを確認した
+- [x] MariaDB 公式ドキュメントで non-blocking API の制約と利用手順を確認した
+- [x] ブランチルールに設計方針・改修粒度・参考資料を整理した
+- [x] `src/allographer/query_builder/libs/mariadb/mariadb_rdb.nim` に必要宣言を追加した
+- [x] `mariadb_impl.nim` に共通待機ヘルパと `_start/_cont` ベースの実行ループを実装する
+- [x] `mariadb_open.nim` で `MYSQL_OPT_NONBLOCK` を有効化し、接続初期化手順を整理する
+- [x] `mariadb_types.nim` / `mariadb_exec.nim` のプール空き待機を通知ベースへ置換する
+- [x] `tests/mariadb/` に pool wait と CRUD 回帰を追加する
+- [x] 実装中に設計差分が出た場合は本ファイルの `調査結果・設計まとめ` を更新する
+- [x] `src/allographer/query_builder/libs/surreal/` と `models/surreal/` の効率改善余地を調査し、`documents/rdb/surreal_efficiency_report.md` に整理した
+- [x] `documents/rdb/surreal_efficiency_report.md` の P0/P1 項目に沿って、`surreal_impl.nim` の HTTP timeout 共通化、`surreal_open.nim` の bootstrap 1 回化、`surreal_lib.nim` の文字列生成改善、`surreal_exec.nim` の `getElems()` 化を実装した
+
+## 参考資料
+- `documents/rdb/mariadb_nonblocking_design.md` の内容を統合済み
+- `src/allographer/query_builder/models/mariadb/mariadb_open.nim`
+- `src/allographer/query_builder/models/mariadb/mariadb_exec.nim`
+- `src/allographer/query_builder/models/mariadb/mariadb_types.nim`
+- `src/allographer/query_builder/libs/mariadb/mariadb_impl.nim`
+- `src/allographer/query_builder/libs/mariadb/mariadb_rdb.nim`
+- `documents/rdb/surreal_efficiency_report.md`
+- `/usr/include/mariadb/mysql.h`
+- MariaDB Documentation: Non-Blocking API Reference
+- MariaDB Documentation: Using the Non-Blocking Library
+- `src/allographer/query_builder/models/postgres/postgres_open.nim`
+- `src/allographer/query_builder/models/postgres/postgres_exec.nim`
+
+## 調査結果・設計まとめ
+
+### 背景
+
+現行の MariaDB 実装は `Future` を返しているが、実際の MariaDB Connector/C 呼び出しは `mysql_real_query()` / `mysql_use_result()` / `mysql_fetch_row()` を同期的に使っている。
+
+そのため、Nim 側では async API に見えても、ソケット I/O 待機は Connector/C 内でブロックされうる。さらに接続プール枯渇時は `sleepAsync(10)` ポーリングで待っており、待機遅延が大きい。
+
+### 現状の問題
+
+1. `mariadb_exec.nim` の `getFreeConn` が `sleepAsync(10)` ポーリングで、プール返却の即時通知がない
+2. `mariadb_impl.nim` の `query*` / `exec*` / `getColumns*` は non-blocking API を使っていない
+3. `timeout` 引数はあるが、Connector/C の I/O 待機そのものをアプリ側 event loop で制御できていない
+4. `mysql_use_result()` を使う都合上、行フェッチ途中で新規操作を開始できないという Connector/C 制約を、内部設計として明示できていない
+5. 設計メモが別ファイルに分散すると、ブランチ進捗と参照資料の整合性が崩れやすい
+
+### 設計目標
+
+1. MariaDB クエリ送受信を Connector/C の `_start/_cont` API へ置き換える
+2. ソケット待機は `mysql_get_socket()` と `MYSQL_WAIT_*` に従って event loop で処理する
+3. `mysql_get_timeout_value_ms()` に従って timeout を扱い、ライブラリ内部 timeout と allographer の接続 timeout を両立させる
+4. 公開 API は維持し、driver 内部だけで差分を吸収する
+5. 接続プール空き待機は PostgreSQL と同様の通知ベースへ寄せる
+
+### 非目標
+
+1. Query Builder の公開 API 変更
+2. MySQL driver まで同時に全面改修すること
+3. 初回対応で prepared statement 系まで non-blocking 化すること
+4. このブランチの責務を MariaDB driver の範囲から広げすぎること
+
+### 実装方針
+
+#### 1. `mariadb_rdb.nim` に non-blocking API 宣言を揃える
+
+追加または有効化する対象:
+- `mysql_options`
+- `mysql_get_socket`
+- `mysql_get_timeout_value`
+- `mysql_get_timeout_value_ms`
+- `mysql_real_connect_start/cont`
+- `mysql_real_query_start/cont`
+- `mysql_store_result_start/cont`
+- `mysql_read_query_result_start/cont`
+- `mysql_fetch_row_start/cont`
+- `mysql_free_result_start/cont`
+- `MYSQL_WAIT_READ/WRITE/EXCEPT/TIMEOUT`
+- 必要なら `mysql_optionsv` など周辺宣言も不足なく追加する
+
+#### 2. `mariadb_open.nim` で non-blocking を明示的に有効化する
+
+手順:
+1. `mysql_init()` 後、`mysql_options(conn, MYSQL_OPT_NONBLOCK, nil)` を呼ぶ
+2. 接続自体も `mysql_real_connect_start/cont` に寄せるか、初手は接続のみ同期で残すかを選ぶ
+3. 設計上は接続も non-blocking に揃えるのが一貫するため、最終的には `_start/_cont` 化を目標とする
+
+補足:
+- MariaDB 公式ドキュメントでは、`MYSQL_OPT_NONBLOCK` を有効化せずに non-blocking API を使うとクラッシュしうる
+- DNS 解決は非同期化されないため、ホスト名利用時は依然として初回接続でブロックしうる
+- 接続初期化の最終形は `_start/_cont` へ寄せるが、既存動作を壊さない段階導入を優先する
+
+#### 3. `mariadb_impl.nim` に共通待機ヘルパを追加する
+
+候補ヘルパ:
+- `waitMariadb(conn: PMySQL, waitStatus: cint, deadline: MonoTime): Future[cint]`
+- `runMariadbOp[T](...)` のような `_start/_cont` 反復ヘルパ
+- `readAllRows(...)` のような result drain ヘルパ
+
+待機仕様:
+- `waitStatus` の `MYSQL_WAIT_READ/WRITE/EXCEPT` を `AsyncFD` で待つ
+- `MYSQL_WAIT_TIMEOUT` が立っているときは `mysql_get_timeout_value_ms()` を優先する
+- allographer 側 `timeout` を超えたら `DbError` を返す
+- 待機ループは API ごとに重複させず、共通の進行関数へ寄せる
+
+#### 4. クエリ実行は「送信」「結果確定」「結果取得」「行フェッチ」に分ける
+
+`SELECT` 系:
+1. `mysql_real_query_start/cont`
+2. `mysql_use_result()` または `mysql_store_result_start/cont` のどちらを使うか判断
+3. 既存実装との互換を優先するなら、まずは `mysql_use_result()` を維持しつつ `mysql_fetch_row_start/cont` で逐次取得する
+4. 行取得後に `mysql_free_result_start/cont` または `mysql_free_result()` で解放する
+
+`INSERT/UPDATE/DELETE` 系:
+1. `mysql_real_query_start/cont`
+2. `mysql_real_query_start/cont` の完了を実行完了とみなし、結果セットがない経路では追加の `read_query_result` 呼び出しを行わない
+3. `mysql_errno()` / `mysql_error()` を確認して `DbError`
+
+補足:
+- MariaDB 公式ドキュメントでは、`mysql_use_result()` 自体はブロックしないが、そこからの `mysql_fetch_row_start/cont` は `use_result` 由来なら待機を伴う
+- `store_result` を選ぶとフェッチ自体は即時化しやすい一方、結果全件受信を先に待つ必要がある
+- 現行の逐次処理に近いのは `use_result + fetch_row_start/cont`
+- 実装上の都合で `store_result` を選ぶ場合でも、公開 API の見え方は変えない
+- 実装検証では、`mysql_real_query_start/cont` 直後に `mysql_read_query_result_start/cont` を追加すると DML 経路でタイムアウトが発生したため、`exec*` 系は `real_query` 完了をもって終了判定する方針へ更新した
+
+#### 4.1 実装差分メモ（2026-03-23）
+
+- `mariadb_rdb.nim` の `MYSQL_OPT_NONBLOCK` は MariaDB ヘッダ定義に合わせて `6000` を明示指定した
+- `mariadb_impl.nim` では `waitMariadb` を共通化し、`mysql_real_query_start/cont` と `mysql_fetch_row_start/cont` / `mysql_free_result_start/cont` を統一ループで実行する実装にした
+- `mariadb_open.nim` で `mysql_options(conn, MYSQL_OPT_NONBLOCK, nil)` を全接続で有効化した
+- `mariadb_types.nim` / `mariadb_exec.nim` で接続プール待機を `waiters` ベースへ置換し、`sleepAsync(10)` ポーリングを撤廃した
+- `tests/mariadb/test_pool_wait.nim` を追加し、`tests/mariadb/test_query.nim` / `tests/mariadb/test_transaction.nim` と合わせて回帰確認した
+
+#### 4.2 効率改善差分メモ（2026-03-23）
+
+- `mariadb_impl.nim`: `setColumnInfo` を `while true` フェッチループの外に移動し、行ごとに `fetch_field_direct` の FFI 呼び出しと文字列アロケーションが発生する問題を解消した。各行では `baseColumns` のコピーに対して NULL 上書きのみ行う
+- `mariadb_impl.nim`: 全 proc から `assert db.ping == 0` を除去した。`mysql_ping` は同期ブロッキングでイベントループを停止するため。接続異常は `real_query_start` のエラーハンドリングで検出する
+- `mariadb_impl.nim`: `epochTime()` ベースのデッドライン管理を `std/monotimes` の `MonoTime` + `Duration` に置き換え、NTP 補正による巻き戻りリスクを排除した
+- `mariadb_impl.nim`: `MariadbWaitState` を `ref object` から `object`（値型）に変更し、`waitMariadb` 呼び出しあたり 1 回のヒープアロケーションを削減した
+- `mariadb_impl.nim`: JSON→string 変換ロジックを `jsonObjValuesToStrSeq` / `jsonFlatToStrSeq` の 2 proc に集約し、4 箇所の重複を解消した
+- `mariadb_impl.nim`: `getColumnTypes` の SQL を文字列補間から `?` プレースホルダに変更し、SQL インジェクションリスクを排除した
+- `mariadb_exec.nim`: `exec` / `insertId` が DML のたびに `INFORMATION_SCHEMA.COLUMNS` を問い合わせていた問題を、`Connections.columnTypeCache` によるテーブル単位キャッシュで解消した
+- `mariadb_types.nim`: `waiters` を `seq[Future[void]]` から `Deque[Future[void]]` に変更し、`wakeOnePoolWaiter` の先頭削除を O(n) → O(1) に改善した
+- `mariadb_lib.nim`: `dbFormat` の char-by-char 連結を、`?` 位置間のサブ文字列を一括 `add` する方式に変更した
+- SurrealDB: `surreal_impl.nim` に `runSurrealSql` / `awaitWithTimeout` を追加し、`query` / `exec` / `info` の HTTP timeout と JSON error 処理を共通化した
+- SurrealDB: `surreal_open.nim` で `/status` と `/sql` の bootstrap を timeout 対応で実行し、namespace/database 定義を初回接続へ集約した
+- SurrealDB: `surreal_lib.nim` の `numToAlphabet` / `questionToDaller` / `dbFormat(JsonNode)` を単一バッファ志向へ整理した
+- SurrealDB: `surreal_exec.nim` の `getAllRows` は `rows.getElems()` を使い、`toSeq()` の追加走査を避けた
+
+#### 5. 接続プール待機は通知ベースへ置換する
+
+`mariadb_types.nim`:
+- `Connections.waiters*: seq[Future[void]]` を追加する
+
+`mariadb_exec.nim`:
+- `getFreeConn` は waiter を積んで `withTimeout` で待つ
+- `returnConn` は接続返却後に 1 件だけ waiter を起こす
+- PostgreSQL 実装と同じ責務分割に揃える
+- waiters の起床順やキャンセル時の取り扱いは、既存 PostgreSQL 実装の方針に合わせて整理する
+
+#### 6. 段階導入する
+
+第1段階:
+- ヘッダ宣言追加
+- ブランチルール・設計書追加
+
+第2段階:
+- プール待機の通知化
+- `exec*` 系の non-blocking 化
+
+第3段階:
+- `query*` / `rawQuery*` / `getColumns*` / `insertId` の非同期 result drain 実装
+- テスト拡充
+- 段階ごとに実装差分が出たら本ファイルへ追記し、ブランチ内の唯一の設計記録にする
+
+### 受け入れ基準
+
+1. MariaDB driver で `sleepAsync(10)` によるプール待機がなくなっている
+2. `mariadb_impl.nim` のクエリ待機が `mysql_real_query_start/cont` などの non-blocking API を利用している
+3. 同一接続上で未完了 non-blocking 操作を残したまま次の操作を始めない
+4. 既存 CRUD / transaction / schema テストが回帰しない
+5. 公開 API 変更なしで実装差分が driver 内に閉じ込められている
+
+### 参照仕様
+
+- MariaDB Documentation: Non-Blocking API Reference
+  https://mariadb.com/docs/server/reference/product-development/mariadb-internals/using-mariadb-with-your-programs-api/non-blocking-client-library/non-blocking-api-reference
+- MariaDB Documentation: Using the Non-Blocking Library
+  https://mariadb.com/docs/server/reference/product-development/mariadb-internals/using-mariadb-with-your-programs-api/non-blocking-client-library/using-the-non-blocking-library
+- `/usr/include/mariadb/mysql.h`
+
+確認済み項目:
+- `MYSQL_OPT_NONBLOCK`
+- `MYSQL_WAIT_READ`, `MYSQL_WAIT_WRITE`, `MYSQL_WAIT_EXCEPT`, `MYSQL_WAIT_TIMEOUT`
+- `mysql_options`, `mysql_optionsv`
+- `mysql_get_socket`
+- `mysql_get_timeout_value`, `mysql_get_timeout_value_ms`
+- `mysql_real_connect_start/cont`
+- `mysql_real_query_start/cont`
+- `mysql_store_result_start/cont`
+- `mysql_read_query_result_start/cont`
+- `mysql_fetch_row_start/cont`
+- `mysql_free_result_start/cont`
+
+### リスク
+
+1. `mysql_use_result()` は結果を最後まで読み切る前に次操作へ進めないため、clean up 漏れがあると接続を壊しやすい
+2. MariaDB non-blocking API は `_cont()` を最後まで呼び切る必要があり、途中中断設計を誤ると不整合が出る
+3. DNS 解決はブロックしうるので、接続初期化だけは期待したほど改善しない可能性がある
+4. MySQL driver と共通化したくなっても、まずは MariaDB driver 内に閉じ込めてから判断すべき
+5. 設計記録を別ファイルに残さないことで、進捗と方針の乖離を抑える
+
+### 段階導入案
+
+1. 設計書とブランチルールを追加
+2. `mariadb_rdb.nim` に宣言追加
+3. プール待機通知化
+4. `exec*` 系を non-blocking 化
+5. `query*` / `rawQuery*` / `getColumns*` を non-blocking 化
+6. 必要なら `mysql_real_connect_start/cont` を導入
+
+### 完了条件
+
+1. MariaDB driver の内部待機が Connector/C non-blocking API ベースになっている
+2. プール空き待機が通知ベースである
+3. 既存公開 API を壊していない
+4. MariaDB の主要テストが通る

clients/nim-allographer/.cursor/rules/branch/323-database-url-for-connection.mdc

@@ -0,0 +1,174 @@
+---
+description: 323-database-url-for-connectionブランチでの開発時に読み込む
+alwaysApply: false
+---
+dbOpen Database URL 対応 ブランチルール
+===
+
+このブランチで実装することは以下の通りです。
+- `dbOpen` に database URL を使って接続できる新しいオーバーロードを追加し、既存の引数シグネチャは後方互換のため残す。
+- SQLite / MySQL / MariaDB / PostgreSQL は一般的な database URL 仕様に従い、scheme・認証情報・host・port・database path・query を解釈できる設計に整える。
+- URL 解析責務を各 driver の `dbOpen` 実装にベタ書きせず、共通化できる層へ寄せて公開 API を汚さない。
+- 既存の URL 文字列 1 引数版 `dbOpen` と、新しく追加する引数デザインの役割分担を明確にし、曖昧なオーバーロード解決を避ける。
+- 既存テスト・example・README・`documents/rdb/query_builder.md` を、最終仕様と齟齬がない状態へ同期する。
+
+## 進捗
+- [x] `.cursor/rules/project.mdc` と `.cursor/rules/branch.mdc` を確認した
+- [x] 現在のブランチ名に対応するブランチルールファイルが未作成であることを確認した
+- [x] 既存 `dbOpen` 実装が SQLite / MySQL / MariaDB / PostgreSQL / SurrealDB でどう分かれているか確認した
+- [x] MySQL / MariaDB / PostgreSQL にはすでに URL 文字列 1 引数版 `dbOpen` があり、SQLite には未整備であることを確認した
+- [x] 既存 URL 実装が `split` ベースの簡易パーサであり、一般的な URL 仕様を十分に扱えていないことを確認した
+- [x] 今回のブランチでは SurrealDB を対象外とする方針を反映した
+- [x] ブランチルールに改修方針・進捗粒度・参考資料を整理した
+- [x] 一般的な database URL 仕様として採用する範囲を整理する
+- [x] 新しい `dbOpen` オーバーロードの引数デザインを確定する
+- [x] URL 解析の共通 helper / 型配置を決め、driver 差分の閉じ込め方を整理する
+- [x] SQLite の URL 受け口を追加し、ファイルパス指定との意味論を衝突させない
+- [x] MySQL / MariaDB / PostgreSQL の URL 解析を一般仕様に合わせて強化する
+- [x] 正常系・異常系・後方互換のテストを driver ごとに追加または更新する
+- [x] example / README / documents を同期する
+- [x] 実装途中で設計認識に誤りが見つかった場合は、本ファイルの `調査結果・設計まとめ` を更新する
+
+## 参考資料
+- `src/allographer/connection.nim`
+- `src/allographer/query_builder/models/sqlite/sqlite_open.nim`
+- `src/allographer/query_builder/models/mysql/mysql_open.nim`
+- `src/allographer/query_builder/models/mariadb/mariadb_open.nim`
+- `src/allographer/query_builder/models/postgres/postgres_open.nim`
+- `src/allographer/query_builder/models/surreal/surreal_open.nim`
+- `tests/mysql/test_open.nim`
+- `tests/mariadb/test_open.nim`
+- `tests/postgres/test_open.nim`
+- `tests/sqlite/connections.nim`
+- `tests/postgres/connections.nim`
+- `tests/mysql/connections.nim`
+- `tests/mariadb/connections.nim`
+- `example/connections.nim`
+- `README.md`
+- `documents/rdb/query_builder.md`
+- RFC 3986: Uniform Resource Identifier (URI): Generic Syntax
+- PostgreSQL Documentation: Connection URIs
+- MySQL / MariaDB ecosystem documentation for connection URI / DSN conventions
+
+## 調査結果・設計まとめ
+
+### 背景
+
+現状の `dbOpen` は、RDB 系では「分解済みの接続情報を個別引数で渡す形」が基本で、一部 driver にだけ URL 文字列 1 引数版が追加されている。
+
+ただし既存の URL 版は `split` を重ねた簡易実装で、一般的な URL で登場する予約文字・query・省略可能項目・scheme 差異に弱い。API としては URL 対応を名乗りつつ、仕様が狭く不均一な状態である。
+
+今回の目的は、既存 API を壊さずに、database URL を正式な接続入力として扱える `dbOpen` オーバーロード群を整備し、RDB driver 間の設計を揃えることである。SurrealDB は今回の対象外とする。
+
+### 現状の問題
+
+1. SQLite はファイルパス引数のみで、URL ベース接続の入口がない
+2. MySQL / MariaDB / PostgreSQL の URL 版は実装されているが、一般的な URL 仕様を十分に扱えない
+3. driver ごとに URL の扱いがバラバラで、共通 API として学習コストが高い
+4. 既存の URL 文字列 1 引数版と、新たな「database url を使う関数」の住み分けを設計しないと、将来の拡張で曖昧さが増える
+
+### 設計目標
+
+1. 既存 `dbOpen` シグネチャを残しつつ、新しいオーバーロードで URL ベース接続を自然に表現できる
+2. SQLite / MySQL / MariaDB / PostgreSQL は一般的な URI 記法を優先する
+3. URL 解析と driver ごとの接続情報変換を責務分離し、公開 API へ場当たり的分岐を持ち込まない
+4. 後方互換・テスト・文書更新まで含めて、利用者が迷わない状態を作る
+
+### 非目標
+
+1. 既存の個別引数版 `dbOpen` を削除または非推奨化すること
+2. 接続 URL と無関係な query builder / schema builder API を同時に変更すること
+3. SurrealDB の接続モデルや URL 設計をこのブランチで見直すこと
+4. このブランチで ORM 的な接続設定 abstraction を全面導入すること
+
+### API 方針
+
+#### 1. 新しいオーバーロードは「URL であることが呼び出し側から明確に分かる」形を優先する
+
+候補:
+1. `dbOpen(MySQL, url = "...", maxConnections = ..., timeout = ...)`
+2. `dbOpen(MySQL, databaseUrl = "...", maxConnections = ..., timeout = ...)`
+3. URL 専用の薄い型を導入して `dbOpen(MySQL, DatabaseUrl("..."), ...)`
+
+採用した設計:
+- URL 専用の薄い型 `DatabaseUrl` を導入し、`dbOpen(driver, databaseUrl = asDatabaseUrl("..."), ...)` で呼べるようにした
+- 既存の `dbOpen(driver, url: string, ...)` は後方互換のため残し、内部では共通 parser に委譲する
+- SQLite の既存 `dbOpen(SQLite3, path: string, ...)` はそのまま維持し、URL 文字列が渡された場合のみ URL ルートへ寄せる
+
+理由:
+- SQLite では単なる `string` がファイルパスと URL の両方になり得る
+- `DatabaseUrl` に分けることで、既存の string overload と overload 解決が衝突しない
+- 将来の拡張でも、URL 専用の入口を安全に追加しやすい
+
+#### 2. RDB の URL 仕様は一般的な形式を優先する
+
+最低限そろえる対象:
+1. `sqlite:///absolute/path/to/db.sqlite3`
+2. `sqlite://relative/path.db` またはこの扱いを不採用とするなら明文化する
+3. `mysql://user:pass@host:3306/database`
+4. `mariadb://user:pass@host:3306/database`
+5. `postgresql://user:pass@host:5432/database`
+
+設計メモ:
+- `postgres://...` は `postgresql://...` の alias として受ける
+- percent-encoding の decode 要否を明確にする
+- query parameter は現段階で未使用でも、少なくとも破壊的に誤解釈しない方針を取る
+- database 名や password に `:` `/` `@` が含まれるケースを、単純 `split` で壊さない
+
+### 実装方針
+
+#### 1. URL 解析は共通 helper 化を優先する
+
+方針:
+- `scheme`, `user`, `password`, `host`, `port`, `path`, `query` を扱える共通 parser を用意する
+- URL 専用の `DatabaseUrl` を導入し、driver ごとの差分は「解析結果からどう接続情報へ落とすか」に限定する
+- 既存 driver ファイルの `split` ベース処理は置き換え対象とする
+
+#### 2. SQLite は URL とファイルパスの意味論を分ける
+
+要点:
+- 既存 `dbOpen(SQLite3, "/path/to/file.db")` はそのまま維持する
+- URL 版は `asDatabaseUrl(...)` で「これは URL」と明示できる形を優先する
+- `:memory:` や相対パスとの整合を壊さない
+
+#### 3. 既存 URL 1 引数版は互換維持しつつ内部実装を新 parser に寄せる
+
+要点:
+- MySQL / MariaDB / PostgreSQL の既存テストは維持する
+- 既存の `ValueError` / `DbError` の期待が妥当なら保つ
+- 公開 API は残しつつ、仕様の狭さだけを改善する
+
+#### 4. テストは「構文解析」と「実接続」を分けて考える
+
+候補:
+1. URL から接続情報へ正しく分解されることを確認する軽量テスト
+2. 既存の integration 系 `dbOpen(...).isConnected()` テスト
+3. 不正 scheme・不足情報・不正 port・予約文字を含む入力の異常系テスト
+4. SQLite の URL 指定とファイルパス指定の後方互換テスト
+5. SurrealDB の namespace / database 解決規則テスト
+
+### 受け入れ基準
+
+1. 既存の `dbOpen` 呼び出しを壊さずに、新しい URL ベースのオーバーロードを追加できている
+2. SQLite / MySQL / MariaDB / PostgreSQL の URL 設計が一般的な仕様と整合している
+3. SurrealDB の URL 設計が独自要件を満たしつつ、他 driver と読後感が大きく乖離していない
+4. 既存の簡易 `split` 実装を置き換え、予約文字や query を誤解釈しにくい構造になっている
+5. driver ごとの正常系・異常系・後方互換テストが追加または更新されている
+6. example / README / documents / ブランチルールが最終仕様と一致している
+
+### リスク
+
+1. Nim 標準ライブラリだけで URL 解析を行う場合、RFC 3986 の細部を十分に扱えない可能性がある
+2. SQLite の URL 仕様を曖昧にすると、既存のファイルパス API と混同されやすい
+3. SurrealDB の namespace / database の載せ方を誤ると、RDB に寄せたつもりで逆に分かりにくくなる
+4. 既存の `dbOpen(driver, urlString)` と新オーバーロードが衝突すると、Nim の overload 解決で利用者体験が悪化する
+5. 文字列解析だけでなく実接続テストも必要なため、driver 横断で確認コストが上がる
+
+### 段階導入案
+
+1. 採用する URL 仕様と新オーバーロードの表面 API を確定する
+2. 共通 URL parser / 接続情報変換レイヤを用意する
+3. MySQL / MariaDB / PostgreSQL の既存 URL 実装を載せ替える
+4. SQLite の URL 入口を追加する
+5. テストを整備して後方互換と異常系を固める
+6. example / README / documents を同期する

clients/nim-allographer/.cursor/rules/branch/333-prepared-statement.mdc

@@ -0,0 +1,167 @@
+---
+description: 333-prepared-statementブランチでの開発時に読み込む
+alwaysApply: false
+---
+333-prepared-statement ブランチでの高速化内容
+===
+
+このブランチで実装することは以下の通りです。
+- prepared statement を、高頻度な同一 SQL 実行で通常経路より速くなるように改善する
+- とくに PostgreSQL で、prepare/deallocate の無駄と接続拡散を減らす
+- benchmark が prepared statement の warm 状態を正しく測れるようにする
+
+## 進捗
+
+- [x] `example/benchmark.nim` の PostgreSQL 計測で prepared update が遅く見える理由を調査した
+- [x] prepared statement 高速化の設計方針を整理した
+- [ ] PostgreSQL にプール単位の prepared statement cache を追加する
+- [ ] `close()` を論理 close 化し、物理破棄は別 API に分離する
+- [ ] 接続固定で prepared statement を連続実行できる API を追加する
+- [ ] `example/benchmark.nim` を cold/warm 計測に分離し、warm 経路で同一 statement を再利用する
+- [ ] prepared cache と接続固定 API のテストを追加する
+
+## 参考資料
+
+- PostgreSQL libpq prepared statements: https://www.postgresql.jp/document/12/html/libpq-exec.html
+  - `PQsendPrepare`
+  - `PQsendQueryPrepared`
+  - `DEALLOCATE`
+- PostgreSQL 非同期 libpq: https://www.postgresql.jp/document/12/html/libpq-async.html
+- 対象実装
+  - `src/allographer/query_builder/models/postgres/postgres_exec.nim`
+  - `src/allographer/query_builder/models/postgres/postgres_types.nim`
+  - `src/allographer/query_builder/libs/postgres/postgres_impl.nim`
+  - `example/benchmark.nim`
+
+## 調査結果・設計まとめ
+
+### 現状の問題
+
+PostgreSQL で prepared statement が遅く見える主因は、prepared statement 自体の性質ではなく、現在の実装と benchmark の計測条件にある。
+
+- `benchmark.nim` は計測のたびに `prepare` と `close` を行っており、steady-state の再利用性能ではなくライフサイクル全体を測っている
+- PostgreSQL 実装は prepared statement をコネクションごとに lazy prepare するため、プールが大きいと `PREPARE` が広く拡散する
+- `first()` と `exec()` が毎回 `getFreeConn()` するため、1 つの業務操作でも接続が変わり、prepared state の局所性が弱い
+- 通常経路も `PQsendQueryParams` による bind 実行なので、prepared の利得は parse/plan 再利用ぶんに限られる
+
+### 高速化の基本方針
+
+prepared statement を速くするには、単発 API を追加するだけでは足りない。以下をまとめて入れる必要がある。
+
+- prepare/deallocate の回数を減らす
+- 同じ logical operation を同じ接続に寄せる
+- warm 済み prepared state をプール内で継続利用する
+
+### 設計方針 1: プール単位の prepared cache
+
+`PreparedStatement` ハンドルごとに物理 state を持つのではなく、`Connections` が SQL ごとの prepared state を保持する。
+
+概念設計:
+
+```nim
+type PostgresPreparedEntry = ref object
+  sql*: string
+  nArgs*: int
+  stmtBaseName*: string
+  stmtNames*: seq[string]   ## connI ごとの物理 prepared 名
+  refCount*: int
+  lastUsedAt*: int64
+
+type Connections* = ref object
+  conns*: seq[Connection]
+  timeout*: int
+  waiters*: Deque[Future[void]]
+  columnTypeCache*: Table[string, seq[Row]]
+  preparedCache*: Table[string, PostgresPreparedEntry]
+```
+
+期待効果:
+
+- 同じ SQL に対する `prepare()` の重複を避けられる
+- 同一プール内では physical prepare を接続ごとに 1 回へ寄せられる
+- 短命な prepared handle を繰り返し作っても warm state を失いにくくなる
+
+### 設計方針 2: `close()` の論理 close 化
+
+現在の `close()` は、その handle が使った接続すべてに `DEALLOCATE` を送る。高速化の観点ではこれは不利なので、意味論を分ける。
+
+- `close()`: handle の参照を閉じるだけ
+- `clearPreparedCache()` または `flushPrepared(sql)`: 物理 `DEALLOCATE`
+- 接続 close 時: その接続に紐づく prepared state を一括破棄
+
+期待効果:
+
+- 利用者が毎回 `prepare` / `close` しても、プール側は hot SQL を保持できる
+- benchmark の warm 計測でも、毎回の物理破棄コストを避けられる
+
+### 設計方針 3: 接続固定 API の追加
+
+prepared statement の locality を高めるため、同じ接続上で複数回の prepared 実行を束ねる API を追加する。
+
+候補 API:
+
+```nim
+proc withPreparedConnection*(
+  self: PostgresConnections,
+  body: proc (ctx: PostgresPreparedContext): Future[void]
+): Future[void]
+```
+
+```nim
+type PostgresPreparedContext* = ref object
+  owner*: PostgresConnections
+  connI*: int
+```
+
+prepared statement 側には `ctx` 付き overload を足す。
+
+```nim
+proc first*(self: PostgresPreparedStatement, ctx: PostgresPreparedContext, args: seq[string]): Future[Option[JsonNode]]
+proc exec*(self: PostgresPreparedStatement, ctx: PostgresPreparedContext, args: seq[string]): Future[void]
+```
+
+期待効果:
+
+- `SELECT` と `UPDATE` が別接続に飛ぶのを防げる
+- lazy prepare の発生先が必要な接続に限定される
+- transaction 中の `transactionConn` と整合しやすい
+
+### benchmark の変更方針
+
+`example/benchmark.nim` は prepared statement の高速化効果を正しく測れるように変更する。
+
+- `selectStmt` / `updateStmt` を `timeProcess` の外で 1 回だけ作る
+- 繰り返し計測では同じ prepared statement を再利用する
+- `close()` は全計測の最後に 1 回だけ呼ぶ
+- benchmark 名を `cold` と `warm` に分ける
+- warm 計測では `withPreparedConnection` を使って接続固定経路を測る
+
+### 実装順序
+
+#### Phase 1
+
+- `Connections.preparedCache` を追加する
+- `prepare()` を cache lookup ベースに変更する
+- `close()` を論理 close 化する
+- `clearPreparedCache()` を追加する
+
+#### Phase 2
+
+- `PostgresPreparedContext` を追加する
+- `withPreparedConnection` を追加する
+- prepared `get/first/exec` に `ctx` overload を追加する
+- `benchmark.nim` を warm/cold 計測へ更新する
+
+#### Phase 3
+
+- `preparedCacheMaxEntries` を追加する
+- `refCount == 0` の entry を対象に LRU eviction を入れる
+- eviction 時に `DEALLOCATE` を発行する
+
+### テスト方針
+
+- 同じ SQL を複数回 `prepare()` しても、同一接続で physical prepare が 1 回に収まること
+- `close()` 後に再 `prepare()` しても、cache が残る設計なら physical prepare が増えないこと
+- `withPreparedConnection` の block 内で同じ `connI` が使われること
+- transaction 中は `transactionConn` が優先されること
+- cache eviction 時に `DEALLOCATE` が正しく走ること

clients/nim-allographer/.cursor/rules/branch/336-update-prepared-statement.mdc

@@ -0,0 +1,206 @@
+---
+description: 336-update-prepared-statementブランチでの開発時に読み込む
+alwaysApply: false
+---
+336-update-prepared-statement ブランチでの prepared statement 横展開
+===
+
+このブランチで実装することは以下の通りです。
+- 既存の SQLite / PostgreSQL / MySQL / MariaDB の prepared statement API を参照しつつ、SurrealDB 向け prepared statement API を追加する
+- SurrealDB v3 の `/sql` API と SurrealQL の `LET` / parameter 仕様を前提に、server-side prepare ではなく client-side template reuse と 1 リクエスト多文実行で prepared statement 的な使い勝手を実現する
+- SurrealDB 固有事情は `models/surreal` と `libs/surreal` に閉じ込め、公開 API は既存 driver と可能な限り揃える
+- このターンでは実装は行わず、調査結果と実装方針の設計書を固める
+
+## 進捗
+
+- [x] `.cursor/rules/project.mdc` / `.cursor/rules/branch.mdc` / `.cursor/rules/branch/336-update-prepared-statement.mdc` を確認した
+- [x] 既存 prepared statement API の到達点を SQLite / PostgreSQL / MariaDB / MySQL で確認した
+- [x] 現在の SurrealDB 実装と `/sql` 利用箇所を確認した
+- [x] SurrealDB v3 公式ドキュメントで parameter / HTTP `/sql` / transaction の仕様を確認した
+- [x] SurrealDB prepared statement の設計と利用例を `documents/surrealdb/prepared_statement.md` に整理した
+- [x] `models/surreal` に prepared statement 用の型と公開 API を追加した
+- [x] `libs/surreal` に multi-statement 実行向けの共通処理を追加した
+- [x] SurrealDB prepared statement のテストを追加した
+- [x] `documents/surrealdb/query_builder.md` / `documents/rdb/query_builder.md` を更新した
+
+## 参考資料
+
+- 既存 prepared statement API
+  - `src/allographer/query_builder/models/sqlite/sqlite_types.nim`
+  - `src/allographer/query_builder/models/sqlite/sqlite_exec.nim`
+  - `src/allographer/query_builder/models/postgres/postgres_types.nim`
+  - `src/allographer/query_builder/models/postgres/postgres_exec.nim`
+  - `src/allographer/query_builder/models/mysql/mysql_exec.nim`
+  - `src/allographer/query_builder/models/mariadb/mariadb_exec.nim`
+- 現在の SurrealDB 実装
+  - `src/allographer/query_builder/models/surreal/surreal_types.nim`
+  - `src/allographer/query_builder/models/surreal/surreal_exec.nim`
+  - `src/allographer/query_builder/models/surreal/surreal_open.nim`
+  - `src/allographer/query_builder/libs/surreal/surreal_impl.nim`
+  - `src/allographer/query_builder/libs/surreal/surreal_lib.nim`
+  - `src/allographer/schema_builder/queries/surreal/schema_utils.nim`
+- 既存ドキュメント
+  - `documents/surrealdb/query_builder.md`
+  - `documents/surrealdb/schema_builder.md`
+- SurrealDB v3 公式ドキュメント
+  - Parameters: https://surrealdb.com/docs/surrealql/parameters
+  - HTTP Protocol (`POST /sql`): https://surrealdb.com/docs/surrealdb/integration/http
+  - Transactions: https://surrealdb.com/docs/surrealql/transactions
+  - Security summary (parameterized query): https://surrealdb.com/docs/surrealdb/security/summary
+
+## 調査結果・設計まとめ
+
+### 1. 前提整理
+
+SurrealDB v3 には PostgreSQL や MySQL のような server-side prepared statement を、そのまま同じ意味で `/sql` HTTP 経由に載せる公開 API は見当たらない。一方で、以下は公式仕様として確認できる。
+
+- `/sql` は 1 回の POST で複数の SurrealQL 文を `;` 区切りで送れる
+- parameter は `LET $x = ...;` で定義して後続文から参照できる
+- SurrealDB 3.x では `$x = ...` だけの旧記法は deprecated で、`LET` を使う必要がある
+- statement はデフォルトで文ごとに transaction 境界を持つ。複数文を原子的に扱いたい場合は `BEGIN TRANSACTION; ...; COMMIT TRANSACTION;` が必要
+
+したがって、このブランチでの `prepare()` は「DB が statement を事前コンパイルして保持する API」ではなく、「SQL template の正規化・再利用・安全な値埋め込み・単一 request 化を行う client-side prepared statement」として設計する。
+
+### 2. 公開 API 方針
+
+利用者体験は既存 driver に寄せる。第一候補は次の API である。
+
+```nim
+let stmt = surreal.prepare("SELECT * FROM user WHERE id = ?")
+let rows = await stmt.get(@["user:alice"])
+let row = await stmt.first(%*[1])
+await stmt.exec(@["value"])
+await stmt.close()
+await surreal.clearStmtCache()
+await surreal.withConn(proc(ctx: SurrealPreparedContext): Future[void] {.async.} =
+  discard await stmt.first(ctx, @["user:alice"])
+)
+```
+
+採用方針:
+
+- `prepare`
+- `get`
+- `first`
+- `exec`
+- `close`
+- `flushStmt`
+- `clearStmtCache`
+- `withConn`
+- `SurrealPreparedContext`
+
+初期スコープでは `getPlain` / `firstPlain` は後回し候補とする。SurrealDB の戻り値は object 中心で列定義が RDB より弱く、列順の意味が薄いため、まずは既存の `JsonNode` 中心 API を優先する。
+
+### 3. 実装モデル
+
+prepared statement 実行時は、毎回次の 3 段階で 1 リクエストを組み立てる。
+
+1. 元 SQL の `?` を `$a`, `$b`, ... に変換する
+2. 各引数を `LET $a = ...; LET $b = ...;` に変換する
+3. `LET` 群と本体 SQL を `;` で連結して `/sql` に 1 回だけ POST する
+
+概念的には次の形になる。
+
+```sql
+LET $a = "user:alice";
+LET $b = <datetime>"2026-04-03T00:00:00Z";
+SELECT * FROM user WHERE id = $a AND created_at >= $b;
+```
+
+この方式なら、すでに `surreal_lib.nim` にある `questionToDaller` と `dbFormat(queryString, args: JsonNode)` の思想をそのまま再利用できる。prepared statement 専用に別の埋め込み規則を増やす必要はない。
+
+### 4. 型設計
+
+既存 driver に合わせ、プール単位 cache を持つ。
+
+```nim
+type SurrealPreparedEntry = ref object
+  sql*: string
+  normalizedSql*: string
+  nArgs*: int
+  refCount*: int
+  lastUsedAt*: int64
+
+type Connections* = ref object
+  conns*: seq[Connection]
+  timeout*: int
+  waiters*: Deque[Future[void]]
+  preparedCache*: Table[string, SurrealPreparedEntry]
+
+type SurrealPreparedContext* = ref object
+  owner*: SurrealConnections
+  connI*: int
+
+type SurrealPreparedStatement* = ref object
+  owner*: SurrealConnections
+  entry*: SurrealPreparedEntry
+  sql*: string
+  isClosed*: bool
+```
+
+ポイント:
+
+- Surreal は HTTP `/sql` なので physical statement handle は持たない
+- cache の目的は server resource 再利用ではなく、template 正規化と API 一貫性の維持
+- `close()` は logical close とし、cache entry 自体は `flushStmt` / `clearStmtCache` まで残す
+
+### 5. 実行結果の扱い
+
+`/sql` の戻り値は statement ごとの配列なので、prepared statement では「最後の本体 SQL の結果」を利用者へ返す。
+
+- `get`: 最終 statement の `result` を `seq[JsonNode]` で返す
+- `first`: `get` の先頭 1 件を `Option[JsonNode]` で返す
+- `exec`: 最終 statement の status を確認し、副作用系として扱う
+- `LET` statement の result は利用者に見せない
+
+ただし error 判定は最後の statement だけでなく全 statement を走査する。`LET` で失敗した場合でも早期に `DbError` を返す必要がある。
+
+### 6. `withConn` を残す理由
+
+HTTP `/sql` だけを見ると、prepared statement は connection 固定が必須ではない。しかし API 統一のため、`withConn` は残す価値がある。
+
+- 既存 driver と同じ呼び出しパターンを維持できる
+- SurrealDB の parameter は connection/session scope を持ちうるため、将来 RPC 対応や session 前提最適化へ進む余地を残せる
+- 現行の connection pool 制御と整合する
+
+ただし初期実装では、`withConn` の主目的は性能よりも API 一貫性になる。
+
+### 7. multi-statement 利用の境界
+
+このブランチで使う multi-statement は「`LET` 群 + 本体 SQL」を 1 リクエストに束ねる用途を主眼とする。
+
+- `prepare("UPDATE ...")` は 1 つの本体 statement を持つ
+- `LET` は前置 statement
+- 複数の業務 statement を 1 個の prepared statement に詰め込む設計は初期スコープ外
+
+理由:
+
+- 既存 prepared statement API も基本は 1 SQL を対象にしている
+- SurrealDB では複数 statement が自動で 1 transaction にはならない
+- 2 個以上の副作用文を 1 本の prepared statement に許すと、`exec()` の返り値・失敗時意味論・テストが急に複雑になる
+
+もし将来 multi-statement business query を扱うなら、別 API として `prepareBatch` あるいは transaction helper を検討する。
+
+### 8. 実装結果
+
+- `surreal_types.nim` に prepared 関連型を追加し、`Connections` に `preparedCache` を持たせた
+- `surreal_lib.nim` に prepared SQL 生成の共通関数を追加した
+- `surreal_exec.nim` に `prepare` / `get` / `first` / `exec` / `close` / `flushStmt` / `clearStmtCache` / `withConn` を追加した
+- `tests/surrealdb/test_prepared_statement.nim` を追加した
+- `documents/surrealdb/prepared_statement.md` と既存ドキュメントを同期した
+
+### 9. テスト方針
+
+- `prepare("SELECT ... WHERE id = ?")` で `get` / `first` が通ること
+- `prepare("UPDATE ... SET name = ? WHERE id = ?")` で `exec` が通ること
+- `close()` 後に同じ SQL を `prepare()` し直しても再利用できること
+- `clearStmtCache()` 後に再度 `prepare()` できること
+- `withConn` 内の `ctx` overload が通ること
+- `JsonNode` 引数で `JInt` / `JString` / `JNull` / `JArray` / `JObject` が `LET` 経由で正しく扱えること
+- record id や datetime 文字列の変換が既存 `dbFormat` 規則と一致すること
+
+### 10. 現時点の結論
+
+SurrealDB v3 版 prepared statement は「server-side prepare の移植」ではなく、「既存 prepared statement API と揃った公開インターフェースを、SurrealDB の `LET` と `/sql` multi-statement で安全に再現する」方針が最も自然である。
+
+この方針なら `SYW-ARCH-001` に従って公開 API を共通化しつつ、SurrealDB 固有差分は `libs/surreal` と `models/surreal` に閉じ込められる。

clients/nim-allographer/.cursor/rules/branch/340-aged-connection.mdc

@@ -0,0 +1,271 @@
+---
+description: 340-aged-connectionブランチでの開発時に読み込む
+alwaysApply: false
+---
+340-aged-connection コネクションプール改善調査
+===
+
+このブランチで実装することは以下の通りです。
+- 既存の SQLite / PostgreSQL / MySQL / MariaDB のコネクションプール実装を調査し、長寿命化した接続や壊れた接続を再利用し続けるリスクを洗い出す
+- https://please-sleep.cou929.nu/go-sql-db-connection-pool.html の `sql.DB` の考え方を参考に、allographer のプールへ取り込める改善点を整理する
+- 「使えないコネクションは破棄してから張り直す」方針を、公開 API を壊さず driver 内へ閉じ込めて実装できる設計に落とし込む
+- prepared statement cache / columnTypeCache / transaction 中の接続固定など、再接続時に影響する内部状態の整合条件を明確化する
+- 調査結果を踏まえて、各 driver の pool slot を差し替える実装へ進める
+
+## 進捗
+- [x] `.cursor/rules/project.mdc` / `.cursor/rules/branch.mdc` を確認した
+- [x] 現在のブランチ名 `340-aged-connection` に対応するブランチルールを新規作成した
+- [x] `src/allographer/query_builder/models/*/*_open.nim` を確認し、各 driver の接続生成方式を調査した
+- [x] `src/allographer/query_builder/models/*/*_exec.nim` を確認し、接続取得・返却・待機方式を調査した
+- [x] `src/allographer/query_builder/libs/*/*_impl.nim` を確認し、接続異常時の現在の振る舞いを調査した
+- [x] 参考記事の `sql.DB` の設計要点を読み、allographer へ適用できる論点を整理した
+- [x] 各 driver 共通で使える `ConnectionHealth` / `ConnectionFactory` 相当の内部構造を設計し、`Connections` に lifetime / factory 情報を持たせた
+- [x] 接続借用時の寿命判定・再生成手順を driver ごとに実装した
+- [x] prepared statement cache の slot 単位無効化を実装し、transaction 中は既存の固定接続をそのまま使う方針を維持した
+- [x] 影響範囲に応じた回帰テストを追加した
+
+## 参考資料
+- 参考記事
+  - https://please-sleep.cou929.nu/go-sql-db-connection-pool.html
+- 現在の接続初期化
+  - `src/allographer/query_builder/models/postgres/postgres_open.nim`
+  - `src/allographer/query_builder/models/sqlite/sqlite_open.nim`
+  - `src/allographer/query_builder/models/mysql/mysql_open.nim`
+  - `src/allographer/query_builder/models/mariadb/mariadb_open.nim`
+- 現在の接続プール管理
+  - `src/allographer/query_builder/models/postgres/postgres_exec.nim`
+  - `src/allographer/query_builder/models/sqlite/sqlite_exec.nim`
+  - `src/allographer/query_builder/models/mysql/mysql_exec.nim`
+  - `src/allographer/query_builder/models/mariadb/mariadb_exec.nim`
+- 現在の型定義
+  - `src/allographer/query_builder/models/postgres/postgres_types.nim`
+  - `src/allographer/query_builder/models/sqlite/sqlite_types.nim`
+  - `src/allographer/query_builder/models/mysql/mysql_types.nim`
+  - `src/allographer/query_builder/models/mariadb/mariadb_types.nim`
+- 接続利用時の低レベル実装
+  - `src/allographer/query_builder/libs/postgres/postgres_impl.nim`
+  - `src/allographer/query_builder/libs/sqlite/sqlite_impl.nim`
+  - `src/allographer/query_builder/libs/mysql/mysql_impl.nim`
+  - `src/allographer/query_builder/libs/mariadb/mariadb_impl.nim`
+
+## 調査結果・設計まとめ
+
+### 1. 現在の実装で見えたこと
+
+allographer のプールは、全 driver とも `dbOpen` 時に `maxConnections` 本を先に開いて配列へ保持する方式になっている。
+
+- PostgreSQL: `postgres_open.nim` で全接続を eager に生成し、`createdAt` を持つが、寿命判定にはまだ使っていない
+- SQLite: `sqlite_open.nim` でも同様に eager open で、`createdAt` は保持しているが再接続用途には未使用
+- MySQL: `mysql_open.nim` で eager open。`ConnectionInfo` はあるため再接続情報は保持しやすい
+- MariaDB: `mariadb_open.nim` も eager open。`ConnectionInfo` はある
+
+接続取得は、PostgreSQL / SQLite / MariaDB は waiter キューで通知ベース、MySQL はまだ `sleepAsync(10)` ポーリングで待っている。
+
+一方で、どの driver でも「借り出す前にその接続が寿命切れか」「壊れていないか」を判定して、不要なら捨てて張り直す仕組みはまだない。
+
+### 2. 参考記事から取り込める設計要点
+
+参考記事の `sql.DB` で特に重要だった論点は次の 5 点。
+
+1. idle 接続と利用中接続を分けて扱う
+2. 接続取得時に idle 接続を再利用し、必要なら新規接続する
+3. 待ち行列を持ち、上限到達時は空き通知で待つ
+4. `SetConnMaxLifetime` / `SetConnMaxIdleTime` 相当で、古い接続を使い回しすぎない
+5. 使えない接続は `ErrBadConn` 相当として捨て、再試行できるようにする
+
+allographer は 1. と 3. は一部できているが、4. と 5. が弱い。今回のブランチの主眼はここに置くのが自然。
+
+### 3. 今のプールで改善余地が大きい箇所
+
+#### 3.1 aged connection を判定する仕組みがない
+
+各 driver の `Connection` には `createdAt` があるが、現在は接続寿命の上限判定に使っていない。
+
+そのため、
+
+- DB サーバ側 `wait_timeout`
+- TCP 切断
+- 長時間放置された idle 接続
+- LB / proxy 配下でのコネクション寿命超過
+
+といった要因で「見た目はプール内にあるが、実際にはもう使えない接続」を抱え続ける可能性がある。
+
+特に MySQL は `mysql_impl.nim` の各所で `assert conn.ping == 0` を前提にしており、壊れた接続に対して graceful に「捨てて張り直す」制御へ入る前に異常化しやすい。
+
+#### 3.2 bad connection を pool slot 単位で交換できない
+
+現状は `self.pools.conns[i].conn` をそのまま実行系へ渡しており、途中で「この接続は再利用不可」と判断しても、その slot の中身を閉じて新しい接続に差し替える共通処理がない。
+
+必要なのは次のような流れである。
+
+1. 接続借用前に寿命・健全性を判定する
+2. 異常ならその slot の接続を close する
+3. 同じ slot に新しい接続を張り直す
+4. その slot にぶら下がる prepared statement 状態を無効化する
+5. その後でクエリ本体へ進む
+
+今は 2. から 4. の共通導線が存在しない。
+
+#### 3.3 reconnect に必要な情報が driver ごとに不揃い
+
+MySQL / MariaDB は `ConnectionInfo` を持つが、PostgreSQL / SQLite の `Connections` には再接続用の接続情報が保存されていない。
+
+したがって共通の「壊れた slot を再接続する」設計を入れるには、少なくとも内部的には各 driver の `Connections` に factory 情報を保持させる必要がある。
+
+例:
+
+- PostgreSQL: database / user / password / host / port / non-blocking 設定
+- SQLite: database path
+- MySQL / MariaDB: 既存 `ConnectionInfo` を `Connections` から参照できる形へ統一
+
+#### 3.4 prepared statement cache が再接続で壊れうる
+
+PostgreSQL / MySQL / MariaDB / SQLite は SQL 単位 cache を持ちつつ、物理 statement handle は conn index ごとに保持している。
+
+このため slot `i` の接続を捨てて張り直すなら、少なくとも slot `i` に紐づく prepared 情報はクリアしないといけない。
+
+- PostgreSQL: `stmtNames[i]` を空に戻す必要がある
+- MySQL / MariaDB: `stmts[i]` を close して nil に戻す必要がある
+- SQLite: `stmts[i]` を finalize して nil に戻す必要がある
+
+再接続だけして cache を残すと、「古い接続に prepare されたハンドルを新しい接続で再利用しようとする」不整合になる。
+
+#### 3.5 transaction 中は自動再接続の扱いを厳格に分ける必要がある
+
+通常クエリでは bad connection を破棄して retry できる余地があるが、transaction 中は話が変わる。
+
+- `BEGIN` 後の接続が死んだら、その transaction 文脈は失われる
+- 同じ API 呼び出しを別接続へ載せ替えても、意味上は同じ transaction ではない
+
+したがって transaction 中は、
+
+- 自動再接続して継続してよい場面
+- 明示的に `DbError` を返して transaction abort を促す場面
+
+を分ける必要がある。初期方針としては「transaction 中は bad connection を検知したら再接続はしても自動リトライしない」が安全。
+
+### 4. このブランチで採るべき基本方針
+
+#### 方針A: pool slot を生かし、接続だけ差し替える
+
+公開 API を崩さないため、接続プール自体を大きく作り変えるより、既存の `conns[i]` 配列を維持したまま「slot 内の接続実体だけ交換する」方がよい。
+
+これにより、
+
+- `getFreeConn` / `returnConn` の外形は維持できる
+- prepared cache の添字も維持できる
+- driver 差分を `*_open.nim` / `*_exec.nim` / `*_types.nim` に閉じ込めやすい
+
+#### 方針B: 借用時に寿命判定、実行失敗時に bad connection 判定を入れる
+
+初回実装は、次の 2 箇所で接続再生成を行うのがよい。
+
+1. `getFreeConn` で idle 接続を貸し出す直前
+2. クエリ / prepare 実行中に「接続断」と判断できる例外を受けた直後
+
+1 は proactive、2 は reactive な対策である。両方あると「古い接続をなるべく使わない」と「想定外に死んだ接続をすぐ交換する」の両立ができる。
+
+#### 方針C: ping 常用よりも age/lifetime と error 分類を優先する
+
+毎回 ping してから貸し出す設計は単純だが、MySQL/MariaDB では同期的な `ping` が待機コストや event loop 停止要因になりうる。
+
+そのため初手は、
+
+- `createdAt` ベースの `maxLifetime`
+- 必要なら `lastUsedAt` ベースの `maxIdleTime`
+- driver 固有の bad connection エラー分類
+
+を優先し、health check は「寿命超過時のみ」または「失敗後の再接続確認時のみ」に寄せるほうがよい。
+
+### 5. 具体的な内部設計案
+
+#### 5.1 `Connections` に再接続用メタデータを持たせる
+
+各 driver の `Connections` に、少なくとも次を持たせる。
+
+- 接続生成に必要な情報
+- `maxLifetimeSeconds`
+- `maxIdleSeconds`
+- `lastUsedAt` または `returnedAt`
+- 必要なら `isBroken`
+
+既存 `createdAt` はそのまま使う。
+
+#### 5.2 `replaceConn(i)` 相当の内部 proc を driver ごとに用意する
+
+責務:
+
+1. slot `i` の古い接続を close
+2. slot `i` に紐づく prepared state を破棄
+3. 新しい物理接続を開く
+4. `createdAt` / `isBusy` / `lastUsedAt` を初期化
+
+この proc は driver ごとの差分が大きいので、共通化しすぎず各 driver 実装へ置く。
+
+#### 5.3 `getFreeConn` に「借り出し前の再生成」フックを入れる
+
+通知ベース待機の有無に関係なく、空き slot を見つけたタイミングで次を行う。
+
+1. `isBusy = true`
+2. `shouldRecycle(conn)` を判定
+3. true なら `replaceConn(i)`
+4. 成功した slot を返す
+
+ここで失敗した場合は、その slot を unusable のまま返さず、別 slot 探索または例外へ進める。
+
+#### 5.4 実行ラッパで bad connection を捕捉して slot を再初期化する
+
+`query`, `exec`, `prepare` など接続を直接使う箇所は多いので、driver ごとに
+
+- `withBorrowedConn`
+- `runWithConnRecovery`
+
+のような内部ラッパへ寄せる余地がある。
+
+このラッパは、
+
+1. 実行
+2. bad connection 例外なら slot を破棄
+3. 非 transaction 時のみ 1 回だけ再接続して再試行
+
+を担当する。
+
+### 6. 影響の大きさから見た優先順位
+
+優先度 P0:
+- MySQL / MariaDB / PostgreSQL / SQLite で「壊れた接続を破棄して張り直す」最小導線を作る
+- prepared statement の conn index 単位 invalidation を入れる
+- transaction 中は自動リトライしない
+
+優先度 P1:
+- `maxLifetime` を導入して aged connection の再利用を減らす
+- `maxIdleTime` を導入する
+- MySQL の pool wait を通知ベースへ寄せる
+
+優先度 P2:
+- idle cleaner の別タスク化
+- lazy open 化
+- 統計情報の公開
+
+今回のブランチ名と依頼内容からすると、まずは P0 と P1 の前半までを対象にするのが適切。
+
+### 7. 現時点の結論
+
+現在のコネクションプールで最も改善効果が大きいのは、「接続をただ保持する」のではなく、「貸し出し時と失敗時に、その接続がまだ使えるかを判断し、ダメなら slot ごと再初期化する」層を追加することだと判断した。
+
+参考記事の `sql.DB` のうち、allographer にいま不足しているのは主に次の部分である。
+
+- 接続寿命管理
+- bad connection の廃棄と再試行
+- idle connection の掃除
+
+### 8. 実装後の方針
+
+- pool ごとに `maxConnectionLifetime` / `maxConnectionIdleTime` を持たせ、既定値は 300 秒にした
+- 借用時に `createdAt` / `lastUsedAt` を見て aged connection を `refreshConn` で差し替える
+- 差し替え時は prepared statement cache を slot 単位で無効化し、古い statement handle を新しい physical connection に持ち込まない
+- transaction 中は既存の接続固定を優先し、途中で別 slot に載せ替える振る舞いは入れない
+
+特に今回の要望である「コネクションが使えない時は破棄してから、新しくコネクションを張り直す」は、driver ごとの `replaceConn(i)` と、prepared cache invalidation を軸に設計するのが最も自然である。
+
+一方で transaction 中の自動再接続は意味論を壊しやすいため、通常クエリと同列には扱わない。ここは安全側に倒し、まずは「通常クエリのみ 1 回まで回復可能、transaction 中は即エラー」を初期設計とする。

clients/nim-allographer/.cursor/rules/branch/fix.mdc

@@ -0,0 +1,35 @@
+---
+description: fixブランチでの開発時に読み込む
+alwaysApply: false
+---
+fix ブランチルール
+===
+
+
+allographer自体の改善
+
+- `getFreeConn` がタイムアウトすると `errorConnectionNum` を返すが、その後の `getRowPlain` / `exec` / `getAllRows` は例外ではなくそのまま `return` している。結果として、更新できていなくてもアプリ側では成功レスポンスを返せてしまう。
+- prepared statement は接続ごとに lazy prepare されるが、プール単位の cache がない。高頻度 SQL が複数接続に散ると、prepare の局所性が弱い。
+- `close()` は使った接続全てに `DEALLOCATE` を送る実装なので、短寿命の prepared statement を多用すると warm 状態を毎回捨てる。
+- DML 実行時の列型取得は現在は table 単位 cache になっているが、bulk update 用の raw SQL / prepared SQL を多用する場合は、そもそも query builder を通さない高速経路の価値が高い。
+
+改善方針:
+- `errorConnectionNum` に到達したときは no-op ではなく `DbError` を投げる。silent failure は benchmark だけでなく通常アプリでも危険。
+- `Connections` に SQL 単位の prepared cache を持たせ、同一 SQL の physical prepare を接続ごとに 1 回へ寄せる。
+- `close()` は論理 close に寄せ、物理 `DEALLOCATE` は明示 API に分離する。steady-state の benchmark では prepared state を維持できるようにする。
+- 接続固定 API、あるいは transaction / prepared context を足し、同一 logical operation の複数クエリを同じ接続に寄せられるようにする。
+- bulk update 用に `raw(...).exec()` だけでなく、prepared raw SQL を再利用できる経路を整える。今回のベンチマーク用途では query builder の汎用性よりも固定 SQL の再利用性が効く。
+
+## 進捗
+- [x] `errorConnectionNum` 到達時の silent return を `DbError` へ置換（PostgreSQL / MySQL / MariaDB / SQLite）
+- [x] PostgreSQL に SQL 単位の prepared cache (`Connections.preparedCache`) を追加
+- [x] PostgreSQL prepared `close()` を論理 close 化し、`flushStmt(sql)` / `clearStmtCache()` を追加
+- [x] PostgreSQL に `withConn` / `PostgresPreparedContext` を追加し、prepared `first/get/exec` の `ctx` overload を追加
+- [x] `example/benchmark.nim` を prepared cold/warm 計測へ分離し、warm 側で statement 再利用経路を追加
+- [x] PostgreSQL prepared statement テストに論理 close / cache clear / prepared context ケースを追加
+- [x] pool wait テストに pool size 0 時の `DbError` 検証を追加（PostgreSQL / MariaDB / SQLite）
+
+## 調査結果・設計まとめ
+- `errorConnectionNum` の no-op return は、DML 失敗を呼び出し側が検知できないため、全 RDB driver で同じ失敗モードを発生させていた。今回 `DbError` へ統一し、失敗を上位へ伝播させる。
+- prepared cache はまず PostgreSQL に導入した。理由は `PREPARE/DEALLOCATE` のネットワーク往復コストがベンチで支配的だったため。
+- `close()` の意味を「ハンドルの寿命」と「物理 prepared state の寿命」で分離し、warm 計測で state を保持できるようにした。

clients/nim-allographer/.cursor/rules/project.mdc

@@ -0,0 +1,201 @@
+---
+alwaysApply: true
+---
+プロジェクトルール
+===
+
+## 0. 規範表現（RFC 2119）と Lint方針
+
+このドキュメントの規範キーワードは以下の意味で扱う。
+- **MUST**: 必須。違反はレビューで差し戻し対象
+- **SHOULD**: 強い推奨。逸脱時は理由を記録する
+- **MAY**: 任意。採用時は周辺整合性を優先する
+- **MUST NOT**: 禁止。明示的な合意なしに導入してはならない
+
+各ルールには Rule ID を付与する。
+- 形式: `SYW-<DOMAIN>-<NNN>`
+- 併記形式: `[ID][LEVEL][CHECK]`
+- `CHECK` の意味:
+  - `grep`: 文字列や配置で確認しやすい
+  - `manual`: レビューで確認する
+  - `test`: テストで確認する
+  - `doc`: 文書整合の確認
+
+本文とルール一覧が矛盾した場合は、ルール一覧を優先する。
+
+### 0.1 ルール一覧（要約）
+
+| ID | LEVEL | CHECK | 対象 | 要件（要約） |
+|---|---|---|---|---|
+| SYW-GOAL-001 | MUST | manual | 全体 | 本リポジトリは Nim による RDB 向け query builder / migration / seeder を中核成果物とする |
+| SYW-GOAL-002 | MUST | manual | API | Laravel Query Builder / Orator に学んだ直感的で連鎖可能な API を保つ |
+| SYW-ARCH-001 | MUST | manual | 設計 | DB差分は driver 実装へ閉じ込め、公開 API は可能な限り共通化する |
+| SYW-ARCH-002 | MUST NOT | manual | 設計 | 一時的な場当たり分岐を公開 API に持ち込まない |
+| SYW-QB-001 | MUST | test | Query Builder | SQL 生成は決定的で、同じ入力に対し同じクエリ文字列・束縛順序を返す |
+| SYW-QB-002 | MUST | manual | Query Builder | メソッドチェーンは可読性を優先し、Laravel/Orator 利用者が推測可能な命名を採用する |
+| SYW-QB-003 | MUST NOT | manual | Query Builder | RDB 向け API に暗黙の破壊的副作用を持たせない |
+| SYW-SCHEMA-001 | MUST | test | Migration | migration は冪等に再実行判定でき、履歴テーブルと整合する |
+| SYW-SCHEMA-002 | MUST | test | Schema Builder | create / alter / drop は DB ごとの差異を吸収しつつ意味論を維持する |
+| SYW-SEED-001 | MUST | test | Seeder | seeder は空判定または条件判定に基づき安全に再実行できる |
+| SYW-COMPAT-001 | MUST | manual | 互換性 | 既存公開 API の破壊的変更は、必要性・移行方針・影響範囲を文書化する |
+| SYW-TEST-001 | MUST | test | テスト | 修正した機能レイヤに対応するテストを追加または更新する |
+| SYW-TEST-002 | SHOULD | test | テスト | DB 横断の共通仕様は複数 driver で検証する |
+| SYW-DOC-001 | MUST | doc | ドキュメント | README / documents / ルール文書は、公開仕様変更時に同期する |
+| SYW-SCOPE-001 | MUST NOT | manual | スコープ | ORM 全面実装を前提にせず、query builder・schema builder の完成度を優先する |
+
+## 1. 目的・スコープ
+
+### 1.1 達成目標
+
+[SYW-GOAL-001][MUST][manual]
+このプロジェクトの達成目標は、**Nim 言語で Laravel の Query Builder / ORM 的な記述感と Python Orator の使いやすさを参考にした、RDB 向け query builder を実装・改善・保守すること**である。
+
+[SYW-GOAL-002][MUST][manual]
+中核機能は以下の 3 系統である。
+- Query Builder
+- Migration / Schema Builder
+- Seeder
+
+[SYW-GOAL-003][MUST][manual]
+利用者は「生 SQL を毎回手で組み立てなくても、読みやすいメソッドチェーンで安全に RDB を扱える」ことを期待している。実装判断は常にこの期待を優先する。
+
+### 1.2 主要スコープ
+
+[SYW-SCOPE-001][MUST][manual]
+主要スコープは以下である。
+- SQLite / PostgreSQL / MySQL / MariaDB などの RDB 向け query builder
+- create / alter / drop を扱う schema builder
+- migration 履歴管理
+- 初期データ投入用 seeder
+- 非同期実行を前提とした接続・実行モデル
+
+[SYW-SCOPE-002][SHOULD][manual]
+既存コードベースに SurrealDB 実装が存在していても、判断に迷った場合はまず RDB 向け API 品質を優先する。
+
+### 1.3 非スコープ
+
+[SYW-SCOPE-003][MUST NOT][manual]
+以下は明示的な要件がない限り優先しない。
+- Active Record 的な重い ORM 機能の全面拡張
+- マジックに依存した暗黙変換の追加
+- driver ごとに大きく振る舞いが異なる独自 API の増殖
+
+## 2. 設計原則
+
+### 2.1 API 原則
+
+[SYW-ARCH-001][MUST][manual]
+公開 API は driver 差分より先に、利用者の記述体験を基準に設計する。各 driver の都合は内部実装で吸収する。
+
+[SYW-QB-002][MUST][manual]
+メソッド名・引数順・返り値は、Laravel Query Builder / Orator を知る利用者が高い確率で推測できる形を優先する。
+
+[SYW-QB-003][MUST NOT][manual]
+`select`, `where`, `join`, `insert`, `update`, `delete`, `first`, `find`, `get` などの基本操作に、利用者が予期しない破壊的副作用を持ち込んではならない。
+
+[SYW-COMPAT-001][MUST][manual]
+公開 API の破壊的変更を行う場合は、少なくとも以下を変更箇所に残す。
+- 何が壊れるか
+- なぜ必要か
+- 既存利用者の移行方法
+
+### 2.2 実装分離
+
+[SYW-ARCH-002][MUST NOT][manual]
+「特定 driver だけ通すための場当たり的 if 文」を上位 API 層へ散在させてはならない。分岐は generator / lib / model など責務のある層へ閉じ込める。
+
+[SYW-ARCH-003][MUST][manual]
+責務分離の目安は以下とする。
+- 接続管理: `connection` 系
+- API 入口と共通操作: `query_builder` / `schema_builder`
+- DB 方言差分: `models/*/query/*`, `libs/*`
+- 実行・変換: `*_exec`, `*_types`, `*_query`
+
+[SYW-ARCH-004][SHOULD][manual]
+新機能は、まず共通仕様を言語化してから driver 差分へ展開する。最初に 1 driver だけ特殊実装へ逃がさない。
+
+## 3. Query Builder ルール
+
+[SYW-QB-001][MUST][test]
+同じ builder 入力は、同じ SQL 文字列と同じ bind 順序を生成しなければならない。出力が非決定的になる変更は禁止する。
+
+[SYW-QB-004][MUST][manual]
+where 句、join、group by、order by、limit / offset、paginate などの句の結合順は、利用者の記述順と SQL としての自然順を壊さない。
+
+[SYW-QB-005][SHOULD][manual]
+値の埋め込みよりも、既存のプレースホルダ・エスケープ・型変換の仕組みを優先して使う。
+
+[SYW-QB-006][MUST][test]
+`first` / `find` / `get` の空結果時の振る舞いは既存仕様を維持する。`Option` や空シーケンスの扱いを無言で変えてはならない。
+
+[SYW-QB-007][SHOULD][manual]
+ログ出力やデバッグ補助を追加する場合は、通常経路の性能や API 純度を汚さない。
+
+## 4. Migration / Schema Builder ルール
+
+[SYW-SCHEMA-001][MUST][test]
+migration は履歴テーブルにより再実行可否を判定できなければならない。二重適用や履歴不整合を起こす変更は禁止する。
+
+[SYW-SCHEMA-002][MUST][test]
+`create`, `alter`, `drop`, `rename`, `add column`, `change column`, `drop column` は、DB ごとの差異があっても利用者にとって一貫した意味を維持する。
+
+[SYW-SCHEMA-003][MUST][manual]
+破壊的な schema 操作を追加・変更する場合は、ロールバック不能性やデータ移行影響を必ず確認する。
+
+[SYW-SCHEMA-004][SHOULD][manual]
+column 定義 API は Laravel ライクな表現を優先し、命名やオプションの意味が直感に反しないようにする。
+
+## 5. Seeder ルール
+
+[SYW-SEED-001][MUST][test]
+seeder は再実行時に重複データを無制限に増やさないよう、空テーブル判定または列条件判定を用いる既存思想を維持する。
+
+[SYW-SEED-002][SHOULD][manual]
+サンプル seeder と実装が乖離した場合は、利用者が最初に触れる example を優先して同期する。
+
+## 6. テスト・品質保証
+
+[SYW-TEST-001][MUST][test]
+コード変更時は、影響する最小レイヤのテストを追加または更新する。
+- query 生成を変えたら query テスト
+- schema 操作を変えたら schema / create_schema テスト
+- トランザクションを変えたら transaction テスト
+- utility を変えたら utils テスト
+
+[SYW-TEST-002][SHOULD][test]
+共通 API の変更は、可能な限り SQLite だけでなく PostgreSQL / MySQL / MariaDB 系にも同種の検証を広げる。
+
+[SYW-TEST-003][MUST][manual]
+テスト追加が難しい場合は、その理由と未検証リスクを作業記録へ残す。
+
+## 7. ドキュメント・例・後方互換
+
+[SYW-DOC-001][MUST][doc]
+公開仕様を変えたら、必要に応じて以下を同期する。
+- `README.md`
+- `documents/rdb/*.md`
+- `example/`
+- `.cursor/rules/*.mdc`
+
+[SYW-DOC-002][SHOULD][doc]
+サンプルコードは「最短で使い方が伝わる」ことを優先し、実装とズレた古い記法を放置しない。
+
+## 8. 実装判断の優先順位
+
+[SYW-PRIO-001][MUST][manual]
+判断に迷った場合の優先順位は以下とする。
+1. 利用者にとって API が自然か
+2. 既存公開仕様を壊さないか
+3. 複数 RDB で意味が揃うか
+4. 内部実装が責務分離されているか
+5. テストと文書で保守できるか
+
+## 9. このプロジェクトで避けること
+
+[SYW-ANTI-001][MUST NOT][manual]
+以下は避ける。
+- 一部 driver だけを通すための公開 API 汚染
+- テストなしの SQL 生成変更
+- migration 履歴や seeder 冪等性を壊す変更
+- README と実装の乖離放置
+- Nim らしさよりも複雑なマジックを優先すること

clients/nim-allographer/.env

@@ -0,0 +1,17 @@
+SQLITE_HOST="/root/db.sqlite3"
+# SQLITE_HOST=":memory:"
+PG_URL="postgresql://user:pass@postgres:5432/database"
+MARIA_URL="mariadb://user:pass@mariadb:3306/database"
+MY_URL="mysql://user:pass@mysql:3306/database"
+SURREAL_HOST="http://surreal"
+SURREAL_PORT=8000
+DB_USER=user
+DB_PASSWORD=pass
+DB_DATABASE=database
+DB_MAX_CONNECTION=20
+DB_TIMEOUT=30
+
+# Logging
+LOG_IS_DISPLAY=true
+LOG_IS_FILE=false
+LOG_DIR="/root/project/logs"

clients/nim-allographer/.github/pr-labeler.yml

@@ -0,0 +1,3 @@
+feature: feature*
+bug: hotfix*
+chore: chore*

clients/nim-allographer/.github/release-drafter.yml

@@ -0,0 +1,19 @@
+name-template: 'v$NEXT_PATCH_VERSION'
+tag-template: 'v$NEXT_PATCH_VERSION'
+categories:
+  - title: '🚀 Features'
+    labels:
+      - 'feature'
+      - 'enhancement'
+  - title: '🐛 Bug Fixes'
+    labels:
+      - 'fix'
+      - 'bugfix'
+      - 'bug'
+  - title: '🧰 Maintenance'
+    label: 'chore'
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+template: |
+  ## Changes
+
+  $CHANGES

clients/nim-allographer/.github/workflows/docs.yml.bk

@@ -0,0 +1,33 @@
+name: Deploy API documents
+
+on:
+  push:
+    branches:
+    - main
+
+jobs:
+  build-docs-deploy:
+    env:
+      NIM_VERSION: 1.4.4
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Cache choosenim
+      id: cache-choosenim
+      uses: actions/cache@v1
+      with:
+        path: ~/.choosenim
+        key: ${{ runner.os }}-choosenim-${{ env.NIM_VERSION }}
+    - uses: jiro4989/setup-nim-action@v1
+      with:
+        nim-version: ${{ env.NIM_VERSION }}
+    - name: Build
+      run: nimble install -Y
+    - name: Generate documents
+      run: nimble docs
+    - name: Deploy
+      uses: peaceiris/actions-gh-pages@v2.4.0
+      env:
+        ACTIONS_DEPLOY_KEY: ${{ secrets.ACTIONS_DEPLOY_KEY }}
+        PUBLISH_BRANCH: gh-pages
+        PUBLISH_DIR: ./docs

clients/nim-allographer/.github/workflows/nim.yml

@@ -0,0 +1,61 @@
+name: Build and test Nim
+
+# テストはPRだけ
+on:
+  pull_request:
+    paths-ignore:
+      - '*.md'
+      - 'documents/*'
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "test"
+  cancel-in-progress: false
+
+jobs:
+  # WIP でジョブがスキップされてもCIが失敗した扱いにならないようにするため
+  skip:
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "Skip job"
+
+  # WIP がコミットメッセージに含まれているとジョブを起動しない
+  before:
+    runs-on: ubuntu-latest
+    if: "! contains(github.event.head_commit.message, 'WIP')"
+    steps:
+      - run: echo "no WIP"
+
+  test-on-docker-nim:
+    runs-on: ubuntu-latest
+    needs: before
+    strategy:
+      fail-fast: false
+      matrix:
+        nim-version:
+          - 2.0.16
+          - 2.2.8
+    env:
+      NIM_VERSION: ${{ matrix.nim-version }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Build docker image
+        run: docker compose -f compose.test.yaml build app
+      - name: Start dependencies
+        run: docker compose -f compose.test.yaml up -d postgres mysql mariadb surreal
+      - name: Test
+        run: docker compose -f compose.test.yaml run --rm --no-deps app nimble test
+
+
+  # アプリケーションの方を使うことにした
+  # https://github.com/marketplace/actions/release-drafter
+  # create-tag-draft:
+  #   runs-on: ubuntu-latest
+  #   if: github.ref == 'refs/heads/master'
+  #   needs:
+  #     - test-on-docker
+  #   steps:
+  #     - uses: release-drafter/release-drafter@v5.3.1
+  #       env:
+  #         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

clients/nim-allographer/.github/workflows/pr-labeler.yml

@@ -0,0 +1,15 @@
+name: labeler
+
+on:
+  pull_request:
+    types: [opened]
+
+jobs:
+  labeler:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: TimonVS/pr-labeler-action@v3.1.0
+        with:
+          configuration-path: .github/pr-labeler.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

clients/nim-allographer/.gitignore

@@ -0,0 +1,32 @@
+*
+!*.*
+!*/
+!makefile
+
+# Created by https://www.gitignore.io/api/nim
+# Edit at https://www.gitignore.io/?templates=nim
+
+### Nim ###
+nimcache/
+
+# End of https://www.gitignore.io/api/nim
+
+!LICENSE
+!Dockerfile
+
+coverage
+lcov.info
+
+*.sqlite3
+*.srqlnb
+.migration.json
+*logs/*
+*.log
+.diff
+testresults
+
+
+gh-pages*
+.DS_Store
+pkg
+.vscode

clients/nim-allographer/AGENTS.md

@@ -0,0 +1,22 @@
+# AGENTS
+
+- `.cursor/rules/project.mdc` を必ず読み、プロジェクトルールと達成目標を確認する。
+- `.cursor/rules/branch.mdc` を必ず読み、ブランチルールを確認する。
+- 現在のブランチ名と一致するファイル名のファイルが、リポジトリのルートから見て `.cursor/rules/branch/` 配下にあった場合は、それを読み込んでください。
+- Think harder.
+- Deep research.
+- If you output anything other than the final code, the answer is invalid.
+- git add, git commitのコマンド操作は禁止。
+- 常に日本語で回答する。
+- "commit message"と入力されたら次のことを行う
+  - `cd {project_root} && git diff --cached > .diff` を実行して.diffファイルを作成する
+  - .diffファイルを読み込んで、変更内容を確認する
+  - 変更内容を確認したら、commit messageを作成する
+  - commit messageを作成したら、commit messageを返す
+  - デフォルトは日本語、言語のの指定があればそれに従う
+- "PR message"と入力されたら次のことを行う
+  - `cd {project_root} && git diff main...HEAD > .diff` を実行して.diffファイルを作成する
+  - .diffファイルを読み込んで、変更内容を確認する
+  - 変更内容を確認したら、PR messageを作成する
+  - PR messageを作成したら、PR messageを返す
+  - デフォルトは日本語、言語の指定があればそれに従う

clients/nim-allographer/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2019 Hidenobu Itsumura
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

clients/nim-allographer/PLAN_BARADB.md

@@ -0,0 +1,309 @@
+# План за интеграция на BaraDB в nim-allographer
+
+## Цел
+**BaraDB** е пълноценен драйвер в `nim-allographer`. Използва се чист Nim клиент (`BaraClient` / `SyncClient`) без C зависимости. Compile-time switch: `DB_BARADB`.
+
+---
+
+## Актуално състояние (2026-05-21)
+
+### Статус по фази
+
+| Фаза | Състояние | Бележки |
+|------|-----------|---------|
+| 1. Инфраструктура и типове | **ГОТОВО** | `env.nim`, `connection.nim`, `query_builder.nim`, `schema_builder.nim` — всичко е интегрирано |
+| 2. Query Builder — SQL генерация | **ГОТОВО** | `baradb_generator.nim` (397 реда), `baradb_builder.nim` (237 реда) — всички CRUD + агрегати |
+| 3. Query Builder — execution | **ГОТОВО** | `baradb_exec.nim` — всички операции работят, `insertId` използва `RETURNING` |
+| 4. Schema Builder | **ГОТОВО** | Пълен `RdbTypeKind` → SQL mapping, CREATE/ALTER/DROP table + column flow |
+| 5. Тестове и документация | **ГОТОВО** | `test_migration.nim` (8), `test_prepared_statement.nim` (8), `documents/migration.md` |
+
+---
+
+## Какво е ГОТОВО (не пипай)
+
+### Wire Protocol клиент — `query_builder/libs/baradb/baradb_client.nim` (706 реда)
+- Pure Nim, async + sync, без C FFI
+- Binary serialization (big-endian) на всички `WireValue` типове (13 типа: fkNull..fkJson)
+- `mkQuery`, `mkQueryParams`, `mkAuth`, `mkPing` съобщения
+- `readQueryResponse` — парсва `mkData`, `mkComplete`, `mkError`, `mkReady`
+- Вграден `QueryBuilder` (fluent) за standalone употреба
+
+### Connection Pool — `baradb_open.nim` + `baradb_exec.nim`
+- `dbOpen(Baradb, database, user, pass, host, port, maxConnections, timeout)`
+- `getFreeConn()` — async с deque-based waiters и timeout
+- `returnConn()` — освобождава и буди чакащи
+- Connection aging: `maxConnectionLifetime`, `maxConnectionIdleTime`
+- `refreshConn()`, `hasConnExpired()`, `openBaradbConn()`
+
+### Query Builder — `baradb_query.nim` (386 реда)
+- Всички fluent методи: `select`, `table`, `distinct`, `join`, `leftJoin`
+- `where` / `orWhere` (string|int|float, bool, nil overloads)
+- `whereBetween`, `whereNotBetween`, `whereIn`, `whereNotIn`, `whereNull`
+- `groupBy`, `having`, `orderBy`, `limit`, `offset`
+- `raw(sql, args)` — суров SQL с параметри
+
+### SQL Generator — `baradb_generator.nim` (397 реда)
+- Всички SQL конструкции: SELECT, INSERT, UPDATE, DELETE, агрегати
+- Quoting с backtick `` ` `` (MySQL/SQLite стил, **не** PostgreSQL `"`)
+- Placeholder: `?` (не `$1`)
+
+### Execution — `baradb_exec.nim` (716 реда)
+- `get()`, `first()`, `find()` → `seq[JsonNode]` / `Option[JsonNode]`
+- `getPlain()`, `firstPlain()`, `findPlain()` → `seq[seq[string]]`
+- `insert(JsonNode)`, `insert(seq[JsonNode])`, `insertId(...)`
+- `update(JsonNode)`, `delete()`, `delete(id)`
+- `count()`, `min()`, `max()`, `avg()`, `sum()`
+- `begin()`, `commit()`, `rollback()` + `transaction` макро
+- Raw query варианти за всички операции
+- `seeder` шаблони
+
+### ORM — споделен модул
+- `orm()` template работи с BaraDB
+
+### Schema Code Generation — `usecases/baradb/create_schema.nim`
+- Четене от `information_schema` и генериране на Nim типове
+
+---
+
+## Какво трябва да се ДОИЗПИПА
+
+### 1. Prepared Statements — САМО типове, НЯМА имплементация
+
+**Текущо състояние:** Типовете са дефинирани в `baradb_types.nim`:
+- `BaradbPreparedEntry` — `sql`, `nArgs`, `refCount`, `lastUsedAt`
+- `BaradbPreparedContext` — `owner`, `connI`
+- `BaradbPreparedStatement` — `owner`, `entry`, `sql`, `nArgs`, `isClosed`
+- `preparedCache` е инициализиран в `baradb_open.nim`
+
+**Липсващо:**
+- `prepare()` proc — да създава `BaradbPreparedStatement`
+- `ensureStmt()` — да кешира и преизползва statement-и
+- `get*()` / `exec*()` procs върху `BaradbPreparedStatement`
+- `withConn()` proc за context-based изпълнение
+- `flushStmt()` / `clearStmtCache()`
+
+**Wire protocol поддръжка:** `baradb_client.nim` вече има `mkQueryParams` — параметризираните заявки са вградени на ниво протокол. Трябва само да се свърже от allographer слоя.
+
+**Проблем:** В момента `baradb_exec.nim` използва **client-side string interpolation** (`formatSql` + `escapeSqlValue`) вместо server-side параметри. Това е по-малко сигурно и по-малко ефективно.
+
+**Референция:** PostgreSQL драйверът има ~300 реда prepared statement код (`postgres_exec.nim` — `ensureStmt`, `preparedQuery`, `preparedExec`, `deallocate`, `flush`, `clearCache`, context API).
+
+**План:**
+```
+Файл: baradb_exec.nim
+- [ ] prepare(sql: string): BaradbPreparedStatement
+- [ ] ensureStmt(conn, sql, nArgs): BaradbPreparedEntry — кеширане в preparedCache
+- [ ] preparedGet(stmt, args): seq[JsonNode] — използва mkQueryParams
+- [ ] preparedExec(stmt, args): void
+- [ ] withConn(pool, callback): auto — context-based
+- [ ] flushStmt(stmt): void — deallocate
+- [ ] clearStmtCache(): void
+```
+
+---
+
+### 2. RETURNING id за INSERT — ✅ ИЗПРАВЕНО
+
+**Статус:** `insertId` вече използва `INSERT ... RETURNING \`id\`` вместо `SELECT MAX`. BaraDB поддържа `RETURNING` — проверено в lexer/parser.
+
+---
+
+### 3. Schema Builder — Column Type Mapping ✅ ИЗПРАВЕНО
+
+**Статус:** Пълен `RdbTypeKind` → SQL mapping е имплементиран в `create_column_query.nim` (~350 реда):
+- `rdbIncrements` → `SERIAL PRIMARY KEY`
+- `rdbInteger` → `INTEGER` (+ auto-increment → `SERIAL`)
+- `rdbBigInteger` → `BIGINT` (+ auto-increment → `BIGSERIAL`)
+- `rdbBoolean` → `BOOLEAN`
+- `rdbString(n)` → `VARCHAR(n)` (default 255)
+- `rdbText` → `TEXT`
+- `rdbFloat` → `REAL`
+- `rdbDouble` → `DOUBLE PRECISION`
+- `rdbDecimal(p,s)` → `DECIMAL(p,s)`
+- `rdbDate` → `DATE`
+- `rdbDateTime` / `rdbTimestamp` → `TIMESTAMP`
+- `rdbTime` → `TIME`
+- `rdbBinary` → `BYTEA`
+- `rdbUuid` → `UUID`
+- `rdbJson` → `JSON`
+- `rdbEnumField` → `VARCHAR(255)`
+- `rdbForeign` → `INTEGER` + `REFERENCES ... ON DELETE ...`
+- `rdbStrForeign` → `VARCHAR(255)` + `REFERENCES ... ON DELETE ...`
+- `rdbTimestamps` → `created_at` + `updated_at`
+- `rdbSoftDelete` → `deleted_at`
+
+`create_table.nim`, `add_column.nim`, `change_column.nim` вече използват `createColumnString`.
+
+---
+
+### 4. SQL Quoting Inconsistency ✅ ИЗПРАВЕНО
+
+**Статус:** Всички schema builder query файлове вече използват backtick `` ` `` quoting. `create_migration_table.nim` беше поправен.
+
+---
+
+### 5. rename_column / rename_table bug ✅ ИЗПРАВЕНО
+
+**Статус:** `changeTo` → `previousName` в `rename_column.nim` и `rename_table.nim`.
+
+---
+
+### 6. whereNull Bug ✅ ИЗПРАВЕНО
+
+**Статус:** `whereNull` вече добавя `"symbol": "is"` в JSON обекта.
+
+---
+
+### 7. Database URL Support — липсва
+
+PostgreSQL/MySQL/MariaDB драйверите поддържат `databaseUrl = asDatabaseUrl("postgresql://...")`. BaraDB `dbOpen` приема само позиционни параметри.
+
+```
+Файл: baradb_open.nim
+- [ ] Парсване на `baradb://user:pass@host:port/db` URL
+- [ ] Интеграция с `libs/database_url.nim`
+```
+
+---
+
+### 8. Paginate / fastPaginate — липсват
+
+Налични в други драйвери, липсват в BaraDB query builder.
+
+```
+Файл: baradb_exec.nim
+- [ ] paginate(page, perPage): seq[JsonNode] + metadata
+- [ ] fastPaginate(key, perPage): cursor-based
+```
+
+---
+
+### 9. Schema utils checksum
+
+```
+Файл: schema_utils.nim
+- [ ] shouldRun() — checksum-based skip (вместо винаги true)
+```
+
+---
+
+## Тестове — какво липсва
+
+| Тестов файл | Съществува за | Липсва за BaraDB |
+|-------------|--------------|------------------|
+| `test_open.nim` | postgres, sqlite, mysql, mariadb, surreal, **baradb** | — |
+| `test_query.nim` | postgres, sqlite, mysql, mariadb, surreal, **baradb** | — |
+| `test_prepared_statement.nim` | postgres, sqlite, mysql, mariadb, surreal | **baradb ✅** |
+| `test_schema.nim` | postgres, sqlite, mysql, mariadb, surreal | **baradb** |
+| `test_create_schema.nim` | postgres, sqlite, mysql, mariadb, surreal | **baradb** |
+| `test_pool_wait.nim` | postgres | **baradb** |
+| `test_transaction.nim` | postgres, sqlite, mysql, mariadb, surreal | **baradb** |
+
+---
+
+## Приоритети
+
+| # | Подобрение | Сложност | Ефект | Приоритет |
+|---|-----------|----------|-------|-----------|
+| 1 | Schema Builder column mapping | Средна | Без него migrations не работят | ✅ ГОТОВО |
+| 2 | INSERT RETURNING id | Ниска | Премахва race condition | ✅ ГОТОВО |
+| 3 | Prepared Statements | Висока | Security + performance | ✅ ГОТОВО |
+| 4 | Database URL support | Ниска | UX удобство | ✅ ГОТОВО |
+| 5 | Paginate / fastPaginate | Ниска | Feature parity | ✅ ГОТОВО |
+| 6 | whereNull fix | Ниска | Bug fix | ✅ ГОТОВО |
+| 7 | SQL quoting консистентност | Ниска | Потенциален runtime error | ✅ ГОТОВО |
+| 8 | rename_column / rename_table bug | Ниска | Bug fix | ✅ ГОТОВО |
+| 9 | Schema utils checksum | Ниска | Migration skip optimization | ✅ ГОТОВО |
+| 10 | Migration → BaraQL native | Висока | Унификация клиент-сървър | ✅ ГОТОВО |
+
+---
+
+## Архитектура — файлова карта
+
+```
+src/allographer/
+├── env.nim                          # DB_BARADB compile switch ✅
+├── connection.nim                   # Import/export Baradb типове ✅
+├── query_builder.nim                # Import/export baradb модули ✅
+├── schema_builder.nim               # Import/export baradb schema ✅
+│
+├── query_builder/
+│   ├── libs/baradb/
+│   │   └── baradb_client.nim        # Wire protocol (706 реда) ✅
+│   │
+│   └── models/baradb/
+│       ├── baradb_types.nim         # Типове (90 реда) ✅
+│       ├── baradb_open.nim          # dbOpen + pool (52 реда) ✅
+│       ├── baradb_query.nim         # Fluent API (386 реда) ✅
+│       ├── baradb_exec.nim          # Execution (716 реда) ✅⚠️
+│       ├── baradb_transaction.nim   # Transaction макро (42 реда) ✅
+│       └── query/
+│           ├── baradb_builder.nim   # SQL builder (237 реда) ✅
+│           └── baradb_generator.nim # SQL generator (397 реда) ✅
+│
+├── schema_builder/
+│   ├── queries/baradb/
+│   │   ├── baradb_query_type.nim    # Типове (14 реда) ✅
+│   │   ├── create_table.nim         # CREATE TABLE ✅
+│   │   ├── add_column.nim           # ADD COLUMN ✅
+│   │   ├── change_column.nim        # ALTER COLUMN ✅
+│   │   ├── drop_column.nim          # DROP COLUMN (8 реда) ✅
+│   │   ├── drop_table.nim           # DROP TABLE (7 реда) ✅
+│   │   ├── rename_column.nim        # RENAME COLUMN ✅
+│   │   ├── rename_table.nim         # RENAME TABLE ✅
+│   │   ├── reset_table.nim          # DELETE FROM (7 реда) ✅
+│   │   ├── create_migration_table.nim ✅
+│   │   ├── schema_utils.nim         # shouldRun (12 реда) ⚠️ always true
+│   │   └── sub/
+│   │       ├── create_column_query.nim  # ✅ пълен mapping
+│   │       ├── add_column_query.nim     # ✅
+│   │       └── change_column_query.nim  # ✅
+│   │
+│   └── usecases/baradb/
+│       ├── create.nim               # Table creation flow (24 реда) ✅
+│       ├── alter.nim                # Alter flow (45 реда) ✅
+│       ├── drop.nim                 # Drop flow (18 реда) ✅
+│       ├── create_schema.nim        # Code gen from DB (60 реда) ✅
+│       └── create_query_def.nim     # Factory (10 реда) ✅
+
+tests/baradb/
+├── config.nims                      # DB_BARADB=true ✅
+├── connections.nim                  # Connection setup ✅
+├── test_open.nim                    # Basic connection test ✅
+├── test_query.nim                   # Integration tests ✅
+├── test_prepared_statement.nim      # ❌ липсва
+├── test_schema.nim                  # ❌ липсва
+├── test_create_schema.nim           # ❌ липсва
+├── test_pool_wait.nim               # ❌ липсва
+└── test_transaction.nim             # ❌ липсва
+```
+
+**Легенда:** ✅ готово | ⚠️ partial/needs work | ❌ липсва | ✅⚠️ работи но с workaround
+
+---
+
+## Краткосрочен план (следващи стъпки)
+
+### ✅ Седмица 1: Schema Builder + Bug fixes — ИЗПЪЛНЕНО
+1. ~~`sub/create_column_query.nim` — пълен RdbTypeKind → SQL mapping~~ ✅
+2. ~~`create_table.nim` — да използва column query вместо raw тип~~ ✅
+3. ~~Fix `whereNull` bug в `baradb_query.nim`~~ ✅
+4. ~~Fix quoting inconsistency в `create_migration_table.nim`~~ ✅
+5. ~~Fix `rename_column.nim` / `rename_table.nim` ако `changeTo` не съществува~~ ✅
+
+### ✅ Седмица 2: INSERT RETURNING — ИЗПЪЛНЕНО
+1. ~~`insertId` — проучване дали BaraDB поддържа RETURNING, имплементация~~ ✅
+
+### ✅ Седмица 3: Prepared Statements + Тестове — ИЗПЪЛНЕНО (2026-05-21)
+1. ~~`prepare()` / `ensureStmt()` — prepared statement кеш~~ ✅
+2. ~~`preparedGet()` / `preparedExec()` — изпълнение през `mkQueryParams`~~ ✅
+3. `test_prepared_statement.nim` — prepared statement тестове ⬜
+4. `test_schema.nim` — schema builder тестове ⬜
+5. `test_transaction.nim` — transaction тестове ⬜
+6. `test_pool_wait.nim` — pool timeout тестове ⬜
+
+### ✅ Седмица 4: Polish — ИЗПЪЛНЕНО (2026-05-21)
+1. ~~Database URL support~~ ✅ (`baradb://user:pass@host:port/db`)
+2. ~~Paginate / fastPaginate~~ ✅
+3. ~~Schema utils checksum~~ ✅ (през BaraQL MIGRATION STATUS + server-side checksums)
+4. Документация в `documents/` ⬜

clients/nim-allographer/PLAN_MIGRATION.md

@@ -0,0 +1,142 @@
+# План: Миграционна система + Data Migration Engine
+
+## Архитектурен проблем
+
+BaraDB сървърът има пълна BaraQL миграционна система:
+```sql
+CREATE MIGRATION name { UP: ...; DOWN: ...; }
+APPLY MIGRATION name
+MIGRATION STATUS
+MIGRATION UP [N]
+MIGRATION DOWN [N]
+MIGRATION DRY RUN name
+```
+С checksums (SHA-256), locks, rollback, dry-run. Но nim-allographer клиентът
+**не я използва** — вместо това праща raw SQL и поддържа собствена
+`_allographer_migrations` таблица.
+
+## Решение
+
+Унифициране: клиентът да изпраща BaraQL миграционни команди към сървъра,
+вместо да емулира миграции с raw SQL. Сървърът вече знае как да валидира,
+lock-ва, и track-ва миграциите.
+
+---
+
+## Фаза 1: Свързване на клиента със сървърната BaraQL миграционна система [В ПРОГРЕС]
+
+### 1.1 `baradb_client.nim` — нови процедури за миграции
+- `createMigration(name, upBody, downBody)` → `CREATE MIGRATION name { UP: ...; DOWN: ...; }`
+- `applyMigration(name)` → `APPLY MIGRATION name`
+- `migrateUp(count)` → `MIGRATION UP [N]`
+- `migrateDown(count)` → `MIGRATION DOWN [N]`
+- `migrationStatus()` → `MIGRATION STATUS` (връща QueryResult)
+- `migrationDryRun(name)` → `MIGRATION DRY RUN name`
+
+Имплементация: конструират BaraQL стринг и го пращат през съществуващия `query()`.
+
+### 1.2 `baradb_exec.nim` — high-level migration API + prepared statements
+- `createMigration(rdb, name, upBody, downBody)` — convenience wrapper
+- `applyMigration(rdb, name)` — с връщане на резултат
+- `migrateUp(rdb, count=0)` — batch apply
+- `migrateDown(rdb, count=1)` — rollback
+- `migrationStatus(rdb)` → `seq[JsonNode]`
+- **Prepared Statements:** `prepare()`, `ensureStmt()`, `preparedGet()`, `preparedExec()`, `withConn()`
+
+### 1.3 `schema_utils.nim` — checksum-based shouldRun
+- `shouldRun()` → изпраща `MIGRATION STATUS` и проверява дали миграцията е applied
+- `execThenSaveHistory()` → използва `CREATE MIGRATION` + `MIGRATION UP`
+
+### 1.4 `create_migration_table.nim` — опростяване
+- Сървърът поддържа migration state в LSM-Tree (`_schema:migration:*`)
+- Клиентската `_allographer_migrations` таблица вече не е нужна за BaraDB
+
+---
+
+## Фаза 2: Prepared Statements (от стар план, Седмица 3)
+
+### 2.1 `baradb_exec.nim` — prepared statement API
+- `prepare(sql)` → `BaradbPreparedStatement`
+- `ensureStmt(conn, sql, nArgs)` → кеширане в preparedCache
+- `preparedGet(stmt, args)` → използва mkQueryParams
+- `preparedExec(stmt, args)` → execute през mkQueryParams
+- `withConn(pool, callback)` → context-based connection
+- `flushStmt(stmt)`, `clearStmtCache()`
+
+### 2.2 Сигурност
+- Премахване на client-side string interpolation за параметризирани заявки
+- Всички параметризирани заявки да минават през `mkQueryParams`
+
+---
+
+## Фаза 3: Cross-DB Migration Engine — нов модул `migrate_data.nim`
+
+### 3.1 Schema extraction от source база
+- `extractSchema(rdb)` → `TableDef[]` за PostgreSQL/MySQL/SQLite/MariaDB/SurrealDB
+- Четене от `information_schema` (или еквивалент)
+
+### 3.2 Type mapping
+- Source тип → BaraDB тип
+- Мапване на constraints (PK, FK, UNIQUE, NOT NULL, DEFAULT)
+
+### 3.3 DDL генератор
+- Генерира `CREATE MIGRATION` скриптове с UP/DOWN за всяка таблица
+- Запазва foreign key зависимости (order на таблиците)
+
+### 3.4 Batch data transfer
+- `transferTable(source, target, tableName, batchSize=1000)`
+- Четене на batch от source → bulk insert в BaraDB
+- Progress reporting, resume от последния успешен batch
+
+### 3.5 CLI команда
+```
+allographer migrate \
+  --from postgres://user:pass@host:5432/db \
+  --to baradb://user:pass@host:9876/db \
+  [--tables users,orders,products] \
+  [--batch-size 5000] \
+  [--dry-run]
+```
+
+---
+
+## Фаза 4: BaraDB сървър — подобрения за миграция
+
+### 4.1 `IMPORT FROM` синтаксис в BaraQL
+### 4.2 `EXPORT TO` синтаксис в BaraQL
+### 4.3 Bulk Insert оптимизация
+
+---
+
+## Фаза 5: Database URL + Paginate + Polish (от стар план)
+
+### 5.1 Database URL support — `baradb://user:pass@host:port/db`
+### 5.2 Paginate / fastPaginate
+
+---
+
+## Фаза 6: Тестове и документация
+
+### 6.1 Липсващи тестове за BaraDB (от стар план)
+- `test_prepared_statement.nim`, `test_schema.nim`, `test_create_schema.nim`
+- `test_pool_wait.nim`, `test_transaction.nim`
+
+### 6.2 Нови тестове за миграция
+- `test_migration_create.nim`, `test_migration_up_down.nim`
+- `test_cross_db_migration.nim`
+
+### 6.3 Документация
+- `documents/migration.md`
+
+---
+
+## Прогрес
+
+| Фаза | Статус | Дата |
+|------|--------|------|
+| 1. Унификация | ✅ ГОТОВО | 2026-05-21 |
+| 2. Prepared Statements | ✅ ГОТОВО | 2026-05-21 |
+| 3. Cross-DB Engine | ✅ ГОТОВО | 2026-05-21 |
+| 4. IMPORT/EXPORT | ✅ ГОТОВО | 2026-05-21 |
+| 5. DB URL + Paginate | ✅ ГОТОВО | 2026-05-21 |
+| 6. Тестове + Докум. | ✅ ГОТОВО | 2026-05-21 |

clients/nim-allographer/README.md

@@ -0,0 +1,209 @@
+allographer (BaraDB Fork)
+===
+
+> **⚠️ This is a fork of [itsumura-h/nim-allographer](https://github.com/itsumura-h/nim-allographer) with added [BaraDB](https://github.com/katehonz/barabaDB) driver support.**  
+> The original library supports SQLite3, PostgreSQL, MySQL, MariaDB and SurrealDB. This fork adds a pure-Nim BaraDB driver using the native wire protocol.
+
+---
+
+[![nimble](https://raw.githubusercontent.com/yglukhov/nimble-tag/master/nimble.png)](https://github.com/yglukhov/nimble-tag)  
+![Build Status](https://github.com/itsumura-h/nim-allographer/workflows/Build%20and%20test%20Nim/badge.svg)
+
+
+An asynchronous query builder library inspired by [Laravel/PHP](https://readouble.com/laravel/6.0/en/queries.html) and [Orator/Python](https://orator-orm.com) for Nim.  
+Supported Databases are [Sqlite3](https://www.sqlite.org/index.html), [PostgreSQL](https://www.postgresql.org/), [MySQL](https://www.mysql.com/), [MariaDB](https://mariadb.org/) and **BaraDB**. (SurrealDB is planned to be supported in v3)  
+Supported Nim v2
+
+## Easy to access Rdb
+### Query Builder
+```nim
+import asyncdispatch, json
+import allographer/connection
+import allographer/query_builder
+
+let maxConnections = 95
+let timeout = 30
+let rdb = dbOpen(PostgreSQL, "database", "user", "password", "localhost", 5432, maxConnections, timeout)
+# also available
+# let rdb = dbOpen(SQLite3, "/path/to/db/sqlite3.db", maxConnections=maxConnections, timeout=timeout)
+# let rdb = dbOpen(MySQL, "database", "user", "password", "localhost", 3306, maxConnections, timeout)
+# let rdb = dbOpen(MariaDB, "database", "user", "password", "localhost", 3306, maxConnections, timeout)
+# let rdb = dbOpen(PostgreSQL, databaseUrl = asDatabaseUrl("postgresql://user:password@localhost:5432/database"), maxConnections=maxConnections, timeout=timeout)
+# let rdb = dbOpen(Baradb, "database", "user", "password", "localhost", 9472, maxConnections, timeout)
+# let surreal = dbOpen(SurrealDB, "test_ns" "test_db", "user", "password" "http://localhost", 8000, maxConnections, timeout)
+
+proc main(){.async.} =
+  let result = await rdb
+                    .table("users")
+                    .select("id", "email", "name")
+                    .limit(5)
+                    .offset(10)
+                    .get()
+  echo result
+
+waitFor main()
+
+>> SELECT id, email, name FROM users LIMIT 5 OFFSET 10
+>> @[
+  {"id":11,"email":"user11@gmail.com","name":"user11"},
+  {"id":12,"email":"user12@gmail.com","name":"user12"},
+  {"id":13,"email":"user13@gmail.com","name":"user13"},
+  {"id":14,"email":"user14@gmail.com","name":"user14"},
+  {"id":15,"email":"user15@gmail.com","name":"user15"}
+]
+```
+
+### Schema Builder
+```nim
+import allographer/schema_builder
+
+
+rdb.create([
+  table("auth", [
+    Column.increments("id"),
+    Column.string("name").nullable(),
+    Column.timestamp("created_at").default()
+  ]),
+  table("users", [
+    Column.increments("id"),
+    Column.string("name"),
+    Column.foreign("auth_id").reference("id").on("auth").onDelete(SET_NULL)
+  ])
+])
+
+>> CREATE TABLE auth (
+    id INT NOT NULL PRIMARY KEY,
+    name VARCHAR,
+    created_at DATETIME DEFAULT (NOW())
+)
+>> CREATE TABLE users (
+    id INT NOT NULL PRIMARY KEY,
+    name VARCHAR NOT NULL,
+    auth_id INT,
+    FOREIGN KEY(auth_id) REFERENCES auth(id) ON DELETE SET NULL
+)
+
+rdb.alter(
+  table("users", [
+    Column.string("email").unique().default("").add(),
+    Column.deleteColumn("name")
+  ])
+)
+
+>> ALTER TABLE "users" ADD COLUMN 'email' VARCHAR UNIQUE DEFAULT '' CHECK (length("email") <= 255)
+>> ALTER TABLE "users" DROP `name`
+```
+
+## Index
+<!--ts-->
+- [allographer](#allographer)
+  - [Easy to access Rdb](#easy-to-access-rdb)
+    - [Query Builder](#query-builder)
+    - [Schema Builder](#schema-builder)
+  - [Index](#index)
+  - [Install](#install)
+  - [Configuation](#configuation)
+  - [Createing connection](#createing-connection)
+  - [Logging](#logging)
+  - [Documents](#documents)
+  - [Nim API Documents](#nim-api-documents)
+    - [v2](#v2)
+  - [Development](#development)
+    - [Branch naming rule](#branch-naming-rule)
+
+<!-- Created by https://github.com/ekalinin/github-markdown-toc -->
+<!-- Added by: root, at: Mon Jul 17 07:46:10 UTC 2023 -->
+
+<!--te-->
+---
+
+## Install
+```sh
+nimble install allographer
+```
+
+If you get `SIGSEGV: Illegal storage access. (Attempt to read from nil?)` when trying to use the database you likely have a problem with the library path. On OS X the default is to check for the `brew --prefix` of the chosen driver, if that doesn't work it will look in `/usr/lib` or an environment variable `DYLD_xxx_PATH` where `xxx` if your driver: `SQLITE`, `MARIADB`, `MYSQL` or `POSTGRES`.
+
+## Configuation
+Allographer loads emvironment variables of `DB_SQLITE`, `DB_POSTGRES`, `DB_MYSQL`, `DB_MARIADB` and `DB_BARADB` to define which process should be **compiled**.<br>
+(`DB_SURREAL` is planned to be supported in v3)<br>
+These environment variables have to be set at compile time, so they have to be written in `config.nims` not in `.env`.
+
+config.nims
+```nim
+import os
+
+putEnv("DB_SQLITE", $true)
+putEnv("DB_POSTGRES", $true)
+```
+In this example, even if your runtime environment lacks `mysqlclient-dev`, execution will success. However if your runtime environment lacks `sqlite3`, execution will fail.
+
+## Createing connection
+Database connection should be definded as singleton variable.
+
+database.nim
+```nim
+import allographer/connection
+
+let rdb* = dbOpen(PostgreSQL, "database", "user", "password", "localhost", 5432, maxConnections, timeout)
+
+# you can create connection for multiple database at same time.
+let sqliteRdb* = dbOpen(Sqlite3, "/path/to/db/sqlite3.db", maxConnections=maxConnections, timeout=timeout)
+let mysqlRdb* = dbOpen(MySQL, "database", "user", "password", "localhost", 3306, maxConnections, timeout)
+let mariaRdb* = dbOpen(MariaDB, "database", "user", "password", "localhost", 3306, maxConnections, timeout)
+let pgUrlRdb* = dbOpen(PostgreSQL, databaseUrl = asDatabaseUrl("postgresql://user:password@localhost:5432/database"), maxConnections=maxConnections, timeout=timeout)
+let baradbRdb* = dbOpen(Baradb, "database", "user", "password", "localhost", 9472, maxConnections, timeout)
+# let surrealDb* = dbOpen(SurrealDb, "test_ns" "test_db", "user", "password" "http://localhost", 8000, maxConnections, timeout) # planned for v3
+```
+
+Then, call connection when you run query.
+
+run_sql.nim
+```nim
+import asyncdispatch
+import allographer/query_builder
+from database import rdb
+
+proc main(){.async.}=
+  echo await rdb.table("users").get()
+
+waitFor main()
+```
+
+## Logging
+Please set args in `dbOpen()`
+```nim
+proc dbOpen*(driver:Driver, database:string="", user:string="", password:string="",
+            host: string="", port=0, maxConnections=1, timeout=30,
+            shouldDisplayLog=false, shouldOutputLogFile=false, logDir=""):Rdb
+```
+- shouldDisplayLog: Whether display logging in terminal console or not.
+- shouldOutputLogFile: Whether output logging in log file or not.
+- logDir: Define logging dir path.
+
+
+## Documents
+[Schema Builder for RDB](./documents/rdb/schema_builder.md)  
+[Query Builder for RDB](./documents/rdb/query_builder.md)  
+[Schema Builder for SurrealDB](./documents/surrealdb/schema_builder.md) (planned for v3)  
+[Query Builder for SurrealDB](./documents/surrealdb/query_builder.md) (planned for v3)
+
+
+## Nim API Documents
+### v2
+[connection](https://itsumura-h.github.io/nim-allographer/v2/connection.html)  
+[Schema Builder](https://itsumura-h.github.io/nim-allographer/v2/schema_builder.html)  
+[Query Builder](https://itsumura-h.github.io/nim-allographer/v2/query_builder.html)
+
+
+## Development
+### Branch naming rule
+Please create this branch name when you will create a new pull request.
+
+| Branch | Description |
+| ------ | ----------- |
+| feature-*** | New feature branch |
+| hotfix-*** | Bug fix branch |
+| chore-*** | Chore work or maintenance |
+
+This naming rule automatically labels the pull request.

clients/nim-allographer/allographer.nimble

@@ -0,0 +1,68 @@
+# Package
+
+version       = "0.32.1"
+author        = "Hidenobu Itsumura @dumblepytech1 as 'medy'"
+description   = "A Nim query builder library inspired by Laravel/PHP and Orator/Python"
+license       = "MIT"
+srcDir        = "src"
+# backend       = "c"
+# bin           = @["allographer/cli/dbtool"]
+# binDir        = "src/bin"
+# installExt    = @["nim"]
+# skipDirs      = @["allographer/cli"]
+
+# Dependencies
+
+requires "nim >= 2.0.0"
+requires "db_connector >= 0.1.0"
+requires "checksums >= 0.1.0"
+
+
+import strformat, os
+
+task test, "run testament test":
+  exec &"testament p 'tests/sqlite/test_*.nim'"
+  exec &"testament p 'tests/postgres/test_*.nim'"
+  exec &"testament p 'tests/mariadb/test_*.nim'"
+  exec &"testament p 'tests/mysql/test_*.nim'"
+  exec &"testament p 'tests/surrealdb/test_*.nim'"
+  exec &"testament p 'tests/utils/test_*.nim'"
+
+  for kind, path in walkDir(getCurrentDir() / "tests"):
+    if not path.contains(".") and path.fileExists():
+      exec "rm -f " & path
+
+task docs, "Generate API documents":
+  let
+    deployDir = &"docs/v{NimMajor}"
+    pkgDir = srcDir / "allographer"
+    srcFiles = @[
+      "connection",
+      "query_builder",
+      "schema_builder",
+    ]
+
+  if dirExists(deployDir):
+    rmDir deployDir
+  for f in srcFiles:
+    let srcFile = pkgDir / f & ".nim"
+    exec &"nim doc --hints:off --project --out:{deployDir} --index:on {srcFile}"
+
+
+let toolImage = "basolato:tool"
+
+task setupTool, "Setup tool docker image":
+  exec &"docker build -t {toolImage} -f tool_Dockerfile ."
+
+proc generateToc(dir: string) =
+  let cwd = getCurrentDir()
+  for f in listFiles(dir):
+    if 3 < f.len:
+      let ext = f[^3..^1]
+      if ext == ".md":
+        exec &"docker run --rm -v {cwd}:/work -it {toolImage} --insert --no-backup {f}"
+
+task toc, "Generate TOC":
+  generateToc(".")
+  generateToc("./documents/rdb")
+  generateToc("./documents/surrealdb")

clients/nim-allographer/compose.test.yaml

@@ -0,0 +1,50 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: ./docker/ubuntu/test.Dockerfile
+      args:
+        NIM_VERSION: "${NIM_VERSION:-2.2.8}"
+    tty: true
+    volumes:
+      - .:/root/project
+    depends_on:
+      - postgres
+      - mysql
+      - mariadb
+      - surreal
+
+  mysql:
+    image: mysql:8.0-debian
+    tty: true
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: database
+      MYSQL_USER: user
+      MYSQL_PASSWORD: pass
+
+  mariadb:
+    image: mariadb
+    tty: true
+    command: --default-authentication-plugin=mysql_native_password
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: database
+      MYSQL_USER: user
+      MYSQL_PASSWORD: pass
+
+  postgres:
+    image: postgres:alpine
+    tty: true
+    environment:
+      POSTGRES_DB: database
+      POSTGRES_USER: user
+      POSTGRES_PASSWORD: pass
+
+  surreal:
+    image: surrealdb/surrealdb:v3.0
+    tty: true
+    # command: start --log trace --user user --pass pass memory # like redis
+    # command: start --log trace --user user --pass pass file://root/.surrealdb # like mongo
+    command: start --log trace --user user --pass pass memory # like in-memory sqlite
+    # command: start --log trace --user user --pass pass file://root/.surrealdb # like rdb

clients/nim-allographer/compose.yaml

@@ -0,0 +1,71 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: ./docker/ubuntu/Dockerfile
+      args:
+        # VERSION: 1.6.14
+        NIM_VERSION: 2.2.8
+    tty: true
+    volumes:
+      - .:/application
+    depends_on:
+      - postgres
+      - mysql
+      - mariadb
+      - surreal
+
+  mysql:
+    image: mysql:8
+    tty: true
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: database
+      MYSQL_USER: user
+      MYSQL_PASSWORD: pass
+
+  mariadb:
+    image: mariadb
+    tty: true
+    command: --default-authentication-plugin=mysql_native_password
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: database
+      MYSQL_USER: user
+      MYSQL_PASSWORD: pass
+
+  postgres:
+    image: postgres:alpine
+    tty: true
+    environment:
+      POSTGRES_DB: database
+      POSTGRES_USER: user
+      POSTGRES_PASSWORD: pass
+
+  surreal:
+    image: surrealdb/surrealdb:v3.0
+    tty: true
+    # command: start --log trace --user user --pass pass memory # like redis
+    # command: start --log trace --user user --pass pass file://root/.surrealdb # like mongo
+    command: start --log trace --user user --pass pass memory # like in-memory sqlite
+    # command: start --log trace --user user --pass pass file://root/.surrealdb # like rdb
+
+  adminer:
+    image: adminer:4.8.1-standalone
+    tty: true
+    ports:
+      - 9001:8080
+    depends_on:
+      - mysql
+      - mariadb
+      - postgres
+
+  adminer-sqlite:
+    build: ./docker/adminer
+    tty: true
+    ports:
+      - 9002:8080
+    volumes:
+      - ./:/app
+    depends_on:
+      - app

clients/nim-allographer/config.nims

@@ -0,0 +1,7 @@
+import os
+
+putEnv("DB_SQLITE", $true)
+putEnv("DB_POSTGRES", $true)
+putEnv("DB_MYSQL", $true)
+putEnv("DB_MARIADB", $true)
+putEnv("DB_SURREAL", $true)

clients/nim-allographer/docker/adminer/Dockerfile

@@ -0,0 +1,3 @@
+FROM adminer:4.8.1-standalone
+USER root
+COPY login-password-less.php /var/www/html/plugins-enabled/login-password-less.php

clients/nim-allographer/docker/adminer/login-password-less.php

@@ -0,0 +1,9 @@
+<?php
+require_once('plugins/login-password-less.php');
+ 
+/** Set allowed password
+ * @param string result of password_hash
+ */
+return new AdminerLoginPasswordLess(
+    $password_hash = password_hash("pass", PASSWORD_DEFAULT)
+);

clients/nim-allographer/docker/alpine/Dockerfile

@@ -0,0 +1,28 @@
+FROM nimlang/nim:1.6.2-alpine-regular
+
+RUN echo http://dl-cdn.alpinelinux.org/alpine/edge/testing >> /etc/apk/repositories
+RUN apk update && \
+    apk upgrade --no-cache && \
+    apk add --no-cache \
+        curl \
+        gcc \
+        musl-dev \
+        bsd-compat-headers \
+        openssh-client \
+        git \
+        lcov \
+        sqlite \
+        libpq \
+        mariadb-dev \
+        openssl \
+        pcre \
+        && \
+    rm /usr/lib/mysqld* -fr && \
+    rm /usr/bin/mysql* -fr
+ENV PATH $PATH:/root/.nimble/bin
+WORKDIR /root/project
+COPY ./allographer.nimble .
+RUN nimble install -y
+RUN nimble install -y \
+           bcrypt \
+           progress

clients/nim-allographer/docker/ubuntu/Dockerfile

@@ -0,0 +1,48 @@
+FROM ubuntu:24.04
+
+# prevent timezone dialogue
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt update
+RUN apt upgrade -y
+RUN apt install -y \
+    # for build Nim and make
+    build-essential \
+    # for unzip tar.xz
+    xz-utils \
+    # for https
+    ca-certificates \
+    # for nim regex
+    libpcre3-dev \
+    vim \
+    curl \
+    git \
+    sqlite3 \
+    libpq-dev \
+    libmariadb-dev
+
+WORKDIR /root
+
+# Nim
+ARG NIM_VERSION="2.0.0"
+RUN curl https://nim-lang.org/choosenim/init.sh -o init.sh
+RUN sh init.sh -y
+RUN rm -f init.sh
+ENV PATH $PATH:/root/.nimble/bin
+RUN choosenim ${NIM_VERSION}
+
+# nimlangserver
+# https://github.com/nim-lang/langserver/releases/latest
+WORKDIR /root
+RUN curl -o nimlangserver.tar.gz -L https://github.com/nim-lang/langserver/releases/latest/download/nimlangserver-linux-amd64.tar.gz
+RUN tar zxf nimlangserver.tar.gz
+RUN rm -f nimlangserver.tar.gz
+RUN mv nimlangserver /root/.nimble/bin/
+
+WORKDIR /application
+COPY ./allographer.nimble .
+RUN nimble install -y -d
+
+RUN git config --global --add safe.directory /application
+
+WORKDIR /application

clients/nim-allographer/docker/ubuntu/test.Dockerfile

@@ -0,0 +1,40 @@
+FROM ubuntu:24.04
+
+# prevent timezone dialogue
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt update
+RUN apt upgrade -y
+RUN apt install -y \
+    gcc \
+    xz-utils \
+    ca-certificates \
+    libpcre3-dev \
+    curl \
+    git \
+    sqlite3 \
+    libpq-dev \
+    libmariadb-dev
+
+# gcc... for Nim
+# xz-utils... for unzip tar.xz
+# ca-certificates... for https
+# libpcre3-dev... for nim regex
+
+WORKDIR /root
+
+# Nim
+ARG NIM_VERSION="2.0.0"
+RUN curl https://nim-lang.org/choosenim/init.sh -o init.sh
+RUN sh init.sh -y
+RUN rm -f init.sh
+ENV PATH $PATH:/root/.nimble/bin
+RUN choosenim ${NIM_VERSION}
+
+WORKDIR /root/project
+COPY ./allographer.nimble .
+RUN nimble install -y -d
+
+RUN git config --global --add safe.directory /root/project
+
+WORKDIR /root/project

clients/nim-allographer/docs/connection.html

@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/connection</title>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="nimdoc.out.css">
+
+<!-- JS -->
+<script type="text/javascript" src="dochack.js"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/connection</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" onkeyup="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <a class="reference reference-toplevel" href="#19" id="69">Exports</a>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="env.html">env</a>, <a class="reference external" href="v2/query_builder/models/sqlite/sqlite_types.html">v2/query_builder/models/sqlite/sqlite_types</a>, <a class="reference external" href="v2/query_builder/models/sqlite/sqlite_open.html">v2/query_builder/models/sqlite/sqlite_open</a>, <a class="reference external" href="v2/query_builder/models/postgres/postgres_types.html">v2/query_builder/models/postgres/postgres_types</a>, <a class="reference external" href="v2/query_builder/models/postgres/postgres_open.html">v2/query_builder/models/postgres/postgres_open</a>, <a class="reference external" href="v2/query_builder/models/mariadb/mariadb_types.html">v2/query_builder/models/mariadb/mariadb_types</a>, <a class="reference external" href="v2/query_builder/models/mariadb/mariadb_open.html">v2/query_builder/models/mariadb/mariadb_open</a>, <a class="reference external" href="v2/query_builder/models/mysql/mysql_types.html">v2/query_builder/models/mysql/mysql_types</a>, <a class="reference external" href="v2/query_builder/models/mysql/mysql_open.html">v2/query_builder/models/mysql/mysql_open</a>, <a class="reference external" href="v2/query_builder/models/surreal/surreal_types.html">v2/query_builder/models/surreal/surreal_types</a>, <a class="reference external" href="v2/query_builder/models/surreal/surreal_open.html">v2/query_builder/models/surreal/surreal_open</a>
+  </dl>
+</div>
+<div class="section" id="19">
+  <h1><a class="toc-backref" href="#19">Exports</a></h1>
+  <dl class="item">
+    <a href="v2/query_builder/models/sqlite/sqlite_types.html#SQLite3"><span class="Identifier">SQLite3</span></a>, <a href="v2/query_builder/models/sqlite/sqlite_types.html#SqliteConnections"><span class="Identifier">SqliteConnections</span></a>, <a href="v2/query_builder/models/sqlite/sqlite_open.html#dbOpen,typeSQLite3,string,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="v2/query_builder/models/postgres/postgres_types.html#PostgreSQL"><span class="Identifier">PostgreSQL</span></a>, <a href="v2/query_builder/models/postgres/postgres_types.html#PostgresConnections"><span class="Identifier">PostgresConnections</span></a>, <a href="v2/query_builder/models/postgres/postgres_open.html#dbOpen,typePostgreSQL,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="v2/query_builder/models/mariadb/mariadb_types.html#MariaDB"><span class="Identifier">MariaDB</span></a>, <a href="v2/query_builder/models/mariadb/mariadb_types.html#MariadbConnections"><span class="Identifier">MariadbConnections</span></a>, <a href="v2/query_builder/models/mariadb/mariadb_open.html#dbOpen,typeMariaDB,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="v2/query_builder/models/mysql/mysql_types.html#MySQL"><span class="Identifier">MySQL</span></a>, <a href="v2/query_builder/models/mysql/mysql_types.html#MysqlConnections"><span class="Identifier">MysqlConnections</span></a>, <a href="v2/query_builder/models/mysql/mysql_open.html#dbOpen,typeMySQL,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="v2/query_builder/models/surreal/surreal_types.html#SurrealDB"><span class="Identifier">SurrealDB</span></a>, <a href="v2/query_builder/models/surreal/surreal_types.html#SurrealConnections"><span class="Identifier">SurrealConnections</span></a>, <a href="v2/query_builder/models/surreal/surreal_open.html#dbOpen,typeSurrealDB,string,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2024-04-26 16:50:23 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+  <!-- Google fonts -->
+  <link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+  <link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+</body>
+</html>

clients/nim-allographer/docs/connection.idx

@@ -0,0 +1 @@
+nimTitle	connection	connection.html	module src/allographer/connection		0

clients/nim-allographer/docs/env.html

@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/env</title>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="nimdoc.out.css">
+
+<!-- JS -->
+<script type="text/javascript" src="dochack.js"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/env</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" onkeyup="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#10" id="60">Consts</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#isExistsMariadb" title="isExistsMariadb = true">isExistsMariadb</a></li>
+<li><a class="reference" href="#isExistsMysql" title="isExistsMysql = true">isExistsMysql</a></li>
+<li><a class="reference" href="#isExistsPostgres" title="isExistsPostgres = true">isExistsPostgres</a></li>
+<li><a class="reference" href="#isExistsSqlite" title="isExistsSqlite = true">isExistsSqlite</a></li>
+<li><a class="reference" href="#isExistsSurrealdb" title="isExistsSurrealdb = true">isExistsSurrealdb</a></li>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="10">
+  <h1><a class="toc-backref" href="#10">Consts</a></h1>
+  <dl class="item">
+    <div id="isExistsMariadb">
+  <dt><pre><a href="env.html#isExistsMariadb"><span class="Identifier">isExistsMariadb</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsMysql">
+  <dt><pre><a href="env.html#isExistsMysql"><span class="Identifier">isExistsMysql</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsPostgres">
+  <dt><pre><a href="env.html#isExistsPostgres"><span class="Identifier">isExistsPostgres</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsSqlite">
+  <dt><pre><a href="env.html#isExistsSqlite"><span class="Identifier">isExistsSqlite</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsSurrealdb">
+  <dt><pre><a href="env.html#isExistsSurrealdb"><span class="Identifier">isExistsSurrealdb</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2024-04-26 16:50:29 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+  <!-- Google fonts -->
+  <link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+  <link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+</body>
+</html>

clients/nim-allographer/docs/env.idx

@@ -0,0 +1,6 @@
+nimTitle	env	env.html	module src/allographer/env		0
+nim	isExistsSqlite	env.html#isExistsSqlite	const isExistsSqlite		22
+nim	isExistsPostgres	env.html#isExistsPostgres	const isExistsPostgres		23
+nim	isExistsMysql	env.html#isExistsMysql	const isExistsMysql		24
+nim	isExistsMariadb	env.html#isExistsMariadb	const isExistsMariadb		25
+nim	isExistsSurrealdb	env.html#isExistsSurrealdb	const isExistsSurrealdb		26

clients/nim-allographer/docs/query_builder.idx

@@ -0,0 +1 @@
+nimTitle	query_builder	query_builder.html	module src/allographer/query_builder		0

clients/nim-allographer/docs/schema_builder.idx

@@ -0,0 +1 @@
+nimTitle	schema_builder	schema_builder.html	module src/allographer/schema_builder		0

clients/nim-allographer/docs/utils.html

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/utils</title>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="nimdoc.out.css">
+
+<!-- JS -->
+<script type="text/javascript" src="dochack.js"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/utils</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" onkeyup="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">getOsName
+  <li><a class="reference" href="#getOsName" title="getOsName(): string">getOsName(): string</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="getOsName-procs-all">
+  <div id="getOsName">
+  <dt><pre><span class="Keyword">func</span> <a href="#getOsName"><span class="Identifier">getOsName</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2024-04-26 16:50:31 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+  <!-- Google fonts -->
+  <link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+  <link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+</body>
+</html>

clients/nim-allographer/docs/utils.idx

@@ -0,0 +1,2 @@
+nimTitle	utils	utils.html	module src/allographer/utils		0
+nim	getOsName	utils.html#getOsName	proc getOsName(): string		3

clients/nim-allographer/docs/v2/connection.html

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/connection</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/connection</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <a class="reference reference-toplevel" href="#19" id="69">Exports</a>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="env.html">env</a>, <a class="reference external" href="query_builder/libs/database_url.html">query_builder/libs/database_url</a>, <a class="reference external" href="query_builder/models/sqlite/sqlite_types.html">query_builder/models/sqlite/sqlite_types</a>, <a class="reference external" href="query_builder/models/sqlite/sqlite_open.html">query_builder/models/sqlite/sqlite_open</a>, <a class="reference external" href="query_builder/models/postgres/postgres_types.html">query_builder/models/postgres/postgres_types</a>, <a class="reference external" href="query_builder/models/postgres/postgres_open.html">query_builder/models/postgres/postgres_open</a>, <a class="reference external" href="query_builder/models/mariadb/mariadb_types.html">query_builder/models/mariadb/mariadb_types</a>, <a class="reference external" href="query_builder/models/mariadb/mariadb_open.html">query_builder/models/mariadb/mariadb_open</a>, <a class="reference external" href="query_builder/models/mysql/mysql_types.html">query_builder/models/mysql/mysql_types</a>, <a class="reference external" href="query_builder/models/mysql/mysql_open.html">query_builder/models/mysql/mysql_open</a>, <a class="reference external" href="query_builder/models/surreal/surreal_types.html">query_builder/models/surreal/surreal_types</a>, <a class="reference external" href="query_builder/models/surreal/surreal_open.html">query_builder/models/surreal/surreal_open</a>
+  </dl>
+</div>
+<div class="section" id="19">
+  <h1><a class="toc-backref" href="#19">Exports</a></h1>
+  <dl class="item">
+    <a href="query_builder/libs/database_url.html#DatabaseUrl"><span class="Identifier">DatabaseUrl</span></a>, <a href="query_builder/libs/database_url.html#DatabaseUrlQuery"><span class="Identifier">DatabaseUrlQuery</span></a>, <a href="query_builder/libs/database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a>, <a href="query_builder/libs/database_url.html#asDatabaseUrl,string"><span class="Identifier">asDatabaseUrl</span></a>, <a href="query_builder/libs/database_url.html#parseDatabaseUrl,string"><span class="Identifier">parseDatabaseUrl</span></a>, <a href="query_builder/libs/database_url.html#parseDatabaseUrl,DatabaseUrl"><span class="Identifier">parseDatabaseUrl</span></a>, <a href="query_builder/libs/database_url.html#databaseName,ParsedDatabaseUrl"><span class="Identifier">databaseName</span></a>, <a href="query_builder/libs/database_url.html#sqliteDatabasePath,ParsedDatabaseUrl"><span class="Identifier">sqliteDatabasePath</span></a>, <a href="query_builder/libs/database_url.html#portOrDefault,ParsedDatabaseUrl,int"><span class="Identifier">portOrDefault</span></a>, <a href="query_builder/libs/database_url.html#requireDatabaseUrlScheme,ParsedDatabaseUrl,openArray[string],string"><span class="Identifier">requireDatabaseUrlScheme</span></a>, <a href="query_builder/models/sqlite/sqlite_types.html#SQLite3"><span class="Identifier">SQLite3</span></a>, <a href="query_builder/models/sqlite/sqlite_types.html#SqliteConnections"><span class="Identifier">SqliteConnections</span></a>, <a href="query_builder/models/sqlite/sqlite_open.html#dbOpen,typeSQLite3,string,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/sqlite/sqlite_open.html#dbOpen,typeSQLite3,DatabaseUrl,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/postgres/postgres_types.html#PostgreSQL"><span class="Identifier">PostgreSQL</span></a>, <a href="query_builder/models/postgres/postgres_types.html#PostgresConnections"><span class="Identifier">PostgresConnections</span></a>, <a href="query_builder/models/postgres/postgres_open.html#dbOpen,typePostgreSQL,DatabaseUrl,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/postgres/postgres_open.html#dbOpen,typePostgreSQL,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/postgres/postgres_open.html#dbOpen,typePostgreSQL,string,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/mariadb/mariadb_types.html#MariaDB"><span class="Identifier">MariaDB</span></a>, <a href="query_builder/models/mariadb/mariadb_types.html#MariadbConnections"><span class="Identifier">MariadbConnections</span></a>, <a href="query_builder/models/mariadb/mariadb_open.html#dbOpen,typeMariaDB,DatabaseUrl,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/mariadb/mariadb_open.html#dbOpen,typeMariaDB,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/mariadb/mariadb_open.html#dbOpen,typeMariaDB,string,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/mysql/mysql_types.html#MySQL"><span class="Identifier">MySQL</span></a>, <a href="query_builder/models/mysql/mysql_types.html#MysqlConnections"><span class="Identifier">MysqlConnections</span></a>, <a href="query_builder/models/mysql/mysql_open.html#dbOpen,typeMySQL,DatabaseUrl,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/mysql/mysql_open.html#dbOpen,typeMySQL,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/mysql/mysql_open.html#dbOpen,typeMySQL,string,int,int,string"><span class="Identifier">dbOpen</span></a>, <a href="query_builder/models/surreal/surreal_types.html#SurrealDB"><span class="Identifier">SurrealDB</span></a>, <a href="query_builder/models/surreal/surreal_types.html#SurrealConnections"><span class="Identifier">SurrealConnections</span></a>, <a href="query_builder/models/surreal/surreal_open.html#dbOpen,typeSurrealDB,string,string,string,string,string,int,int,int,string"><span class="Identifier">dbOpen</span></a>
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:24 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/connection.idx

@@ -0,0 +1 @@
+nimTitle	connection	connection.html	module src/allographer/connection		0

clients/nim-allographer/docs/v2/env.html

@@ -0,0 +1,135 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/env</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/env</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#10" id="60">Consts</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#isExistsMariadb" title="isExistsMariadb = true">isExistsMariadb</a></li>
+<li><a class="reference" href="#isExistsMysql" title="isExistsMysql = true">isExistsMysql</a></li>
+<li><a class="reference" href="#isExistsPostgres" title="isExistsPostgres = true">isExistsPostgres</a></li>
+<li><a class="reference" href="#isExistsSqlite" title="isExistsSqlite = true">isExistsSqlite</a></li>
+<li><a class="reference" href="#isExistsSurrealdb" title="isExistsSurrealdb = true">isExistsSurrealdb</a></li>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="10">
+  <h1><a class="toc-backref" href="#10">Consts</a></h1>
+  <dl class="item">
+    <div id="isExistsMariadb">
+  <dt><pre><a href="env.html#isExistsMariadb"><span class="Identifier">isExistsMariadb</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsMysql">
+  <dt><pre><a href="env.html#isExistsMysql"><span class="Identifier">isExistsMysql</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsPostgres">
+  <dt><pre><a href="env.html#isExistsPostgres"><span class="Identifier">isExistsPostgres</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsSqlite">
+  <dt><pre><a href="env.html#isExistsSqlite"><span class="Identifier">isExistsSqlite</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="isExistsSurrealdb">
+  <dt><pre><a href="env.html#isExistsSurrealdb"><span class="Identifier">isExistsSurrealdb</span></a> <span class="Other">=</span> <span class="DecNumber">true</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:32 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/env.idx

@@ -0,0 +1,6 @@
+nimTitle	env	env.html	module src/allographer/env		0
+nim	isExistsSqlite	env.html#isExistsSqlite	const isExistsSqlite		22
+nim	isExistsPostgres	env.html#isExistsPostgres	const isExistsPostgres		23
+nim	isExistsMysql	env.html#isExistsMysql	const isExistsMysql		24
+nim	isExistsMariadb	env.html#isExistsMariadb	const isExistsMariadb		25
+nim	isExistsSurrealdb	env.html#isExistsSurrealdb	const isExistsSurrealdb		26

clients/nim-allographer/docs/v2/query_builder.idx

@@ -0,0 +1 @@
+nimTitle	query_builder	query_builder.html	module src/allographer/query_builder		0

clients/nim-allographer/docs/v2/query_builder/enums.html

@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/enums</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/enums</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#Collation" title="Collation = enum
+  None = &quot;&quot;, Collate = &quot;COLLATE&quot;, Numeric = &quot;NUMERIC&quot;">Collation</a></li>
+<li><a class="reference" href="#Order" title="Order = enum
+  Asc = &quot;ASC&quot;, Desc = &quot;DESC&quot;">Order</a></li>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="7">
+  <h1><a class="toc-backref" href="#7">Types</a></h1>
+  <dl class="item">
+    <div id="Collation">
+  <dt><pre><a href="enums.html#Collation"><span class="Identifier">Collation</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
+  <span class="Identifier">None</span> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">,</span> <span class="Identifier">Collate</span> <span class="Other">=</span> <span class="StringLit">&quot;COLLATE&quot;</span><span class="Other">,</span> <span class="Identifier">Numeric</span> <span class="Other">=</span> <span class="StringLit">&quot;NUMERIC&quot;</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="Order">
+  <dt><pre><a href="enums.html#Order"><span class="Identifier">Order</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
+  <span class="Identifier">Asc</span> <span class="Other">=</span> <span class="StringLit">&quot;ASC&quot;</span><span class="Other">,</span> <span class="Identifier">Desc</span> <span class="Other">=</span> <span class="StringLit">&quot;DESC&quot;</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:33 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/enums.idx

@@ -0,0 +1,8 @@
+nimTitle	enums	query_builder/enums.html	module src/allographer/query_builder/enums		0
+nim	Asc	query_builder/enums.html#Asc	Order.Asc		1
+nim	Desc	query_builder/enums.html#Desc	Order.Desc		1
+nim	Order	query_builder/enums.html#Order	enum Order		1
+nim	None	query_builder/enums.html#None	Collation.None		5
+nim	Collate	query_builder/enums.html#Collate	Collation.Collate		5
+nim	Numeric	query_builder/enums.html#Numeric	Collation.Numeric		5
+nim	Collation	query_builder/enums.html#Collation	enum Collation		5

clients/nim-allographer/docs/v2/query_builder/error.html

@@ -0,0 +1,129 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/error</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/error</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#DbError" title="DbError = object of IOError">DbError</a></li>
+
+    </ul>
+  </details>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">dbError
+  <li><a class="reference" href="#dbError%2Cstring" title="dbError(msg: string)">dbError(msg: string)</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="7">
+  <h1><a class="toc-backref" href="#7">Types</a></h1>
+  <dl class="item">
+    <div id="DbError">
+  <dt><pre><a href="error.html#DbError"><span class="Identifier">DbError</span></a> <span class="Other">=</span> <span class="Keyword">object</span> <span class="Keyword">of</span> <span class="Identifier">IOError</span></pre></dt>
+  <dd>
+    
+    exception that is raised if a database error occurs
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="dbError-procs-all">
+  <div id="dbError,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbError%2Cstring"><span class="Identifier">dbError</span></a><span class="Other">(</span><span class="Identifier">msg</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span> {.<span class="Identifier">noreturn</span><span class="Other">,</span> <span class="Identifier">noinline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+                            <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    raises an DbError exception with message <tt class="docutils literal"><span class="pre"><span class="Identifier">msg</span></span></tt>.
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:32 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/error.idx

@@ -0,0 +1,3 @@
+nimTitle	error	query_builder/error.html	module src/allographer/query_builder/error		0
+nim	DbError	query_builder/error.html#DbError	object DbError		2
+nim	dbError	query_builder/error.html#dbError,string	proc dbError(msg: string)		4

clients/nim-allographer/docs/v2/query_builder/libs/database_url.html

@@ -0,0 +1,274 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/database_url</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/database_url</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#DatabaseUrl" title="DatabaseUrl = distinct string">DatabaseUrl</a></li>
+<li><a class="reference" href="#DatabaseUrlQuery" title="DatabaseUrlQuery = tuple[key, value: string]">DatabaseUrlQuery</a></li>
+<li><a class="reference" href="#ParsedDatabaseUrl" title="ParsedDatabaseUrl = object
+  raw*: string
+  scheme*: string
+  username*: string
+  password*: string
+  hostname*: string
+  port*: int
+  hasPort*: bool
+  path*: string
+  query*: seq[DatabaseUrlQuery]">ParsedDatabaseUrl</a></li>
+
+    </ul>
+  </details>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">$
+  <li><a class="reference" href="#%24%2CDatabaseUrl" title="`$`(value: DatabaseUrl): string">`$`(value: DatabaseUrl): string</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">asDatabaseUrl
+  <li><a class="reference" href="#asDatabaseUrl%2Cstring" title="asDatabaseUrl(value: string): DatabaseUrl">asDatabaseUrl(value: string): DatabaseUrl</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">databaseName
+  <li><a class="reference" href="#databaseName%2CParsedDatabaseUrl" title="databaseName(value: ParsedDatabaseUrl): string">databaseName(value: ParsedDatabaseUrl): string</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">parseDatabaseUrl
+  <li><a class="reference" href="#parseDatabaseUrl%2CDatabaseUrl" title="parseDatabaseUrl(value: DatabaseUrl): ParsedDatabaseUrl">parseDatabaseUrl(value: DatabaseUrl): ParsedDatabaseUrl</a></li>
+<li><a class="reference" href="#parseDatabaseUrl%2Cstring" title="parseDatabaseUrl(value: string): ParsedDatabaseUrl">parseDatabaseUrl(value: string): ParsedDatabaseUrl</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">portOrDefault
+  <li><a class="reference" href="#portOrDefault%2CParsedDatabaseUrl%2Cint" title="portOrDefault(value: ParsedDatabaseUrl; defaultPort: int): int">portOrDefault(value: ParsedDatabaseUrl; defaultPort: int): int</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">requireDatabaseUrlScheme
+  <li><a class="reference" href="#requireDatabaseUrlScheme%2CParsedDatabaseUrl%2CopenArray%5Bstring%5D%2Cstring" title="requireDatabaseUrlScheme(value: ParsedDatabaseUrl;
+                         expectedSchemes: openArray[string]; driverName: string)">requireDatabaseUrlScheme(value: ParsedDatabaseUrl;
+                         expectedSchemes: openArray[string]; driverName: string)</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">sqliteDatabasePath
+  <li><a class="reference" href="#sqliteDatabasePath%2CParsedDatabaseUrl" title="sqliteDatabasePath(value: ParsedDatabaseUrl): string">sqliteDatabasePath(value: ParsedDatabaseUrl): string</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="7">
+  <h1><a class="toc-backref" href="#7">Types</a></h1>
+  <dl class="item">
+    <div id="DatabaseUrl">
+  <dt><pre><a href="database_url.html#DatabaseUrl"><span class="Identifier">DatabaseUrl</span></a> <span class="Other">=</span> <span class="Keyword">distinct</span> <span class="Identifier">string</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="DatabaseUrlQuery">
+  <dt><pre><a href="database_url.html#DatabaseUrlQuery"><span class="Identifier">DatabaseUrlQuery</span></a> <span class="Other">=</span> <span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">key</span><span class="Other">,</span> <span class="Identifier">value</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">]</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="ParsedDatabaseUrl">
+  <dt><pre><a href="database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
+  <span class="Identifier">raw</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">scheme</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">username</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">password</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">hostname</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">port</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">int</span>
+  <span class="Identifier">hasPort</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">bool</span>
+  <span class="Identifier">path</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">query</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="database_url.html#DatabaseUrlQuery"><span class="Identifier">DatabaseUrlQuery</span></a><span class="Other">]</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="$-procs-all">
+  <div id="$,DatabaseUrl">
+  <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CDatabaseUrl"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <a href="database_url.html#DatabaseUrl"><span class="Identifier">DatabaseUrl</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="asDatabaseUrl-procs-all">
+  <div id="asDatabaseUrl,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#asDatabaseUrl%2Cstring"><span class="Identifier">asDatabaseUrl</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <a href="database_url.html#DatabaseUrl"><span class="Identifier">DatabaseUrl</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="databaseName-procs-all">
+  <div id="databaseName,ParsedDatabaseUrl">
+  <dt><pre><span class="Keyword">proc</span> <a href="#databaseName%2CParsedDatabaseUrl"><span class="Identifier">databaseName</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <a href="database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="parseDatabaseUrl-procs-all">
+  <div id="parseDatabaseUrl,DatabaseUrl">
+  <dt><pre><span class="Keyword">proc</span> <a href="#parseDatabaseUrl%2CDatabaseUrl"><span class="Identifier">parseDatabaseUrl</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <a href="database_url.html#DatabaseUrl"><span class="Identifier">DatabaseUrl</span></a><span class="Other">)</span><span class="Other">:</span> <a href="database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="parseDatabaseUrl,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#parseDatabaseUrl%2Cstring"><span class="Identifier">parseDatabaseUrl</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <a href="database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="portOrDefault-procs-all">
+  <div id="portOrDefault,ParsedDatabaseUrl,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#portOrDefault%2CParsedDatabaseUrl%2Cint"><span class="Identifier">portOrDefault</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <a href="database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a><span class="Other">;</span> <span class="Identifier">defaultPort</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">int</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="requireDatabaseUrlScheme-procs-all">
+  <div id="requireDatabaseUrlScheme,ParsedDatabaseUrl,openArray[string],string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#requireDatabaseUrlScheme%2CParsedDatabaseUrl%2CopenArray%5Bstring%5D%2Cstring"><span class="Identifier">requireDatabaseUrlScheme</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <a href="database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a><span class="Other">;</span>
+                              <span class="Identifier">expectedSchemes</span><span class="Other">:</span> <span class="Identifier">openArray</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span>
+                              <span class="Identifier">driverName</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="sqliteDatabasePath-procs-all">
+  <div id="sqliteDatabasePath,ParsedDatabaseUrl">
+  <dt><pre><span class="Keyword">proc</span> <a href="#sqliteDatabasePath%2CParsedDatabaseUrl"><span class="Identifier">sqliteDatabasePath</span></a><span class="Other">(</span><span class="Identifier">value</span><span class="Other">:</span> <a href="database_url.html#ParsedDatabaseUrl"><span class="Identifier">ParsedDatabaseUrl</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:23 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/database_url.idx

@@ -0,0 +1,13 @@
+nimTitle	database_url	query_builder/libs/database_url.html	module src/allographer/query_builder/libs/database_url		0
+nim	DatabaseUrl	query_builder/libs/database_url.html#DatabaseUrl	type DatabaseUrl		5
+nim	DatabaseUrlQuery	query_builder/libs/database_url.html#DatabaseUrlQuery	tuple DatabaseUrlQuery		7
+nim	ParsedDatabaseUrl	query_builder/libs/database_url.html#ParsedDatabaseUrl	object ParsedDatabaseUrl		9
+nim	asDatabaseUrl	query_builder/libs/database_url.html#asDatabaseUrl,string	proc asDatabaseUrl(value: string): DatabaseUrl		21
+nim	`$`	query_builder/libs/database_url.html#$,DatabaseUrl	proc `$`(value: DatabaseUrl): string		25
+nim	parseDatabaseUrl	query_builder/libs/database_url.html#parseDatabaseUrl,string	proc parseDatabaseUrl(value: string): ParsedDatabaseUrl		44
+nim	parseDatabaseUrl	query_builder/libs/database_url.html#parseDatabaseUrl,DatabaseUrl	proc parseDatabaseUrl(value: DatabaseUrl): ParsedDatabaseUrl		60
+nim	requireDatabaseUrlScheme	query_builder/libs/database_url.html#requireDatabaseUrlScheme,ParsedDatabaseUrl,openArray[string],string	proc requireDatabaseUrlScheme(value: ParsedDatabaseUrl;\n                         expectedSchemes: openArray[string]; driverName: string)		64
+nim	databaseName	query_builder/libs/database_url.html#databaseName,ParsedDatabaseUrl	proc databaseName(value: ParsedDatabaseUrl): string		82
+nim	sqliteDatabasePath	query_builder/libs/database_url.html#sqliteDatabasePath,ParsedDatabaseUrl	proc sqliteDatabasePath(value: ParsedDatabaseUrl): string		86
+nim	portOrDefault	query_builder/libs/database_url.html#portOrDefault,ParsedDatabaseUrl,int	proc portOrDefault(value: ParsedDatabaseUrl; defaultPort: int): int		97
+nimgrp	parsedatabaseurl	query_builder/libs/database_url.html#parseDatabaseUrl-procs-all	proc		44

clients/nim-allographer/docs/v2/query_builder/libs/mariadb/mariadb_impl.html

@@ -0,0 +1,295 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/mariadb/mariadb_impl</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/mariadb/mariadb_impl</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">exec
+  <li><a class="reference" href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint" title="exec(db: PMySQL; query: string; args: JsonNode; columns: seq[seq[string]];
+     timeout: int): owned(Future[void])">exec(db: PMySQL; query: string; args: JsonNode; columns: seq[seq[string]];
+     timeout: int): owned(Future[void])</a></li>
+<li><a class="reference" href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="exec(db: PMySQL; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])">exec(db: PMySQL; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])</a></li>
+<li><a class="reference" href="#exec%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="exec(db: PMySQL; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])">exec(db: PMySQL; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">execGetValue
+  <li><a class="reference" href="#execGetValue%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint" title="execGetValue(db: PMySQL; query: string; args: JsonNode;
+             columns: seq[seq[string]]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">execGetValue(db: PMySQL; query: string; args: JsonNode;
+             columns: seq[seq[string]]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">getColumns
+  <li><a class="reference" href="#getColumns%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="getColumns(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]">getColumns(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">getColumnTypes
+  <li><a class="reference" href="#getColumnTypes%2CPMySQL%2Cstring%2Cstring%2Cint" title="getColumnTypes(db: PMySQL; database, table: string; timeout: int): Future[
+    seq[database_types.Row]]">getColumnTypes(db: PMySQL; database, table: string; timeout: int): Future[
+    seq[database_types.Row]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">query
+  <li><a class="reference" href="#query%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="query(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">query(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+<li><a class="reference" href="#query%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="query(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">query(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">queryPlain
+  <li><a class="reference" href="#queryPlain%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="queryPlain(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    seq[database_types.Row]]">queryPlain(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    seq[database_types.Row]]</a></li>
+<li><a class="reference" href="#queryPlain%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="queryPlain(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[database_types.Row]]">queryPlain(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[database_types.Row]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">rawQuery
+  <li><a class="reference" href="#rawQuery%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="rawQuery(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">rawQuery(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="../../error.html">../../error</a>, <a class="reference external" href="../../models/database_types.html">../../models/database_types</a>, <a class="reference external" href="mariadb_rdb.html">mariadb_rdb</a>, <a class="reference external" href="mariadb_lib.html">mariadb_lib</a>
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="exec-procs-all">
+  <div id="exec,PMySQL,string,JsonNode,seq[seq[string]],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span><span class="Other">;</span>
+          <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="exec,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="exec,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="execGetValue-procs-all">
+  <div id="execGetValue,PMySQL,string,JsonNode,seq[seq[string]],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#execGetValue%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint"><span class="Identifier">execGetValue</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span>
+                  <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="getColumns-procs-all">
+  <div id="getColumns,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#getColumns%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">getColumns</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                   <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="getColumnTypes-procs-all">
+  <div id="getColumnTypes,PMySQL,string,string,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#getColumnTypes%2CPMySQL%2Cstring%2Cstring%2Cint"><span class="Identifier">getColumnTypes</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">database</span><span class="Other">,</span> <span class="Identifier">table</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span>
+    <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="query-procs-all">
+  <div id="query,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#query%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">query</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="query,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#query%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">query</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="queryPlain-procs-all">
+  <div id="queryPlain,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#queryPlain%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">queryPlain</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span>
+    <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="queryPlain,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#queryPlain%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">queryPlain</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span>
+    <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="rawQuery-procs-all">
+  <div id="rawQuery,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#rawQuery%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">rawQuery</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:34 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/mariadb/mariadb_impl.idx

@@ -0,0 +1,15 @@
+nimTitle	mariadb_impl	query_builder/libs/mariadb/mariadb_impl.html	module src/allographer/query_builder/libs/mariadb/mariadb_impl		0
+nim	query	query_builder/libs/mariadb/mariadb_impl.html#query,PMySQL,string,seq[string],int	proc query(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		178
+nim	query	query_builder/libs/mariadb/mariadb_impl.html#query,PMySQL,string,JsonNode,int	proc query(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		212
+nim	queryPlain	query_builder/libs/mariadb/mariadb_impl.html#queryPlain,PMySQL,string,seq[string],int	proc queryPlain(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[\n    seq[database_types.Row]]		215
+nim	queryPlain	query_builder/libs/mariadb/mariadb_impl.html#queryPlain,PMySQL,string,JsonNode,int	proc queryPlain(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[\n    seq[database_types.Row]]		241
+nim	exec	query_builder/libs/mariadb/mariadb_impl.html#exec,PMySQL,string,seq[string],int	proc exec(db: PMySQL; query: string; args: seq[string]; timeout: int): owned(\n    Future[void])		244
+nim	exec	query_builder/libs/mariadb/mariadb_impl.html#exec,PMySQL,string,JsonNode,int	proc exec(db: PMySQL; query: string; args: JsonNode; timeout: int): owned(\n    Future[void])		249
+nim	exec	query_builder/libs/mariadb/mariadb_impl.html#exec,PMySQL,string,JsonNode,seq[seq[string]],int	proc exec(db: PMySQL; query: string; args: JsonNode; columns: seq[seq[string]];\n     timeout: int): owned(Future[void])		252
+nim	execGetValue	query_builder/libs/mariadb/mariadb_impl.html#execGetValue,PMySQL,string,JsonNode,seq[seq[string]],int	proc execGetValue(db: PMySQL; query: string; args: JsonNode;\n             columns: seq[seq[string]]; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		256
+nim	rawQuery	query_builder/libs/mariadb/mariadb_impl.html#rawQuery,PMySQL,string,JsonNode,int	proc rawQuery(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		291
+nim	getColumns	query_builder/libs/mariadb/mariadb_impl.html#getColumns,PMySQL,string,seq[string],int	proc getColumns(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[\n    seq[string]]		294
+nim	getColumnTypes	query_builder/libs/mariadb/mariadb_impl.html#getColumnTypes,PMySQL,string,string,int	proc getColumnTypes(db: PMySQL; database, table: string; timeout: int): Future[\n    seq[database_types.Row]]		317
+nimgrp	queryplain	query_builder/libs/mariadb/mariadb_impl.html#queryPlain-procs-all	proc		215
+nimgrp	query	query_builder/libs/mariadb/mariadb_impl.html#query-procs-all	proc		178
+nimgrp	exec	query_builder/libs/mariadb/mariadb_impl.html#exec-procs-all	proc		244

clients/nim-allographer/docs/v2/query_builder/libs/mariadb/mariadb_lib.html

@@ -0,0 +1,207 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/mariadb/mariadb_lib</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/mariadb/mariadb_lib</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#MariadbParams" title="MariadbParams = seq[MariadbParamValue]">MariadbParams</a></li>
+<li><a class="reference" href="#MariadbParamValue" title="MariadbParamValue = object
+  value*: string
+  isBinary*: bool">MariadbParamValue</a></li>
+
+    </ul>
+  </details>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">dbError
+  <li><a class="reference" href="#dbError%2CPMySQL" title="dbError(db: PMySQL)">dbError(db: PMySQL)</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">dbFormat
+  <li><a class="reference" href="#dbFormat%2CPMySQL%2Cstring%2CMariadbParams" title="dbFormat(conn: PMySQL; query: string; args: MariadbParams): string">dbFormat(conn: PMySQL; query: string; args: MariadbParams): string</a></li>
+<li><a class="reference" href="#dbFormat%2Cstring%2Cseq%5Bstring%5D" title="dbFormat(formatstr: string; args: seq[string]): string">dbFormat(formatstr: string; args: seq[string]): string</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">fromObj
+  <li><a class="reference" href="#fromObj%2CtypeMariadbParams%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D" title="fromObj(_: type MariadbParams; args: JsonNode; columns: seq[seq[string]]): MariadbParams">fromObj(_: type MariadbParams; args: JsonNode; columns: seq[seq[string]]): MariadbParams</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">setColumnInfo
+  <li><a class="reference" href="#setColumnInfo%2CDbColumns%2CPRES%2Cint" title="setColumnInfo(columns: var DbColumns; res: PRES; L: int)">setColumnInfo(columns: var DbColumns; res: PRES; L: int)</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="../../error.html">../../error</a>, <a class="reference external" href="../../models/database_types.html">../../models/database_types</a>, <a class="reference external" href="mariadb_rdb.html">mariadb_rdb</a>
+  </dl>
+</div>
+<div class="section" id="7">
+  <h1><a class="toc-backref" href="#7">Types</a></h1>
+  <dl class="item">
+    <div id="MariadbParams">
+  <dt><pre><a href="mariadb_lib.html#MariadbParams"><span class="Identifier">MariadbParams</span></a> <span class="Other">=</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="mariadb_lib.html#MariadbParamValue"><span class="Identifier">MariadbParamValue</span></a><span class="Other">]</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="MariadbParamValue">
+  <dt><pre><a href="mariadb_lib.html#MariadbParamValue"><span class="Identifier">MariadbParamValue</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
+  <span class="Identifier">value</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">isBinary</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">bool</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="dbError-procs-all">
+  <div id="dbError,PMySQL">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbError%2CPMySQL"><span class="Identifier">dbError</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">)</span> {.<span class="Identifier">noreturn</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    raises a DbError exception.
+    
+  </dd>
+</div>
+
+</div>
+<div id="dbFormat-procs-all">
+  <div id="dbFormat,PMySQL,string,MariadbParams">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbFormat%2CPMySQL%2Cstring%2CMariadbParams"><span class="Identifier">dbFormat</span></a><span class="Other">(</span><span class="Identifier">conn</span><span class="Other">:</span> <a href="mariadb_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <a href="mariadb_lib.html#MariadbParams"><span class="Identifier">MariadbParams</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="dbFormat,string,seq[string]">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbFormat%2Cstring%2Cseq%5Bstring%5D"><span class="Identifier">dbFormat</span></a><span class="Other">(</span><span class="Identifier">formatstr</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="fromObj-procs-all">
+  <div id="fromObj,typeMariadbParams,JsonNode,seq[seq[string]]">
+  <dt><pre><span class="Keyword">proc</span> <a href="#fromObj%2CtypeMariadbParams%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D"><span class="Identifier">fromObj</span></a><span class="Other">(</span><span class="Operator">_</span><span class="Other">:</span> <span class="Keyword">type</span> <span class="Identifier">MariadbParams</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="mariadb_lib.html#MariadbParams"><span class="Identifier">MariadbParams</span></a></pre></dt>
+  <dd>
+    
+    args is JArray <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span><span class="StringLit">&quot;id&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="DecNumber">1</span><span class="Punctuation">}</span><span class="Punctuation">,</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;name&quot;</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;alice&quot;</span><span class="Punctuation">}</span><span class="Punctuation">]</span></span></tt>
+    
+  </dd>
+</div>
+
+</div>
+<div id="setColumnInfo-procs-all">
+  <div id="setColumnInfo,DbColumns,PRES,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#setColumnInfo%2CDbColumns%2CPRES%2Cint"><span class="Identifier">setColumnInfo</span></a><span class="Other">(</span><span class="Identifier">columns</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="../../models/database_types.html#DbColumns"><span class="Identifier">DbColumns</span></a><span class="Other">;</span> <span class="Identifier">res</span><span class="Other">:</span> <a href="mariadb_rdb.html#PRES"><span class="Identifier">PRES</span></a><span class="Other">;</span> <span class="Identifier">L</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:34 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/mariadb/mariadb_lib.idx

@@ -0,0 +1,9 @@
+nimTitle	mariadb_lib	query_builder/libs/mariadb/mariadb_lib.html	module src/allographer/query_builder/libs/mariadb/mariadb_lib		0
+nim	dbError	query_builder/libs/mariadb/mariadb_lib.html#dbError,PMySQL	proc dbError(db: PMySQL)		12
+nim	setColumnInfo	query_builder/libs/mariadb/mariadb_lib.html#setColumnInfo,DbColumns,PRES,int	proc setColumnInfo(columns: var DbColumns; res: PRES; L: int)		80
+nim	dbFormat	query_builder/libs/mariadb/mariadb_lib.html#dbFormat,string,seq[string]	proc dbFormat(formatstr: string; args: seq[string]): string		120
+nim	MariadbParamValue	query_builder/libs/mariadb/mariadb_lib.html#MariadbParamValue	object MariadbParamValue		171
+nim	MariadbParams	query_builder/libs/mariadb/mariadb_lib.html#MariadbParams	type MariadbParams		175
+nim	fromObj	query_builder/libs/mariadb/mariadb_lib.html#fromObj,typeMariadbParams,JsonNode,seq[seq[string]]	proc fromObj(_: type MariadbParams; args: JsonNode; columns: seq[seq[string]]): MariadbParams		177
+nim	dbFormat	query_builder/libs/mariadb/mariadb_lib.html#dbFormat,PMySQL,string,MariadbParams	proc dbFormat(conn: PMySQL; query: string; args: MariadbParams): string		211
+nimgrp	dbformat	query_builder/libs/mariadb/mariadb_lib.html#dbFormat-procs-all	proc		120

clients/nim-allographer/docs/v2/query_builder/libs/mariadb/mariadb_rdb.idx

@@ -0,0 +1,156 @@
+nimTitle	mariadb_rdb	query_builder/libs/mariadb/mariadb_rdb.html	module src/allographer/query_builder/libs/mariadb/mariadb_rdb		0
+nim	false	query_builder/libs/mariadb/mariadb_rdb.html#false	my_bool.false		21
+nim	true	query_builder/libs/mariadb/mariadb_rdb.html#true	my_bool.true		21
+nim	my_bool	query_builder/libs/mariadb/mariadb_rdb.html#my_bool	type my_bool		21
+nim	Pmy_bool	query_builder/libs/mariadb/mariadb_rdb.html#Pmy_bool	type Pmy_bool		22
+nim	PVIO	query_builder/libs/mariadb/mariadb_rdb.html#PVIO	type PVIO		23
+nim	gptr	query_builder/libs/mariadb/mariadb_rdb.html#gptr	type gptr		25
+nim	my_socket	query_builder/libs/mariadb/mariadb_rdb.html#my_socket	type my_socket		27
+nim	PPByte	query_builder/libs/mariadb/mariadb_rdb.html#PPByte	type PPByte		28
+nim	cuint	query_builder/libs/mariadb/mariadb_rdb.html#cuint	type cuint		29
+nim	MYSQL_WAIT_READ	query_builder/libs/mariadb/mariadb_rdb.html#MYSQL_WAIT_READ	const MYSQL_WAIT_READ		44
+nim	MYSQL_WAIT_WRITE	query_builder/libs/mariadb/mariadb_rdb.html#MYSQL_WAIT_WRITE	const MYSQL_WAIT_WRITE		45
+nim	MYSQL_WAIT_EXCEPT	query_builder/libs/mariadb/mariadb_rdb.html#MYSQL_WAIT_EXCEPT	const MYSQL_WAIT_EXCEPT		46
+nim	MYSQL_WAIT_TIMEOUT	query_builder/libs/mariadb/mariadb_rdb.html#MYSQL_WAIT_TIMEOUT	const MYSQL_WAIT_TIMEOUT		47
+nim	SQLSTATE_LENGTH	query_builder/libs/mariadb/mariadb_rdb.html#SQLSTATE_LENGTH	const SQLSTATE_LENGTH		52
+nim	Enum_server_command	query_builder/libs/mariadb/mariadb_rdb.html#Enum_server_command	enum Enum_server_command		61
+nim	SCRAMBLE_LENGTH	query_builder/libs/mariadb/mariadb_rdb.html#SCRAMBLE_LENGTH	const SCRAMBLE_LENGTH		72
+nim	NOT_NULL_FLAG	query_builder/libs/mariadb/mariadb_rdb.html#NOT_NULL_FLAG	const NOT_NULL_FLAG		79
+nim	PRI_KEY_FLAG	query_builder/libs/mariadb/mariadb_rdb.html#PRI_KEY_FLAG	const PRI_KEY_FLAG		80
+nim	ERRMSG_SIZE	query_builder/libs/mariadb/mariadb_rdb.html#ERRMSG_SIZE	const ERRMSG_SIZE		145
+nim	St_net	query_builder/libs/mariadb/mariadb_rdb.html#St_net	object St_net		162
+nim	NET	query_builder/libs/mariadb/mariadb_rdb.html#NET	type NET		202
+nim	PNET	query_builder/libs/mariadb/mariadb_rdb.html#PNET	type PNET		203
+nim	TYPE_DECIMAL	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_DECIMAL	Enum_field_types.TYPE_DECIMAL		210
+nim	TYPE_TINY	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_TINY	Enum_field_types.TYPE_TINY		210
+nim	TYPE_SHORT	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_SHORT	Enum_field_types.TYPE_SHORT		210
+nim	TYPE_LONG	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_LONG	Enum_field_types.TYPE_LONG		210
+nim	TYPE_FLOAT	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_FLOAT	Enum_field_types.TYPE_FLOAT		210
+nim	TYPE_DOUBLE	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_DOUBLE	Enum_field_types.TYPE_DOUBLE		210
+nim	TYPE_NULL	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_NULL	Enum_field_types.TYPE_NULL		210
+nim	TYPE_TIMESTAMP	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_TIMESTAMP	Enum_field_types.TYPE_TIMESTAMP		210
+nim	TYPE_LONGLONG	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_LONGLONG	Enum_field_types.TYPE_LONGLONG		210
+nim	TYPE_INT24	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_INT24	Enum_field_types.TYPE_INT24		210
+nim	TYPE_DATE	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_DATE	Enum_field_types.TYPE_DATE		210
+nim	TYPE_TIME	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_TIME	Enum_field_types.TYPE_TIME		210
+nim	TYPE_DATETIME	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_DATETIME	Enum_field_types.TYPE_DATETIME		210
+nim	TYPE_YEAR	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_YEAR	Enum_field_types.TYPE_YEAR		210
+nim	TYPE_NEWDATE	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_NEWDATE	Enum_field_types.TYPE_NEWDATE		210
+nim	TYPE_VARCHAR	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_VARCHAR	Enum_field_types.TYPE_VARCHAR		210
+nim	TYPE_BIT	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_BIT	Enum_field_types.TYPE_BIT		210
+nim	TYPE_NEWDECIMAL	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_NEWDECIMAL	Enum_field_types.TYPE_NEWDECIMAL		210
+nim	TYPE_ENUM	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_ENUM	Enum_field_types.TYPE_ENUM		210
+nim	TYPE_SET	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_SET	Enum_field_types.TYPE_SET		210
+nim	TYPE_TINY_BLOB	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_TINY_BLOB	Enum_field_types.TYPE_TINY_BLOB		210
+nim	TYPE_MEDIUM_BLOB	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_MEDIUM_BLOB	Enum_field_types.TYPE_MEDIUM_BLOB		210
+nim	TYPE_LONG_BLOB	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_LONG_BLOB	Enum_field_types.TYPE_LONG_BLOB		210
+nim	TYPE_BLOB	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_BLOB	Enum_field_types.TYPE_BLOB		210
+nim	TYPE_VAR_STRING	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_VAR_STRING	Enum_field_types.TYPE_VAR_STRING		210
+nim	TYPE_STRING	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_STRING	Enum_field_types.TYPE_STRING		210
+nim	TYPE_GEOMETRY	query_builder/libs/mariadb/mariadb_rdb.html#TYPE_GEOMETRY	Enum_field_types.TYPE_GEOMETRY		210
+nim	Enum_field_types	query_builder/libs/mariadb/mariadb_rdb.html#Enum_field_types	enum Enum_field_types		210
+nim	St_mysql_field	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_field	object St_mysql_field		407
+nim	FIELD	query_builder/libs/mariadb/mariadb_rdb.html#FIELD	type FIELD		430
+nim	PFIELD	query_builder/libs/mariadb/mariadb_rdb.html#PFIELD	type PFIELD		431
+nim	ROW	query_builder/libs/mariadb/mariadb_rdb.html#ROW	type ROW		433
+nim	my_ulonglong	query_builder/libs/mariadb/mariadb_rdb.html#my_ulonglong	type my_ulonglong		446
+nim	Pst_mysql_rows	query_builder/libs/mariadb/mariadb_rdb.html#Pst_mysql_rows	type Pst_mysql_rows		453
+nim	St_mysql_rows	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_rows	object St_mysql_rows		454
+nim	ROWS	query_builder/libs/mariadb/mariadb_rdb.html#ROWS	type ROWS		459
+nim	PROWS	query_builder/libs/mariadb/mariadb_rdb.html#PROWS	type PROWS		460
+nim	Pst_used_mem	query_builder/libs/mariadb/mariadb_rdb.html#Pst_used_mem	type Pst_used_mem		471
+nim	St_used_mem	query_builder/libs/mariadb/mariadb_rdb.html#St_used_mem	object St_used_mem		472
+nim	USED_MEM	query_builder/libs/mariadb/mariadb_rdb.html#USED_MEM	type USED_MEM		477
+nim	PUSED_MEM	query_builder/libs/mariadb/mariadb_rdb.html#PUSED_MEM	type PUSED_MEM		478
+nim	St_mem_root	query_builder/libs/mariadb/mariadb_rdb.html#St_mem_root	object St_mem_root		480
+nim	MEM_ROOT	query_builder/libs/mariadb/mariadb_rdb.html#MEM_ROOT	type MEM_ROOT		492
+nim	St_mysql_data	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_data	object St_mysql_data		499
+nim	DATA	query_builder/libs/mariadb/mariadb_rdb.html#DATA	type DATA		506
+nim	PDATA	query_builder/libs/mariadb/mariadb_rdb.html#PDATA	type PDATA		507
+nim	OPT_CONNECT_TIMEOUT	query_builder/libs/mariadb/mariadb_rdb.html#OPT_CONNECT_TIMEOUT	Option.OPT_CONNECT_TIMEOUT		508
+nim	OPT_COMPRESS	query_builder/libs/mariadb/mariadb_rdb.html#OPT_COMPRESS	Option.OPT_COMPRESS		508
+nim	OPT_NAMED_PIPE	query_builder/libs/mariadb/mariadb_rdb.html#OPT_NAMED_PIPE	Option.OPT_NAMED_PIPE		508
+nim	INIT_COMMAND	query_builder/libs/mariadb/mariadb_rdb.html#INIT_COMMAND	Option.INIT_COMMAND		508
+nim	READ_DEFAULT_FILE	query_builder/libs/mariadb/mariadb_rdb.html#READ_DEFAULT_FILE	Option.READ_DEFAULT_FILE		508
+nim	READ_DEFAULT_GROUP	query_builder/libs/mariadb/mariadb_rdb.html#READ_DEFAULT_GROUP	Option.READ_DEFAULT_GROUP		508
+nim	SET_CHARSET_DIR	query_builder/libs/mariadb/mariadb_rdb.html#SET_CHARSET_DIR	Option.SET_CHARSET_DIR		508
+nim	SET_CHARSET_NAME	query_builder/libs/mariadb/mariadb_rdb.html#SET_CHARSET_NAME	Option.SET_CHARSET_NAME		508
+nim	OPT_LOCAL_INFILE	query_builder/libs/mariadb/mariadb_rdb.html#OPT_LOCAL_INFILE	Option.OPT_LOCAL_INFILE		508
+nim	OPT_PROTOCOL	query_builder/libs/mariadb/mariadb_rdb.html#OPT_PROTOCOL	Option.OPT_PROTOCOL		508
+nim	SHARED_MEMORY_BASE_NAME	query_builder/libs/mariadb/mariadb_rdb.html#SHARED_MEMORY_BASE_NAME	Option.SHARED_MEMORY_BASE_NAME		508
+nim	OPT_READ_TIMEOUT	query_builder/libs/mariadb/mariadb_rdb.html#OPT_READ_TIMEOUT	Option.OPT_READ_TIMEOUT		508
+nim	OPT_WRITE_TIMEOUT	query_builder/libs/mariadb/mariadb_rdb.html#OPT_WRITE_TIMEOUT	Option.OPT_WRITE_TIMEOUT		508
+nim	OPT_USE_RESULT	query_builder/libs/mariadb/mariadb_rdb.html#OPT_USE_RESULT	Option.OPT_USE_RESULT		508
+nim	OPT_USE_REMOTE_CONNECTION	query_builder/libs/mariadb/mariadb_rdb.html#OPT_USE_REMOTE_CONNECTION	Option.OPT_USE_REMOTE_CONNECTION		508
+nim	OPT_USE_EMBEDDED_CONNECTION	query_builder/libs/mariadb/mariadb_rdb.html#OPT_USE_EMBEDDED_CONNECTION	Option.OPT_USE_EMBEDDED_CONNECTION		508
+nim	OPT_GUESS_CONNECTION	query_builder/libs/mariadb/mariadb_rdb.html#OPT_GUESS_CONNECTION	Option.OPT_GUESS_CONNECTION		508
+nim	SET_CLIENT_IP	query_builder/libs/mariadb/mariadb_rdb.html#SET_CLIENT_IP	Option.SET_CLIENT_IP		508
+nim	SECURE_AUTH	query_builder/libs/mariadb/mariadb_rdb.html#SECURE_AUTH	Option.SECURE_AUTH		508
+nim	REPORT_DATA_TRUNCATION	query_builder/libs/mariadb/mariadb_rdb.html#REPORT_DATA_TRUNCATION	Option.REPORT_DATA_TRUNCATION		508
+nim	OPT_RECONNECT	query_builder/libs/mariadb/mariadb_rdb.html#OPT_RECONNECT	Option.OPT_RECONNECT		508
+nim	MYSQL_OPT_NONBLOCK	query_builder/libs/mariadb/mariadb_rdb.html#MYSQL_OPT_NONBLOCK	Option.MYSQL_OPT_NONBLOCK		508
+nim	Option	query_builder/libs/mariadb/mariadb_rdb.html#Option	enum Option		508
+nim	St_dynamic_array	query_builder/libs/mariadb/mariadb_rdb.html#St_dynamic_array	object St_dynamic_array		528
+nim	Pst_dynamic_array	query_builder/libs/mariadb/mariadb_rdb.html#Pst_dynamic_array	type Pst_dynamic_array		536
+nim	St_mysql_options	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_options	object St_mysql_options		538
+nim	STATUS_READY	query_builder/libs/mariadb/mariadb_rdb.html#STATUS_READY	Status.STATUS_READY		584
+nim	STATUS_GET_RESULT	query_builder/libs/mariadb/mariadb_rdb.html#STATUS_GET_RESULT	Status.STATUS_GET_RESULT		584
+nim	STATUS_USE_RESULT	query_builder/libs/mariadb/mariadb_rdb.html#STATUS_USE_RESULT	Status.STATUS_USE_RESULT		584
+nim	Status	query_builder/libs/mariadb/mariadb_rdb.html#Status	enum Status		584
+nim	Charset_info_st	query_builder/libs/mariadb/mariadb_rdb.html#Charset_info_st	object Charset_info_st		593
+nim	Pcharset_info_st	query_builder/libs/mariadb/mariadb_rdb.html#Pcharset_info_st	type Pcharset_info_st		622
+nim	Pst_mysql_methods	query_builder/libs/mariadb/mariadb_rdb.html#Pst_mysql_methods	type Pst_mysql_methods		636
+nim	Pst_mysql	query_builder/libs/mariadb/mariadb_rdb.html#Pst_mysql	type Pst_mysql		637
+nim	St_mysql	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql	object St_mysql		638
+nim	MySQL	query_builder/libs/mariadb/mariadb_rdb.html#MySQL	type MySQL		684
+nim	PMySQL	query_builder/libs/mariadb/mariadb_rdb.html#PMySQL	type PMySQL		685
+nim	St_mysql_res	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_res	object St_mysql_res		687
+nim	RES	query_builder/libs/mariadb/mariadb_rdb.html#RES	type RES		703
+nim	PRES	query_builder/libs/mariadb/mariadb_rdb.html#PRES	type PRES		704
+nim	Pst_mysql_stmt	query_builder/libs/mariadb/mariadb_rdb.html#Pst_mysql_stmt	type Pst_mysql_stmt		705
+nim	PSTMT	query_builder/libs/mariadb/mariadb_rdb.html#PSTMT	type PSTMT		706
+nim	St_mysql_methods	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_methods	object St_mysql_methods		707
+nim	STMT_INIT_DONE	query_builder/libs/mariadb/mariadb_rdb.html#STMT_INIT_DONE	Enum_mysql_stmt_state.STMT_INIT_DONE		755
+nim	STMT_PREPARE_DONE	query_builder/libs/mariadb/mariadb_rdb.html#STMT_PREPARE_DONE	Enum_mysql_stmt_state.STMT_PREPARE_DONE		755
+nim	STMT_EXECUTE_DONE	query_builder/libs/mariadb/mariadb_rdb.html#STMT_EXECUTE_DONE	Enum_mysql_stmt_state.STMT_EXECUTE_DONE		755
+nim	STMT_FETCH_DONE	query_builder/libs/mariadb/mariadb_rdb.html#STMT_FETCH_DONE	Enum_mysql_stmt_state.STMT_FETCH_DONE		755
+nim	Enum_mysql_stmt_state	query_builder/libs/mariadb/mariadb_rdb.html#Enum_mysql_stmt_state	enum Enum_mysql_stmt_state		755
+nim	U	query_builder/libs/mariadb/mariadb_rdb.html#U	object U		779
+nim	St_mysql_bind	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_bind	object St_mysql_bind		783
+nim	BIND	query_builder/libs/mariadb/mariadb_rdb.html#BIND	type BIND		804
+nim	PBIND	query_builder/libs/mariadb/mariadb_rdb.html#PBIND	type PBIND		805
+nim	St_mysql_stmt	query_builder/libs/mariadb/mariadb_rdb.html#St_mysql_stmt	object St_mysql_stmt		806
+nim	STMT	query_builder/libs/mariadb/mariadb_rdb.html#STMT	type STMT		834
+nim	num_fields	query_builder/libs/mariadb/mariadb_rdb.html#num_fields,PRES	proc num_fields(res: PRES): cuint		877
+nim	fetch_field_direct	query_builder/libs/mariadb/mariadb_rdb.html#fetch_field_direct,PRES,cuint	proc fetch_field_direct(res: PRES; fieldnr: cuint): PFIELD		880
+nim	error	query_builder/libs/mariadb/mariadb_rdb.html#error,PMySQL	proc error(MySQL: PMySQL): cstring		895
+nim	init	query_builder/libs/mariadb/mariadb_rdb.html#init,PMySQL	proc init(MySQL: PMySQL): PMySQL		905
+nim	init	query_builder/libs/mariadb/mariadb_rdb.html#init,PMySQL_2	proc init(MySQL: var PMySQL)		906
+nim	real_connect	query_builder/libs/mariadb/mariadb_rdb.html#real_connect,PMySQL,cstring,cstring,cstring,cstring,cuint,cstring,int	proc real_connect(MySQL: PMySQL; host: cstring; user: cstring; passwd: cstring;\n             db: cstring; port: cuint; unix_socket: cstring; clientflag: int): PMySQL		912
+nim	real_query	query_builder/libs/mariadb/mariadb_rdb.html#real_query,PMySQL,cstring,int	proc real_query(MySQL: PMySQL; q: cstring; len: int): cint		935
+nim	use_result	query_builder/libs/mariadb/mariadb_rdb.html#use_result,PMySQL	proc use_result(MySQL: PMySQL): PRES		939
+nim	ping	query_builder/libs/mariadb/mariadb_rdb.html#ping,PMySQL	proc ping(MySQL: PMySQL): cint		995
+nim	options	query_builder/libs/mariadb/mariadb_rdb.html#options,PMySQL,Option,pointer	proc options(MySQL: PMySQL; option: Option; arg: pointer): cint		1017
+nim	optionsv	query_builder/libs/mariadb/mariadb_rdb.html#optionsv,PMySQL,Option	proc optionsv(MySQL: PMySQL; option: Option): cint		1019
+nim	get_socket	query_builder/libs/mariadb/mariadb_rdb.html#get_socket,PMySQL	proc get_socket(MySQL: PMySQL): my_socket		1021
+nim	get_timeout_value	query_builder/libs/mariadb/mariadb_rdb.html#get_timeout_value,PMySQL	proc get_timeout_value(MySQL: PMySQL): cuint		1023
+nim	get_timeout_value_ms	query_builder/libs/mariadb/mariadb_rdb.html#get_timeout_value_ms,PMySQL	proc get_timeout_value_ms(MySQL: PMySQL): cuint		1025
+nim	free_result	query_builder/libs/mariadb/mariadb_rdb.html#free_result,PRES	proc free_result(result: PRES)		1027
+nim	free_result_start	query_builder/libs/mariadb/mariadb_rdb.html#free_result_start,PRES	proc free_result_start(result: PRES): cint		1029
+nim	free_result_cont	query_builder/libs/mariadb/mariadb_rdb.html#free_result_cont,PRES,cint	proc free_result_cont(result: PRES; status: cint): cint		1031
+nim	fetch_row	query_builder/libs/mariadb/mariadb_rdb.html#fetch_row,PRES	proc fetch_row(result: PRES): ROW		1039
+nim	fetch_row_start	query_builder/libs/mariadb/mariadb_rdb.html#fetch_row_start,ptr.ROW,PRES	proc fetch_row_start(ret: ptr ROW; result: PRES): cint		1041
+nim	fetch_row_cont	query_builder/libs/mariadb/mariadb_rdb.html#fetch_row_cont,ptr.ROW,PRES,cint	proc fetch_row_cont(ret: ptr ROW; result: PRES; status: cint): cint		1043
+nim	real_escape_string	query_builder/libs/mariadb/mariadb_rdb.html#real_escape_string,PMySQL,cstring,cstring,int	proc real_escape_string(MySQL: PMySQL; fto: cstring; from: cstring; len: int): int		1055
+nim	read_query_result	query_builder/libs/mariadb/mariadb_rdb.html#read_query_result,PMySQL	proc read_query_result(MySQL: PMySQL): my_bool		1077
+nim	read_query_result_start	query_builder/libs/mariadb/mariadb_rdb.html#read_query_result_start,ptr.my_bool,PMySQL	proc read_query_result_start(ret: ptr my_bool; MySQL: PMySQL): cint		1079
+nim	read_query_result_cont	query_builder/libs/mariadb/mariadb_rdb.html#read_query_result_cont,ptr.my_bool,PMySQL,cint	proc read_query_result_cont(ret: ptr my_bool; MySQL: PMySQL; status: cint): cint		1081
+nim	real_connect_start	query_builder/libs/mariadb/mariadb_rdb.html#real_connect_start,ptr.PMySQL,PMySQL,cstring,cstring,cstring,cstring,cuint,cstring,culong	proc real_connect_start(ret: ptr PMySQL; MySQL: PMySQL; host: cstring; user: cstring;\n                   passwd: cstring; db: cstring; port: cuint;\n                   unix_socket: cstring; clientflag: culong): cint		1083
+nim	real_connect_cont	query_builder/libs/mariadb/mariadb_rdb.html#real_connect_cont,ptr.PMySQL,PMySQL,cint	proc real_connect_cont(ret: ptr PMySQL; MySQL: PMySQL; status: cint): cint		1087
+nim	real_query_start	query_builder/libs/mariadb/mariadb_rdb.html#real_query_start,ptr.cint,PMySQL,cstring,culong	proc real_query_start(ret: ptr cint; MySQL: PMySQL; q: cstring; len: culong): cint		1089
+nim	real_query_cont	query_builder/libs/mariadb/mariadb_rdb.html#real_query_cont,ptr.cint,PMySQL,cint	proc real_query_cont(ret: ptr cint; MySQL: PMySQL; status: cint): cint		1091
+nim	store_result_start	query_builder/libs/mariadb/mariadb_rdb.html#store_result_start,ptr.PRES,PMySQL	proc store_result_start(ret: ptr PRES; MySQL: PMySQL): cint		1093
+nim	store_result_cont	query_builder/libs/mariadb/mariadb_rdb.html#store_result_cont,ptr.PRES,PMySQL,cint	proc store_result_cont(ret: ptr PRES; MySQL: PMySQL; status: cint): cint		1095
+nim	stmt_init	query_builder/libs/mariadb/mariadb_rdb.html#stmt_init,PMySQL	proc stmt_init(MySQL: PMySQL): PSTMT		1097
+nim	close	query_builder/libs/mariadb/mariadb_rdb.html#close,PMySQL	proc close(sock: PMySQL)		1158
+nimgrp	init	query_builder/libs/mariadb/mariadb_rdb.html#init-procs-all	proc		905

clients/nim-allographer/docs/v2/query_builder/libs/mysql/mysql_impl.html

@@ -0,0 +1,294 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/mysql/mysql_impl</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/mysql/mysql_impl</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">exec
+  <li><a class="reference" href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint" title="exec(db: PMySQL; query: string; args: JsonNode; columns: seq[seq[string]];
+     timeout: int): owned(Future[void])">exec(db: PMySQL; query: string; args: JsonNode; columns: seq[seq[string]];
+     timeout: int): owned(Future[void])</a></li>
+<li><a class="reference" href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="exec(db: PMySQL; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])">exec(db: PMySQL; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])</a></li>
+<li><a class="reference" href="#exec%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="exec(db: PMySQL; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])">exec(db: PMySQL; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">execGetValue
+  <li><a class="reference" href="#execGetValue%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint" title="execGetValue(db: PMySQL; query: string; args: JsonNode;
+             columns: seq[seq[string]]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">execGetValue(db: PMySQL; query: string; args: JsonNode;
+             columns: seq[seq[string]]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">getColumns
+  <li><a class="reference" href="#getColumns%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="getColumns(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]">getColumns(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">getColumnTypes
+  <li><a class="reference" href="#getColumnTypes%2CPMySQL%2Cstring%2Cstring%2Cint" title="getColumnTypes(db: PMySQL; database, table: string; timeout: int): Future[
+    seq[database_types.Row]]">getColumnTypes(db: PMySQL; database, table: string; timeout: int): Future[
+    seq[database_types.Row]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">query
+  <li><a class="reference" href="#query%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="query(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">query(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+<li><a class="reference" href="#query%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="query(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">query(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">queryPlain
+  <li><a class="reference" href="#queryPlain%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="queryPlain(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    seq[database_types.Row]]">queryPlain(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    seq[database_types.Row]]</a></li>
+<li><a class="reference" href="#queryPlain%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint" title="queryPlain(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[database_types.Row]]">queryPlain(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[
+    seq[database_types.Row]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">rawQuery
+  <li><a class="reference" href="#rawQuery%2CPMySQL%2Cstring%2CJsonNode%2Cint" title="rawQuery(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]">rawQuery(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[
+    (seq[database_types.Row], DbRows)]</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="../../error.html">../../error</a>, <a class="reference external" href="../../models/database_types.html">../../models/database_types</a>, <a class="reference external" href="mysql_rdb.html">mysql_rdb</a>, <a class="reference external" href="mysql_lib.html">mysql_lib</a>
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="exec-procs-all">
+  <div id="exec,PMySQL,string,JsonNode,seq[seq[string]],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span><span class="Other">;</span>
+          <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    args is JArray <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span><span class="StringLit">&quot;id&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="DecNumber">1</span><span class="Punctuation">}</span><span class="Punctuation">,</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;name&quot;</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;alice&quot;</span><span class="Punctuation">}</span><span class="Punctuation">]</span></span></tt>
+    
+  </dd>
+</div>
+<div id="exec,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="exec,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="execGetValue-procs-all">
+  <div id="execGetValue,PMySQL,string,JsonNode,seq[seq[string]],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#execGetValue%2CPMySQL%2Cstring%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D%2Cint"><span class="Identifier">execGetValue</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span>
+                  <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="getColumns-procs-all">
+  <div id="getColumns,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#getColumns%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">getColumns</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="getColumnTypes-procs-all">
+  <div id="getColumnTypes,PMySQL,string,string,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#getColumnTypes%2CPMySQL%2Cstring%2Cstring%2Cint"><span class="Identifier">getColumnTypes</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">database</span><span class="Other">,</span> <span class="Identifier">table</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                               <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                               <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="query-procs-all">
+  <div id="query,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#query%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">query</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="query,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#query%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">query</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="queryPlain-procs-all">
+  <div id="queryPlain,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#queryPlain%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">queryPlain</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                               <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                               <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="queryPlain,PMySQL,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#queryPlain%2CPMySQL%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">queryPlain</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                               <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                               <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="rawQuery-procs-all">
+  <div id="rawQuery,PMySQL,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#rawQuery%2CPMySQL%2Cstring%2CJsonNode%2Cint"><span class="Identifier">rawQuery</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">database_types</span><span class="Other">.</span><span class="Identifier">Row</span><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:35 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/mysql/mysql_impl.idx

@@ -0,0 +1,15 @@
+nimTitle	mysql_impl	query_builder/libs/mysql/mysql_impl.html	module src/allographer/query_builder/libs/mysql/mysql_impl		0
+nim	query	query_builder/libs/mysql/mysql_impl.html#query,PMySQL,string,seq[string],int	proc query(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		36
+nim	query	query_builder/libs/mysql/mysql_impl.html#query,PMySQL,string,JsonNode,int	proc query(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		70
+nim	queryPlain	query_builder/libs/mysql/mysql_impl.html#queryPlain,PMySQL,string,seq[string],int	proc queryPlain(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[\n    seq[database_types.Row]]		92
+nim	queryPlain	query_builder/libs/mysql/mysql_impl.html#queryPlain,PMySQL,string,JsonNode,int	proc queryPlain(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[\n    seq[database_types.Row]]		114
+nim	exec	query_builder/libs/mysql/mysql_impl.html#exec,PMySQL,string,seq[string],int	proc exec(db: PMySQL; query: string; args: seq[string]; timeout: int): owned(\n    Future[void])		136
+nim	exec	query_builder/libs/mysql/mysql_impl.html#exec,PMySQL,string,JsonNode,int	proc exec(db: PMySQL; query: string; args: JsonNode; timeout: int): owned(\n    Future[void])		142
+nim	exec	query_builder/libs/mysql/mysql_impl.html#exec,PMySQL,string,JsonNode,seq[seq[string]],int	proc exec(db: PMySQL; query: string; args: JsonNode; columns: seq[seq[string]];\n     timeout: int): owned(Future[void])		164
+nim	execGetValue	query_builder/libs/mysql/mysql_impl.html#execGetValue,PMySQL,string,JsonNode,seq[seq[string]],int	proc execGetValue(db: PMySQL; query: string; args: JsonNode;\n             columns: seq[seq[string]]; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		172
+nim	rawQuery	query_builder/libs/mysql/mysql_impl.html#rawQuery,PMySQL,string,JsonNode,int	proc rawQuery(db: PMySQL; query: string; args: JsonNode; timeout: int): Future[\n    (seq[database_types.Row], DbRows)]		207
+nim	getColumns	query_builder/libs/mysql/mysql_impl.html#getColumns,PMySQL,string,seq[string],int	proc getColumns(db: PMySQL; query: string; args: seq[string]; timeout: int): Future[\n    seq[string]]		229
+nim	getColumnTypes	query_builder/libs/mysql/mysql_impl.html#getColumnTypes,PMySQL,string,string,int	proc getColumnTypes(db: PMySQL; database, table: string; timeout: int): Future[\n    seq[database_types.Row]]		252
+nimgrp	queryplain	query_builder/libs/mysql/mysql_impl.html#queryPlain-procs-all	proc		92
+nimgrp	query	query_builder/libs/mysql/mysql_impl.html#query-procs-all	proc		36
+nimgrp	exec	query_builder/libs/mysql/mysql_impl.html#exec-procs-all	proc		136

clients/nim-allographer/docs/v2/query_builder/libs/mysql/mysql_lib.html

@@ -0,0 +1,207 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/mysql/mysql_lib</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/mysql/mysql_lib</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#MysqlParams" title="MysqlParams = seq[MysqlParamValue]">MysqlParams</a></li>
+<li><a class="reference" href="#MysqlParamValue" title="MysqlParamValue = object
+  value*: string
+  isBinary*: bool">MysqlParamValue</a></li>
+
+    </ul>
+  </details>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">dbError
+  <li><a class="reference" href="#dbError%2CPMySQL" title="dbError(db: PMySQL)">dbError(db: PMySQL)</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">dbFormat
+  <li><a class="reference" href="#dbFormat%2CPMySQL%2Cstring%2CMysqlParams" title="dbFormat(conn: PMySQL; query: string; args: MysqlParams): string">dbFormat(conn: PMySQL; query: string; args: MysqlParams): string</a></li>
+<li><a class="reference" href="#dbFormat%2Cstring%2Cseq%5Bstring%5D" title="dbFormat(formatstr: string; args: seq[string]): string">dbFormat(formatstr: string; args: seq[string]): string</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">fromObj
+  <li><a class="reference" href="#fromObj%2CtypeMysqlParams%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D" title="fromObj(_: type MysqlParams; args: JsonNode; columns: seq[seq[string]]): MysqlParams">fromObj(_: type MysqlParams; args: JsonNode; columns: seq[seq[string]]): MysqlParams</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">setColumnInfo
+  <li><a class="reference" href="#setColumnInfo%2CDbColumns%2CPRES%2Cint" title="setColumnInfo(columns: var DbColumns; res: PRES; L: int)">setColumnInfo(columns: var DbColumns; res: PRES; L: int)</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="../../error.html">../../error</a>, <a class="reference external" href="../../models/database_types.html">../../models/database_types</a>, <a class="reference external" href="mysql_rdb.html">mysql_rdb</a>
+  </dl>
+</div>
+<div class="section" id="7">
+  <h1><a class="toc-backref" href="#7">Types</a></h1>
+  <dl class="item">
+    <div id="MysqlParams">
+  <dt><pre><a href="mysql_lib.html#MysqlParams"><span class="Identifier">MysqlParams</span></a> <span class="Other">=</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="mysql_lib.html#MysqlParamValue"><span class="Identifier">MysqlParamValue</span></a><span class="Other">]</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="MysqlParamValue">
+  <dt><pre><a href="mysql_lib.html#MysqlParamValue"><span class="Identifier">MysqlParamValue</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
+  <span class="Identifier">value</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">string</span>
+  <span class="Identifier">isBinary</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">bool</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="dbError-procs-all">
+  <div id="dbError,PMySQL">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbError%2CPMySQL"><span class="Identifier">dbError</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">)</span> {.<span class="Identifier">noreturn</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    raises a DbError exception.
+    
+  </dd>
+</div>
+
+</div>
+<div id="dbFormat-procs-all">
+  <div id="dbFormat,PMySQL,string,MysqlParams">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbFormat%2CPMySQL%2Cstring%2CMysqlParams"><span class="Identifier">dbFormat</span></a><span class="Other">(</span><span class="Identifier">conn</span><span class="Other">:</span> <a href="mysql_rdb.html#PMySQL"><span class="Identifier">PMySQL</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <a href="mysql_lib.html#MysqlParams"><span class="Identifier">MysqlParams</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="dbFormat,string,seq[string]">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbFormat%2Cstring%2Cseq%5Bstring%5D"><span class="Identifier">dbFormat</span></a><span class="Other">(</span><span class="Identifier">formatstr</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="fromObj-procs-all">
+  <div id="fromObj,typeMysqlParams,JsonNode,seq[seq[string]]">
+  <dt><pre><span class="Keyword">proc</span> <a href="#fromObj%2CtypeMysqlParams%2CJsonNode%2Cseq%5Bseq%5Bstring%5D%5D"><span class="Identifier">fromObj</span></a><span class="Other">(</span><span class="Operator">_</span><span class="Other">:</span> <span class="Keyword">type</span> <span class="Identifier">MysqlParams</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="mysql_lib.html#MysqlParams"><span class="Identifier">MysqlParams</span></a></pre></dt>
+  <dd>
+    
+    args is JArray <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span><span class="StringLit">&quot;id&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="DecNumber">1</span><span class="Punctuation">}</span><span class="Punctuation">,</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;name&quot;</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;alice&quot;</span><span class="Punctuation">}</span><span class="Punctuation">]</span></span></tt> 
+    
+  </dd>
+</div>
+
+</div>
+<div id="setColumnInfo-procs-all">
+  <div id="setColumnInfo,DbColumns,PRES,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#setColumnInfo%2CDbColumns%2CPRES%2Cint"><span class="Identifier">setColumnInfo</span></a><span class="Other">(</span><span class="Identifier">columns</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="../../models/database_types.html#DbColumns"><span class="Identifier">DbColumns</span></a><span class="Other">;</span> <span class="Identifier">res</span><span class="Other">:</span> <a href="mysql_rdb.html#PRES"><span class="Identifier">PRES</span></a><span class="Other">;</span> <span class="Identifier">L</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:35 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/mysql/mysql_lib.idx

@@ -0,0 +1,9 @@
+nimTitle	mysql_lib	query_builder/libs/mysql/mysql_lib.html	module src/allographer/query_builder/libs/mysql/mysql_lib		0
+nim	dbError	query_builder/libs/mysql/mysql_lib.html#dbError,PMySQL	proc dbError(db: PMySQL)		12
+nim	setColumnInfo	query_builder/libs/mysql/mysql_lib.html#setColumnInfo,DbColumns,PRES,int	proc setColumnInfo(columns: var DbColumns; res: PRES; L: int)		80
+nim	dbFormat	query_builder/libs/mysql/mysql_lib.html#dbFormat,string,seq[string]	proc dbFormat(formatstr: string; args: seq[string]): string		120
+nim	MysqlParamValue	query_builder/libs/mysql/mysql_lib.html#MysqlParamValue	object MysqlParamValue		167
+nim	MysqlParams	query_builder/libs/mysql/mysql_lib.html#MysqlParams	type MysqlParams		171
+nim	fromObj	query_builder/libs/mysql/mysql_lib.html#fromObj,typeMysqlParams,JsonNode,seq[seq[string]]	proc fromObj(_: type MysqlParams; args: JsonNode; columns: seq[seq[string]]): MysqlParams		173
+nim	dbFormat	query_builder/libs/mysql/mysql_lib.html#dbFormat,PMySQL,string,MysqlParams	proc dbFormat(conn: PMySQL; query: string; args: MysqlParams): string		207
+nimgrp	dbformat	query_builder/libs/mysql/mysql_lib.html#dbFormat-procs-all	proc		120

clients/nim-allographer/docs/v2/query_builder/libs/mysql/mysql_rdb.idx

@@ -0,0 +1,133 @@
+nimTitle	mysql_rdb	query_builder/libs/mysql/mysql_rdb.html	module src/allographer/query_builder/libs/mysql/mysql_rdb		0
+nim	false	query_builder/libs/mysql/mysql_rdb.html#false	my_bool.false		21
+nim	true	query_builder/libs/mysql/mysql_rdb.html#true	my_bool.true		21
+nim	my_bool	query_builder/libs/mysql/mysql_rdb.html#my_bool	type my_bool		21
+nim	Pmy_bool	query_builder/libs/mysql/mysql_rdb.html#Pmy_bool	type Pmy_bool		22
+nim	PVIO	query_builder/libs/mysql/mysql_rdb.html#PVIO	type PVIO		23
+nim	gptr	query_builder/libs/mysql/mysql_rdb.html#gptr	type gptr		25
+nim	my_socket	query_builder/libs/mysql/mysql_rdb.html#my_socket	type my_socket		27
+nim	PPByte	query_builder/libs/mysql/mysql_rdb.html#PPByte	type PPByte		28
+nim	cuint	query_builder/libs/mysql/mysql_rdb.html#cuint	type cuint		29
+nim	SQLSTATE_LENGTH	query_builder/libs/mysql/mysql_rdb.html#SQLSTATE_LENGTH	const SQLSTATE_LENGTH		48
+nim	Enum_server_command	query_builder/libs/mysql/mysql_rdb.html#Enum_server_command	enum Enum_server_command		57
+nim	SCRAMBLE_LENGTH	query_builder/libs/mysql/mysql_rdb.html#SCRAMBLE_LENGTH	const SCRAMBLE_LENGTH		68
+nim	NOT_NULL_FLAG	query_builder/libs/mysql/mysql_rdb.html#NOT_NULL_FLAG	const NOT_NULL_FLAG		75
+nim	PRI_KEY_FLAG	query_builder/libs/mysql/mysql_rdb.html#PRI_KEY_FLAG	const PRI_KEY_FLAG		76
+nim	ERRMSG_SIZE	query_builder/libs/mysql/mysql_rdb.html#ERRMSG_SIZE	const ERRMSG_SIZE		141
+nim	St_net	query_builder/libs/mysql/mysql_rdb.html#St_net	object St_net		158
+nim	NET	query_builder/libs/mysql/mysql_rdb.html#NET	type NET		198
+nim	PNET	query_builder/libs/mysql/mysql_rdb.html#PNET	type PNET		199
+nim	TYPE_DECIMAL	query_builder/libs/mysql/mysql_rdb.html#TYPE_DECIMAL	Enum_field_types.TYPE_DECIMAL		206
+nim	TYPE_TINY	query_builder/libs/mysql/mysql_rdb.html#TYPE_TINY	Enum_field_types.TYPE_TINY		206
+nim	TYPE_SHORT	query_builder/libs/mysql/mysql_rdb.html#TYPE_SHORT	Enum_field_types.TYPE_SHORT		206
+nim	TYPE_LONG	query_builder/libs/mysql/mysql_rdb.html#TYPE_LONG	Enum_field_types.TYPE_LONG		206
+nim	TYPE_FLOAT	query_builder/libs/mysql/mysql_rdb.html#TYPE_FLOAT	Enum_field_types.TYPE_FLOAT		206
+nim	TYPE_DOUBLE	query_builder/libs/mysql/mysql_rdb.html#TYPE_DOUBLE	Enum_field_types.TYPE_DOUBLE		206
+nim	TYPE_NULL	query_builder/libs/mysql/mysql_rdb.html#TYPE_NULL	Enum_field_types.TYPE_NULL		206
+nim	TYPE_TIMESTAMP	query_builder/libs/mysql/mysql_rdb.html#TYPE_TIMESTAMP	Enum_field_types.TYPE_TIMESTAMP		206
+nim	TYPE_LONGLONG	query_builder/libs/mysql/mysql_rdb.html#TYPE_LONGLONG	Enum_field_types.TYPE_LONGLONG		206
+nim	TYPE_INT24	query_builder/libs/mysql/mysql_rdb.html#TYPE_INT24	Enum_field_types.TYPE_INT24		206
+nim	TYPE_DATE	query_builder/libs/mysql/mysql_rdb.html#TYPE_DATE	Enum_field_types.TYPE_DATE		206
+nim	TYPE_TIME	query_builder/libs/mysql/mysql_rdb.html#TYPE_TIME	Enum_field_types.TYPE_TIME		206
+nim	TYPE_DATETIME	query_builder/libs/mysql/mysql_rdb.html#TYPE_DATETIME	Enum_field_types.TYPE_DATETIME		206
+nim	TYPE_YEAR	query_builder/libs/mysql/mysql_rdb.html#TYPE_YEAR	Enum_field_types.TYPE_YEAR		206
+nim	TYPE_NEWDATE	query_builder/libs/mysql/mysql_rdb.html#TYPE_NEWDATE	Enum_field_types.TYPE_NEWDATE		206
+nim	TYPE_VARCHAR	query_builder/libs/mysql/mysql_rdb.html#TYPE_VARCHAR	Enum_field_types.TYPE_VARCHAR		206
+nim	TYPE_BIT	query_builder/libs/mysql/mysql_rdb.html#TYPE_BIT	Enum_field_types.TYPE_BIT		206
+nim	TYPE_NEWDECIMAL	query_builder/libs/mysql/mysql_rdb.html#TYPE_NEWDECIMAL	Enum_field_types.TYPE_NEWDECIMAL		206
+nim	TYPE_ENUM	query_builder/libs/mysql/mysql_rdb.html#TYPE_ENUM	Enum_field_types.TYPE_ENUM		206
+nim	TYPE_SET	query_builder/libs/mysql/mysql_rdb.html#TYPE_SET	Enum_field_types.TYPE_SET		206
+nim	TYPE_TINY_BLOB	query_builder/libs/mysql/mysql_rdb.html#TYPE_TINY_BLOB	Enum_field_types.TYPE_TINY_BLOB		206
+nim	TYPE_MEDIUM_BLOB	query_builder/libs/mysql/mysql_rdb.html#TYPE_MEDIUM_BLOB	Enum_field_types.TYPE_MEDIUM_BLOB		206
+nim	TYPE_LONG_BLOB	query_builder/libs/mysql/mysql_rdb.html#TYPE_LONG_BLOB	Enum_field_types.TYPE_LONG_BLOB		206
+nim	TYPE_BLOB	query_builder/libs/mysql/mysql_rdb.html#TYPE_BLOB	Enum_field_types.TYPE_BLOB		206
+nim	TYPE_VAR_STRING	query_builder/libs/mysql/mysql_rdb.html#TYPE_VAR_STRING	Enum_field_types.TYPE_VAR_STRING		206
+nim	TYPE_STRING	query_builder/libs/mysql/mysql_rdb.html#TYPE_STRING	Enum_field_types.TYPE_STRING		206
+nim	TYPE_GEOMETRY	query_builder/libs/mysql/mysql_rdb.html#TYPE_GEOMETRY	Enum_field_types.TYPE_GEOMETRY		206
+nim	Enum_field_types	query_builder/libs/mysql/mysql_rdb.html#Enum_field_types	enum Enum_field_types		206
+nim	St_mysql_field	query_builder/libs/mysql/mysql_rdb.html#St_mysql_field	object St_mysql_field		403
+nim	FIELD	query_builder/libs/mysql/mysql_rdb.html#FIELD	type FIELD		426
+nim	PFIELD	query_builder/libs/mysql/mysql_rdb.html#PFIELD	type PFIELD		427
+nim	ROW	query_builder/libs/mysql/mysql_rdb.html#ROW	type ROW		429
+nim	my_ulonglong	query_builder/libs/mysql/mysql_rdb.html#my_ulonglong	type my_ulonglong		442
+nim	Pst_mysql_rows	query_builder/libs/mysql/mysql_rdb.html#Pst_mysql_rows	type Pst_mysql_rows		449
+nim	St_mysql_rows	query_builder/libs/mysql/mysql_rdb.html#St_mysql_rows	object St_mysql_rows		450
+nim	ROWS	query_builder/libs/mysql/mysql_rdb.html#ROWS	type ROWS		455
+nim	PROWS	query_builder/libs/mysql/mysql_rdb.html#PROWS	type PROWS		456
+nim	Pst_used_mem	query_builder/libs/mysql/mysql_rdb.html#Pst_used_mem	type Pst_used_mem		467
+nim	St_used_mem	query_builder/libs/mysql/mysql_rdb.html#St_used_mem	object St_used_mem		468
+nim	USED_MEM	query_builder/libs/mysql/mysql_rdb.html#USED_MEM	type USED_MEM		473
+nim	PUSED_MEM	query_builder/libs/mysql/mysql_rdb.html#PUSED_MEM	type PUSED_MEM		474
+nim	St_mem_root	query_builder/libs/mysql/mysql_rdb.html#St_mem_root	object St_mem_root		476
+nim	MEM_ROOT	query_builder/libs/mysql/mysql_rdb.html#MEM_ROOT	type MEM_ROOT		488
+nim	St_mysql_data	query_builder/libs/mysql/mysql_rdb.html#St_mysql_data	object St_mysql_data		495
+nim	DATA	query_builder/libs/mysql/mysql_rdb.html#DATA	type DATA		502
+nim	PDATA	query_builder/libs/mysql/mysql_rdb.html#PDATA	type PDATA		503
+nim	OPT_CONNECT_TIMEOUT	query_builder/libs/mysql/mysql_rdb.html#OPT_CONNECT_TIMEOUT	Option.OPT_CONNECT_TIMEOUT		504
+nim	OPT_COMPRESS	query_builder/libs/mysql/mysql_rdb.html#OPT_COMPRESS	Option.OPT_COMPRESS		504
+nim	OPT_NAMED_PIPE	query_builder/libs/mysql/mysql_rdb.html#OPT_NAMED_PIPE	Option.OPT_NAMED_PIPE		504
+nim	INIT_COMMAND	query_builder/libs/mysql/mysql_rdb.html#INIT_COMMAND	Option.INIT_COMMAND		504
+nim	READ_DEFAULT_FILE	query_builder/libs/mysql/mysql_rdb.html#READ_DEFAULT_FILE	Option.READ_DEFAULT_FILE		504
+nim	READ_DEFAULT_GROUP	query_builder/libs/mysql/mysql_rdb.html#READ_DEFAULT_GROUP	Option.READ_DEFAULT_GROUP		504
+nim	SET_CHARSET_DIR	query_builder/libs/mysql/mysql_rdb.html#SET_CHARSET_DIR	Option.SET_CHARSET_DIR		504
+nim	SET_CHARSET_NAME	query_builder/libs/mysql/mysql_rdb.html#SET_CHARSET_NAME	Option.SET_CHARSET_NAME		504
+nim	OPT_LOCAL_INFILE	query_builder/libs/mysql/mysql_rdb.html#OPT_LOCAL_INFILE	Option.OPT_LOCAL_INFILE		504
+nim	OPT_PROTOCOL	query_builder/libs/mysql/mysql_rdb.html#OPT_PROTOCOL	Option.OPT_PROTOCOL		504
+nim	SHARED_MEMORY_BASE_NAME	query_builder/libs/mysql/mysql_rdb.html#SHARED_MEMORY_BASE_NAME	Option.SHARED_MEMORY_BASE_NAME		504
+nim	OPT_READ_TIMEOUT	query_builder/libs/mysql/mysql_rdb.html#OPT_READ_TIMEOUT	Option.OPT_READ_TIMEOUT		504
+nim	OPT_WRITE_TIMEOUT	query_builder/libs/mysql/mysql_rdb.html#OPT_WRITE_TIMEOUT	Option.OPT_WRITE_TIMEOUT		504
+nim	OPT_USE_RESULT	query_builder/libs/mysql/mysql_rdb.html#OPT_USE_RESULT	Option.OPT_USE_RESULT		504
+nim	OPT_USE_REMOTE_CONNECTION	query_builder/libs/mysql/mysql_rdb.html#OPT_USE_REMOTE_CONNECTION	Option.OPT_USE_REMOTE_CONNECTION		504
+nim	OPT_USE_EMBEDDED_CONNECTION	query_builder/libs/mysql/mysql_rdb.html#OPT_USE_EMBEDDED_CONNECTION	Option.OPT_USE_EMBEDDED_CONNECTION		504
+nim	OPT_GUESS_CONNECTION	query_builder/libs/mysql/mysql_rdb.html#OPT_GUESS_CONNECTION	Option.OPT_GUESS_CONNECTION		504
+nim	SET_CLIENT_IP	query_builder/libs/mysql/mysql_rdb.html#SET_CLIENT_IP	Option.SET_CLIENT_IP		504
+nim	SECURE_AUTH	query_builder/libs/mysql/mysql_rdb.html#SECURE_AUTH	Option.SECURE_AUTH		504
+nim	REPORT_DATA_TRUNCATION	query_builder/libs/mysql/mysql_rdb.html#REPORT_DATA_TRUNCATION	Option.REPORT_DATA_TRUNCATION		504
+nim	OPT_RECONNECT	query_builder/libs/mysql/mysql_rdb.html#OPT_RECONNECT	Option.OPT_RECONNECT		504
+nim	MYSQL_OPT_NONBLOCK	query_builder/libs/mysql/mysql_rdb.html#MYSQL_OPT_NONBLOCK	Option.MYSQL_OPT_NONBLOCK		504
+nim	Option	query_builder/libs/mysql/mysql_rdb.html#Option	enum Option		504
+nim	St_dynamic_array	query_builder/libs/mysql/mysql_rdb.html#St_dynamic_array	object St_dynamic_array		524
+nim	Pst_dynamic_array	query_builder/libs/mysql/mysql_rdb.html#Pst_dynamic_array	type Pst_dynamic_array		532
+nim	St_mysql_options	query_builder/libs/mysql/mysql_rdb.html#St_mysql_options	object St_mysql_options		534
+nim	STATUS_READY	query_builder/libs/mysql/mysql_rdb.html#STATUS_READY	Status.STATUS_READY		580
+nim	STATUS_GET_RESULT	query_builder/libs/mysql/mysql_rdb.html#STATUS_GET_RESULT	Status.STATUS_GET_RESULT		580
+nim	STATUS_USE_RESULT	query_builder/libs/mysql/mysql_rdb.html#STATUS_USE_RESULT	Status.STATUS_USE_RESULT		580
+nim	Status	query_builder/libs/mysql/mysql_rdb.html#Status	enum Status		580
+nim	Charset_info_st	query_builder/libs/mysql/mysql_rdb.html#Charset_info_st	object Charset_info_st		589
+nim	Pcharset_info_st	query_builder/libs/mysql/mysql_rdb.html#Pcharset_info_st	type Pcharset_info_st		618
+nim	Pst_mysql_methods	query_builder/libs/mysql/mysql_rdb.html#Pst_mysql_methods	type Pst_mysql_methods		632
+nim	Pst_mysql	query_builder/libs/mysql/mysql_rdb.html#Pst_mysql	type Pst_mysql		633
+nim	St_mysql	query_builder/libs/mysql/mysql_rdb.html#St_mysql	object St_mysql		634
+nim	PMySQL	query_builder/libs/mysql/mysql_rdb.html#PMySQL	type PMySQL		681
+nim	St_mysql_res	query_builder/libs/mysql/mysql_rdb.html#St_mysql_res	object St_mysql_res		683
+nim	RES	query_builder/libs/mysql/mysql_rdb.html#RES	type RES		699
+nim	PRES	query_builder/libs/mysql/mysql_rdb.html#PRES	type PRES		700
+nim	Pst_mysql_stmt	query_builder/libs/mysql/mysql_rdb.html#Pst_mysql_stmt	type Pst_mysql_stmt		701
+nim	PSTMT	query_builder/libs/mysql/mysql_rdb.html#PSTMT	type PSTMT		702
+nim	St_mysql_methods	query_builder/libs/mysql/mysql_rdb.html#St_mysql_methods	object St_mysql_methods		703
+nim	STMT_INIT_DONE	query_builder/libs/mysql/mysql_rdb.html#STMT_INIT_DONE	Enum_mysql_stmt_state.STMT_INIT_DONE		751
+nim	STMT_PREPARE_DONE	query_builder/libs/mysql/mysql_rdb.html#STMT_PREPARE_DONE	Enum_mysql_stmt_state.STMT_PREPARE_DONE		751
+nim	STMT_EXECUTE_DONE	query_builder/libs/mysql/mysql_rdb.html#STMT_EXECUTE_DONE	Enum_mysql_stmt_state.STMT_EXECUTE_DONE		751
+nim	STMT_FETCH_DONE	query_builder/libs/mysql/mysql_rdb.html#STMT_FETCH_DONE	Enum_mysql_stmt_state.STMT_FETCH_DONE		751
+nim	Enum_mysql_stmt_state	query_builder/libs/mysql/mysql_rdb.html#Enum_mysql_stmt_state	enum Enum_mysql_stmt_state		751
+nim	U	query_builder/libs/mysql/mysql_rdb.html#U	object U		775
+nim	St_mysql_bind	query_builder/libs/mysql/mysql_rdb.html#St_mysql_bind	object St_mysql_bind		779
+nim	BIND	query_builder/libs/mysql/mysql_rdb.html#BIND	type BIND		800
+nim	PBIND	query_builder/libs/mysql/mysql_rdb.html#PBIND	type PBIND		801
+nim	St_mysql_stmt	query_builder/libs/mysql/mysql_rdb.html#St_mysql_stmt	object St_mysql_stmt		802
+nim	STMT	query_builder/libs/mysql/mysql_rdb.html#STMT	type STMT		830
+nim	num_fields	query_builder/libs/mysql/mysql_rdb.html#num_fields,PRES	proc num_fields(res: PRES): cuint		873
+nim	fetch_field_direct	query_builder/libs/mysql/mysql_rdb.html#fetch_field_direct,PRES,cuint	proc fetch_field_direct(res: PRES; fieldnr: cuint): PFIELD		876
+nim	error	query_builder/libs/mysql/mysql_rdb.html#error,PMySQL	proc error(MySQL: PMySQL): cstring		891
+nim	init	query_builder/libs/mysql/mysql_rdb.html#init,PMySQL	proc init(MySQL: PMySQL): PMySQL		901
+nim	init	query_builder/libs/mysql/mysql_rdb.html#init,PMySQL_2	proc init(MySQL: var PMySQL)		902
+nim	real_connect	query_builder/libs/mysql/mysql_rdb.html#real_connect,PMySQL,cstring,cstring,cstring,cstring,cuint,cstring,int	proc real_connect(MySQL: PMySQL; host: cstring; user: cstring; passwd: cstring;\n             db: cstring; port: cuint; unix_socket: cstring; clientflag: int): PMySQL		908
+nim	real_query	query_builder/libs/mysql/mysql_rdb.html#real_query,PMySQL,cstring,int	proc real_query(MySQL: PMySQL; q: cstring; len: int): cint		931
+nim	use_result	query_builder/libs/mysql/mysql_rdb.html#use_result,PMySQL	proc use_result(MySQL: PMySQL): PRES		935
+nim	ping	query_builder/libs/mysql/mysql_rdb.html#ping,PMySQL	proc ping(MySQL: PMySQL): cint		991
+nim	free_result	query_builder/libs/mysql/mysql_rdb.html#free_result,PRES	proc free_result(result: PRES)		1013
+nim	fetch_row	query_builder/libs/mysql/mysql_rdb.html#fetch_row,PRES	proc fetch_row(result: PRES): ROW		1021
+nim	real_escape_string	query_builder/libs/mysql/mysql_rdb.html#real_escape_string,PMySQL,cstring,cstring,int	proc real_escape_string(MySQL: PMySQL; fto: cstring; from: cstring; len: int): int		1033
+nim	stmt_init	query_builder/libs/mysql/mysql_rdb.html#stmt_init,PMySQL	proc stmt_init(MySQL: PMySQL): PSTMT		1055
+nim	close	query_builder/libs/mysql/mysql_rdb.html#close,PMySQL	proc close(sock: PMySQL)		1116
+nimgrp	init	query_builder/libs/mysql/mysql_rdb.html#init-procs-all	proc		901

clients/nim-allographer/docs/v2/query_builder/libs/postgres/postgres_impl.html

@@ -0,0 +1,323 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/postgres/postgres_impl</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/postgres/postgres_impl</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">exec
+  <li><a class="reference" href="#exec%2CPPGconn%2Cstring%2CJsonNode%2Cseq%5BRow%5D%2Cint" title="exec(db: PPGconn; query: string; args: JsonNode; columns: seq[Row]; timeout: int): owned(
+    Future[void])">exec(db: PPGconn; query: string; args: JsonNode; columns: seq[Row]; timeout: int): owned(
+    Future[void])</a></li>
+<li><a class="reference" href="#exec%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint" title="exec(db: PPGconn; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])">exec(db: PPGconn; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">execGetValue
+  <li><a class="reference" href="#execGetValue%2CPPGconn%2Cstring%2CJsonNode%2Cseq%5BRow%5D%2Cint" title="execGetValue(db: PPGconn; query: string; args: JsonNode; columns: seq[Row];
+             timeout: int): Future[(seq[Row], DbRows)]">execGetValue(db: PPGconn; query: string; args: JsonNode; columns: seq[Row];
+             timeout: int): Future[(seq[Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">getColumns
+  <li><a class="reference" href="#getColumns%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint" title="getColumns(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]">getColumns(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">prepare
+  <li><a class="reference" href="#prepare%2CPPGconn%2Cstring%2Cint%2Cstring" title="prepare(db: PPGconn; query: string; timeout: int; stmtName: string): Future[int]">prepare(db: PPGconn; query: string; timeout: int; stmtName: string): Future[int]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">preparedExec
+  <li><a class="reference" href="#preparedExec%2CPPGconn%2Cseq%5Bstring%5D%2Cint%2Cint%2Cstring" title="preparedExec(db: PPGconn; args: seq[string]; nArgs: int; timeout: int;
+             stmtName: string): owned(Future[void])">preparedExec(db: PPGconn; args: seq[string]; nArgs: int; timeout: int;
+             stmtName: string): owned(Future[void])</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">preparedQuery
+  <li><a class="reference" href="#preparedQuery%2CPPGconn%2Cseq%5Bstring%5D%2Cint%2Cint%2Cstring" title="preparedQuery(db: PPGconn; args: seq[string]; nArgs: int; timeout: int;
+              stmtName: string): Future[(seq[Row], DbRows)]">preparedQuery(db: PPGconn; args: seq[string]; nArgs: int; timeout: int;
+              stmtName: string): Future[(seq[Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">query
+  <li><a class="reference" href="#query%2CPPGconn%2Cstring%2CJsonNode%2Cint" title="query(db: PPGconn; query: string; args: JsonNode; timeout: int): Future[
+    (seq[Row], DbRows)]">query(db: PPGconn; query: string; args: JsonNode; timeout: int): Future[
+    (seq[Row], DbRows)]</a></li>
+<li><a class="reference" href="#query%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint" title="query(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[
+    (seq[Row], DbRows)]">query(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[
+    (seq[Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">queryPlain
+  <li><a class="reference" href="#queryPlain%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint" title="queryPlain(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[
+    seq[Row]]">queryPlain(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[
+    seq[Row]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">rawExec
+  <li><a class="reference" href="#rawExec%2CPPGconn%2Cstring%2CJsonNode%2Cint" title="rawExec(db: PPGconn; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])">rawExec(db: PPGconn; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">rawQuery
+  <li><a class="reference" href="#rawQuery%2CPPGconn%2Cstring%2CJsonNode%2Cint" title="rawQuery(db: PPGconn; query: string; args: JsonNode; timeout: int): Future[
+    (seq[Row], DbRows)]">rawQuery(db: PPGconn; query: string; args: JsonNode; timeout: int): Future[
+    (seq[Row], DbRows)]</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"><a class="reference external" href="https://www.postgresql.jp/document/12/html/libpq-async.html">https://www.postgresql.jp/document/12/html/libpq-async.html</a></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="../../error.html">../../error</a>, <a class="reference external" href="../../models/database_types.html">../../models/database_types</a>, <a class="reference external" href="postgres_rdb.html">postgres_rdb</a>, <a class="reference external" href="postgres_lib.html">postgres_lib</a>
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="exec-procs-all">
+  <div id="exec,PPGconn,string,JsonNode,seq[Row],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPPGconn%2Cstring%2CJsonNode%2Cseq%5BRow%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">;</span>
+          <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="exec,PPGconn,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="execGetValue-procs-all">
+  <div id="execGetValue,PPGconn,string,JsonNode,seq[Row],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#execGetValue%2CPPGconn%2Cstring%2CJsonNode%2Cseq%5BRow%5D%2Cint"><span class="Identifier">execGetValue</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">;</span>
+                  <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span><span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="getColumns-procs-all">
+  <div id="getColumns,PPGconn,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#getColumns%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">getColumns</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                   <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="prepare-procs-all">
+  <div id="prepare,PPGconn,string,int,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#prepare%2CPPGconn%2Cstring%2Cint%2Cstring"><span class="Identifier">prepare</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">;</span> <span class="Identifier">stmtName</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">int</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+           <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="preparedExec-procs-all">
+  <div id="preparedExec,PPGconn,seq[string],int,int,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#preparedExec%2CPPGconn%2Cseq%5Bstring%5D%2Cint%2Cint%2Cstring"><span class="Identifier">preparedExec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">nArgs</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">;</span>
+                  <span class="Identifier">stmtName</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="preparedQuery-procs-all">
+  <div id="preparedQuery,PPGconn,seq[string],int,int,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#preparedQuery%2CPPGconn%2Cseq%5Bstring%5D%2Cint%2Cint%2Cstring"><span class="Identifier">preparedQuery</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">nArgs</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">;</span>
+                   <span class="Identifier">stmtName</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span><span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="query-procs-all">
+  <div id="query,PPGconn,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#query%2CPPGconn%2Cstring%2CJsonNode%2Cint"><span class="Identifier">query</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span>
+    <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+<div id="query,PPGconn,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#query%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">query</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                          <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                          <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="queryPlain-procs-all">
+  <div id="queryPlain,PPGconn,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#queryPlain%2CPPGconn%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">queryPlain</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="rawExec-procs-all">
+  <div id="rawExec,PPGconn,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#rawExec%2CPPGconn%2Cstring%2CJsonNode%2Cint"><span class="Identifier">rawExec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="rawQuery-procs-all">
+  <div id="rawQuery,PPGconn,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#rawQuery%2CPPGconn%2Cstring%2CJsonNode%2Cint"><span class="Identifier">rawQuery</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                          <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">OSError</span><span class="Other">]</span><span class="Other">,</span>
+                          <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:33 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/postgres/postgres_impl.idx

@@ -0,0 +1,15 @@
+nimTitle	postgres_impl	query_builder/libs/postgres/postgres_impl.html	module src/allographer/query_builder/libs/postgres/postgres_impl		0
+nim	query	query_builder/libs/postgres/postgres_impl.html#query,PPGconn,string,JsonNode,int	proc query(db: PPGconn; query: string; args: JsonNode; timeout: int): Future[\n    (seq[Row], DbRows)]		132
+nim	exec	query_builder/libs/postgres/postgres_impl.html#exec,PPGconn,string,JsonNode,seq[Row],int	proc exec(db: PPGconn; query: string; args: JsonNode; columns: seq[Row]; timeout: int): owned(\n    Future[void])		160
+nim	execGetValue	query_builder/libs/postgres/postgres_impl.html#execGetValue,PPGconn,string,JsonNode,seq[Row],int	proc execGetValue(db: PPGconn; query: string; args: JsonNode; columns: seq[Row];\n             timeout: int): Future[(seq[Row], DbRows)]		176
+nim	rawQuery	query_builder/libs/postgres/postgres_impl.html#rawQuery,PPGconn,string,JsonNode,int	proc rawQuery(db: PPGconn; query: string; args: JsonNode; timeout: int): Future[\n    (seq[Row], DbRows)]		204
+nim	rawExec	query_builder/libs/postgres/postgres_impl.html#rawExec,PPGconn,string,JsonNode,int	proc rawExec(db: PPGconn; query: string; args: JsonNode; timeout: int): owned(\n    Future[void])		232
+nim	query	query_builder/libs/postgres/postgres_impl.html#query,PPGconn,string,seq[string],int	proc query(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[\n    (seq[Row], DbRows)]		252
+nim	queryPlain	query_builder/libs/postgres/postgres_impl.html#queryPlain,PPGconn,string,seq[string],int	proc queryPlain(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[\n    seq[Row]]		277
+nim	exec	query_builder/libs/postgres/postgres_impl.html#exec,PPGconn,string,seq[string],int	proc exec(db: PPGconn; query: string; args: seq[string]; timeout: int): owned(\n    Future[void])		300
+nim	getColumns	query_builder/libs/postgres/postgres_impl.html#getColumns,PPGconn,string,seq[string],int	proc getColumns(db: PPGconn; query: string; args: seq[string]; timeout: int): Future[\n    seq[string]]		314
+nim	prepare	query_builder/libs/postgres/postgres_impl.html#prepare,PPGconn,string,int,string	proc prepare(db: PPGconn; query: string; timeout: int; stmtName: string): Future[int]		336
+nim	preparedQuery	query_builder/libs/postgres/postgres_impl.html#preparedQuery,PPGconn,seq[string],int,int,string	proc preparedQuery(db: PPGconn; args: seq[string]; nArgs: int; timeout: int;\n              stmtName: string): Future[(seq[Row], DbRows)]		351
+nim	preparedExec	query_builder/libs/postgres/postgres_impl.html#preparedExec,PPGconn,seq[string],int,int,string	proc preparedExec(db: PPGconn; args: seq[string]; nArgs: int; timeout: int;\n             stmtName: string): owned(Future[void])		379
+nimgrp	query	query_builder/libs/postgres/postgres_impl.html#query-procs-all	proc		132
+nimgrp	exec	query_builder/libs/postgres/postgres_impl.html#exec-procs-all	proc		160

clients/nim-allographer/docs/v2/query_builder/libs/postgres/postgres_lib.html

@@ -0,0 +1,314 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/postgres/postgres_lib</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/postgres/postgres_lib</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
+    <ul class="simple simple-toc-section">
+      <li><a class="reference" href="#PGParams" title="PGParams = object
+  nParams*: int32
+  values*: cstringArray
+  lengths*: seq[int32]
+  formats*: seq[int32]">PGParams</a></li>
+
+    </ul>
+  </details>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">appendDbRowWithBaseColumns
+  <li><a class="reference" href="#appendDbRowWithBaseColumns%2CPPGresult%2CDbRows%2Cint32%2Cint32%2CDbColumns" title="appendDbRowWithBaseColumns(res: PPGresult; dbRows: var DbRows;
+                           line, cols: int32; base: DbColumns)">appendDbRowWithBaseColumns(res: PPGresult; dbRows: var DbRows;
+                           line, cols: int32; base: DbColumns)</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">buildBaseDbColumns
+  <li><a class="reference" href="#buildBaseDbColumns%2CPPGresult%2Cint32" title="buildBaseDbColumns(res: PPGresult; cols: int32): DbColumns">buildBaseDbColumns(res: PPGresult; cols: int32): DbColumns</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">checkError
+  <li><a class="reference" href="#checkError%2CPPGconn" title="checkError(db: PPGconn)">checkError(db: PPGconn)</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">dbError
+  <li><a class="reference" href="#dbError%2CPPGconn" title="dbError(db: PPGconn)">dbError(db: PPGconn)</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">dbFormat
+  <li><a class="reference" href="#dbFormat%2Cstring%2Cvarargs%5Bstring%5D" title="dbFormat(formatstr: string; args: varargs[string]): string">dbFormat(formatstr: string; args: varargs[string]): string</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">fromArray
+  <li><a class="reference" href="#fromArray%2CtypePGParams%2CJsonNode" title="fromArray(_: type PGParams; args: JsonNode): PGParams">fromArray(_: type PGParams; args: JsonNode): PGParams</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">fromObjArray
+  <li><a class="reference" href="#fromObjArray%2CtypePGParams%2CJsonNode" title="fromObjArray(_: type PGParams; args: JsonNode): PGParams">fromObjArray(_: type PGParams; args: JsonNode): PGParams</a></li>
+<li><a class="reference" href="#fromObjArray%2CtypePGParams%2CJsonNode%2Cseq%5BRow%5D" title="fromObjArray(_: type PGParams; args: JsonNode; columns: seq[Row]): PGParams">fromObjArray(_: type PGParams; args: JsonNode; columns: seq[Row]): PGParams</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">newRow
+  <li><a class="reference" href="#newRow%2Cint" title="newRow(L: int): Row">newRow(L: int): Row</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">questionToDaller
+  <li><a class="reference" href="#questionToDaller%2Cstring" title="questionToDaller(s: string): string">questionToDaller(s: string): string</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">setColumnInfo
+  <li><a class="reference" href="#setColumnInfo%2CPPGresult%2CDbRows%2Cint32%2Cint32" title="setColumnInfo(res: PPGresult; dbRows: var DbRows; line, cols: int32)">setColumnInfo(res: PPGresult; dbRows: var DbRows; line, cols: int32)</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">setRow
+  <li><a class="reference" href="#setRow%2CPPGresult%2CRow%2Cint32%2Cint32" title="setRow(res: PPGresult; r: var Row; line, cols: int32)">setRow(res: PPGresult; r: var Row; line, cols: int32)</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="../../error.html">../../error</a>, <a class="reference external" href="../../models/database_types.html">../../models/database_types</a>, <a class="reference external" href="postgres_rdb.html">postgres_rdb</a>
+  </dl>
+</div>
+<div class="section" id="7">
+  <h1><a class="toc-backref" href="#7">Types</a></h1>
+  <dl class="item">
+    <div id="PGParams">
+  <dt><pre><a href="postgres_lib.html#PGParams"><span class="Identifier">PGParams</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
+  <span class="Identifier">nParams</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">int32</span>
+  <span class="Identifier">values</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">cstringArray</span>
+  <span class="Identifier">lengths</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">int32</span><span class="Other">]</span>
+  <span class="Identifier">formats</span><span class="Operator">*</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">int32</span><span class="Other">]</span></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="appendDbRowWithBaseColumns-procs-all">
+  <div id="appendDbRowWithBaseColumns,PPGresult,DbRows,int32,int32,DbColumns">
+  <dt><pre><span class="Keyword">proc</span> <a href="#appendDbRowWithBaseColumns%2CPPGresult%2CDbRows%2Cint32%2Cint32%2CDbColumns"><span class="Identifier">appendDbRowWithBaseColumns</span></a><span class="Other">(</span><span class="Identifier">res</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGresult"><span class="Identifier">PPGresult</span></a><span class="Other">;</span> <span class="Identifier">dbRows</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">;</span>
+                                <span class="Identifier">line</span><span class="Other">,</span> <span class="Identifier">cols</span><span class="Other">:</span> <span class="Identifier">int32</span><span class="Other">;</span> <span class="Identifier">base</span><span class="Other">:</span> <a href="../../models/database_types.html#DbColumns"><span class="Identifier">DbColumns</span></a><span class="Other">)</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="buildBaseDbColumns-procs-all">
+  <div id="buildBaseDbColumns,PPGresult,int32">
+  <dt><pre><span class="Keyword">proc</span> <a href="#buildBaseDbColumns%2CPPGresult%2Cint32"><span class="Identifier">buildBaseDbColumns</span></a><span class="Other">(</span><span class="Identifier">res</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGresult"><span class="Identifier">PPGresult</span></a><span class="Other">;</span> <span class="Identifier">cols</span><span class="Other">:</span> <span class="Identifier">int32</span><span class="Other">)</span><span class="Other">:</span> <a href="../../models/database_types.html#DbColumns"><span class="Identifier">DbColumns</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="checkError-procs-all">
+  <div id="checkError,PPGconn">
+  <dt><pre><span class="Keyword">proc</span> <a href="#checkError%2CPPGconn"><span class="Identifier">checkError</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    Raises a DbError exception.
+    
+  </dd>
+</div>
+
+</div>
+<div id="dbError-procs-all">
+  <div id="dbError,PPGconn">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbError%2CPPGconn"><span class="Identifier">dbError</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGconn"><span class="Identifier">PPGconn</span></a><span class="Other">)</span> {.<span class="Identifier">noreturn</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    raises a DbError exception.
+    
+  </dd>
+</div>
+
+</div>
+<div id="dbFormat-procs-all">
+  <div id="dbFormat,string,varargs[string]">
+  <dt><pre><span class="Keyword">proc</span> <a href="#dbFormat%2Cstring%2Cvarargs%5Bstring%5D"><span class="Identifier">dbFormat</span></a><span class="Other">(</span><span class="Identifier">formatstr</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">varargs</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="fromArray-procs-all">
+  <div id="fromArray,typePGParams,JsonNode">
+  <dt><pre><span class="Keyword">proc</span> <a href="#fromArray%2CtypePGParams%2CJsonNode"><span class="Identifier">fromArray</span></a><span class="Other">(</span><span class="Operator">_</span><span class="Other">:</span> <span class="Keyword">type</span> <span class="Identifier">PGParams</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">)</span><span class="Other">:</span> <a href="postgres_lib.html#PGParams"><span class="Identifier">PGParams</span></a></pre></dt>
+  <dd>
+    
+    <tt class="docutils literal"><span class="pre"><span class="Identifier">args</span></span></tt> is JArray <tt class="docutils literal"><span class="pre"><span class="Punctuation">{</span><span class="Identifier">true</span><span class="Punctuation">,</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="FloatNumber">1.1</span><span class="Punctuation">,</span> <span class="StringLit">&quot;alice&quot;</span><span class="Punctuation">}</span></span></tt>
+    
+  </dd>
+</div>
+
+</div>
+<div id="fromObjArray-procs-all">
+  <div id="fromObjArray,typePGParams,JsonNode">
+  <dt><pre><span class="Keyword">proc</span> <a href="#fromObjArray%2CtypePGParams%2CJsonNode"><span class="Identifier">fromObjArray</span></a><span class="Other">(</span><span class="Operator">_</span><span class="Other">:</span> <span class="Keyword">type</span> <span class="Identifier">PGParams</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">)</span><span class="Other">:</span> <a href="postgres_lib.html#PGParams"><span class="Identifier">PGParams</span></a></pre></dt>
+  <dd>
+    
+    <tt class="docutils literal"><span class="pre"><span class="Identifier">args</span></span></tt> is JArray <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;bool&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="Identifier">true</span><span class="Punctuation">}</span><span class="Punctuation">,</span><span class="Punctuation">{</span><span class="StringLit">&quot;key&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;int&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;value&quot;</span><span class="Punctuation">:</span> <span class="DecNumber">1</span><span class="Punctuation">}</span><span class="Punctuation">]</span></span></tt>
+    
+  </dd>
+</div>
+<div id="fromObjArray,typePGParams,JsonNode,seq[Row]">
+  <dt><pre><span class="Keyword">proc</span> <a href="#fromObjArray%2CtypePGParams%2CJsonNode%2Cseq%5BRow%5D"><span class="Identifier">fromObjArray</span></a><span class="Other">(</span><span class="Operator">_</span><span class="Other">:</span> <span class="Keyword">type</span> <span class="Identifier">PGParams</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="postgres_lib.html#PGParams"><span class="Identifier">PGParams</span></a></pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="newRow-procs-all">
+  <div id="newRow,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#newRow%2Cint"><span class="Identifier">newRow</span></a><span class="Other">(</span><span class="Identifier">L</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="questionToDaller-procs-all">
+  <div id="questionToDaller,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#questionToDaller%2Cstring"><span class="Identifier">questionToDaller</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">string</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    <p>from <tt class="docutils literal"><span class="pre"><span class="Identifier">UPDATE</span> <span class="Identifier">user</span> <span class="Identifier">SET</span> <span class="Identifier">name</span> <span class="Operator">=</span> <span class="Operator">?</span><span class="Punctuation">,</span> <span class="Identifier">email</span> <span class="Operator">=</span> <span class="Operator">?</span> <span class="Identifier">WHERE</span> <span class="Identifier">id</span> <span class="Operator">=</span> <span class="Operator">?</span></span></tt></p>
+<p>to   <tt class="docutils literal"><span class="pre"><span class="Identifier">UPDATE</span> <span class="Identifier">user</span> <span class="Identifier">SET</span> <span class="Identifier">name</span> <span class="Operator">=</span> <span class="Operator">$</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">email</span> <span class="Operator">=</span> <span class="Operator">$</span><span class="DecNumber">2</span> <span class="Identifier">WHERE</span> <span class="Identifier">id</span> <span class="Operator">=</span> <span class="Operator">$</span><span class="DecNumber">3</span></span></tt></p>
+
+    
+  </dd>
+</div>
+
+</div>
+<div id="setColumnInfo-procs-all">
+  <div id="setColumnInfo,PPGresult,DbRows,int32,int32">
+  <dt><pre><span class="Keyword">proc</span> <a href="#setColumnInfo%2CPPGresult%2CDbRows%2Cint32%2Cint32"><span class="Identifier">setColumnInfo</span></a><span class="Other">(</span><span class="Identifier">res</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGresult"><span class="Identifier">PPGresult</span></a><span class="Other">;</span> <span class="Identifier">dbRows</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">;</span> <span class="Identifier">line</span><span class="Other">,</span> <span class="Identifier">cols</span><span class="Other">:</span> <span class="Identifier">int32</span><span class="Other">)</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="setRow-procs-all">
+  <div id="setRow,PPGresult,Row,int32,int32">
+  <dt><pre><span class="Keyword">proc</span> <a href="#setRow%2CPPGresult%2CRow%2Cint32%2Cint32"><span class="Identifier">setRow</span></a><span class="Other">(</span><span class="Identifier">res</span><span class="Other">:</span> <a href="postgres_rdb.html#PPGresult"><span class="Identifier">PPGresult</span></a><span class="Other">;</span> <span class="Identifier">r</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">;</span> <span class="Identifier">line</span><span class="Other">,</span> <span class="Identifier">cols</span><span class="Other">:</span> <span class="Identifier">int32</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:33 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/postgres/postgres_lib.idx

@@ -0,0 +1,15 @@
+nimTitle	postgres_lib	query_builder/libs/postgres/postgres_lib.html	module src/allographer/query_builder/libs/postgres/postgres_lib		0
+nim	dbError	query_builder/libs/postgres/postgres_lib.html#dbError,PPGconn	proc dbError(db: PPGconn)		8
+nim	checkError	query_builder/libs/postgres/postgres_lib.html#checkError,PPGconn	proc checkError(db: PPGconn)		15
+nim	buildBaseDbColumns	query_builder/libs/postgres/postgres_lib.html#buildBaseDbColumns,PPGresult,int32	proc buildBaseDbColumns(res: PPGresult; cols: int32): DbColumns		153
+nim	appendDbRowWithBaseColumns	query_builder/libs/postgres/postgres_lib.html#appendDbRowWithBaseColumns,PPGresult,DbRows,int32,int32,DbColumns	proc appendDbRowWithBaseColumns(res: PPGresult; dbRows: var DbRows;\n                           line, cols: int32; base: DbColumns)		161
+nim	setColumnInfo	query_builder/libs/postgres/postgres_lib.html#setColumnInfo,PPGresult,DbRows,int32,int32	proc setColumnInfo(res: PPGresult; dbRows: var DbRows; line, cols: int32)		168
+nim	newRow	query_builder/libs/postgres/postgres_lib.html#newRow,int	proc newRow(L: int): Row		172
+nim	setRow	query_builder/libs/postgres/postgres_lib.html#setRow,PPGresult,Row,int32,int32	proc setRow(res: PPGresult; r: var Row; line, cols: int32)		176
+nim	dbFormat	query_builder/libs/postgres/postgres_lib.html#dbFormat,string,varargs[string]	proc dbFormat(formatstr: string; args: varargs[string]): string		207
+nim	questionToDaller	query_builder/libs/postgres/postgres_lib.html#questionToDaller,string	proc questionToDaller(s: string): string		226
+nim	PGParams	query_builder/libs/postgres/postgres_lib.html#PGParams	object PGParams		245
+nim	fromObjArray	query_builder/libs/postgres/postgres_lib.html#fromObjArray,typePGParams,JsonNode,seq[Row]	proc fromObjArray(_: type PGParams; args: JsonNode; columns: seq[Row]): PGParams		307
+nim	fromObjArray	query_builder/libs/postgres/postgres_lib.html#fromObjArray,typePGParams,JsonNode	proc fromObjArray(_: type PGParams; args: JsonNode): PGParams		313
+nim	fromArray	query_builder/libs/postgres/postgres_lib.html#fromArray,typePGParams,JsonNode	proc fromArray(_: type PGParams; args: JsonNode): PGParams		321
+nimgrp	fromobjarray	query_builder/libs/postgres/postgres_lib.html#fromObjArray-procs-all	proc		307

clients/nim-allographer/docs/v2/query_builder/libs/postgres/postgres_rdb.idx

@@ -0,0 +1,187 @@
+nimTitle	postgres_rdb	query_builder/libs/postgres/postgres_rdb.html	module src/allographer/query_builder/libs/postgres/postgres_rdb		0
+nim	POid	query_builder/libs/postgres/postgres_rdb.html#POid	type POid		14
+nim	Oid	query_builder/libs/postgres/postgres_rdb.html#Oid	type Oid		15
+nim	ERROR_MSG_LENGTH	query_builder/libs/postgres/postgres_rdb.html#ERROR_MSG_LENGTH	const ERROR_MSG_LENGTH		18
+nim	CMDSTATUS_LEN	query_builder/libs/postgres/postgres_rdb.html#CMDSTATUS_LEN	const CMDSTATUS_LEN		19
+nim	SockAddr	query_builder/libs/postgres/postgres_rdb.html#SockAddr	type SockAddr		22
+nim	PGresAttDesc	query_builder/libs/postgres/postgres_rdb.html#PGresAttDesc	object PGresAttDesc		23
+nim	PPGresAttDesc	query_builder/libs/postgres/postgres_rdb.html#PPGresAttDesc	type PPGresAttDesc		28
+nim	PPPGresAttDesc	query_builder/libs/postgres/postgres_rdb.html#PPPGresAttDesc	type PPPGresAttDesc		29
+nim	PGresAttValue	query_builder/libs/postgres/postgres_rdb.html#PGresAttValue	object PGresAttValue		30
+nim	PPGresAttValue	query_builder/libs/postgres/postgres_rdb.html#PPGresAttValue	type PPGresAttValue		34
+nim	PPPGresAttValue	query_builder/libs/postgres/postgres_rdb.html#PPPGresAttValue	type PPPGresAttValue		35
+nim	PExecStatusType	query_builder/libs/postgres/postgres_rdb.html#PExecStatusType	type PExecStatusType		36
+nim	PGRES_EMPTY_QUERY	query_builder/libs/postgres/postgres_rdb.html#PGRES_EMPTY_QUERY	ExecStatusType.PGRES_EMPTY_QUERY		37
+nim	PGRES_COMMAND_OK	query_builder/libs/postgres/postgres_rdb.html#PGRES_COMMAND_OK	ExecStatusType.PGRES_COMMAND_OK		37
+nim	PGRES_TUPLES_OK	query_builder/libs/postgres/postgres_rdb.html#PGRES_TUPLES_OK	ExecStatusType.PGRES_TUPLES_OK		37
+nim	PGRES_COPY_OUT	query_builder/libs/postgres/postgres_rdb.html#PGRES_COPY_OUT	ExecStatusType.PGRES_COPY_OUT		37
+nim	PGRES_COPY_IN	query_builder/libs/postgres/postgres_rdb.html#PGRES_COPY_IN	ExecStatusType.PGRES_COPY_IN		37
+nim	PGRES_BAD_RESPONSE	query_builder/libs/postgres/postgres_rdb.html#PGRES_BAD_RESPONSE	ExecStatusType.PGRES_BAD_RESPONSE		37
+nim	PGRES_NONFATAL_ERROR	query_builder/libs/postgres/postgres_rdb.html#PGRES_NONFATAL_ERROR	ExecStatusType.PGRES_NONFATAL_ERROR		37
+nim	PGRES_FATAL_ERROR	query_builder/libs/postgres/postgres_rdb.html#PGRES_FATAL_ERROR	ExecStatusType.PGRES_FATAL_ERROR		37
+nim	PGRES_COPY_BOTH	query_builder/libs/postgres/postgres_rdb.html#PGRES_COPY_BOTH	ExecStatusType.PGRES_COPY_BOTH		37
+nim	PGRES_SINGLE_TUPLE	query_builder/libs/postgres/postgres_rdb.html#PGRES_SINGLE_TUPLE	ExecStatusType.PGRES_SINGLE_TUPLE		37
+nim	ExecStatusType	query_builder/libs/postgres/postgres_rdb.html#ExecStatusType	enum ExecStatusType		37
+nim	PGlobjfuncs	query_builder/libs/postgres/postgres_rdb.html#PGlobjfuncs	object PGlobjfuncs		41
+nim	PPGlobjfuncs	query_builder/libs/postgres/postgres_rdb.html#PPGlobjfuncs	type PPGlobjfuncs		51
+nim	PConnStatusType	query_builder/libs/postgres/postgres_rdb.html#PConnStatusType	type PConnStatusType		52
+nim	CONNECTION_OK	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_OK	ConnStatusType.CONNECTION_OK		53
+nim	CONNECTION_BAD	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_BAD	ConnStatusType.CONNECTION_BAD		53
+nim	CONNECTION_STARTED	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_STARTED	ConnStatusType.CONNECTION_STARTED		53
+nim	CONNECTION_MADE	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_MADE	ConnStatusType.CONNECTION_MADE		53
+nim	CONNECTION_AWAITING_RESPONSE	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_AWAITING_RESPONSE	ConnStatusType.CONNECTION_AWAITING_RESPONSE		53
+nim	CONNECTION_AUTH_OK	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_AUTH_OK	ConnStatusType.CONNECTION_AUTH_OK		53
+nim	CONNECTION_SETENV	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_SETENV	ConnStatusType.CONNECTION_SETENV		53
+nim	CONNECTION_SSL_STARTUP	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_SSL_STARTUP	ConnStatusType.CONNECTION_SSL_STARTUP		53
+nim	CONNECTION_NEEDED	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_NEEDED	ConnStatusType.CONNECTION_NEEDED		53
+nim	CONNECTION_CHECK_WRITABLE	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_CHECK_WRITABLE	ConnStatusType.CONNECTION_CHECK_WRITABLE		53
+nim	CONNECTION_CONSUME	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_CONSUME	ConnStatusType.CONNECTION_CONSUME		53
+nim	CONNECTION_GSS_STARTUP	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_GSS_STARTUP	ConnStatusType.CONNECTION_GSS_STARTUP		53
+nim	CONNECTION_CHECK_TARGET	query_builder/libs/postgres/postgres_rdb.html#CONNECTION_CHECK_TARGET	ConnStatusType.CONNECTION_CHECK_TARGET		53
+nim	ConnStatusType	query_builder/libs/postgres/postgres_rdb.html#ConnStatusType	enum ConnStatusType		53
+nim	PGconn	query_builder/libs/postgres/postgres_rdb.html#PGconn	object PGconn		58
+nim	PPGconn	query_builder/libs/postgres/postgres_rdb.html#PPGconn	type PPGconn		79
+nim	PGresult	query_builder/libs/postgres/postgres_rdb.html#PGresult	object PGresult		80
+nim	PGCancel	query_builder/libs/postgres/postgres_rdb.html#PGCancel	object PGCancel		91
+nim	PPGcancel	query_builder/libs/postgres/postgres_rdb.html#PPGcancel	type PPGcancel		92
+nim	PPGresult	query_builder/libs/postgres/postgres_rdb.html#PPGresult	type PPGresult		94
+nim	PPostgresPollingStatusType	query_builder/libs/postgres/postgres_rdb.html#PPostgresPollingStatusType	type PPostgresPollingStatusType		95
+nim	PGRES_POLLING_FAILED	query_builder/libs/postgres/postgres_rdb.html#PGRES_POLLING_FAILED	PostgresPollingStatusType.PGRES_POLLING_FAILED		96
+nim	PGRES_POLLING_READING	query_builder/libs/postgres/postgres_rdb.html#PGRES_POLLING_READING	PostgresPollingStatusType.PGRES_POLLING_READING		96
+nim	PGRES_POLLING_WRITING	query_builder/libs/postgres/postgres_rdb.html#PGRES_POLLING_WRITING	PostgresPollingStatusType.PGRES_POLLING_WRITING		96
+nim	PGRES_POLLING_OK	query_builder/libs/postgres/postgres_rdb.html#PGRES_POLLING_OK	PostgresPollingStatusType.PGRES_POLLING_OK		96
+nim	PGRES_POLLING_ACTIVE	query_builder/libs/postgres/postgres_rdb.html#PGRES_POLLING_ACTIVE	PostgresPollingStatusType.PGRES_POLLING_ACTIVE		96
+nim	PostgresPollingStatusType	query_builder/libs/postgres/postgres_rdb.html#PostgresPollingStatusType	enum PostgresPollingStatusType		96
+nim	PPGTransactionStatusType	query_builder/libs/postgres/postgres_rdb.html#PPGTransactionStatusType	type PPGTransactionStatusType		99
+nim	PQTRANS_IDLE	query_builder/libs/postgres/postgres_rdb.html#PQTRANS_IDLE	PGTransactionStatusType.PQTRANS_IDLE		100
+nim	PQTRANS_ACTIVE	query_builder/libs/postgres/postgres_rdb.html#PQTRANS_ACTIVE	PGTransactionStatusType.PQTRANS_ACTIVE		100
+nim	PQTRANS_INTRANS	query_builder/libs/postgres/postgres_rdb.html#PQTRANS_INTRANS	PGTransactionStatusType.PQTRANS_INTRANS		100
+nim	PQTRANS_INERROR	query_builder/libs/postgres/postgres_rdb.html#PQTRANS_INERROR	PGTransactionStatusType.PQTRANS_INERROR		100
+nim	PQTRANS_UNKNOWN	query_builder/libs/postgres/postgres_rdb.html#PQTRANS_UNKNOWN	PGTransactionStatusType.PQTRANS_UNKNOWN		100
+nim	PGTransactionStatusType	query_builder/libs/postgres/postgres_rdb.html#PGTransactionStatusType	enum PGTransactionStatusType		100
+nim	PPGVerbosity	query_builder/libs/postgres/postgres_rdb.html#PPGVerbosity	type PPGVerbosity		103
+nim	PQERRORS_TERSE	query_builder/libs/postgres/postgres_rdb.html#PQERRORS_TERSE	PGVerbosity.PQERRORS_TERSE		104
+nim	PQERRORS_DEFAULT	query_builder/libs/postgres/postgres_rdb.html#PQERRORS_DEFAULT	PGVerbosity.PQERRORS_DEFAULT		104
+nim	PQERRORS_VERBOSE	query_builder/libs/postgres/postgres_rdb.html#PQERRORS_VERBOSE	PGVerbosity.PQERRORS_VERBOSE		104
+nim	PQERRORS_SQLSTATE	query_builder/libs/postgres/postgres_rdb.html#PQERRORS_SQLSTATE	PGVerbosity.PQERRORS_SQLSTATE		104
+nim	PGVerbosity	query_builder/libs/postgres/postgres_rdb.html#PGVerbosity	enum PGVerbosity		104
+nim	PPGNotify	query_builder/libs/postgres/postgres_rdb.html#PPGNotify	type PPGNotify		106
+nim	pgNotify	query_builder/libs/postgres/postgres_rdb.html#pgNotify	object pgNotify		107
+nim	PQnoticeReceiver	query_builder/libs/postgres/postgres_rdb.html#PQnoticeReceiver	type PQnoticeReceiver		112
+nim	PQnoticeProcessor	query_builder/libs/postgres/postgres_rdb.html#PQnoticeProcessor	type PQnoticeProcessor		113
+nim	Ppqbool	query_builder/libs/postgres/postgres_rdb.html#Ppqbool	type Ppqbool		114
+nim	pqbool	query_builder/libs/postgres/postgres_rdb.html#pqbool	type pqbool		115
+nim	PPQprintOpt	query_builder/libs/postgres/postgres_rdb.html#PPQprintOpt	type PPQprintOpt		116
+nim	PQprintOpt	query_builder/libs/postgres/postgres_rdb.html#PQprintOpt	object PQprintOpt		117
+nim	PPQconninfoOption	query_builder/libs/postgres/postgres_rdb.html#PPQconninfoOption	type PPQconninfoOption		129
+nim	PQconninfoOption	query_builder/libs/postgres/postgres_rdb.html#PQconninfoOption	object PQconninfoOption		130
+nim	PPQArgBlock	query_builder/libs/postgres/postgres_rdb.html#PPQArgBlock	type PPQArgBlock		139
+nim	PQArgBlock	query_builder/libs/postgres/postgres_rdb.html#PQArgBlock	object PQArgBlock		140
+nim	pqinitOpenSSL	query_builder/libs/postgres/postgres_rdb.html#pqinitOpenSSL,int32,int32	proc pqinitOpenSSL(do_ssl: int32; do_crypto: int32)		145
+nim	pqconnectStart	query_builder/libs/postgres/postgres_rdb.html#pqconnectStart,cstring	proc pqconnectStart(conninfo: cstring): PPGconn		147
+nim	pqconnectPoll	query_builder/libs/postgres/postgres_rdb.html#pqconnectPoll,PPGconn	proc pqconnectPoll(conn: PPGconn): PostgresPollingStatusType		149
+nim	pqconnectdb	query_builder/libs/postgres/postgres_rdb.html#pqconnectdb,cstring	proc pqconnectdb(conninfo: cstring): PPGconn		151
+nim	pqsetdbLogin	query_builder/libs/postgres/postgres_rdb.html#pqsetdbLogin,cstring,cstring,cstring,cstring,cstring,cstring,cstring	proc pqsetdbLogin(pghost: cstring; pgport: cstring; pgoptions: cstring;\n             pgtty: cstring; dbName: cstring; login: cstring; pwd: cstring): PPGconn		153
+nim	pqsetdb	query_builder/libs/postgres/postgres_rdb.html#pqsetdb,cstring,cstring,cstring,cstring,cstring	proc pqsetdb(M_PGHOST, M_PGPORT, M_PGOPT, M_PGTTY, M_DBNAME: cstring): PPGconn		156
+nim	pqfinish	query_builder/libs/postgres/postgres_rdb.html#pqfinish,PPGconn	proc pqfinish(conn: PPGconn)		157
+nim	pqconndefaults	query_builder/libs/postgres/postgres_rdb.html#pqconndefaults	proc pqconndefaults(): PPQconninfoOption		158
+nim	pqconninfoFree	query_builder/libs/postgres/postgres_rdb.html#pqconninfoFree,PPQconninfoOption	proc pqconninfoFree(connOptions: PPQconninfoOption)		160
+nim	pqresetStart	query_builder/libs/postgres/postgres_rdb.html#pqresetStart,PPGconn	proc pqresetStart(conn: PPGconn): int32		162
+nim	pqresetPoll	query_builder/libs/postgres/postgres_rdb.html#pqresetPoll,PPGconn	proc pqresetPoll(conn: PPGconn): PostgresPollingStatusType		164
+nim	pqreset	query_builder/libs/postgres/postgres_rdb.html#pqreset,PPGconn	proc pqreset(conn: PPGconn)		166
+nim	pqGetCancel	query_builder/libs/postgres/postgres_rdb.html#pqGetCancel,PPGconn	proc pqGetCancel(conn: PPGconn): PPGcancel		170
+nim	pqFreeCancel	query_builder/libs/postgres/postgres_rdb.html#pqFreeCancel,PPGcancel	proc pqFreeCancel(cancel: PPGcancel)		171
+nim	pqCancel	query_builder/libs/postgres/postgres_rdb.html#pqCancel,PPGcancel,cstring,int32	proc pqCancel(cancel: PPGcancel; errbuf: cstring; errbufsize: int32): int32		172
+nim	pqrequestCancel	query_builder/libs/postgres/postgres_rdb.html#pqrequestCancel,PPGconn	proc pqrequestCancel(conn: PPGconn): int32		174
+nim	pqdb	query_builder/libs/postgres/postgres_rdb.html#pqdb,PPGconn	proc pqdb(conn: PPGconn): cstring		176
+nim	pquser	query_builder/libs/postgres/postgres_rdb.html#pquser,PPGconn	proc pquser(conn: PPGconn): cstring		177
+nim	pqpass	query_builder/libs/postgres/postgres_rdb.html#pqpass,PPGconn	proc pqpass(conn: PPGconn): cstring		178
+nim	pqhost	query_builder/libs/postgres/postgres_rdb.html#pqhost,PPGconn	proc pqhost(conn: PPGconn): cstring		179
+nim	pqport	query_builder/libs/postgres/postgres_rdb.html#pqport,PPGconn	proc pqport(conn: PPGconn): cstring		180
+nim	pqtty	query_builder/libs/postgres/postgres_rdb.html#pqtty,PPGconn	proc pqtty(conn: PPGconn): cstring		181
+nim	pqoptions	query_builder/libs/postgres/postgres_rdb.html#pqoptions,PPGconn	proc pqoptions(conn: PPGconn): cstring		182
+nim	pqstatus	query_builder/libs/postgres/postgres_rdb.html#pqstatus,PPGconn	proc pqstatus(conn: PPGconn): ConnStatusType		184
+nim	pqtransactionStatus	query_builder/libs/postgres/postgres_rdb.html#pqtransactionStatus,PPGconn	proc pqtransactionStatus(conn: PPGconn): PGTransactionStatusType		186
+nim	pqparameterStatus	query_builder/libs/postgres/postgres_rdb.html#pqparameterStatus,PPGconn,cstring	proc pqparameterStatus(conn: PPGconn; paramName: cstring): cstring		188
+nim	pqserverVersion	query_builder/libs/postgres/postgres_rdb.html#pqserverVersion,PPGconn	proc pqserverVersion(conn: PPGconn): int32		190
+nim	pqprotocolVersion	query_builder/libs/postgres/postgres_rdb.html#pqprotocolVersion,PPGconn	proc pqprotocolVersion(conn: PPGconn): int32		192
+nim	pqerrorMessage	query_builder/libs/postgres/postgres_rdb.html#pqerrorMessage,PPGconn	proc pqerrorMessage(conn: PPGconn): cstring		194
+nim	pqsocket	query_builder/libs/postgres/postgres_rdb.html#pqsocket,PPGconn	proc pqsocket(conn: PPGconn): int32		196
+nim	pqbackendPID	query_builder/libs/postgres/postgres_rdb.html#pqbackendPID,PPGconn	proc pqbackendPID(conn: PPGconn): int32		198
+nim	pqconnectionNeedsPassword	query_builder/libs/postgres/postgres_rdb.html#pqconnectionNeedsPassword,PPGconn	proc pqconnectionNeedsPassword(conn: PPGconn): int32		200
+nim	pqconnectionUsedPassword	query_builder/libs/postgres/postgres_rdb.html#pqconnectionUsedPassword,PPGconn	proc pqconnectionUsedPassword(conn: PPGconn): int32		202
+nim	pqclientEncoding	query_builder/libs/postgres/postgres_rdb.html#pqclientEncoding,PPGconn	proc pqclientEncoding(conn: PPGconn): int32		204
+nim	pqsetClientEncoding	query_builder/libs/postgres/postgres_rdb.html#pqsetClientEncoding,PPGconn,cstring	proc pqsetClientEncoding(conn: PPGconn; encoding: cstring): int32		206
+nim	pqsetErrorVerbosity	query_builder/libs/postgres/postgres_rdb.html#pqsetErrorVerbosity,PPGconn,PGVerbosity	proc pqsetErrorVerbosity(conn: PPGconn; verbosity: PGVerbosity): PGVerbosity		212
+nim	pqtrace	query_builder/libs/postgres/postgres_rdb.html#pqtrace,PPGconn,File	proc pqtrace(conn: PPGconn; debug_port: File)		214
+nim	pquntrace	query_builder/libs/postgres/postgres_rdb.html#pquntrace,PPGconn	proc pquntrace(conn: PPGconn)		216
+nim	pqsetNoticeReceiver	query_builder/libs/postgres/postgres_rdb.html#pqsetNoticeReceiver,PPGconn,PQnoticeReceiver,pointer	proc pqsetNoticeReceiver(conn: PPGconn; theProc: PQnoticeReceiver; arg: pointer): PQnoticeReceiver		217
+nim	pqsetNoticeProcessor	query_builder/libs/postgres/postgres_rdb.html#pqsetNoticeProcessor,PPGconn,PQnoticeProcessor,pointer	proc pqsetNoticeProcessor(conn: PPGconn; theProc: PQnoticeProcessor; arg: pointer): PQnoticeProcessor		219
+nim	pqexec	query_builder/libs/postgres/postgres_rdb.html#pqexec,PPGconn,cstring	proc pqexec(conn: PPGconn; query: cstring): PPGresult		222
+nim	pqexecParams	query_builder/libs/postgres/postgres_rdb.html#pqexecParams,PPGconn,cstring,int32,POid,cstringArray,ptr.int32,ptr.int32,int32	proc pqexecParams(conn: PPGconn; command: cstring; nParams: int32; paramTypes: POid;\n             paramValues: cstringArray; paramLengths, paramFormats: ptr int32;\n             resultFormat: int32): PPGresult		224
+nim	pqprepare	query_builder/libs/postgres/postgres_rdb.html#pqprepare,PPGconn,cstring,cstring,int32,POid	proc pqprepare(conn: PPGconn; stmtName, query: cstring; nParams: int32;\n          paramTypes: POid): PPGresult		228
+nim	pqexecPrepared	query_builder/libs/postgres/postgres_rdb.html#pqexecPrepared,PPGconn,cstring,int32,cstringArray,ptr.int32,ptr.int32,int32	proc pqexecPrepared(conn: PPGconn; stmtName: cstring; nParams: int32;\n               paramValues: cstringArray; paramLengths, paramFormats: ptr int32;\n               resultFormat: int32): PPGresult		230
+nim	pqsendQuery	query_builder/libs/postgres/postgres_rdb.html#pqsendQuery,PPGconn,cstring	proc pqsendQuery(conn: PPGconn; query: cstring): int32		234
+nim	pqsendQueryParams	query_builder/libs/postgres/postgres_rdb.html#pqsendQueryParams,PPGconn,cstring,int32,POid,cstringArray,ptr.int32,ptr.int32,int32	proc pqsendQueryParams(conn: PPGconn; command: cstring; nParams: int32;\n                  paramTypes: POid; paramValues: cstringArray;\n                  paramLengths, paramFormats: ptr int32; resultFormat: int32): int32		237
+nim	pqsendPrepare	query_builder/libs/postgres/postgres_rdb.html#pqsendPrepare,PPGconn,cstring,cstring,int32,POid	proc pqsendPrepare(conn: PPGconn; stmtName: cstring; query: cstring; nParams: int32;\n              paramTypes: POid): int32		242
+nim	pqsendQueryPrepared	query_builder/libs/postgres/postgres_rdb.html#pqsendQueryPrepared,PPGconn,cstring,int32,cstringArray,ptr.int32,ptr.int32,int32	proc pqsendQueryPrepared(conn: PPGconn; stmtName: cstring; nParams: int32;\n                    paramValues: cstringArray;\n                    paramLengths, paramFormats: ptr int32; resultFormat: int32): int32		245
+nim	pqSetSingleRowMode	query_builder/libs/postgres/postgres_rdb.html#pqSetSingleRowMode,PPGconn	proc pqSetSingleRowMode(conn: PPGconn): int32		250
+nim	pqgetResult	query_builder/libs/postgres/postgres_rdb.html#pqgetResult,PPGconn	proc pqgetResult(conn: PPGconn): PPGresult		253
+nim	pqisBusy	query_builder/libs/postgres/postgres_rdb.html#pqisBusy,PPGconn	proc pqisBusy(conn: PPGconn): int32		255
+nim	pqconsumeInput	query_builder/libs/postgres/postgres_rdb.html#pqconsumeInput,PPGconn	proc pqconsumeInput(conn: PPGconn): int32		257
+nim	pqnotifies	query_builder/libs/postgres/postgres_rdb.html#pqnotifies,PPGconn	proc pqnotifies(conn: PPGconn): PPGNotify		259
+nim	pqputCopyData	query_builder/libs/postgres/postgres_rdb.html#pqputCopyData,PPGconn,cstring,int32	proc pqputCopyData(conn: PPGconn; buffer: cstring; nbytes: int32): int32		261
+nim	pqputCopyEnd	query_builder/libs/postgres/postgres_rdb.html#pqputCopyEnd,PPGconn,cstring	proc pqputCopyEnd(conn: PPGconn; errormsg: cstring): int32		263
+nim	pqgetCopyData	query_builder/libs/postgres/postgres_rdb.html#pqgetCopyData,PPGconn,cstringArray,int32	proc pqgetCopyData(conn: PPGconn; buffer: cstringArray; async: int32): int32		265
+nim	pqgetline	query_builder/libs/postgres/postgres_rdb.html#pqgetline,PPGconn,cstring,int32	proc pqgetline(conn: PPGconn; str: cstring; len: int32): int32		267
+nim	pqputline	query_builder/libs/postgres/postgres_rdb.html#pqputline,PPGconn,cstring	proc pqputline(conn: PPGconn; str: cstring): int32		269
+nim	pqgetlineAsync	query_builder/libs/postgres/postgres_rdb.html#pqgetlineAsync,PPGconn,cstring,int32	proc pqgetlineAsync(conn: PPGconn; buffer: cstring; bufsize: int32): int32		271
+nim	pqputnbytes	query_builder/libs/postgres/postgres_rdb.html#pqputnbytes,PPGconn,cstring,int32	proc pqputnbytes(conn: PPGconn; buffer: cstring; nbytes: int32): int32		273
+nim	pqendcopy	query_builder/libs/postgres/postgres_rdb.html#pqendcopy,PPGconn	proc pqendcopy(conn: PPGconn): int32		275
+nim	pqsetnonblocking	query_builder/libs/postgres/postgres_rdb.html#pqsetnonblocking,PPGconn,int32	proc pqsetnonblocking(conn: PPGconn; arg: int32): int32		277
+nim	pqisnonblocking	query_builder/libs/postgres/postgres_rdb.html#pqisnonblocking,PPGconn	proc pqisnonblocking(conn: PPGconn): int32		279
+nim	pqflush	query_builder/libs/postgres/postgres_rdb.html#pqflush,PPGconn	proc pqflush(conn: PPGconn): int32		281
+nim	pqfn	query_builder/libs/postgres/postgres_rdb.html#pqfn,PPGconn,int32,ptr.int32,ptr.int32,int32,PPQArgBlock,int32	proc pqfn(conn: PPGconn; fnid: int32; result_buf, result_len: ptr int32;\n     result_is_int: int32; args: PPQArgBlock; nargs: int32): PPGresult		282
+nim	pqresultStatus	query_builder/libs/postgres/postgres_rdb.html#pqresultStatus,PPGresult	proc pqresultStatus(res: PPGresult): ExecStatusType		285
+nim	pqresStatus	query_builder/libs/postgres/postgres_rdb.html#pqresStatus,ExecStatusType	proc pqresStatus(status: ExecStatusType): cstring		287
+nim	pqresultErrorMessage	query_builder/libs/postgres/postgres_rdb.html#pqresultErrorMessage,PPGresult	proc pqresultErrorMessage(res: PPGresult): cstring		289
+nim	pqresultErrorField	query_builder/libs/postgres/postgres_rdb.html#pqresultErrorField,PPGresult,int32	proc pqresultErrorField(res: PPGresult; fieldcode: int32): cstring		291
+nim	pqntuples	query_builder/libs/postgres/postgres_rdb.html#pqntuples,PPGresult	proc pqntuples(res: PPGresult): int32		293
+nim	pqnfields	query_builder/libs/postgres/postgres_rdb.html#pqnfields,PPGresult	proc pqnfields(res: PPGresult): int32		295
+nim	pqbinaryTuples	query_builder/libs/postgres/postgres_rdb.html#pqbinaryTuples,PPGresult	proc pqbinaryTuples(res: PPGresult): int32		297
+nim	pqfname	query_builder/libs/postgres/postgres_rdb.html#pqfname,PPGresult,int32	proc pqfname(res: PPGresult; field_num: int32): cstring		299
+nim	pqfnumber	query_builder/libs/postgres/postgres_rdb.html#pqfnumber,PPGresult,cstring	proc pqfnumber(res: PPGresult; field_name: cstring): int32		301
+nim	pqftable	query_builder/libs/postgres/postgres_rdb.html#pqftable,PPGresult,int32	proc pqftable(res: PPGresult; field_num: int32): Oid		303
+nim	pqftablecol	query_builder/libs/postgres/postgres_rdb.html#pqftablecol,PPGresult,int32	proc pqftablecol(res: PPGresult; field_num: int32): int32		305
+nim	pqfformat	query_builder/libs/postgres/postgres_rdb.html#pqfformat,PPGresult,int32	proc pqfformat(res: PPGresult; field_num: int32): int32		307
+nim	pqftype	query_builder/libs/postgres/postgres_rdb.html#pqftype,PPGresult,int32	proc pqftype(res: PPGresult; field_num: int32): Oid		309
+nim	pqfsize	query_builder/libs/postgres/postgres_rdb.html#pqfsize,PPGresult,int32	proc pqfsize(res: PPGresult; field_num: int32): int32		311
+nim	pqfmod	query_builder/libs/postgres/postgres_rdb.html#pqfmod,PPGresult,int32	proc pqfmod(res: PPGresult; field_num: int32): int32		313
+nim	pqcmdStatus	query_builder/libs/postgres/postgres_rdb.html#pqcmdStatus,PPGresult	proc pqcmdStatus(res: PPGresult): cstring		315
+nim	pqoidStatus	query_builder/libs/postgres/postgres_rdb.html#pqoidStatus,PPGresult	proc pqoidStatus(res: PPGresult): cstring		317
+nim	pqoidValue	query_builder/libs/postgres/postgres_rdb.html#pqoidValue,PPGresult	proc pqoidValue(res: PPGresult): Oid		319
+nim	pqcmdTuples	query_builder/libs/postgres/postgres_rdb.html#pqcmdTuples,PPGresult	proc pqcmdTuples(res: PPGresult): cstring		321
+nim	pqgetvalue	query_builder/libs/postgres/postgres_rdb.html#pqgetvalue,PPGresult,int32,int32	proc pqgetvalue(res: PPGresult; tup_num: int32; field_num: int32): cstring		323
+nim	pqgetlength	query_builder/libs/postgres/postgres_rdb.html#pqgetlength,PPGresult,int32,int32	proc pqgetlength(res: PPGresult; tup_num: int32; field_num: int32): int32		325
+nim	pqgetisnull	query_builder/libs/postgres/postgres_rdb.html#pqgetisnull,PPGresult,int32,int32	proc pqgetisnull(res: PPGresult; tup_num: int32; field_num: int32): int32		327
+nim	pqclear	query_builder/libs/postgres/postgres_rdb.html#pqclear,PPGresult	proc pqclear(res: PPGresult)		329
+nim	pqfreemem	query_builder/libs/postgres/postgres_rdb.html#pqfreemem,pointer	proc pqfreemem(p: pointer)		330
+nim	pqmakeEmptyPGresult	query_builder/libs/postgres/postgres_rdb.html#pqmakeEmptyPGresult,PPGconn,ExecStatusType	proc pqmakeEmptyPGresult(conn: PPGconn; status: ExecStatusType): PPGresult		331
+nim	pqescapeString	query_builder/libs/postgres/postgres_rdb.html#pqescapeString,cstring,cstring,int	proc pqescapeString(till, from: cstring; len: int): int		333
+nim	pqescapeBytea	query_builder/libs/postgres/postgres_rdb.html#pqescapeBytea,cstring,int,int	proc pqescapeBytea(bintext: cstring; binlen: int; bytealen: var int): cstring		335
+nim	pqunescapeBytea	query_builder/libs/postgres/postgres_rdb.html#pqunescapeBytea,cstring,int	proc pqunescapeBytea(strtext: cstring; retbuflen: var int): cstring		337
+nim	pqprint	query_builder/libs/postgres/postgres_rdb.html#pqprint,File,PPGresult,PPQprintOpt	proc pqprint(fout: File; res: PPGresult; ps: PPQprintOpt)		339
+nim	pqdisplayTuples	query_builder/libs/postgres/postgres_rdb.html#pqdisplayTuples,PPGresult,File,int32,cstring,int32,int32	proc pqdisplayTuples(res: PPGresult; fp: File; fillAlign: int32; fieldSep: cstring;\n                printHeader: int32; quiet: int32)		341
+nim	pqprintTuples	query_builder/libs/postgres/postgres_rdb.html#pqprintTuples,PPGresult,File,int32,int32,int32	proc pqprintTuples(res: PPGresult; fout: File; printAttName: int32;\n              terseOutput: int32; width: int32)		344
+nim	lo_open	query_builder/libs/postgres/postgres_rdb.html#lo_open,PPGconn,Oid,int32	proc lo_open(conn: PPGconn; lobjId: Oid; mode: int32): int32		347
+nim	lo_close	query_builder/libs/postgres/postgres_rdb.html#lo_close,PPGconn,int32	proc lo_close(conn: PPGconn; fd: int32): int32		349
+nim	lo_read	query_builder/libs/postgres/postgres_rdb.html#lo_read,PPGconn,int32,cstring,int	proc lo_read(conn: PPGconn; fd: int32; buf: cstring; length: int): int32		351
+nim	lo_write	query_builder/libs/postgres/postgres_rdb.html#lo_write,PPGconn,int32,cstring,int	proc lo_write(conn: PPGconn; fd: int32; buf: cstring; length: int): int32		353
+nim	lo_lseek	query_builder/libs/postgres/postgres_rdb.html#lo_lseek,PPGconn,int32,int32,int32	proc lo_lseek(conn: PPGconn; fd: int32; offset: int32; whence: int32): int32		355
+nim	lo_creat	query_builder/libs/postgres/postgres_rdb.html#lo_creat,PPGconn,int32	proc lo_creat(conn: PPGconn; mode: int32): Oid		357
+nim	lo_tell	query_builder/libs/postgres/postgres_rdb.html#lo_tell,PPGconn,int32	proc lo_tell(conn: PPGconn; fd: int32): int32		359
+nim	lo_unlink	query_builder/libs/postgres/postgres_rdb.html#lo_unlink,PPGconn,Oid	proc lo_unlink(conn: PPGconn; lobjId: Oid): int32		361
+nim	lo_import	query_builder/libs/postgres/postgres_rdb.html#lo_import,PPGconn,cstring	proc lo_import(conn: PPGconn; filename: cstring): Oid		363
+nim	lo_export	query_builder/libs/postgres/postgres_rdb.html#lo_export,PPGconn,Oid,cstring	proc lo_export(conn: PPGconn; lobjId: Oid; filename: cstring): int32		365
+nim	pqmblen	query_builder/libs/postgres/postgres_rdb.html#pqmblen,cstring,int32	proc pqmblen(s: cstring; encoding: int32): int32		367
+nim	pqenv2encoding	query_builder/libs/postgres/postgres_rdb.html#pqenv2encoding	proc pqenv2encoding(): int32		369

clients/nim-allographer/docs/v2/query_builder/libs/sqlite/sqlite_impl.html

@@ -0,0 +1,277 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--  This file is generated by Nim. -->
+<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>src/allographer/query_builder/libs/sqlite/sqlite_impl</title>
+
+<!-- Google fonts -->
+<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
+<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
+
+<!-- Favicon -->
+<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
+<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
+
+<!-- CSS -->
+<link rel="stylesheet" type="text/css" href="../../../nimdoc.out.css?v=2.2.8">
+
+<!-- JS -->
+<script type="text/javascript" src="../../../dochack.js?v=2.2.8"></script>
+</head>
+<body>
+  <div class="document" id="documentId">
+    <div class="container">
+      <h1 class="title">src/allographer/query_builder/libs/sqlite/sqlite_impl</h1>
+      <div class="row">
+  <div class="three columns">
+    <div class="theme-select-wrapper">
+      <label for="theme-select">Theme:&nbsp;</label>
+      <select id="theme-select" onchange="setTheme(this.value)">
+        <option value="auto">🌗 Match OS</option>
+        <option value="dark">🌑 Dark</option>
+        <option value="light">🌕 Light</option>
+      </select>
+    </div>
+    <div id="global-links">
+      <ul class="simple">
+        <li><a id="indexLink" href="../../../theindex.html">Index</a></li>
+      </ul>
+    </div>
+    <div id="searchInputDiv">
+      Search: <input type="search" id="searchInput" oninput="search()"/>
+    </div>
+    <div>
+      Group by:
+      <select onchange="groupBy(this.value)">
+        <option value="section">Section</option>
+        <option value="type">Type</option>
+      </select>
+    </div>
+    <ul class="simple simple-toc" id="toc-list">
+  <li>
+  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
+</li>
+<li>
+  <details open>
+    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
+    <ul class="simple simple-toc-section">
+      <ul class="simple nested-toc-section">exec
+  <li><a class="reference" href="#exec%2CPSqlite3%2Cstring%2CJsonNode%2Cseq%5B%5D%2Cint" title="exec(db: PSqlite3; query: string; args: JsonNode;
+     columns: seq[(string, string)]; timeout: int): owned(Future[void])">exec(db: PSqlite3; query: string; args: JsonNode;
+     columns: seq[(string, string)]; timeout: int): owned(Future[void])</a></li>
+<li><a class="reference" href="#exec%2CPSqlite3%2Cstring%2CJsonNode%2Cint" title="exec(db: PSqlite3; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])">exec(db: PSqlite3; query: string; args: JsonNode; timeout: int): owned(
+    Future[void])</a></li>
+<li><a class="reference" href="#exec%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint" title="exec(db: PSqlite3; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])">exec(db: PSqlite3; query: string; args: seq[string]; timeout: int): owned(
+    Future[void])</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">getColumns
+  <li><a class="reference" href="#getColumns%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint" title="getColumns(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]">getColumns(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[
+    seq[string]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">getColumnTypes
+  <li><a class="reference" href="#getColumnTypes%2CPSqlite3%2Cstring" title="getColumnTypes(db: PSqlite3; query: string): Future[seq[(string, string)]]">getColumnTypes(db: PSqlite3; query: string): Future[seq[(string, string)]]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">prepare
+  <li><a class="reference" href="#prepare%2CPSqlite3%2Cstring%2Cint" title="prepare(db: PSqlite3; query: string; timeout: int): Future[PStmt]">prepare(db: PSqlite3; query: string; timeout: int): Future[PStmt]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">preparedExec
+  <li><a class="reference" href="#preparedExec%2CPSqlite3%2Cseq%5Bstring%5D%2CPStmt" title="preparedExec(db: PSqlite3; args: seq[string] = @[]; sqliteStmt: PStmt): owned(
+    Future[void])">preparedExec(db: PSqlite3; args: seq[string] = @[]; sqliteStmt: PStmt): owned(
+    Future[void])</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">preparedQuery
+  <li><a class="reference" href="#preparedQuery%2CPSqlite3%2Cseq%5Bstring%5D%2CPStmt" title="preparedQuery(db: PSqlite3; args: seq[string] = @[]; sqliteStmt: PStmt): Future[
+    (seq[Row], DbRows)]">preparedQuery(db: PSqlite3; args: seq[string] = @[]; sqliteStmt: PStmt): Future[
+    (seq[Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">query
+  <li><a class="reference" href="#query%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint" title="query(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[
+    (seq[Row], DbRows)]">query(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[
+    (seq[Row], DbRows)]</a></li>
+
+</ul>
+<ul class="simple nested-toc-section">queryPlain
+  <li><a class="reference" href="#queryPlain%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint" title="queryPlain(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[
+    seq[Row]]">queryPlain(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[
+    seq[Row]]</a></li>
+
+</ul>
+
+    </ul>
+  </details>
+</li>
+
+</ul>
+
+  </div>
+  <div class="nine columns" id="content">
+    
+    <div id="tocRoot"></div>
+    
+    <p class="module-desc"></p>
+    <div class="section" id="6">
+  <h1><a class="toc-backref" href="#6">Imports</a></h1>
+  <dl class="item">
+    <a class="reference external" href="../../models/database_types.html">../../models/database_types</a>, <a class="reference external" href="sqlite_rdb.html">sqlite_rdb</a>, <a class="reference external" href="sqlite_lib.html">sqlite_lib</a>
+  </dl>
+</div>
+<div class="section" id="12">
+  <h1><a class="toc-backref" href="#12">Procs</a></h1>
+  <dl class="item">
+    <div id="exec-procs-all">
+  <div id="exec,PSqlite3,string,JsonNode,seq[],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPSqlite3%2Cstring%2CJsonNode%2Cseq%5B%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span>
+          <span class="Identifier">columns</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Other">(</span><span class="Identifier">string</span><span class="Other">,</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span><span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">KeyError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    args is <tt class="docutils literal"><span class="pre"><span class="Identifier">JArray</span></span></tt>
+    
+  </dd>
+</div>
+<div id="exec,PSqlite3,string,JsonNode,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPSqlite3%2Cstring%2CJsonNode%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">JsonNode</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    used for rdb.raw().exec() args are <tt class="docutils literal"><span class="pre"><span class="Identifier">JArray</span></span></tt>
+    
+  </dd>
+</div>
+<div id="exec,PSqlite3,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#exec%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">exec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    Not used anymore
+    
+  </dd>
+</div>
+
+</div>
+<div id="getColumns-procs-all">
+  <div id="getColumns,PSqlite3,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#getColumns%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">getColumns</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="getColumnTypes-procs-all">
+  <div id="getColumnTypes,PSqlite3,string">
+  <dt><pre><span class="Keyword">proc</span> <a href="#getColumnTypes%2CPSqlite3%2Cstring"><span class="Identifier">getColumnTypes</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">seq</span><span class="Other">[</span><span class="Other">(</span><span class="Identifier">string</span><span class="Other">,</span> <span class="Identifier">string</span><span class="Other">)</span><span class="Other">]</span><span class="Other">]</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">,</span> <span class="Identifier">ReadDbEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="prepare-procs-all">
+  <div id="prepare,PSqlite3,string,int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#prepare%2CPSqlite3%2Cstring%2Cint"><span class="Identifier">prepare</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span><a href="sqlite_rdb.html#PStmt"><span class="Identifier">PStmt</span></a><span class="Other">]</span> {.
+    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="preparedExec-procs-all">
+  <div id="preparedExec,PSqlite3,seq[string],PStmt">
+  <dt><pre><span class="Keyword">proc</span> <a href="#preparedExec%2CPSqlite3%2Cseq%5Bstring%5D%2CPStmt"><span class="Identifier">preparedExec</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span> <span class="Other">=</span> <span class="Operator">@</span><span class="Other">[</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">sqliteStmt</span><span class="Other">:</span> <a href="sqlite_rdb.html#PStmt"><span class="Identifier">PStmt</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span><span class="Other">(</span>
+    <span class="Identifier">Future</span><span class="Other">[</span><span class="Identifier">void</span><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span>
+                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="preparedQuery-procs-all">
+  <div id="preparedQuery,PSqlite3,seq[string],PStmt">
+  <dt><pre><span class="Keyword">proc</span> <a href="#preparedQuery%2CPSqlite3%2Cseq%5Bstring%5D%2CPStmt"><span class="Identifier">preparedQuery</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span> <span class="Other">=</span> <span class="Operator">@</span><span class="Other">[</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">sqliteStmt</span><span class="Other">:</span> <a href="sqlite_rdb.html#PStmt"><span class="Identifier">PStmt</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                          <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span>
+    <span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">,</span> <span class="Identifier">ReadDbEffect</span><span class="Other">,</span> <span class="Identifier">WriteDbEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="query-procs-all">
+  <div id="query,PSqlite3,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#query%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">query</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Other">(</span><span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">,</span> <a href="../../models/database_types.html#DbRows"><span class="Identifier">DbRows</span></a><span class="Other">)</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span>
+                          <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                          <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">,</span> <span class="Identifier">ReadDbEffect</span><span class="Other">]</span><span class="Other">,</span>
+                          <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+<div id="queryPlain-procs-all">
+  <div id="queryPlain,PSqlite3,string,seq[string],int">
+  <dt><pre><span class="Keyword">proc</span> <a href="#queryPlain%2CPSqlite3%2Cstring%2Cseq%5Bstring%5D%2Cint"><span class="Identifier">queryPlain</span></a><span class="Other">(</span><span class="Identifier">db</span><span class="Other">:</span> <a href="sqlite_rdb.html#PSqlite3"><span class="Identifier">PSqlite3</span></a><span class="Other">;</span> <span class="Identifier">query</span><span class="Other">:</span> <span class="Identifier">string</span><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <span class="Identifier">seq</span><span class="Other">[</span><span class="Identifier">string</span><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">timeout</span><span class="Other">:</span> <span class="Identifier">int</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">Future</span><span class="Other">[</span>
+    <span class="Identifier">seq</span><span class="Other">[</span><a href="../../models/database_types.html#Row"><span class="Identifier">Row</span></a><span class="Other">]</span><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">stackTrace</span><span class="Other">:</span> <span class="DecNumber">false</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">Exception</span><span class="Other">,</span> <span class="Identifier">ValueError</span><span class="Other">,</span> <span class="Identifier">DbError</span><span class="Other">]</span><span class="Other">,</span>
+                <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">RootEffect</span><span class="Other">,</span> <span class="Identifier">TimeEffect</span><span class="Other">,</span> <span class="Identifier">ReadDbEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
+  <dd>
+    
+    
+    
+  </dd>
+</div>
+
+</div>
+
+  </dl>
+</div>
+
+  </div>
+</div>
+
+      <div class="twelve-columns footer">
+        <span class="nim-sprite"></span>
+        <br>
+        <small style="color: var(--hint);">Made with Nim. Generated: 2026-03-24 13:25:33 UTC</small>
+      </div>
+    </div>
+  </div>
+  
+</body>
+</html>

clients/nim-allographer/docs/v2/query_builder/libs/sqlite/sqlite_impl.idx

@@ -0,0 +1,12 @@
+nimTitle	sqlite_impl	query_builder/libs/sqlite/sqlite_impl.html	module src/allographer/query_builder/libs/sqlite/sqlite_impl		0
+nim	query	query_builder/libs/sqlite/sqlite_impl.html#query,PSqlite3,string,seq[string],int	proc query(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[\n    (seq[Row], DbRows)]		9
+nim	queryPlain	query_builder/libs/sqlite/sqlite_impl.html#queryPlain,PSqlite3,string,seq[string],int	proc queryPlain(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[\n    seq[Row]]		22
+nim	getColumnTypes	query_builder/libs/sqlite/sqlite_impl.html#getColumnTypes,PSqlite3,string	proc getColumnTypes(db: PSqlite3; query: string): Future[seq[(string, string)]]		34
+nim	exec	query_builder/libs/sqlite/sqlite_impl.html#exec,PSqlite3,string,JsonNode,seq[],int	proc exec(db: PSqlite3; query: string; args: JsonNode;\n     columns: seq[(string, string)]; timeout: int): owned(Future[void])		43
+nim	exec	query_builder/libs/sqlite/sqlite_impl.html#exec,PSqlite3,string,JsonNode,int	proc exec(db: PSqlite3; query: string; args: JsonNode; timeout: int): owned(\n    Future[void])		96
+nim	exec	query_builder/libs/sqlite/sqlite_impl.html#exec,PSqlite3,string,seq[string],int	proc exec(db: PSqlite3; query: string; args: seq[string]; timeout: int): owned(\n    Future[void])		137
+nim	getColumns	query_builder/libs/sqlite/sqlite_impl.html#getColumns,PSqlite3,string,seq[string],int	proc getColumns(db: PSqlite3; query: string; args: seq[string]; timeout: int): Future[\n    seq[string]]		155
+nim	prepare	query_builder/libs/sqlite/sqlite_impl.html#prepare,PSqlite3,string,int	proc prepare(db: PSqlite3; query: string; timeout: int): Future[PStmt]		161
+nim	preparedQuery	query_builder/libs/sqlite/sqlite_impl.html#preparedQuery,PSqlite3,seq[string],PStmt	proc preparedQuery(db: PSqlite3; args: seq[string] = @[]; sqliteStmt: PStmt): Future[\n    (seq[Row], DbRows)]		167
+nim	preparedExec	query_builder/libs/sqlite/sqlite_impl.html#preparedExec,PSqlite3,seq[string],PStmt	proc preparedExec(db: PSqlite3; args: seq[string] = @[]; sqliteStmt: PStmt): owned(\n    Future[void])		185
+nimgrp	exec	query_builder/libs/sqlite/sqlite_impl.html#exec-procs-all	proc		43