@b4moss/crudian 0.6.0 → 0.9.0

package/README.md

@@ -4,6 +4,8 @@ CRUD abstraction for DDD repositories.
 
 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.
 
+**Versioning:** this npm package has its own SemVer (`package.json`). It is independent of the Go module (`packages/go/VERSION`). Shipping Go `0.7.0` does not require bumping this package.
+
 ## Install
 
 ```bash
@@ -236,6 +238,15 @@ crud.count("items") // 5
 crud.count("items", { where: where().eq("name", "n0") }) // 1
 ```
 
+### `exists(table, query?)` → boolean
+
+Whether any row matches (`CountQuery` shape). Does not return a count. Prefer this over `count(...) > 0` when you only need presence (e.g. email already registered).
+
+```ts
+crud.exists("items") // true if the table has any row
+crud.exists("items", { where: where().eq("name", "n0") }) // true / false
+```
+
 ### `upsert(table, cols)` → row
 
 Conflict target is primary key `id`. Inserts or updates; returns the row. `id` is required in `cols`.
@@ -382,6 +393,7 @@ Nestable `and` / `or`. Empty `in([])` is rejected.
 | Pagination | cursor on `id` ASC only (no offset) |
 | `columns` | optional on `read` / `search` / `list`; omit → `*` |
 | `search.total` / `count` | full where count; not page length |
+| `exists` | boolean presence; same input as `count`; use instead of `count > 0` when you only need yes/no |
 | 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 |

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

@@ -1,9 +1,10 @@
 import type { Database } from "bun:sqlite";
+import { type CreateCrudOptions } from "../index.js";
 import { type SyncSqliteCrud } from "../sqlite/sync-crud.js";
 export type BunSqliteCrud = SyncSqliteCrud<Database>;
 /**
  * Create a Crud bound to a Bun SQLite Database.
  * The same Database instance is reused for every operation.
  */
-export declare function createCrud(db: Database): BunSqliteCrud;
+export declare function createCrud(db: Database, options?: CreateCrudOptions): BunSqliteCrud;
 //# sourceMappingURL=crud.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/bun-sqlite/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAA;AAE5D,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAA;AAM/B,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;AAEpD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,aAAa,CAyBtD"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/bun-sqlite/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAA;AAM/B,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;AAEpD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,aAAa,CA6Bf"}

package/dist/bun-sqlite/crud.js

@@ -7,7 +7,7 @@ function bindings(args) {
  * Create a Crud bound to a Bun SQLite Database.
  * The same Database instance is reused for every operation.
  */
-export function createCrud(db) {
+export function createCrud(db, options) {
     if (db == null) {
         throw new CrudianError("db is required");
     }
@@ -28,5 +28,5 @@ export function createCrud(db) {
         transaction(fn) {
             return db.transaction(fn)();
         },
-    });
+    }, options);
 }

package/dist/drizzle/crud.d.ts

@@ -1,5 +1,6 @@
 import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
 import type BetterSqlite3 from "better-sqlite3";
+import { type CreateCrudOptions } from "../index.js";
 import { type SyncSqliteCrud } from "../sqlite/sync-crud.js";
 type DrizzleSqliteDb = BetterSQLite3Database<Record<string, unknown>> & {
     $client: BetterSqlite3.Database;
@@ -9,6 +10,6 @@ export type DrizzleCrud = SyncSqliteCrud<DrizzleSqliteDb>;
  * Create a Crud bound to a Drizzle better-sqlite3 database.
  * Raw SQL goes through the underlying better-sqlite3 client (`db.$client`).
  */
-export declare function createCrud(db: DrizzleSqliteDb): DrizzleCrud;
+export declare function createCrud(db: DrizzleSqliteDb, options?: CreateCrudOptions): DrizzleCrud;
 export {};
 //# sourceMappingURL=crud.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/drizzle/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAA;AAE/C,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAA;AAE/B,KAAK,eAAe,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;IACtE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC,CAAA;AAEzD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,eAAe,GAAG,WAAW,CA2B3D"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/drizzle/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAA;AAE/B,KAAK,eAAe,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;IACtE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC,CAAA;AAEzD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,eAAe,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,WAAW,CA+Bb"}

package/dist/drizzle/crud.js

@@ -4,7 +4,7 @@ import { createSyncSqliteCrud, } from "../sqlite/sync-crud.js";
  * Create a Crud bound to a Drizzle better-sqlite3 database.
  * Raw SQL goes through the underlying better-sqlite3 client (`db.$client`).
  */
-export function createCrud(db) {
+export function createCrud(db, options) {
     if (db == null) {
         throw new CrudianError("db is required");
     }
@@ -29,5 +29,5 @@ export function createCrud(db) {
         transaction(fn) {
             return client.transaction(fn)();
         },
-    });
+    }, options);
 }

package/dist/index.d.ts

@@ -8,5 +8,5 @@
  */
 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, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, } from "./types.js";
+export type { Row, OffsetSearchResult, CursorSearchResult, SearchResult, WhereInput, ReadQuery, SearchQuery, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, CreateCrudOptions, } 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;;;;;;;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"}
+{"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,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAA"}

package/dist/libsql/crud.d.ts

@@ -1,3 +1,4 @@
+import { type CreateCrudOptions } from "../index.js";
 import { type AsyncSqliteCrud } from "../sqlite/async-crud.js";
 import type { Row } from "../types.js";
 /** Result shape used by the libSQL executor bridge. */
@@ -27,5 +28,5 @@ export type LibsqlCrud = AsyncSqliteCrud<LibsqlLikeClient>;
  * 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;
+export declare function createCrud(client: LibsqlLikeClient, options?: CreateCrudOptions): LibsqlCrud;
 //# sourceMappingURL=crud.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/libsql/crud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAClE,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,CACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,UAAU,CAiDZ"}

package/dist/libsql/crud.js

@@ -16,7 +16,7 @@ function normalizeRow(row) {
  * 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) {
+export function createCrud(client, options) {
     if (client == null) {
         throw new CrudianError("db is required");
     }
@@ -58,5 +58,5 @@ export function createCrud(client) {
                 tx.close();
             }
         },
-    });
+    }, options);
 }

package/dist/prisma/crud.d.ts

@@ -1,3 +1,4 @@
+import { type CreateCrudOptions } from "../index.js";
 import { type AsyncSqliteCrud } from "../sqlite/async-crud.js";
 /** Minimal surface of PrismaClient used by the adapter (raw SQL + TX). */
 export type PrismaLikeClient = {
@@ -10,5 +11,5 @@ export type PrismaCrud = AsyncSqliteCrud<PrismaLikeClient>;
  * Create a Crud bound to a PrismaClient (SQLite).
  * Methods are async. The injected client is exposed as `crud.db`.
  */
-export declare function createCrud(client: PrismaLikeClient): PrismaCrud;
+export declare function createCrud(client: PrismaLikeClient, options?: CreateCrudOptions): PrismaCrud;
 //# sourceMappingURL=crud.d.ts.map

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,CA0C/D"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/prisma/crud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAClE,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,CACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,UAAU,CA8CZ"}

package/dist/prisma/crud.js

@@ -12,7 +12,7 @@ function normalizeRow(row) {
  * Create a Crud bound to a PrismaClient (SQLite).
  * Methods are async. The injected client is exposed as `crud.db`.
  */
-export function createCrud(client) {
+export function createCrud(client, options) {
     if (client == null) {
         throw new CrudianError("db is required");
     }
@@ -50,7 +50,7 @@ export function createCrud(client) {
                 }
             });
         },
-    });
+    }, options);
 }
 function normalizeQueryResult(result) {
     if (result == null)

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

@@ -1,4 +1,4 @@
-import { type CountQuery, type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
+import { type CountQuery, type CreateCrudOptions, 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;
@@ -22,7 +22,8 @@ export type AsyncSqliteCrud<TDb> = {
     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>;
+    exists(table: string, query?: CountQuery): Promise<boolean>;
     transaction<T>(fn: () => Promise<T>): Promise<T>;
 };
-export declare function createAsyncSqliteCrud<TDb>(db: TDb, ex: AsyncSqliteExecutor): AsyncSqliteCrud<TDb>;
+export declare function createAsyncSqliteCrud<TDb>(db: TDb, ex: AsyncSqliteExecutor, options?: CreateCrudOptions): AsyncSqliteCrud<TDb>;
 //# sourceMappingURL=async-crud.d.ts.map

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":"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"}
+{"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

@@ -1,4 +1,5 @@
 import { CrudianError, assertString, } from "../index.js";
+import { createAsyncPkGuard, resolvePk } from "./pk.js";
 import { compileWhere, quoteIdent, resolveWhere } from "./sql.js";
 function requireWhere(query, label) {
     if (query.where === undefined || query.where === null) {
@@ -16,11 +17,14 @@ function rowFromObject(value) {
     }
     return { ...value };
 }
-export function createAsyncSqliteCrud(db, ex) {
+export function createAsyncSqliteCrud(db, ex, options) {
+    const pk = resolvePk(options);
+    const ensurePkColumn = createAsyncPkGuard(pk, ex.all);
     const crud = {
         db,
         async create(table, cols) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
             }
@@ -39,6 +43,7 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async read(table, query = {}) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
             const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
@@ -49,6 +54,7 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async update(table, cols, query) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             requireWhere(query, "update");
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
@@ -72,6 +78,7 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async delete(table, query) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             requireWhere(query, "delete");
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
@@ -83,10 +90,21 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async search(table, query = {}) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             const limit = query.limit ?? 20;
             if (typeof limit !== "number" || !Number.isFinite(limit) || limit <= 0) {
                 throw new CrudianError("limit must be a positive number");
             }
+            const paging = query.paging ?? "offset";
+            if (paging !== "offset" && paging !== "cursor") {
+                throw new CrudianError('paging must be "offset" or "cursor"');
+            }
+            if (paging === "offset" && query.cursor !== undefined) {
+                throw new CrudianError("offset paging does not accept cursor");
+            }
+            if (paging === "cursor" && query.offset !== undefined) {
+                throw new CrudianError("cursor paging does not accept offset");
+            }
             if (query.cursor != null &&
                 typeof query.cursor !== "number" &&
                 typeof query.cursor !== "string") {
@@ -94,27 +112,48 @@ export function createAsyncSqliteCrud(db, ex) {
             }
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
+            const total = await crud.count(table, { where: query.where });
+            if (paging === "offset") {
+                const offset = query.offset ?? 0;
+                if (typeof offset !== "number" || !Number.isFinite(offset) || offset < 0) {
+                    throw new CrudianError("offset must be a non-negative number");
+                }
+                const args = [...where.args];
+                const whereSql = where.sql ? ` WHERE ${where.sql}` : "";
+                const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
+                    whereSql +
+                    ` ORDER BY ${quoteIdent(pk)} ASC LIMIT ? OFFSET ?`;
+                args.push(limit, offset);
+                const items = (await ex.all(sql, args)).map((r) => rowFromObject(r));
+                return {
+                    items,
+                    total,
+                    offset,
+                    limit,
+                    hasMore: offset + items.length < total,
+                };
+            }
             const args = [...where.args];
             const parts = [];
             if (where.sql)
                 parts.push(`(${where.sql})`);
             if (query.cursor != null) {
-                parts.push(`${quoteIdent("id")} > ?`);
+                parts.push(`${quoteIdent(pk)} > ?`);
                 args.push(query.cursor);
             }
             const whereSql = parts.length > 0 ? ` WHERE ${parts.join(" AND ")}` : "";
             const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
                 whereSql +
-                ` ORDER BY ${quoteIdent("id")} ASC LIMIT ?`;
+                ` ORDER BY ${quoteIdent(pk)} ASC LIMIT ?`;
             args.push(limit + 1);
             const rows = (await ex.all(sql, args)).map((r) => rowFromObject(r));
             const hasMore = rows.length > limit;
             const items = hasMore ? rows.slice(0, limit) : rows;
             const last = items[items.length - 1];
-            const nextCursor = hasMore && last != null && (typeof last.id === "number" || typeof last.id === "string")
-                ? last.id
+            const pkVal = last != null ? last[pk] : undefined;
+            const nextCursor = hasMore && last != null && (typeof pkVal === "number" || typeof pkVal === "string")
+                ? pkVal
                 : null;
-            const total = await crud.count(table, { where: query.where });
             return { items, nextCursor, hasMore, total };
         },
         async list(table, query) {
@@ -122,6 +161,7 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async count(table, query = {}) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
             const sql = `SELECT COUNT(*) AS ${quoteIdent("row_count")} FROM ${tbl}` +
@@ -129,8 +169,20 @@ export function createAsyncSqliteCrud(db, ex) {
             const row = await ex.get(sql, where.args);
             return Number(row?.row_count ?? 0);
         },
+        async exists(table, query = {}) {
+            assertString(table, "table");
+            await ensurePkColumn(table);
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const sql = `SELECT 1 AS ${quoteIdent("ok")} FROM ${tbl}` +
+                (where.sql ? ` WHERE ${where.sql}` : "") +
+                ` LIMIT 1`;
+            const row = await ex.get(sql, where.args);
+            return row != null;
+        },
         async upsert(table, cols) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
             }
@@ -138,19 +190,20 @@ export function createAsyncSqliteCrud(db, ex) {
             if (keys.length === 0) {
                 throw new CrudianError("cols must not be empty");
             }
-            if (!Object.prototype.hasOwnProperty.call(cols, "id")) {
-                throw new CrudianError("upsert requires cols.id");
+            if (!Object.prototype.hasOwnProperty.call(cols, pk)) {
+                throw new CrudianError(`upsert requires cols.${pk}`);
             }
-            const id = cols.id;
+            const id = cols[pk];
             const existing = await crud.read(table, {
-                where: { type: "cond", op: "eq", column: "id", value: id },
+                where: { type: "cond", op: "eq", column: pk, value: id },
             });
             if (existing != null) {
-                const { id: _id, ...patch } = cols;
+                const patch = { ...cols };
+                delete patch[pk];
                 if (Object.keys(patch).length === 0)
                     return existing;
                 const updated = await crud.update(table, patch, {
-                    where: { type: "cond", op: "eq", column: "id", value: id },
+                    where: { type: "cond", op: "eq", column: pk, value: id },
                 });
                 if (updated == null) {
                     throw new CrudianError("upsert update failed");
@@ -161,22 +214,25 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async duplicate(table, query) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             requireWhere(query, "duplicate");
             const source = await crud.read(table, { where: query.where });
             if (source == null)
                 return null;
-            const { id: _id, ...rest } = source;
+            const rest = { ...source };
+            delete rest[pk];
             const overrides = query.overrides != null &&
                 typeof query.overrides === "object" &&
                 !Array.isArray(query.overrides)
                 ? query.overrides
                 : {};
             const cols = { ...rest, ...overrides };
-            delete cols.id;
+            delete cols[pk];
             return crud.create(table, cols);
         },
         async bulkCreate(table, rows) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             if (!Array.isArray(rows)) {
                 throw new CrudianError("rows must be an array");
             }
@@ -194,6 +250,7 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async bulkUpdate(table, cols, query) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             requireWhere(query, "bulkUpdate");
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
@@ -217,6 +274,7 @@ export function createAsyncSqliteCrud(db, ex) {
         },
         async bulkUpsert(table, rows) {
             assertString(table, "table");
+            await ensurePkColumn(table);
             if (!Array.isArray(rows)) {
                 throw new CrudianError("rows must be an array");
             }
@@ -227,8 +285,8 @@ export function createAsyncSqliteCrud(db, ex) {
                 if (row == null || typeof row !== "object" || Array.isArray(row)) {
                     throw new CrudianError("each row must be an object");
                 }
-                if (!Object.prototype.hasOwnProperty.call(row, "id")) {
-                    throw new CrudianError("bulkUpsert requires each row to have id");
+                if (!Object.prototype.hasOwnProperty.call(row, pk)) {
+                    throw new CrudianError(`bulkUpsert requires each row to have ${pk}`);
                 }
                 await crud.upsert(table, row);
                 count += 1;

package/dist/sqlite/pk.d.ts

@@ -0,0 +1,22 @@
+import { type CreateCrudOptions } from "../index.js";
+/** Resolve PK column name from createCrud options. Default: `"id"`. */
+export declare function resolvePk(options?: CreateCrudOptions): string;
+export type PkColumnChecker = {
+    get(sql: string, args?: unknown[]): {
+        name?: unknown;
+    } | RowLike | undefined;
+};
+export type AsyncPkColumnChecker = {
+    get(sql: string, args?: unknown[]): Promise<{
+        name?: unknown;
+    } | RowLike | undefined>;
+};
+type RowLike = Record<string, unknown>;
+/**
+ * Ensure `pk` exists on `table` via PRAGMA table_info. Caches per table.
+ * Throws CrudianError when the column is missing.
+ */
+export declare function createPkGuard(pk: string, get: (sql: string, args?: unknown[]) => RowLike | undefined, all: (sql: string, args?: unknown[]) => RowLike[]): (table: string) => void;
+export declare function createAsyncPkGuard(pk: string, all: (sql: string, args?: unknown[]) => Promise<RowLike[]>): (table: string) => Promise<void>;
+export {};
+//# sourceMappingURL=pk.d.ts.map

package/dist/sqlite/pk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pk.d.ts","sourceRoot":"","sources":["../../src/sqlite/pk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGlE,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAW7D;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,GAAG,SAAS,CAAA;CAC7E,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,CACD,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EAAE,GACf,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;CACrD,CAAA;AAED,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtC;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,SAAS,EAC3D,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAGlB,OAAO,MAAM,KAAG,IAAI,CAapD;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAGrB,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAanE"}

package/dist/sqlite/pk.js

@@ -0,0 +1,45 @@
+import { CrudianError } from "../index.js";
+import { quoteIdent } from "./sql.js";
+/** Resolve PK column name from createCrud options. Default: `"id"`. */
+export function resolvePk(options) {
+    if (options == null || options.pk === undefined) {
+        return "id";
+    }
+    if (typeof options.pk !== "string") {
+        throw new CrudianError("pk must be a string");
+    }
+    if (options.pk === "") {
+        throw new CrudianError("pk must not be empty");
+    }
+    return options.pk;
+}
+/**
+ * Ensure `pk` exists on `table` via PRAGMA table_info. Caches per table.
+ * Throws CrudianError when the column is missing.
+ */
+export function createPkGuard(pk, get, all) {
+    const ok = new Set();
+    return function ensurePkColumn(table) {
+        if (ok.has(table))
+            return;
+        const rows = all(`PRAGMA table_info(${quoteIdent(table)})`);
+        const names = new Set(rows.map((r) => String(r.name ?? "")).filter((n) => n.length > 0));
+        if (!names.has(pk)) {
+            throw new CrudianError(`pk column "${pk}" does not exist on table "${table}"`);
+        }
+        ok.add(table);
+    };
+}
+export function createAsyncPkGuard(pk, all) {
+    const ok = new Set();
+    return async function ensurePkColumn(table) {
+        if (ok.has(table))
+            return;
+        const rows = await all(`PRAGMA table_info(${quoteIdent(table)})`);
+        const names = new Set(rows.map((r) => String(r.name ?? "")).filter((n) => n.length > 0));
+        if (!names.has(pk)) {
+            throw new CrudianError(`pk column "${pk}" does not exist on table "${table}"`);
+        }
+        ok.add(table);
+    };
+}

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

@@ -1,4 +1,4 @@
-import { type CountQuery, type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
+import { type CountQuery, type CreateCrudOptions, 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;
@@ -22,7 +22,8 @@ export type SyncSqliteCrud<TDb> = {
     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;
+    exists(table: string, query?: CountQuery): boolean;
     transaction<T>(fn: () => T): T;
 };
-export declare function createSyncSqliteCrud<TDb>(db: TDb, ex: SyncSqliteExecutor): SyncSqliteCrud<TDb>;
+export declare function createSyncSqliteCrud<TDb>(db: TDb, ex: SyncSqliteExecutor, options?: CreateCrudOptions): SyncSqliteCrud<TDb>;
 //# sourceMappingURL=sync-crud.d.ts.map

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":"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"}
+{"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

@@ -1,4 +1,5 @@
 import { CrudianError, assertString, } from "../index.js";
+import { createPkGuard, resolvePk } from "./pk.js";
 import { compileWhere, quoteIdent, resolveWhere } from "./sql.js";
 function requireWhere(query, label) {
     if (query.where === undefined || query.where === null) {
@@ -16,11 +17,14 @@ function rowFromObject(value) {
     }
     return { ...value };
 }
-export function createSyncSqliteCrud(db, ex) {
+export function createSyncSqliteCrud(db, ex, options) {
+    const pk = resolvePk(options);
+    const ensurePkColumn = createPkGuard(pk, ex.get, ex.all);
     const crud = {
         db,
         create(table, cols) {
             assertString(table, "table");
+            ensurePkColumn(table);
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
             }
@@ -33,13 +37,15 @@ export function createSyncSqliteCrud(db, ex) {
             const placeholders = keys.map(() => "?").join(", ");
             const args = keys.map((k) => cols[k]);
             ex.run(`INSERT INTO ${tbl} (${colSql}) VALUES (${placeholders})`, args);
-            const idRow = ex.get("SELECT last_insert_rowid() AS id");
-            const id = Number(idRow?.id);
-            const row = ex.get(`SELECT * FROM ${tbl} WHERE "id" = ?`, [id]);
+            const pkValue = Object.prototype.hasOwnProperty.call(cols, pk)
+                ? cols[pk]
+                : Number(ex.get("SELECT last_insert_rowid() AS id")?.id);
+            const row = ex.get(`SELECT * FROM ${tbl} WHERE ${quoteIdent(pk)} = ?`, [pkValue]);
             return rowFromObject(row);
         },
         read(table, query = {}) {
             assertString(table, "table");
+            ensurePkColumn(table);
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
             const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
@@ -50,6 +56,7 @@ export function createSyncSqliteCrud(db, ex) {
         },
         update(table, cols, query) {
             assertString(table, "table");
+            ensurePkColumn(table);
             requireWhere(query, "update");
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
@@ -73,6 +80,7 @@ export function createSyncSqliteCrud(db, ex) {
         },
         delete(table, query) {
             assertString(table, "table");
+            ensurePkColumn(table);
             requireWhere(query, "delete");
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
@@ -84,10 +92,21 @@ export function createSyncSqliteCrud(db, ex) {
         },
         search(table, query = {}) {
             assertString(table, "table");
+            ensurePkColumn(table);
             const limit = query.limit ?? 20;
             if (typeof limit !== "number" || !Number.isFinite(limit) || limit <= 0) {
                 throw new CrudianError("limit must be a positive number");
             }
+            const paging = query.paging ?? "offset";
+            if (paging !== "offset" && paging !== "cursor") {
+                throw new CrudianError('paging must be "offset" or "cursor"');
+            }
+            if (paging === "offset" && query.cursor !== undefined) {
+                throw new CrudianError("offset paging does not accept cursor");
+            }
+            if (paging === "cursor" && query.offset !== undefined) {
+                throw new CrudianError("cursor paging does not accept offset");
+            }
             if (query.cursor != null &&
                 typeof query.cursor !== "number" &&
                 typeof query.cursor !== "string") {
@@ -95,27 +114,48 @@ export function createSyncSqliteCrud(db, ex) {
             }
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
+            const total = crud.count(table, { where: query.where });
+            if (paging === "offset") {
+                const offset = query.offset ?? 0;
+                if (typeof offset !== "number" || !Number.isFinite(offset) || offset < 0) {
+                    throw new CrudianError("offset must be a non-negative number");
+                }
+                const args = [...where.args];
+                const whereSql = where.sql ? ` WHERE ${where.sql}` : "";
+                const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
+                    whereSql +
+                    ` ORDER BY ${quoteIdent(pk)} ASC LIMIT ? OFFSET ?`;
+                args.push(limit, offset);
+                const items = ex.all(sql, args).map((r) => rowFromObject(r));
+                return {
+                    items,
+                    total,
+                    offset,
+                    limit,
+                    hasMore: offset + items.length < total,
+                };
+            }
             const args = [...where.args];
             const parts = [];
             if (where.sql)
                 parts.push(`(${where.sql})`);
             if (query.cursor != null) {
-                parts.push(`${quoteIdent("id")} > ?`);
+                parts.push(`${quoteIdent(pk)} > ?`);
                 args.push(query.cursor);
             }
             const whereSql = parts.length > 0 ? ` WHERE ${parts.join(" AND ")}` : "";
             const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
                 whereSql +
-                ` ORDER BY ${quoteIdent("id")} ASC LIMIT ?`;
+                ` ORDER BY ${quoteIdent(pk)} ASC LIMIT ?`;
             args.push(limit + 1);
             const rows = ex.all(sql, args).map((r) => rowFromObject(r));
             const hasMore = rows.length > limit;
             const items = hasMore ? rows.slice(0, limit) : rows;
             const last = items[items.length - 1];
-            const nextCursor = hasMore && last != null && (typeof last.id === "number" || typeof last.id === "string")
-                ? last.id
+            const pkVal = last != null ? last[pk] : undefined;
+            const nextCursor = hasMore && last != null && (typeof pkVal === "number" || typeof pkVal === "string")
+                ? pkVal
                 : null;
-            const total = crud.count(table, { where: query.where });
             return { items, nextCursor, hasMore, total };
         },
         list(table, query) {
@@ -123,6 +163,7 @@ export function createSyncSqliteCrud(db, ex) {
         },
         count(table, query = {}) {
             assertString(table, "table");
+            ensurePkColumn(table);
             const tbl = quoteIdent(table);
             const where = compileWhere(resolveWhere(query.where));
             const sql = `SELECT COUNT(*) AS ${quoteIdent("row_count")} FROM ${tbl}` +
@@ -130,8 +171,19 @@ export function createSyncSqliteCrud(db, ex) {
             const row = ex.get(sql, where.args);
             return Number(row?.row_count ?? 0);
         },
+        exists(table, query = {}) {
+            assertString(table, "table");
+            ensurePkColumn(table);
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const sql = `SELECT 1 AS ${quoteIdent("ok")} FROM ${tbl}` +
+                (where.sql ? ` WHERE ${where.sql}` : "") +
+                ` LIMIT 1`;
+            return ex.get(sql, where.args) != null;
+        },
         upsert(table, cols) {
             assertString(table, "table");
+            ensurePkColumn(table);
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
             }
@@ -139,19 +191,20 @@ export function createSyncSqliteCrud(db, ex) {
             if (keys.length === 0) {
                 throw new CrudianError("cols must not be empty");
             }
-            if (!Object.prototype.hasOwnProperty.call(cols, "id")) {
-                throw new CrudianError("upsert requires cols.id");
+            if (!Object.prototype.hasOwnProperty.call(cols, pk)) {
+                throw new CrudianError(`upsert requires cols.${pk}`);
             }
-            const id = cols.id;
+            const id = cols[pk];
             const existing = crud.read(table, {
-                where: { type: "cond", op: "eq", column: "id", value: id },
+                where: { type: "cond", op: "eq", column: pk, value: id },
             });
             if (existing != null) {
-                const { id: _id, ...patch } = cols;
+                const patch = { ...cols };
+                delete patch[pk];
                 if (Object.keys(patch).length === 0)
                     return existing;
                 const updated = crud.update(table, patch, {
-                    where: { type: "cond", op: "eq", column: "id", value: id },
+                    where: { type: "cond", op: "eq", column: pk, value: id },
                 });
                 if (updated == null) {
                     throw new CrudianError("upsert update failed");
@@ -162,22 +215,25 @@ export function createSyncSqliteCrud(db, ex) {
         },
         duplicate(table, query) {
             assertString(table, "table");
+            ensurePkColumn(table);
             requireWhere(query, "duplicate");
             const source = crud.read(table, { where: query.where });
             if (source == null)
                 return null;
-            const { id: _id, ...rest } = source;
+            const rest = { ...source };
+            delete rest[pk];
             const overrides = query.overrides != null &&
                 typeof query.overrides === "object" &&
                 !Array.isArray(query.overrides)
                 ? query.overrides
                 : {};
             const cols = { ...rest, ...overrides };
-            delete cols.id;
+            delete cols[pk];
             return crud.create(table, cols);
         },
         bulkCreate(table, rows) {
             assertString(table, "table");
+            ensurePkColumn(table);
             if (!Array.isArray(rows)) {
                 throw new CrudianError("rows must be an array");
             }
@@ -195,6 +251,7 @@ export function createSyncSqliteCrud(db, ex) {
         },
         bulkUpdate(table, cols, query) {
             assertString(table, "table");
+            ensurePkColumn(table);
             requireWhere(query, "bulkUpdate");
             if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
                 throw new CrudianError("cols must be an object");
@@ -218,6 +275,7 @@ export function createSyncSqliteCrud(db, ex) {
         },
         bulkUpsert(table, rows) {
             assertString(table, "table");
+            ensurePkColumn(table);
             if (!Array.isArray(rows)) {
                 throw new CrudianError("rows must be an array");
             }
@@ -228,8 +286,8 @@ export function createSyncSqliteCrud(db, ex) {
                 if (row == null || typeof row !== "object" || Array.isArray(row)) {
                     throw new CrudianError("each row must be an object");
                 }
-                if (!Object.prototype.hasOwnProperty.call(row, "id")) {
-                    throw new CrudianError("bulkUpsert requires each row to have id");
+                if (!Object.prototype.hasOwnProperty.call(row, pk)) {
+                    throw new CrudianError(`bulkUpsert requires each row to have ${pk}`);
                 }
                 crud.upsert(table, row);
                 count += 1;

package/dist/types.d.ts

@@ -1,12 +1,20 @@
 import type { WhereBuilder, WhereNode } from "./where.js";
 export type Row = Record<string, unknown>;
-export type SearchResult<T = Row> = {
+export type OffsetSearchResult<T = Row> = {
+    items: T[];
+    total: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+};
+export type CursorSearchResult<T = Row> = {
     items: T[];
     nextCursor: number | string | null;
     hasMore: boolean;
     /** Rows matching `where` (ignores limit/cursor). */
     total: number;
 };
+export type SearchResult<T = Row> = OffsetSearchResult<T> | CursorSearchResult<T>;
 export type WhereInput = WhereBuilder | WhereNode;
 export type ReadQuery = {
     columns?: string[];
@@ -16,7 +24,11 @@ export type SearchQuery = {
     columns?: string[];
     where?: WhereInput;
     limit?: number;
-    /** Raw `id` cursor (keyset). */
+    /** Pagination mode. Default: `"offset"`. */
+    paging?: "offset" | "cursor";
+    /** Offset for `paging: "offset"` (default `0`). */
+    offset?: number;
+    /** Raw PK cursor (keyset; default column `id`) for `paging: "cursor"`. */
     cursor?: number | string | null;
 };
 export type CountQuery = {
@@ -32,4 +44,9 @@ export type DuplicateQuery = {
     where: WhereInput;
     overrides?: Record<string, unknown>;
 };
+/** Options for `createCrud(db, options?)`. */
+export type CreateCrudOptions = {
+    /** Primary key column name. Default: `"id"`. */
+    pk?: string;
+};
 //# sourceMappingURL=types.d.ts.map

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;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"}
+{"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,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI;IACxC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI;IACxC,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,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;AAEjF,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,4CAA4C;IAC5C,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC5B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,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;AAED,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gDAAgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b4moss/crudian",
-  "version": "0.6.0",
+  "version": "0.9.0",
   "description": "CRUD abstraction for DDD repositories",
   "type": "module",
   "license": "MIT",
@@ -43,9 +43,9 @@
     "prisma:generate": "prisma generate --schema prisma/schema.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:libsql": "tsx --test src/libsql/crud.test.ts"
+    "test:drizzle": "tsx --test src/drizzle/crud.test.ts src/drizzle/pk.test.ts",
+    "test:prisma": "bun run prisma:generate && tsx --test src/prisma/crud.test.ts src/prisma/pk.test.ts",
+    "test:libsql": "tsx --test src/libsql/crud.test.ts src/libsql/pk.test.ts"
   },
   "engines": {
     "node": ">=24",
@@ -77,7 +77,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^13",
     "bun-types": "^1.2.0",
-    "drizzle-orm": "^0.44.4",
+    "drizzle-orm": "^0.45.2",
     "prisma": "^6.14.0",
     "tsx": "^4.23.12",
     "typescript": "^5.8.0"