@b4moss/crudian 0.9.0 → 0.10.0

package/README.md

@@ -69,18 +69,39 @@ const db = drizzle(sqlite)
 const crud = createCrud(db)
 ```
 
-### Prisma (SQLite) — async
+### Prisma (SQLite / Postgres / MySQL) — async
 
 ```ts
 import { PrismaClient } from "@prisma/client"
 import { createCrud } from "@b4moss/crudian/prisma"
 
 const client = new PrismaClient()
-const crud = createCrud(client)
+// Default dialect is "sqlite". For server DBs:
+const crudPg = createCrud(client, { dialect: "postgres" })
+const crudMy = createCrud(client, { dialect: "mysql" })
+const crudSqlite = createCrud(client) // or { dialect: "sqlite" }
 
-await crud.create("items", { name: "alpha", score: 1 })
+await crudSqlite.create("items", { name: "alpha", score: 1 })
 ```
 
+Match `options.dialect` to the Prisma schema `provider`. Placeholders and
+insert-return strategies follow the dialect (`$n` + `RETURNING` on Postgres;
+`` `ident` `` + `LAST_INSERT_ID` fetch on MySQL — no `RETURNING`).
+
+### Connection pool / lifetime (JS)
+
+crudian never opens connections. For **Postgres / MySQL**, configure pooling on
+the client you inject:
+
+| Adapter | How to set pool |
+|---------|-----------------|
+| **Prisma** | Prisma datasource / connection URL params / engine pool settings (caller-owned). See Prisma docs for your provider. |
+| **bun-sqlite / drizzle (sqlite) / libsql** | No pool settings needed (no-op). |
+
+Optional type for docs / future drivers: `PoolOptions` from `@b4moss/crudian`
+(not applied by Prisma — configure the client instead). Go GORM uses
+`crudian.Options.Pool` / `ApplyPool` (see `packages/go/README.md`).
+
 ### libSQL (`@libsql/client`) — async
 
 ```ts
@@ -385,18 +406,21 @@ Nestable `and` / `or`. Empty `in([])` is rejected.
 
 | Topic | Behavior |
 |-------|----------|
-| Entry | `createCrud(db)` — inject a caller-owned client; exposed as `crud.db` |
+| Entry | `createCrud(db, options?)` — inject a caller-owned client; exposed as `crud.db` |
+| Dialects | Shared Dialect layer: SQLite (all adapters), Postgres / MySQL via **Prisma** (`options.dialect`) |
+| Drizzle | **SQLite (better-sqlite3) only** in this line; PG/MySQL subpaths are out of scope |
 | 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) |
+| Upsert conflict | application-level on PK (default `id`; no SQL `ON CONFLICT`) |
+| Pagination | `paging?: "offset" \| "cursor"` (default `"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 |
+| `exists` | boolean presence; same input as `count` |
+| Pool | caller-owned; Prisma via datasource settings; SQLite adapters no-op |
 | 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 |
+| Out of scope | relations, migrations, full-text search, ORM models, TypeORM (#43) |
 
 ## License
 

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

@@ -1,2 +1,6 @@
-export { compileWhere, quoteIdent, resolveWhere, } from "../sqlite/sql.js";
+import type { WhereNode } from "../index.js";
+import { quoteIdent, resolveWhere, type CompiledWhere } from "../sqlite/sql.js";
+export { quoteIdent, resolveWhere };
+/** SQLite-default compileWhere (compat for bun-sqlite tests). */
+export declare function compileWhere(node: WhereNode | undefined, startIndex?: number): CompiledWhere;
 //# sourceMappingURL=sql.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/bun-sqlite/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/bun-sqlite/sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAEL,UAAU,EACV,YAAY,EACZ,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAA;AAEnC,iEAAiE;AACjE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,UAAU,SAAI,GACb,aAAa,CAEf"}

package/dist/bun-sqlite/sql.js

@@ -1 +1,7 @@
-export { compileWhere, quoteIdent, resolveWhere, } from "../sqlite/sql.js";
+import { sqliteDialect } from "../dialect/sqlite.js";
+import { compileWhere as compileWhereDialect, quoteIdent, resolveWhere, } from "../sqlite/sql.js";
+export { quoteIdent, resolveWhere };
+/** SQLite-default compileWhere (compat for bun-sqlite tests). */
+export function compileWhere(node, startIndex = 1) {
+    return compileWhereDialect(sqliteDialect, node, startIndex);
+}

package/dist/dialect/index.d.ts

@@ -0,0 +1,7 @@
+import type { Dialect, DialectName } from "./types.js";
+export type { Dialect, DialectName, DescribeColumnsQuery } from "./types.js";
+export { sqliteDialect } from "./sqlite.js";
+export { postgresDialect } from "./postgres.js";
+export { mysqlDialect } from "./mysql.js";
+export declare function resolveDialect(name: DialectName | undefined): Dialect;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dialect/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEtD,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAWrE"}

package/dist/dialect/index.js

@@ -0,0 +1,19 @@
+import { CrudianError } from "../index.js";
+import { mysqlDialect } from "./mysql.js";
+import { postgresDialect } from "./postgres.js";
+import { sqliteDialect } from "./sqlite.js";
+export { sqliteDialect } from "./sqlite.js";
+export { postgresDialect } from "./postgres.js";
+export { mysqlDialect } from "./mysql.js";
+export function resolveDialect(name) {
+    switch (name ?? "sqlite") {
+        case "sqlite":
+            return sqliteDialect;
+        case "postgres":
+            return postgresDialect;
+        case "mysql":
+            return mysqlDialect;
+        default:
+            throw new CrudianError(`unknown dialect: ${String(name)}`);
+    }
+}

package/dist/dialect/mysql.d.ts

@@ -0,0 +1,4 @@
+import type { Dialect } from "./types.js";
+/** MySQL dialect: `` `ident` ``, `?`, LAST_INSERT_ID, information_schema (no RETURNING). */
+export declare const mysqlDialect: Dialect;
+//# sourceMappingURL=mysql.d.ts.map

package/dist/dialect/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/dialect/mysql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC,4FAA4F;AAC5F,eAAO,MAAM,YAAY,EAAE,OA0B1B,CAAA"}

package/dist/dialect/mysql.js

@@ -0,0 +1,24 @@
+import { assertIdent } from "./types.js";
+/** MySQL dialect: `` `ident` ``, `?`, LAST_INSERT_ID, information_schema (no RETURNING). */
+export const mysqlDialect = {
+    name: "mysql",
+    supportsInsertReturning: false,
+    quoteIdent(name) {
+        const n = assertIdent(name);
+        return `\`${n.replaceAll("`", "``")}\``;
+    },
+    placeholder(_i) {
+        return "?";
+    },
+    lastInsertIdSql() {
+        return "SELECT LAST_INSERT_ID() AS id";
+    },
+    describeColumns(table) {
+        const n = assertIdent(table);
+        return {
+            sql: `SELECT COLUMN_NAME AS name FROM information_schema.COLUMNS` +
+                ` WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = ?`,
+            args: [n],
+        };
+    },
+};

package/dist/dialect/postgres.d.ts

@@ -0,0 +1,4 @@
+import type { Dialect } from "./types.js";
+/** Postgres dialect: `"ident"`, `$n`, RETURNING *, information_schema. */
+export declare const postgresDialect: Dialect;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/dialect/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/dialect/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC,0EAA0E;AAC1E,eAAO,MAAM,eAAe,EAAE,OA2B7B,CAAA"}

package/dist/dialect/postgres.js

@@ -0,0 +1,25 @@
+import { assertIdent } from "./types.js";
+/** Postgres dialect: `"ident"`, `$n`, RETURNING *, information_schema. */
+export const postgresDialect = {
+    name: "postgres",
+    supportsInsertReturning: true,
+    quoteIdent(name) {
+        const n = assertIdent(name);
+        return `"${n.replaceAll('"', '""')}"`;
+    },
+    placeholder(i) {
+        return `$${i}`;
+    },
+    lastInsertIdSql() {
+        // Prefer RETURNING; this is a fallback for sync-style paths.
+        return "SELECT lastval() AS id";
+    },
+    describeColumns(table) {
+        const n = assertIdent(table);
+        return {
+            sql: `SELECT column_name AS name FROM information_schema.columns` +
+                ` WHERE table_schema = current_schema() AND table_name = $1`,
+            args: [n],
+        };
+    },
+};

package/dist/dialect/sqlite.d.ts

@@ -0,0 +1,4 @@
+import type { Dialect } from "./types.js";
+/** SQLite / libSQL dialect: `"ident"`, `?`, PRAGMA, last_insert_rowid / RETURNING. */
+export declare const sqliteDialect: Dialect;
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/dialect/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC,sFAAsF;AACtF,eAAO,MAAM,aAAa,EAAE,OAwB3B,CAAA"}

package/dist/dialect/sqlite.js

@@ -0,0 +1,23 @@
+import { assertIdent } from "./types.js";
+/** SQLite / libSQL dialect: `"ident"`, `?`, PRAGMA, last_insert_rowid / RETURNING. */
+export const sqliteDialect = {
+    name: "sqlite",
+    supportsInsertReturning: true,
+    quoteIdent(name) {
+        const n = assertIdent(name);
+        return `"${n.replaceAll('"', '""')}"`;
+    },
+    placeholder(_i) {
+        return "?";
+    },
+    lastInsertIdSql() {
+        return "SELECT last_insert_rowid() AS id";
+    },
+    describeColumns(table) {
+        const n = assertIdent(table);
+        return {
+            sql: `PRAGMA table_info(${sqliteDialect.quoteIdent(n)})`,
+            args: [],
+        };
+    },
+};

package/dist/dialect/types.d.ts

@@ -0,0 +1,25 @@
+/** Supported SQL dialect names. */
+export type DialectName = "sqlite" | "postgres" | "mysql";
+/** Result of compiling a column-description query for PK checks. */
+export type DescribeColumnsQuery = {
+    sql: string;
+    args: unknown[];
+};
+/**
+ * SQL dialect hooks for shared CRUD.
+ * Pool / connection lifetime is intentionally not part of this interface.
+ */
+export type Dialect = {
+    readonly name: DialectName;
+    quoteIdent(name: string): string;
+    /** 1-based placeholder index into the statement args. */
+    placeholder(i: number): string;
+    /** When true, async create prefers `INSERT … RETURNING *`. */
+    readonly supportsInsertReturning: boolean;
+    /** Query returning a single column `id` for fetch-after-insert. */
+    lastInsertIdSql(): string;
+    /** List column names (`name` field) for a table. */
+    describeColumns(table: string): DescribeColumnsQuery;
+};
+export declare function assertIdent(name: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/dialect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dialect/types.ts"],"names":[],"mappings":"AAEA,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;AAEzD,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,OAAO,EAAE,CAAA;CAChB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,yDAAyD;IACzD,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAA;IACzC,mEAAmE;IACnE,eAAe,IAAI,MAAM,CAAA;IACzB,oDAAoD;IACpD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAA;CACrD,CAAA;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/dist/dialect/types.js

@@ -0,0 +1,5 @@
+import { assertString } from "../index.js";
+export function assertIdent(name) {
+    assertString(name, "identifier");
+    return name;
+}

package/dist/index.d.ts

@@ -8,5 +8,6 @@
  */
 export { CrudianError, assertString } from "./errors.js";
 export { WhereBuilder, where, isWhereBuilder, type Op, type CondNode, type GroupNode, type WhereNode, } from "./where.js";
-export type { Row, OffsetSearchResult, CursorSearchResult, SearchResult, WhereInput, ReadQuery, SearchQuery, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, CreateCrudOptions, } from "./types.js";
+export type { Row, OffsetSearchResult, CursorSearchResult, SearchResult, WhereInput, ReadQuery, SearchQuery, CountQuery, DeleteQuery, UpdateQuery, DuplicateQuery, CreateCrudOptions, CreateCrudDialect, } from "./types.js";
+export type { PoolOptions } from "./pool.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,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"}
+{"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,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/dist/pool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Optional pool / lifetime hints for documentation and future driver adapters.
+ * Prisma owns pooling via datasource / engine settings — callers configure that
+ * on the PrismaClient they inject. crudian does not open connections.
+ *
+ * Not part of the Dialect interface (#105 / #73).
+ */
+export type PoolOptions = {
+    /** Max open connections (driver-dependent). */
+    maxOpenConns?: number;
+    /** Max idle connections. */
+    maxIdleConns?: number;
+    /** Max connection lifetime in milliseconds. */
+    connMaxLifetimeMs?: number;
+    /** Max idle time in milliseconds. */
+    connMaxIdleTimeMs?: number;
+};
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA"}

package/dist/pool.js

@@ -0,0 +1 @@
+export {};

package/dist/prisma/crud.d.ts

@@ -8,8 +8,9 @@ export type PrismaLikeClient = {
 };
 export type PrismaCrud = AsyncSqliteCrud<PrismaLikeClient>;
 /**
- * Create a Crud bound to a PrismaClient (SQLite).
+ * Create a Crud bound to a PrismaClient.
  * Methods are async. The injected client is exposed as `crud.db`.
+ * Pass `options.dialect` for Postgres / MySQL (`"sqlite"` default).
  */
 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":"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"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/prisma/crud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAElE,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;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,UAAU,CAgDZ"}

package/dist/prisma/crud.js

@@ -1,5 +1,6 @@
 import { CrudianError } from "../index.js";
-import { createAsyncSqliteCrud, } from "../sqlite/async-crud.js";
+import { resolveDialect } from "../dialect/index.js";
+import { createAsyncCrud, } from "../sqlite/async-crud.js";
 function normalizeRow(row) {
     const out = { ...row };
     for (const [k, v] of Object.entries(out)) {
@@ -9,8 +10,9 @@ function normalizeRow(row) {
     return out;
 }
 /**
- * Create a Crud bound to a PrismaClient (SQLite).
+ * Create a Crud bound to a PrismaClient.
  * Methods are async. The injected client is exposed as `crud.db`.
+ * Pass `options.dialect` for Postgres / MySQL (`"sqlite"` default).
  */
 export function createCrud(client, options) {
     if (client == null) {
@@ -23,7 +25,8 @@ export function createCrud(client, options) {
         throw new CrudianError("db must be a PrismaClient");
     }
     let active = client;
-    return createAsyncSqliteCrud(client, {
+    const dialect = resolveDialect(options?.dialect);
+    return createAsyncCrud(client, {
         async run(sql, args = []) {
             const changes = await active.$executeRawUnsafe(sql, ...args);
             return { changes: Number(changes ?? 0) };
@@ -50,7 +53,7 @@ export function createCrud(client, options) {
                 }
             });
         },
-    }, options);
+    }, dialect, options);
 }
 function normalizeQueryResult(result) {
     if (result == null)

package/dist/prisma/server-dialect-harness.d.ts

@@ -0,0 +1,16 @@
+import { type PrismaLikeClient } from "./index.js";
+export type DialectName = "postgres" | "mysql";
+export type ServerDbHarness = {
+    dialect: DialectName;
+    envKey: "DATABASE_URL_POSTGRES" | "DATABASE_URL_MYSQL";
+    createClient: () => PrismaLikeClient & {
+        $disconnect(): Promise<void>;
+        $executeRawUnsafe(q: string, ...a: unknown[]): Promise<number>;
+    };
+    createItemsDDL: string;
+    dropItemsDDL: string;
+    createAltPkDDL: string;
+    dropAltPkDDL: string;
+};
+export declare function registerPrismaServerDialectTests(h: ServerDbHarness): void;
+//# sourceMappingURL=server-dialect-harness.d.ts.map

package/dist/prisma/server-dialect-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-dialect-harness.d.ts","sourceRoot":"","sources":["../../src/prisma/server-dialect-harness.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE9D,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,CAAA;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,uBAAuB,GAAG,oBAAoB,CAAA;IACtD,YAAY,EAAE,MAAM,gBAAgB,GAAG;QAAE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;IACvI,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,eAAe,QA0IlE"}

package/dist/prisma/server-dialect-harness.js

@@ -0,0 +1,120 @@
+/**
+ * Shared contract suite for Prisma against Postgres / MySQL.
+ * Skipped automatically when the DATABASE_URL_* env var is unset.
+ */
+import assert from "node:assert/strict";
+import { after, before, describe, test } from "node:test";
+import { CrudianError, where } from "../index.js";
+import { createCrud } from "./index.js";
+export function registerPrismaServerDialectTests(h) {
+    const url = process.env[h.envKey];
+    const suite = describe;
+    suite(`prisma.${h.dialect}`, { skip: !url }, () => {
+        let client;
+        let crud;
+        before(async () => {
+            if (!url)
+                return;
+            process.env[h.envKey] = url;
+            client = h.createClient();
+            await client.$executeRawUnsafe(h.dropItemsDDL);
+            await client.$executeRawUnsafe(h.createItemsDDL);
+            crud = createCrud(client, { dialect: h.dialect });
+        });
+        after(async () => {
+            if (!url)
+                return;
+            try {
+                await client.$executeRawUnsafe(h.dropItemsDDL);
+                await client.$executeRawUnsafe(h.dropAltPkDDL);
+            }
+            catch {
+                /* ignore */
+            }
+            await client.$disconnect();
+        });
+        async function reset() {
+            await client.$executeRawUnsafe(h.dropItemsDDL);
+            await client.$executeRawUnsafe(h.createItemsDDL);
+        }
+        test("正常系: create / read / update / delete", async () => {
+            await reset();
+            const created = await crud.create("items", { name: "alice", score: 10 });
+            assert.equal(created.name, "alice");
+            assert.ok(created.id != null);
+            const got = await crud.read("items", {
+                where: where().eq("id", created.id),
+            });
+            assert.equal(got?.name, "alice");
+            const updated = await crud.update("items", { score: 20 }, { where: where().eq("id", created.id) });
+            assert.equal(updated?.score, 20);
+            const n = await crud.delete("items", {
+                where: where().eq("id", created.id),
+            });
+            assert.equal(n, 1);
+            assert.equal(await crud.read("items", { where: where().eq("id", created.id) }), null);
+        });
+        test("正常系: count / exists / search offset / cursor", async () => {
+            await reset();
+            await crud.bulkCreate("items", [
+                { name: "a", score: 1 },
+                { name: "b", score: 2 },
+                { name: "c", score: 3 },
+            ]);
+            assert.equal(await crud.count("items"), 3);
+            assert.equal(await crud.exists("items", { where: where().eq("name", "b") }), true);
+            assert.equal(await crud.exists("items", { where: where().eq("name", "z") }), false);
+            const page = await crud.search("items", { limit: 2, offset: 0 });
+            assert.equal(page.items.length, 2);
+            assert.equal("total" in page && page.total, 3);
+            assert.equal("hasMore" in page && page.hasMore, true);
+            const cursorPage = await crud.search("items", {
+                paging: "cursor",
+                limit: 2,
+            });
+            assert.equal(cursorPage.items.length, 2);
+            assert.ok("nextCursor" in cursorPage);
+        });
+        test("正常系: upsert / duplicate / transaction", async () => {
+            await reset();
+            const a = await crud.create("items", { name: "x", score: 1 });
+            const up = await crud.upsert("items", {
+                id: a.id,
+                name: "x",
+                score: 9,
+            });
+            assert.equal(up.score, 9);
+            const dup = await crud.duplicate("items", {
+                where: where().eq("id", a.id),
+                overrides: { name: "y" },
+            });
+            assert.ok(dup);
+            assert.notEqual(dup.id, a.id);
+            assert.equal(dup.name, "y");
+            await crud.transaction(async () => {
+                await crud.create("items", { name: "tx", score: 1 });
+            });
+            assert.equal(await crud.exists("items", { where: where().eq("name", "tx") }), true);
+        });
+        test("正常系: 可変 PK", async () => {
+            await reset();
+            await client.$executeRawUnsafe(h.dropAltPkDDL);
+            await client.$executeRawUnsafe(h.createAltPkDDL);
+            const alt = createCrud(client, { dialect: h.dialect, pk: "item_id" });
+            const row = await alt.create("alt_items", { name: "pk" });
+            assert.ok(row.item_id != null);
+            const got = await alt.read("alt_items", {
+                where: where().eq("item_id", row.item_id),
+            });
+            assert.equal(got?.name, "pk");
+            await client.$executeRawUnsafe(h.dropAltPkDDL);
+        });
+        test("異常系: 空 in / 不正 dialect は拒否", async () => {
+            await reset();
+            await assert.rejects(() => crud.search("items", {
+                where: where().in("id", []),
+            }), CrudianError);
+            assert.throws(() => createCrud(client, { dialect: "nope" }), CrudianError);
+        });
+    });
+}

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

@@ -1,4 +1,5 @@
 import { type CountQuery, type CreateCrudOptions, type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
+import type { Dialect } from "../dialect/types.js";
 export type AsyncSqliteExecutor = {
     run(sql: string, args?: unknown[]): Promise<{
         changes: number;
@@ -25,5 +26,8 @@ export type AsyncSqliteCrud<TDb> = {
     exists(table: string, query?: CountQuery): Promise<boolean>;
     transaction<T>(fn: () => Promise<T>): Promise<T>;
 };
+/** Dialect-aware async CRUD factory. */
+export declare function createAsyncCrud<TDb>(db: TDb, ex: AsyncSqliteExecutor, dialect: Dialect, options?: CreateCrudOptions): AsyncSqliteCrud<TDb>;
+/** SQLite async CRUD (compat). */
 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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"}