tempest-db-js 0.8.0 → 0.9.0

package/README.md

@@ -77,6 +77,14 @@ Typed extras, each with a [docs recipe](https://mauriciobenjamin700.github.io/te
 - **Active-record (opt-in)** — `activeRecord(User, session)` → `save`/`update`/`delete`/`reload` over `.data`; the plain-object default is unchanged.
 - **Query logging & errors** — `createEngine(url, { onQuery })` traces every statement; a failed statement throws `QueryExecutionError` carrying the SQL + params. `{ onNotice }` routes PostgreSQL notices to your logger instead of the driver printing them into your stdout, and `{ driverOptions }` passes through whatever the typed surface does not model.
 - **SQLite driver choice** — `node:sqlite` by default (nothing to install); `{ driver: "better-sqlite3" }` or `sqlite+better-sqlite3:///app.db` switches to the optional peer dependency, same rows and same coercion. An unknown driver name throws instead of being ignored.
+- **Model mixins** — `withTimestamps` / `withSoftDelete` / `withAudit` declare the columns every table repeats once, as real columns (they reach `InferModel`, the migration IR and the DDL).
+- **Cursor pagination** — `repo.cursorPaginate({ cursor, limit, orderBy })`: no `COUNT(*)`, a boundary that survives concurrent inserts, and the primary key appended as a tie-break so no row falls between pages.
+- **Query surface** — CTEs (`cte` / `cteRecursive`, for walking a tree in one statement), window functions through `select().compute({ rank: over(rowNumber(), …) })`, set operations (`union`/`intersect`/`except`) with branch shapes checked at compile time, `exists`/`scalar` subqueries, `caseWhen`/`cast`, and writes that read another table (`insert().fromSelect`, `update().from`, `del().using`).
+- **Text search** — `contains(["name", "email"], term)` tokenizes and **escapes** what the user typed (a raw `ilike` turns `100%` into "everything"), and `fullText`/`fullTextRank` use PostgreSQL's `to_tsvector`/`ts_rank`, falling back to substring matching elsewhere.
+- **`parseIntegrityError`** — reads the driver's error back into `{ violation, constraint, columns }`, so `409 {"code":"EMAIL_TAKEN","field":"email"}` does not need a regex per service.
+- **Repository signals, audit and multi-tenancy** — `onSignal(Model, "postSave", …)` (a throwing `preSave` vetoes the write), an append-only audit trail with a before/after diff written in the change's own transaction, and `TenantScopedRepository`, which injects the tenant into every read and stamps it on every write.
+- **Transactional outbox** — `outboxModel(...)` plus a relay (`claim`/`markSent`/`markFailed`) whose concurrent workers take disjoint batches.
+- **Unit of work (opt-in)** — `session.unitOfWork()` gives an identity map and a batched `flush()`; the plain-object default is unchanged.
 - **Durable queues** — `select(Job).where(...).limit(10).forUpdate({ skipLocked: true })` inside a transaction hands each worker a disjoint batch, and `set({ attempts: sql.raw("attempts + 1") })` increments in the database instead of read-modify-write. SQLite throws rather than emitting an unlocked `SELECT`.
 - **Partial-index upsert** — `onConflictDoNothing(["consumer", "idempotencyKey"], { where: { idempotencyKey: { isNull: false } } })` repeats the index predicate PostgreSQL requires to match a **partial** unique index as a conflict target.
 - **Column names** — `.name("consumer_name")` per column, or `static naming = "snake_case"` per table: a `snake_case` schema behind a `camelCase` model, mapped everywhere including the migration IR (so no false drift).