@justwant/db 0.2.0

package/dist/waddler/tidb/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Waddler adapter for TiDB (MySQL-compatible).
+ * @see https://waddler.drizzle.team/docs/connect-tidb
+ *
+ * Peer deps: waddler, @tidbcloud/serverless
+ */
+import type { WaddlerConnectionConfig } from "../types.js";
+export interface CreateTidbAdapterConfig {
+    connection?: string;
+    client?: unknown;
+}
+/**
+ * Creates a TiDB (MySQL-compatible) connection config. Pass to createDb.
+ * Pass connection string or existing driver.
+ */
+export declare function createTidbAdapter(config: CreateTidbAdapterConfig): WaddlerConnectionConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/waddler/tidb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/waddler/tidb/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAc,MAAM,aAAa,CAAC;AAIvE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,uBAAuB,CAgB1F"}

package/dist/waddler/tidb/index.js

@@ -0,0 +1,29 @@
+/**
+ * Waddler adapter for TiDB (MySQL-compatible).
+ * @see https://waddler.drizzle.team/docs/connect-tidb
+ *
+ * Peer deps: waddler, @tidbcloud/serverless
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/**
+ * Creates a TiDB (MySQL-compatible) connection config. Pass to createDb.
+ * Pass connection string or existing driver.
+ */
+export function createTidbAdapter(config) {
+    if (!config.client && config.connection == null) {
+        throw new Error("createTidbAdapter: connection or client is required");
+    }
+    const { waddler } = require("waddler/tidb-serverless");
+    if (config.client) {
+        return { sql: waddler({ client: config.client }), dialect: "mysql", driver: config.client };
+    }
+    if (config.connection == null)
+        throw new Error("connection required");
+    return {
+        sql: waddler({ connection: config.connection }),
+        dialect: "mysql",
+        driver: config.client,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/waddler/tidb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/waddler/tidb/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAO/C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAEpD,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9F,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACtE,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/C,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/waddler/turso/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Waddler adapter for Turso (LibSQL).
+ * @see https://waddler.drizzle.team/docs/connect-turso
+ *
+ * Peer deps: waddler, @libsql/client
+ */
+import type { WaddlerConnectionConfig } from "../types.js";
+export interface CreateTursoAdapterConfig {
+    connection?: string;
+    client?: unknown;
+}
+/**
+ * Creates a Turso (LibSQL) connection config. Pass to createDb.
+ * Pass connection config or existing LibSQL client.
+ */
+export declare function createTursoAdapter(config: CreateTursoAdapterConfig): WaddlerConnectionConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/waddler/turso/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/waddler/turso/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAc,MAAM,aAAa,CAAC;AAIvE,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,uBAAuB,CAgB5F"}

package/dist/waddler/turso/index.js

@@ -0,0 +1,29 @@
+/**
+ * Waddler adapter for Turso (LibSQL).
+ * @see https://waddler.drizzle.team/docs/connect-turso
+ *
+ * Peer deps: waddler, @libsql/client
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/**
+ * Creates a Turso (LibSQL) connection config. Pass to createDb.
+ * Pass connection config or existing LibSQL client.
+ */
+export function createTursoAdapter(config) {
+    if (!config.client && config.connection == null) {
+        throw new Error("createTursoAdapter: connection or client is required");
+    }
+    const { waddler } = require("waddler/libsql");
+    if (config.client) {
+        return { sql: waddler({ client: config.client }), dialect: "sqlite", driver: config.client };
+    }
+    if (config.connection == null)
+        throw new Error("connection required");
+    return {
+        sql: waddler({ connection: config.connection }),
+        dialect: "sqlite",
+        driver: config.client,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/waddler/turso/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/waddler/turso/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAO/C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgC;IACjE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAE3C,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC/F,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACtE,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/C,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/waddler/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Waddler adapter types.
+ * Schema-less: table and column names are strings.
+ */
+import type { AnyContract, TableContract } from "@justwant/contract";
+import type { MappedTable, MappedTableInternal } from "@justwant/db";
+/** String-based mapping: contract key → column name. */
+export type StringMapping<TContract extends AnyContract> = {
+    [K in keyof TContract]: {
+        name: string;
+    };
+};
+/** Table source: table name or schema.table. */
+export type TableSource = string | {
+    schema?: string;
+    table: string;
+};
+/**
+ * Waddler SQL client interface.
+ * Compatible with waddler/node-postgres, waddler/neon-http, etc.
+ */
+export interface WaddlerSql {
+    (strings: TemplateStringsArray, ...values: unknown[]): WaddlerQuery;
+    identifier: (name: string | {
+        schema?: string;
+        table: string;
+        column?: string;
+        as?: string;
+    }) => unknown;
+    raw: (sql: string) => unknown;
+    values: (tuples: unknown[][]) => unknown;
+    append?: (part: unknown) => WaddlerQuery;
+}
+/** Query result - thenable, may have append for building. */
+export interface WaddlerQuery {
+    then<T>(onfulfilled?: (value: unknown) => T | PromiseLike<T>): Promise<T>;
+    catch<T>(onrejected?: (reason: unknown) => T | PromiseLike<T>): Promise<T>;
+    append?: (part: unknown) => WaddlerQuery;
+}
+export interface WaddlerMappedTableInternal<TContract extends AnyContract> extends MappedTableInternal<TContract> {
+    readonly tableName: string;
+    readonly mapping: StringMapping<TContract>;
+    readonly client: WaddlerSql;
+}
+export interface WaddlerMappedTable<TContract extends AnyContract> extends MappedTable<TContract> {
+    readonly _internal: WaddlerMappedTableInternal<TContract>;
+}
+export type WaddlerDialect = "pg" | "mysql" | "sqlite";
+/** Connection config passed to createDb. Returned by driver factories (createBunSqliteAdapter, etc.). */
+export interface WaddlerConnectionConfig {
+    sql: WaddlerSql;
+    dialect: WaddlerDialect;
+    driver?: unknown;
+    onValidationError?: "throw" | "return";
+    /** Release connection when done. Call db.close() or await on shutdown. */
+    close?: () => Promise<void>;
+}
+export interface CreateWaddlerAdapterOptions {
+    dialect: WaddlerDialect;
+    /** Expose the native driver (pg Pool, neon client, etc.). */
+    driver?: unknown;
+    /** On validation error: "throw" (default) or "return" for createSafe/updateSafe. */
+    onValidationError?: "throw" | "return";
+}
+export interface TableOptions {
+    /** Override mapping for specific keys. Merged with contract.mapping. */
+    mapping?: Partial<Record<string, {
+        name: string;
+    }>>;
+    /** Column name for soft delete. Default 'deletedAt'. Set to null to disable. */
+    softDeleteColumn?: string | null;
+}
+export interface Db {
+    readonly sql: WaddlerSql;
+    readonly driver?: unknown;
+    readonly dialect: WaddlerDialect;
+    /** Execute getCreateTableSQL and run DDL. */
+    createTable<T extends TableContract<AnyContract>>(contract: T): Promise<void>;
+    /** Create table from TableContract (tableName + mapping from contract). */
+    table<T extends TableContract<AnyContract>>(contract: T, options?: TableOptions): WaddlerMappedTable<T["fields"]>;
+    /** Legacy: define table with explicit tableSource, contract, mapping. */
+    defineTable<TContract extends AnyContract>(tableName: TableSource, contract: TContract, mapping: StringMapping<TContract>, options?: DefineWaddlerTableOptions): WaddlerMappedTable<TContract>;
+    transaction?<T>(fn: (tx: Db) => Promise<T>): Promise<T>;
+    /** Release connection. No-op if config had no close. */
+    close?(): Promise<void>;
+}
+export interface DefineWaddlerTableOptions {
+    /** Column name for soft delete. Default 'deletedAt'. Set to null to disable. */
+    softDeleteColumn?: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/waddler/types.ts"],"names":[],"mappings":"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"}

package/dist/waddler/types.js

@@ -0,0 +1,6 @@
+/**
+ * Waddler adapter types.
+ * Schema-less: table and column names are strings.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/waddler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/waddler/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/waddler/vercel-postgres/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Waddler adapter for Vercel Postgres.
+ * @see https://waddler.drizzle.team/docs/connect-vercel-postgres
+ *
+ * Peer deps: waddler, @vercel/postgres
+ */
+import type { WaddlerConnectionConfig } from "../types.js";
+export interface CreateVercelPostgresAdapterConfig {
+    connection?: string;
+    client?: unknown;
+}
+/**
+ * Creates a Vercel Postgres connection config. Pass to createDb.
+ * Pass connection string or existing Pool client.
+ */
+export declare function createVercelPostgresAdapter(config: CreateVercelPostgresAdapterConfig): WaddlerConnectionConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/waddler/vercel-postgres/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/waddler/vercel-postgres/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAc,MAAM,aAAa,CAAC;AAIvE,MAAM,WAAW,iCAAiC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,iCAAiC,GACxC,uBAAuB,CAYzB"}

package/dist/waddler/vercel-postgres/index.js

@@ -0,0 +1,25 @@
+/**
+ * Waddler adapter for Vercel Postgres.
+ * @see https://waddler.drizzle.team/docs/connect-vercel-postgres
+ *
+ * Peer deps: waddler, @vercel/postgres
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/**
+ * Creates a Vercel Postgres connection config. Pass to createDb.
+ * Pass connection string or existing Pool client.
+ */
+export function createVercelPostgresAdapter(config) {
+    if (!config.client && config.connection == null) {
+        throw new Error("createVercelPostgresAdapter: connection or client is required");
+    }
+    const { waddler } = require("waddler/vercel-postgres");
+    if (config.client) {
+        return { sql: waddler({ client: config.client }), dialect: "pg", driver: config.client };
+    }
+    if (config.connection == null)
+        throw new Error("connection required");
+    return { sql: waddler({ connection: config.connection }), dialect: "pg", driver: config.client };
+}
+//# sourceMappingURL=index.js.map

package/dist/waddler/vercel-postgres/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/waddler/vercel-postgres/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAO/C;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAyC;IAEzC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAEpD,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3F,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACtE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AACnG,CAAC"}

package/dist/waddler/xata/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Waddler adapter for Xata (PostgreSQL).
+ * @see https://waddler.drizzle.team/docs/connect-xata
+ *
+ * Peer deps: waddler, @xata.io/client
+ */
+import type { WaddlerConnectionConfig } from "../types.js";
+export interface CreateXataAdapterConfig {
+    connection?: string;
+    client?: unknown;
+}
+/**
+ * Creates an Xata PostgreSQL connection config. Pass to createDb.
+ * Pass connection string or existing XataClient.
+ */
+export declare function createXataAdapter(config: CreateXataAdapterConfig): WaddlerConnectionConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/waddler/xata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/waddler/xata/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAc,MAAM,aAAa,CAAC;AAIvE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,uBAAuB,CAY1F"}

package/dist/waddler/xata/index.js

@@ -0,0 +1,25 @@
+/**
+ * Waddler adapter for Xata (PostgreSQL).
+ * @see https://waddler.drizzle.team/docs/connect-xata
+ *
+ * Peer deps: waddler, @xata.io/client
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/**
+ * Creates an Xata PostgreSQL connection config. Pass to createDb.
+ * Pass connection string or existing XataClient.
+ */
+export function createXataAdapter(config) {
+    if (!config.client && config.connection == null) {
+        throw new Error("createXataAdapter: connection or client is required");
+    }
+    const { waddler } = require("waddler/xata-http");
+    if (config.client) {
+        return { sql: waddler({ client: config.client }), dialect: "pg", driver: config.client };
+    }
+    if (config.connection == null)
+        throw new Error("connection required");
+    return { sql: waddler({ connection: config.connection }), dialect: "pg", driver: config.client };
+}
+//# sourceMappingURL=index.js.map

package/dist/waddler/xata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/waddler/xata/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAO/C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAE9C,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3F,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACtE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AACnG,CAAC"}

package/docs/CONTRACT.md

@@ -0,0 +1,36 @@
+# Contract invariants
+
+## FieldDef
+
+- **`_required: true`** — Field is required in create/update. Must be present.
+- **`_required: false`** — Field is optional. Can be omitted.
+- **`_nullable: true`** — Optional fields. At read time, DB `null` → JS `undefined`.
+- **`_nullable: false`** — Required fields. Never null.
+
+## BoundQuery
+
+- **Lazy execution** — Queries are not run until `execute()` is called.
+- **Transaction context** — When inside `adapter.transaction(fn)`, `execute()` uses the transaction context. Implementations must propagate this.
+- **No factory** — This package does not provide `createBoundQuery()`. Implementations (e.g. `@justwant/db/drizzle`) construct `BoundQuery` objects. Example:
+
+  ```ts
+  const q: BoundQuery<T> = {
+    get _result() { return undefined as T },
+    async execute() { return /* run query */ }
+  }
+  ```
+
+## MappedTableInternal.sql
+
+- **delete(id)** — Soft delete. Marks row as deleted, preserves data. Typically sets `deleted_at` or similar.
+- **hardDelete(id)** — Hard delete. Removes row permanently.
+
+## CreateInput
+
+- Excludes `id`, `createdAt`, `updatedAt` by default. Override if your schema uses different column names.
+
+## AnyContract
+
+- Must be `Record<string, FieldDef<unknown, boolean>>`.
+- Empty contract `{}` is valid.
+- Index signatures are not supported.

package/docs/COVERAGE.md

@@ -0,0 +1,59 @@
+# Couverture des tests — @justwant/db
+
+## Résumé
+
+| Module | Spec | Couverture estimée | Lacunes |
+|--------|------|-------------------|---------|
+| **base/** | | | |
+| contract.ts | contract.spec.ts | ✓ | — |
+| tableContract.ts | tableContract.spec.ts | ✓ | — |
+| table.ts | table.spec.ts | ✓ | — |
+| conforms.ts | conforms.spec.ts | ✓ | — |
+| validate.ts | validate.spec.ts | ✓ | — |
+| schemas.ts | schemas.spec.ts | ✓ | — |
+| fieldBuilder.ts | via tableContract, validate | ✓ | — |
+| fields.ts | réexport | ✓ | — |
+| errors.ts | adapter.spec.ts | ✓ | — |
+| adapter.ts | adapter.spec.ts | ✓ | — |
+| **waddler/** | | | |
+| core.ts | createAdapter.spec.ts, integration.spec.ts | ✓ | buildWhere, buildOrderBy (indirect) |
+| errors.ts | errors.spec.ts | ✓ | — |
+| buildWhere.ts | via createAdapter | ✓ | — |
+| mapping.ts | via drizzle/mapping.spec | ✓ | — |
+| **drizzle/** | | | |
+| createAdapter.ts | createAdapter.spec.ts | ✓ | — |
+| buildWhere, buildOrderBy, buildPagination | *.spec.ts | ✓ | — |
+| mapping, upsert, bulkInsert, collectSchemas | *.spec.ts | ✓ | — |
+| errors.ts | errors.spec.ts | ✓ | — |
+| **prisma/** | | | |
+| createAdapter.ts | createAdapter.spec.ts | ✓ | — |
+| buildWhere, mapping, upsert, bulkInsert | *.spec.ts | ✓ | — |
+| errors.ts | errors.spec.ts | ✓ | — |
+
+## Fichiers sans spec dédié
+
+- **Entry points** (bun-sqlite, pg, neon, etc.) : wrappers minces autour de `createWaddlerAdapter`, couverts par les tests d’intégration.
+- **fieldBuilder.ts** : couvert via tableContract (defineContract avec field builders) et validate (email, uuid).
+- **waddler/buildOrderBy.ts** : non utilisé par le core waddler actuel ; couvert si utilisé via drizzle.
+
+## Tests E2E / intégration
+
+- `waddler/integration.spec.ts` : CRUD complet avec bun-sqlite.
+- `prisma/integration.spec.ts` : CRUD avec Prisma.
+- `drizzle/createAdapter.spec.ts` : CRUD avec Drizzle + SQLite.
+
+## Verdict
+
+**Couverture suffisante** pour un package DAL :
+
+1. **API publique** : create, findById, findOne, findMany, update, delete, createSafe, updateSafe, table(), createTable() sont testés.
+2. **Validation** : validateContractData, ContractValidationError, createSafe couverts.
+3. **Conformité** : assertTableConforms, conformsTo, tableConforms couverts.
+4. **Erreurs** : hiérarchie AdapterError et parseWaddlerError/parseDbError couvertes.
+5. **Schémas** : uuid, email, url, ipv4, slug validés.
+
+## Recommandations
+
+1. **Coverage threshold** : ajouter `coverageThreshold = 0.8` dans `bunfig.toml` pour bloquer les merges si la couverture baisse.
+2. **Tests manquants** : `updateSafe` avec validation échouée (retourne `{ ok: false }`).
+3. **E2E multi-dialecte** : un test pg ou mysql en CI si possible.

package/docs/DRIVERS.md

@@ -0,0 +1,62 @@
+# DB Drivers (Waddler)
+
+Pass the driver config to `createDb` for tree-shaking. Import only the driver you need. Connection must be passed explicitly (no `process.env` fallback in drivers).
+
+## Bun SQLite
+
+**Package:** `@justwant/db/bun-sqlite`  
+**Peer deps:** waddler (Bun runtime)
+
+```ts
+import { createDb } from "@justwant/db/waddler";
+import { createBunSqliteAdapter } from "@justwant/db/bun-sqlite";
+
+const db = createDb(createBunSqliteAdapter({ connection: ":memory:" }));
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `connection` | `string` | Path or `:memory:`. Default: `:memory:` |
+| `client` | `unknown` | Existing Database |
+
+## PostgreSQL (node-postgres)
+
+**Package:** `@justwant/db/pg`
+
+```ts
+const db = createDb(createPgAdapter({ connection: "postgresql://user:pass@localhost/db" }));
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `connection` | `string` | Connection string (required if no client) |
+| `client` | `unknown` | Existing pg Pool/Client |
+
+## Neon
+
+**Package:** `@justwant/db/neon`
+
+```ts
+const db = createDb(createNeonAdapter({ connection: "postgresql://..." }));
+```
+
+## Vercel Postgres, Xata, PGLite, Bun SQL, postgres.js
+
+Same pattern: `{ connection: string }` or `{ client: unknown }`.
+
+## MySQL, PlanetScale, TiDB
+
+```ts
+const db = createDb(createMysqlAdapter({ connection: "mysql://..." }));
+```
+
+## Turso, D1, Durable Objects, better-sqlite3
+
+- **Turso:** `{ connection: string }` or `{ client: unknown }`
+- **D1:** `{ client: unknown }` (required)
+- **Durable Objects:** `{ client: unknown }` (required)
+- **better-sqlite3:** `{ connection: ":memory:" }` or `{ client: unknown }`
+
+## Mapping
+
+See [@justwant/contract README](../../contract/README.md#mapping-contract-key--column-name). Default: contract key = column name. Use `defaultMapping: "camelToSnake"` or `mapping` to override.

package/docs/drizzle/DIALECTS.md

@@ -0,0 +1,62 @@
+# Supported Dialects and Types
+
+`@justwant/db/drizzle` supports PostgreSQL, MySQL, and SQLite via Drizzle ORM.
+
+## Drivers
+
+| Dialect | Drizzle driver | Package |
+|---------|---------------|---------|
+| **PostgreSQL** | `drizzle-orm/node-pg` | `pg` |
+| **MySQL** | `drizzle-orm/mysql2` | `mysql2` |
+| **SQLite** | `drizzle-orm/better-sqlite3` | `better-sqlite3` |
+| **SQLite (Bun)** | `drizzle-orm/bun-sqlite` | built-in `bun:sqlite` |
+
+## Type Support by Dialect
+
+### PostgreSQL
+
+- `text`, `varchar`, `char` → `string`
+- `integer`, `bigint`, `smallint` → `number`
+- `boolean` → `boolean`
+- `timestamp`, `timestamptz`, `date` → `Date`
+- `json`, `jsonb` → `unknown` (or typed via schema)
+- `uuid` → `string`
+- `numeric`, `decimal` → `number` or `string` (precision-dependent)
+
+### MySQL
+
+- `varchar`, `char`, `text` → `string`
+- `int`, `bigint`, `tinyint` → `number` (tinyint as boolean: `0`/`1`)
+- `boolean` (alias for tinyint) → `boolean`
+- `datetime`, `timestamp`, `date` → `Date`
+- `json` → `unknown`
+- `decimal` → `number` or `string`
+
+### SQLite
+
+- `text` → `string`
+- `integer` → `number`
+- `real` → `number`
+- `blob` → `Buffer` or `Uint8Array`
+- `boolean` (stored as integer 0/1) → `boolean`
+- `numeric` → `number` or `string`
+
+## Enums
+
+- **PostgreSQL**: `pgEnum()` → TypeScript `string` union
+- **MySQL**: `mysqlEnum()` → TypeScript `string` union
+- **SQLite**: Use `text` with check constraint or application-level validation
+
+## Dialect Detection
+
+The adapter infers dialect from `db.dialect.name`:
+
+- `"pg"` or `"postgresql"` → PostgreSQL
+- `"mysql"` → MySQL
+- `"sqlite"` or `"bun-sqlite"` → SQLite
+
+For drivers where auto-detection fails (e.g. `drizzle-orm/bun-sqlite`), pass `dialect` explicitly:
+
+```ts
+createDrizzleAdapter(db, { dialect: "sqlite" });
+```

package/docs/drizzle/LIMITS.md

@@ -0,0 +1,39 @@
+# Known Limits
+
+## drizzle-orm Version Compatibility
+
+- **0.45.x**: Tested and supported.
+- **1.0.0-beta.x**: Tested with `1.0.0-beta.16` and compatible. The adapter uses the core query builder API (`select`, `insert`, `update`, `delete`, `eq`, `and`, `isNull`, `getTableName`) and does not rely on RQB (Relational Query Builder), so RQBv1→v2 migration does not affect this package.
+- **Internal types**: `Table['_']['columns']` and `Column._.data` are used for mapping; if Drizzle changes these internals in a future release, `drizzle-types.ts` is the single point to update.
+
+## Upsert
+
+- **PostgreSQL**: Full support via `ON CONFLICT DO UPDATE`
+- **MySQL**: Not supported (throws `AdapterUnsupportedError`). Use `ON DUPLICATE KEY` manually or a separate package.
+- **SQLite**: Not supported in Phase 1. May be added later.
+
+## Computed / Generated Columns
+
+- Columns with database-side defaults (e.g. `DEFAULT (lower(hex(randomblob(16))))`) are supported for inserts when omitted.
+- Application-generated values (e.g. `$defaultFn`) are handled by Drizzle; ensure your mapping includes them when reading.
+- Virtual/computed columns that are not stored are not supported in the mapping.
+
+## JSON / JSONB
+
+- Stored and retrieved as `unknown` by default.
+- Use schema-level typing or `mapRowToContract` custom logic for typed JSON fields.
+
+## Index Signatures in Contracts
+
+- `InferContract` does not support index signatures (`[key: string]: T`).
+- Use explicit field definitions only.
+
+## Migrations
+
+- `collectSchemas()` returns tables for inspection.
+- Use **drizzle-kit** for migration generation: `drizzle-kit generate`, `drizzle-kit migrate`.
+
+## Transactions
+
+- Supported when the Drizzle client exposes `transaction(fn)`.
+- The transaction adapter uses the same API; all `defineTable` tables use the transactional client during the callback.