@b4moss/crudian 0.3.1 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 CRUD abstraction for DDD repositories.
 
-Single npm package with adapter subpaths. Shared contracts live at the package root; concrete backends are imported from subpaths.
+One npm package, adapter subpaths. Shared contracts live at the package root; backends are imported from subpaths. Callers inject their own DB/client — crudian never opens connections or reads env secrets for you.
 
 ## Install
 
@@ -10,15 +10,18 @@ Single npm package with adapter subpaths. Shared contracts live at the package r
 npm install @b4moss/crudian
 ```
 
-Adapter peers (install only what you use):
+Install only the peer deps for the adapter you use:
 
-| Subpath | Peer dependencies |
-|---------|-------------------|
-| `@b4moss/crudian/bun-sqlite` | Bun (`bun:sqlite`) |
-| `@b4moss/crudian/drizzle` | `drizzle-orm`, `better-sqlite3` |
-| `@b4moss/crudian/prisma` | `@prisma/client` |
+| Subpath | Runtime | Sync / async | Peer dependencies |
+|---------|---------|--------------|-------------------|
+| `@b4moss/crudian/bun-sqlite` | Bun | sync | Bun (`bun:sqlite`) |
+| `@b4moss/crudian/drizzle` | Node.js 24+ | sync | `drizzle-orm`, `better-sqlite3` |
+| `@b4moss/crudian/prisma` | Node.js 24+ | async | `@prisma/client` |
+| `@b4moss/crudian/libsql` | Node.js 24+ / Bun | async | `@libsql/client` |
 
-## Usage
+Node must not import `@b4moss/crudian/bun-sqlite` (resolves to an explicit error stub).
+
+## Quick start (adapters)
 
 ### Shared contracts
 
@@ -26,7 +29,7 @@ Adapter peers (install only what you use):
 import { where, CrudianError } from "@b4moss/crudian"
 ```
 
-### Bun (`bun:sqlite`)
+### Bun (`bun:sqlite`) — sync
 
 ```ts
 import { Database } from "bun:sqlite"
@@ -34,15 +37,19 @@ import { createCrud } from "@b4moss/crudian/bun-sqlite"
 import { where } from "@b4moss/crudian"
 
 const db = new Database(":memory:")
+db.exec(`
+  CREATE TABLE items (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    score INTEGER,
+    note TEXT
+  )
+`)
 const crud = createCrud(db)
-
-const row = crud.create("items", { name: "alpha", score: 1 })
-const found = crud.read("items", { where: where().eq("id", row.id) })
+// raw DB is also available as crud.db
 ```
 
-Node.js must not import `@b4moss/crudian/bun-sqlite` (resolves to an explicit error stub).
-
-### Drizzle (better-sqlite3)
+### Drizzle (better-sqlite3) — sync
 
 ```ts
 import Database from "better-sqlite3"
@@ -50,11 +57,17 @@ import { drizzle } from "drizzle-orm/better-sqlite3"
 import { createCrud } from "@b4moss/crudian/drizzle"
 
 const sqlite = new Database(":memory:")
+sqlite.exec(`CREATE TABLE items (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  score INTEGER,
+  note TEXT
+)`)
 const db = drizzle(sqlite)
 const crud = createCrud(db)
 ```
 
-### Prisma (SQLite)
+### Prisma (SQLite) — async
 
 ```ts
 import { PrismaClient } from "@prisma/client"
@@ -66,15 +79,312 @@ const crud = createCrud(client)
 await crud.create("items", { name: "alpha", score: 1 })
 ```
 
-Prisma methods are async. Raw SQL goes through the injected client.
+### libSQL (`@libsql/client`) — async
+
+```ts
+import { createClient } from "@libsql/client"
+import { createCrud } from "@b4moss/crudian/libsql"
+
+const client = createClient({
+  url: process.env.LIBSQL_URL ?? "file:local.db",
+  authToken: process.env.LIBSQL_AUTH_TOKEN, // optional; set for remote hosts
+})
+const crud = createCrud(client)
+
+await crud.create("items", { name: "alpha", score: 1 })
+```
+
+URL / auth token belong on the caller-created client (typically from `.env`).
+
+---
+
+## API reference (all methods)
+
+Examples below use the **sync** Bun adapter. For `prisma` / `libsql`, `await` every call (same shapes).
+
+Assume a table:
+
+```sql
+CREATE TABLE items (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  score INTEGER,
+  note TEXT
+);
+```
+
+```ts
+import { Database } from "bun:sqlite"
+import { createCrud } from "@b4moss/crudian/bun-sqlite"
+import { where } from "@b4moss/crudian"
+
+const db = new Database(":memory:")
+db.exec(/* schema above */)
+const crud = createCrud(db)
+
+type Item = { id: number; name: string; score: number | null; note: string | null }
+```
+
+### `create(table, cols)` → row
+
+Inserts one row and returns it (including generated `id`).
+
+```ts
+const row = crud.create<Item>("items", { name: "alpha", score: 10, note: "n" })
+// { id: 1, name: "alpha", score: 10, note: "n" }
+```
+
+### `read(table, query?)` → row | `null`
+
+Reads one row. Misses return `null` (does not throw).
+
+```ts
+const found = crud.read<Item>("items", {
+  columns: ["id", "name"],
+  where: where().eq("id", row.id),
+})
+// { id: 1, name: "alpha" }
+
+const missing = crud.read<Item>("items", { where: where().eq("id", 999) })
+// null
+```
+
+### `update(table, cols, query)` → row | `null`
+
+Updates matching rows; returns the updated row. Zero matches → `null`. `where` is required.
+
+```ts
+const updated = crud.update<Item>(
+  "items",
+  { score: 9 },
+  { where: where().eq("id", row.id) },
+)
+// { id: 1, name: "alpha", score: 9, note: "n" }
+```
+
+### `delete(table, query)` → number
+
+Deletes matching rows; returns affected count. `where` is required.
+
+```ts
+const deleted = crud.delete("items", { where: where().eq("id", row.id) })
+// 1
+```
+
+### `search(table, query?)` → `{ items, nextCursor, hasMore, total }`
+
+Canonical list API. Cursor pagination on `id` ascending. `total` is the full where-match count (ignores `limit` / `cursor`).
+
+`SearchQuery` fields:
+
+| Field | Meaning |
+|-------|---------|
+| `columns?` | Column list for `SELECT` (same idea as `read`). Omit → `*` |
+| `where?` | Condition builder / node |
+| `limit?` | Page size (default `20`) |
+| `cursor?` | Raw `id` cursor (keyset); rows with `id > cursor` |
+
+```ts
+for (let i = 0; i < 5; i++) {
+  crud.create("items", { name: `n${i}`, score: i })
+}
+
+const page1 = crud.search<Item>("items", { limit: 2 })
+// {
+//   items: [ { id: 1, ... }, { id: 2, ... } ],
+//   nextCursor: 2,
+//   hasMore: true,
+//   total: 5,
+// }
+
+const page2 = crud.search<Item>("items", {
+  limit: 2,
+  cursor: page1.nextCursor,
+})
+// items ids [3, 4], total still 5
+
+const filtered = crud.search<Item>("items", {
+  columns: ["id", "name"],
+  where: where().gte("score", 3),
+  limit: 10,
+})
+// each item is { id, name } only
+```
+
+### `list(table, query?)` → same as `search`
+
+Thin alias of `search` (same `SearchQuery`, including `columns`).
+
+```ts
+const a = crud.list<Item>("items", {
+  columns: ["id", "name"],
+  limit: 10,
+})
+const b = crud.search<Item>("items", {
+  columns: ["id", "name"],
+  limit: 10,
+})
+// a and b are deep-equal
+```
+
+### `count(table, query?)` → number
+
+Where-match count only (`CountQuery` is `{ where? }`). No `limit` / `cursor` / `columns`.
+
+```ts
+crud.count("items") // 5
+crud.count("items", { where: where().eq("name", "n0") }) // 1
+```
+
+### `upsert(table, cols)` → row
+
+Conflict target is primary key `id`. Inserts or updates; returns the row. `id` is required in `cols`.
+
+```ts
+const inserted = crud.upsert<Item>("items", { id: 10, name: "new", score: 1 })
+const again = crud.upsert<Item>("items", { id: 10, name: "upd", score: 9 })
+// again.name === "upd"
+```
+
+### `duplicate(table, query)` → row | `null`
+
+Copies the first matching row (new `id`). Optional `overrides`. Zero matches → `null`. `where` is required.
+
+```ts
+const source = crud.create<Item>("items", { name: "a", score: 1, note: "n" })
+const copy = crud.duplicate<Item>("items", {
+  where: where().eq("id", source.id),
+  overrides: { name: "b" },
+})
+// copy.id !== source.id, copy.name === "b"
+
+const none = crud.duplicate<Item>("items", { where: where().eq("id", 999) })
+// null
+```
+
+### `bulkCreate(table, rows)` → number
+
+Inserts many rows; returns inserted count. Empty array → `0`.
+
+```ts
+const n = crud.bulkCreate("items", [
+  { name: "x", score: 1 },
+  { name: "y", score: 2 },
+])
+// 2
+```
+
+### `bulkUpdate(table, cols, query)` → number
+
+Updates many rows; returns affected count. `where` is required.
+
+```ts
+const n = crud.bulkUpdate(
+  "items",
+  { score: 8 },
+  { where: where().eq("name", "x") },
+)
+// 1
+```
+
+### `bulkDelete(table, query)` → number
+
+Deletes many rows; returns affected count. `where` is required.
+
+```ts
+const n = crud.bulkDelete("items", { where: where().eq("name", "y") })
+// 1
+```
+
+### `bulkUpsert(table, rows)` → number
+
+Upserts many rows (each row needs `id`); returns processed count. Empty array → `0`.
+
+```ts
+const n = crud.bulkUpsert("items", [
+  { id: 100, name: "z", score: 1 },
+  { id: 10, name: "z2", score: 2 },
+])
+// 2
+```
+
+### `transaction(fn)` → `fn` return value
+
+Runs `fn` inside a transaction helper. Crudian does **not** auto-wrap each CRUD call; use this when you need atomic multi-step work. Success commits; throw rolls back.
+
+```ts
+const result = crud.transaction(() => {
+  crud.create("items", { name: "a", score: 1 })
+  crud.create("items", { name: "b", score: 2 })
+  return "ok"
+})
+// result === "ok"; both rows visible afterward
+
+try {
+  crud.transaction(() => {
+    crud.create("items", { name: "c", score: 3 })
+    throw new Error("boom")
+  })
+} catch {
+  // partial writes from that callback are rolled back
+}
+```
+
+Async adapters:
+
+```ts
+await crud.transaction(async () => {
+  await crud.create("items", { name: "a", score: 1 })
+  await crud.create("items", { name: "b", score: 2 })
+})
+```
+
+---
+
+## `where()` builder
+
+```ts
+import { where } from "@b4moss/crudian"
+
+where().eq("name", "alpha")
+where().ne("score", 0)
+where().lt("score", 10)
+where().lte("score", 10)
+where().gt("score", 0)
+where().gte("score", 0)
+where().in("name", ["a", "b"])
+where().like("name", "a%")
+where().isNull("note")
+where().isNotNull("note")
+
+where()
+  .eq("name", "alpha")
+  .and(where().gte("score", 5))
+
+where()
+  .eq("name", "alpha")
+  .or(where().eq("name", "beta"))
+```
+
+Nestable `and` / `or`. Empty `in([])` is rejected.
 
-## API surface
+---
 
-`create` / `read` / `update` / `delete` / `search` / `list` / `upsert` / `duplicate` / `bulkCreate` / `bulkUpdate` / `bulkDelete` / `bulkUpsert` / `transaction`
+## Behavior notes
 
-- `search` is canonical; `list` is an alias
-- Cursor pagination uses `id` ascending; response is `{ items, nextCursor, hasMore }`
-- Conditions use the `where()` builder (`eq` / `ne` / `lt` / `gt` / `lte` / `gte` / `in` / `like` / `isNull` / `isNotNull`, nestable `and` / `or`)
+| Topic | Behavior |
+|-------|----------|
+| Entry | `createCrud(db)` — inject a caller-owned client; exposed as `crud.db` |
+| Sync vs async | `bun-sqlite` / `drizzle` sync; `prisma` / `libsql` return `Promise`s |
+| `read` / `update` / `duplicate` miss | `null` |
+| `delete` / bulk miss | `0` |
+| Upsert conflict | primary key `id` |
+| Pagination | cursor on `id` ASC only (no offset) |
+| `columns` | optional on `read` / `search` / `list`; omit → `*` |
+| `search.total` / `count` | full where count; not page length |
+| Errors | minimal `CrudianError`; other errors propagate from the driver |
+| Identifiers | string required; no format validation |
+| Out of scope | relations, migrations, full-text search, ORM models |
 
 ## License
 

package/dist/bun-sqlite/index.d.ts

@@ -5,5 +5,5 @@
  * Node.js resolves `package.json` exports to `node-stub` instead of this file.
  */
 export { createCrud, type BunSqliteCrud } from "./crud.js";
-export { CrudianError, where, WhereBuilder, type Row, type SearchResult, type SearchQuery, type ReadQuery, } from "../index.js";
+export { CrudianError, where, WhereBuilder, type Row, type SearchResult, type SearchQuery, type CountQuery, type ReadQuery, } from "../index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/bun-sqlite/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bun-sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AAC1D,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,GAAG,EACR,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bun-sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AAC1D,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,GAAG,EACR,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}

package/dist/drizzle/index.d.ts

@@ -3,6 +3,6 @@
  * Import via: `import { createCrud } from "@b4moss/crudian/drizzle"`
  */
 export { createCrud, type DrizzleCrud } from "./crud.js";
-export type { Row, SearchResult, WhereInput, ReadQuery, SearchQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "../types.js";
+export type { Row, SearchResult, WhereInput, ReadQuery, SearchQuery, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "../types.js";
 export { CrudianError, where, WhereBuilder, type Op, type CondNode, type GroupNode, type WhereNode, } from "../index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/drizzle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drizzle/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AACxD,YAAY,EACV,GAAG,EACH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,EAAE,EACP,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drizzle/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AACxD,YAAY,EACV,GAAG,EACH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,EAAE,EACP,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}

package/dist/index.d.ts

@@ -4,8 +4,9 @@
  * - @b4moss/crudian/bun-sqlite
  * - @b4moss/crudian/drizzle
  * - @b4moss/crudian/prisma
+ * - @b4moss/crudian/libsql
  */
 export { CrudianError, assertString } from "./errors.js";
 export { WhereBuilder, where, isWhereBuilder, type Op, type CondNode, type GroupNode, type WhereNode, } from "./where.js";
-export type { Row, SearchResult, WhereInput, ReadQuery, SearchQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "./types.js";
+export type { Row, SearchResult, WhereInput, ReadQuery, SearchQuery, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EACL,YAAY,EACZ,KAAK,EACL,cAAc,EACd,KAAK,EAAE,EACP,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,GAAG,EACH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EACL,YAAY,EACZ,KAAK,EACL,cAAc,EACd,KAAK,EAAE,EACP,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,GAAG,EACH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -4,6 +4,7 @@
  * - @b4moss/crudian/bun-sqlite
  * - @b4moss/crudian/drizzle
  * - @b4moss/crudian/prisma
+ * - @b4moss/crudian/libsql
  */
 export { CrudianError, assertString } from "./errors.js";
 export { WhereBuilder, where, isWhereBuilder, } from "./where.js";

package/dist/libsql/crud.d.ts

@@ -0,0 +1,31 @@
+import { type AsyncSqliteCrud } from "../sqlite/async-crud.js";
+import type { Row } from "../types.js";
+/** Result shape used by the libSQL executor bridge. */
+export type LibsqlResultSet = {
+    rows: Array<Row | unknown>;
+    rowsAffected: number;
+};
+/** Minimal execute surface shared by Client and Transaction. */
+export type LibsqlExecutor = {
+    execute(stmt: {
+        sql: string;
+        args?: unknown[];
+    } | string): Promise<LibsqlResultSet>;
+};
+/** Minimal surface of @libsql/client Client used by the adapter. */
+export type LibsqlLikeClient = LibsqlExecutor & {
+    transaction(mode?: "write" | "read" | "deferred"): Promise<LibsqlLikeTransaction>;
+};
+export type LibsqlLikeTransaction = LibsqlExecutor & {
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    close(): void;
+};
+export type LibsqlCrud = AsyncSqliteCrud<LibsqlLikeClient>;
+/**
+ * Create a Crud bound to a libSQL client (`@libsql/client`).
+ * Methods are async. The injected client is exposed as `crud.db`.
+ * Auth / URL are configured on the caller-created client (e.g. from env).
+ */
+export declare function createCrud(client: LibsqlLikeClient): LibsqlCrud;
+//# sourceMappingURL=crud.d.ts.map

package/dist/libsql/crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/libsql/crud.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAEtC,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CACL,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,MAAM,GAC/C,OAAO,CAAC,eAAe,CAAC,CAAA;CAC5B,CAAA;AAED,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG;IAC9C,WAAW,CACT,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAA;AAa1D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA6C/D"}

package/dist/libsql/crud.js

@@ -0,0 +1,62 @@
+import { CrudianError } from "../index.js";
+import { createAsyncSqliteCrud, } from "../sqlite/async-crud.js";
+function normalizeRow(row) {
+    if (row == null || typeof row !== "object") {
+        throw new CrudianError("expected row object");
+    }
+    const out = { ...row };
+    for (const [k, v] of Object.entries(out)) {
+        if (typeof v === "bigint")
+            out[k] = Number(v);
+    }
+    return out;
+}
+/**
+ * Create a Crud bound to a libSQL client (`@libsql/client`).
+ * Methods are async. The injected client is exposed as `crud.db`.
+ * Auth / URL are configured on the caller-created client (e.g. from env).
+ */
+export function createCrud(client) {
+    if (client == null) {
+        throw new CrudianError("db is required");
+    }
+    if (typeof client !== "object" ||
+        typeof client.execute !== "function" ||
+        typeof client.transaction !== "function") {
+        throw new CrudianError("db must be a libSQL client");
+    }
+    let active = client;
+    return createAsyncSqliteCrud(client, {
+        async run(sql, args = []) {
+            const result = await active.execute({ sql, args });
+            return { changes: Number(result.rowsAffected ?? 0) };
+        },
+        async get(sql, args = []) {
+            const result = await active.execute({ sql, args });
+            const row = result.rows[0];
+            return row == null ? undefined : normalizeRow(row);
+        },
+        async all(sql, args = []) {
+            const result = await active.execute({ sql, args });
+            return result.rows.map((row) => normalizeRow(row));
+        },
+        async transaction(fn) {
+            const tx = await client.transaction("write");
+            const prev = active;
+            active = tx;
+            try {
+                const value = await fn();
+                await tx.commit();
+                return value;
+            }
+            catch (err) {
+                await tx.rollback();
+                throw err;
+            }
+            finally {
+                active = prev;
+                tx.close();
+            }
+        },
+    });
+}

package/dist/libsql/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * libSQL adapter for @b4moss/crudian.
+ * Import via: `import { createCrud } from "@b4moss/crudian/libsql"`
+ */
+export { createCrud, type LibsqlCrud, type LibsqlLikeClient, type LibsqlLikeTransaction, type LibsqlExecutor, type LibsqlResultSet, } from "./crud.js";
+export type { Row, SearchResult, WhereInput, ReadQuery, SearchQuery, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "../types.js";
+export { CrudianError, where, WhereBuilder, type Op, type CondNode, type GroupNode, type WhereNode, } from "../index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/libsql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/libsql/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,UAAU,EACV,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,GAAG,EACH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,EAAE,EACP,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}

package/dist/libsql/index.js

@@ -0,0 +1,6 @@
+/**
+ * libSQL adapter for @b4moss/crudian.
+ * Import via: `import { createCrud } from "@b4moss/crudian/libsql"`
+ */
+export { createCrud, } from "./crud.js";
+export { CrudianError, where, WhereBuilder, } from "../index.js";

package/dist/prisma/crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/prisma/crud.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAA;AAGhC,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC7E,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACtE,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAA;AAU1D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAyC/D"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/prisma/crud.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAA;AAGhC,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC7E,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACtE,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAA;AAU1D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA0C/D"}

package/dist/prisma/crud.js

@@ -29,13 +29,14 @@ export function createCrud(client) {
             return { changes: Number(changes ?? 0) };
         },
         async get(sql, args = []) {
-            const rows = (await active.$queryRawUnsafe(sql, ...args)) ?? [];
+            const result = await active.$queryRawUnsafe(sql, ...args);
+            const rows = normalizeQueryResult(result);
             const row = rows[0];
             return row == null ? undefined : normalizeRow(row);
         },
         async all(sql, args = []) {
-            const rows = (await active.$queryRawUnsafe(sql, ...args)) ?? [];
-            return rows.map(normalizeRow);
+            const result = await active.$queryRawUnsafe(sql, ...args);
+            return normalizeQueryResult(result).map(normalizeRow);
         },
         async transaction(fn) {
             return client.$transaction(async (tx) => {
@@ -51,3 +52,12 @@ export function createCrud(client) {
         },
     });
 }
+function normalizeQueryResult(result) {
+    if (result == null)
+        return [];
+    if (Array.isArray(result))
+        return result;
+    if (typeof result === "object")
+        return [result];
+    return [];
+}

package/dist/prisma/index.d.ts

@@ -3,6 +3,6 @@
  * Import via: `import { createCrud } from "@b4moss/crudian/prisma"`
  */
 export { createCrud, type PrismaCrud, type PrismaLikeClient } from "./crud.js";
-export type { Row, SearchResult, WhereInput, ReadQuery, SearchQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "../types.js";
+export type { Row, SearchResult, WhereInput, ReadQuery, SearchQuery, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "../types.js";
 export { CrudianError, where, WhereBuilder, type Op, type CondNode, type GroupNode, type WhereNode, } from "../index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/prisma/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prisma/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC9E,YAAY,EACV,GAAG,EACH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,EAAE,EACP,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prisma/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC9E,YAAY,EACV,GAAG,EACH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,EAAE,EACP,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}

package/dist/sqlite/async-crud.d.ts

@@ -1,4 +1,4 @@
-import { type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
+import { type CountQuery, type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
 export type AsyncSqliteExecutor = {
     run(sql: string, args?: unknown[]): Promise<{
         changes: number;
@@ -21,6 +21,7 @@ export type AsyncSqliteCrud<TDb> = {
     bulkUpsert(table: string, rows: Record<string, unknown>[]): Promise<number>;
     search<T extends Row = Row>(table: string, query?: SearchQuery): Promise<SearchResult<T>>;
     list<T extends Row = Row>(table: string, query?: SearchQuery): Promise<SearchResult<T>>;
+    count(table: string, query?: CountQuery): Promise<number>;
     transaction<T>(fn: () => Promise<T>): Promise<T>;
 };
 export declare function createAsyncSqliteCrud<TDb>(db: TDb, ex: AsyncSqliteExecutor): AsyncSqliteCrud<TDb>;

package/dist/sqlite/async-crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-crud.d.ts","sourceRoot":"","sources":["../../src/sqlite/async-crud.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AAGpB,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAA;IAC5D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAClD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,GAAG,IAAI;IACjC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAA;IAChB,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAA;IACb,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC9E,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1D,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAA;IACb,SAAS,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACpB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3E,UAAU,CACR,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAAA;IAClB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3E,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3B,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3B,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACjD,CAAA;AAoBD,wBAAgB,qBAAqB,CAAC,GAAG,EACvC,EAAE,EAAE,GAAG,EACP,EAAE,EAAE,mBAAmB,GACtB,eAAe,CAAC,GAAG,CAAC,CAsRtB"}
+{"version":3,"file":"async-crud.d.ts","sourceRoot":"","sources":["../../src/sqlite/async-crud.ts"],"names":[],"mappings":"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"}

package/dist/sqlite/async-crud.js

@@ -32,10 +32,9 @@ export function createAsyncSqliteCrud(db, ex) {
             const colSql = keys.map((k) => quoteIdent(k)).join(", ");
             const placeholders = keys.map(() => "?").join(", ");
             const args = keys.map((k) => cols[k]);
-            await ex.run(`INSERT INTO ${tbl} (${colSql}) VALUES (${placeholders})`, args);
-            const idRow = await ex.get("SELECT last_insert_rowid() AS id");
-            const id = Number(idRow?.id);
-            const row = await ex.get(`SELECT * FROM ${tbl} WHERE "id" = ?`, [id]);
+            // Single-statement insert+fetch avoids last_insert_rowid() across pooled
+            // connections (Prisma SQLite), which can return an empty row after COUNT.
+            const row = await ex.get(`INSERT INTO ${tbl} (${colSql}) VALUES (${placeholders}) RETURNING *`, args);
             return rowFromObject(row);
         },
         async read(table, query = {}) {
@@ -115,11 +114,21 @@ export function createAsyncSqliteCrud(db, ex) {
             const nextCursor = hasMore && last != null && (typeof last.id === "number" || typeof last.id === "string")
                 ? last.id
                 : null;
-            return { items, nextCursor, hasMore };
+            const total = await crud.count(table, { where: query.where });
+            return { items, nextCursor, hasMore, total };
         },
         async list(table, query) {
             return crud.search(table, query);
         },
+        async count(table, query = {}) {
+            assertString(table, "table");
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const sql = `SELECT COUNT(*) AS ${quoteIdent("row_count")} FROM ${tbl}` +
+                (where.sql ? ` WHERE ${where.sql}` : "");
+            const row = await ex.get(sql, where.args);
+            return Number(row?.row_count ?? 0);
+        },
         async upsert(table, cols) {
             assertString(table, "table");
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {

package/dist/sqlite/sync-crud.d.ts

@@ -1,4 +1,4 @@
-import { type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
+import { type CountQuery, type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
 export type SyncSqliteExecutor = {
     run(sql: string, args?: unknown[]): {
         changes: number;
@@ -21,6 +21,7 @@ export type SyncSqliteCrud<TDb> = {
     bulkUpsert(table: string, rows: Record<string, unknown>[]): number;
     search<T extends Row = Row>(table: string, query?: SearchQuery): SearchResult<T>;
     list<T extends Row = Row>(table: string, query?: SearchQuery): SearchResult<T>;
+    count(table: string, query?: CountQuery): number;
     transaction<T>(fn: () => T): T;
 };
 export declare function createSyncSqliteCrud<TDb>(db: TDb, ex: SyncSqliteExecutor): SyncSqliteCrud<TDb>;

package/dist/sqlite/sync-crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-crud.d.ts","sourceRoot":"","sources":["../../src/sqlite/sync-crud.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AAGpB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,SAAS,CAAA;IACnD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,CAAA;IACzC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,GAAG,IAAI;IAChC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAA;IAChB,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAC5E,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,CAAC,GAAG,IAAI,CAAA;IACrE,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,WAAW,GACjB,CAAC,GAAG,IAAI,CAAA;IACX,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAAA;IACjD,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAC5E,SAAS,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,CAAC,GAAG,IAAI,CAAA;IAC9E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAA;IAClE,UAAU,CACR,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,WAAW,GACjB,MAAM,CAAA;IACT,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAAA;IACrD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAA;IAClE,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;IAChF,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;IAC9E,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;CAC/B,CAAA;AAoBD,wBAAgB,oBAAoB,CAAC,GAAG,EACtC,EAAE,EAAE,GAAG,EACP,EAAE,EAAE,kBAAkB,GACrB,cAAc,CAAC,GAAG,CAAC,CA2PrB"}
+{"version":3,"file":"sync-crud.d.ts","sourceRoot":"","sources":["../../src/sqlite/sync-crud.ts"],"names":[],"mappings":"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"}

package/dist/sqlite/sync-crud.js

@@ -115,11 +115,21 @@ export function createSyncSqliteCrud(db, ex) {
             const nextCursor = hasMore && last != null && (typeof last.id === "number" || typeof last.id === "string")
                 ? last.id
                 : null;
-            return { items, nextCursor, hasMore };
+            const total = crud.count(table, { where: query.where });
+            return { items, nextCursor, hasMore, total };
         },
         list(table, query) {
             return crud.search(table, query);
         },
+        count(table, query = {}) {
+            assertString(table, "table");
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const sql = `SELECT COUNT(*) AS ${quoteIdent("row_count")} FROM ${tbl}` +
+                (where.sql ? ` WHERE ${where.sql}` : "");
+            const row = ex.get(sql, where.args);
+            return Number(row?.row_count ?? 0);
+        },
         upsert(table, cols) {
             assertString(table, "table");
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {

package/dist/types.d.ts

@@ -4,6 +4,8 @@ export type SearchResult<T = Row> = {
     items: T[];
     nextCursor: number | string | null;
     hasMore: boolean;
+    /** Rows matching `where` (ignores limit/cursor). */
+    total: number;
 };
 export type WhereInput = WhereBuilder | WhereNode;
 export type ReadQuery = {
@@ -17,6 +19,9 @@ export type SearchQuery = {
     /** Raw `id` cursor (keyset). */
     cursor?: number | string | null;
 };
+export type CountQuery = {
+    where?: WhereInput;
+};
 export type DeleteQuery = {
     where: WhereInput;
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI;IAClC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,CAAA;AAEjD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI;IAClC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,CAAA;AAEjD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b4moss/crudian",
-  "version": "0.3.1",
+  "version": "0.6.0",
   "description": "CRUD abstraction for DDD repositories",
   "type": "module",
   "license": "MIT",
@@ -25,6 +25,11 @@
       "types": "./dist/prisma/index.d.ts",
       "import": "./dist/prisma/index.js",
       "default": "./dist/prisma/index.js"
+    },
+    "./libsql": {
+      "types": "./dist/libsql/index.d.ts",
+      "import": "./dist/libsql/index.js",
+      "default": "./dist/libsql/index.js"
     }
   },
   "files": [
@@ -36,21 +41,26 @@
     "build": "tsc -p tsconfig.json",
     "prepublishOnly": "npm run build",
     "prisma:generate": "prisma generate --schema prisma/schema.prisma",
-    "test": "bun run test:bun-sqlite && bun run test:drizzle && bun run test:prisma",
+    "test": "bun run test:bun-sqlite && bun run test:drizzle && bun run test:prisma && bun run test:libsql",
     "test:bun-sqlite": "bun test src/bun-sqlite",
     "test:drizzle": "tsx --test src/drizzle/crud.test.ts",
-    "test:prisma": "bun run prisma:generate && tsx --test src/prisma/crud.test.ts"
+    "test:prisma": "bun run prisma:generate && tsx --test src/prisma/crud.test.ts",
+    "test:libsql": "tsx --test src/libsql/crud.test.ts"
   },
   "engines": {
-    "node": ">=22",
+    "node": ">=24",
     "bun": ">=1.0.0"
   },
   "peerDependencies": {
+    "@libsql/client": "^0.14.0 || ^0.15.0 || ^0.17.0",
     "@prisma/client": "^6.0.0",
     "better-sqlite3": "^11.0.0",
     "drizzle-orm": "^0.39.0 || ^0.40.0 || ^0.41.0 || ^0.44.0"
   },
   "peerDependenciesMeta": {
+    "@libsql/client": {
+      "optional": true
+    },
     "@prisma/client": {
       "optional": true
     },
@@ -62,9 +72,10 @@
     }
   },
   "devDependencies": {
+    "@libsql/client": "^0.17.4",
     "@prisma/client": "^6.14.0",
     "@types/better-sqlite3": "^7.6.13",
-    "better-sqlite3": "^11.10.0",
+    "better-sqlite3": "^13",
     "bun-types": "^1.2.0",
     "drizzle-orm": "^0.44.4",
     "prisma": "^6.14.0",
@@ -78,6 +89,7 @@
     "bun",
     "drizzle",
     "prisma",
+    "libsql",
     "ddd"
   ],
   "repository": {