@justwant/db 0.2.0

package/README.md

@@ -0,0 +1,111 @@
+# @justwant/db
+
+[![npm version](https://img.shields.io/npm/v/@justwant/db.svg)](https://www.npmjs.com/package/@justwant/db)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Data Access Layer for transactional databases. Define contracts once, plug any backend (Drizzle, Prisma, Waddler).
+
+## Installation
+
+```bash
+bun add @justwant/db
+# or
+npm install @justwant/db
+# or
+pnpm add @justwant/db
+```
+
+## Usage
+
+### defineContract, field, InferContract
+
+```ts
+import { defineContract, field, type InferContract } from "@justwant/contract";
+
+const UserContract = defineContract({
+  id: field<string>().required(),
+  email: field<string>().required(),
+  emailVerified: field<boolean>().required(),
+  createdAt: field<Date>().required(),
+  name: field<string>().optional(),
+});
+
+type User = InferContract<typeof UserContract>;
+// { id: string; email: string; emailVerified: boolean; createdAt: Date; name?: string }
+```
+
+### AdapterError
+
+```ts
+import { AdapterError } from "@justwant/db";
+
+throw new AdapterError("User not found", "NOT_FOUND");
+```
+
+### Hierarchy
+
+```
+@justwant/db              ← base (contracts, types)
+@justwant/db/drizzle      ← Drizzle ORM implementation
+@justwant/db/prisma       ← Prisma implementation
+@justwant/db/waddler      ← Waddler core (createDb, createWaddlerAdapter)
+@justwant/db/bun-sqlite   ← Bun SQLite (createBunSqliteAdapter)
+@justwant/db/pg           ← PostgreSQL (createPgAdapter)
+...                       ← other backends (neon, mysql, turso, etc.)
+        ↓ consumed by
+@justwant/auth, @justwant/audit, @justwant/keys...
+  → see only MappedTable<TContract>, never Drizzle/Prisma types
+```
+
+## Exports
+
+| Entry | Content |
+|-------|---------|
+| `@justwant/db` | Base: table types, errors, tableConforms |
+| `@justwant/db/base` | Same as main |
+| `@justwant/contract` | field, defineContract, InferContract, uuid, string, etc. (import from @justwant/contract) |
+| `@justwant/db/table` | MappedTable, MappedTableInternal, BoundQuery, CreateInput |
+| `@justwant/db/adapter` | BaseAdapter, PackageAdapter |
+| `@justwant/db/errors` | AdapterError hierarchy |
+| `@justwant/db/conforms` | tableConforms |
+| `@justwant/db/drizzle` | createDrizzleAdapter, defineMappedTable, helpers |
+| `@justwant/db/prisma` | createPrismaAdapter, helpers |
+| `@justwant/db/waddler` | createDb, createWaddlerAdapter (core) |
+| `@justwant/db/bun-sqlite` | createBunSqliteAdapter |
+| `@justwant/db/pg` | createPgAdapter |
+| `@justwant/db/neon` | createNeonAdapter |
+| ... | other backends: vercel-postgres, xata, pglite, bun-sql, postgres-js, mysql, planetscale, tidb, turso, d1, durable-objects, better-sqlite3 |
+
+### Table-centric DDL (Waddler)
+
+```ts
+import { defineContract, uuid, email, string } from "@justwant/contract";
+import { createDb } from "@justwant/db/waddler";
+import { createBunSqliteAdapter } from "@justwant/db/bun-sqlite";
+
+const UserContract = defineContract("users", {
+  id: uuid().required().primaryKey(),
+  email: email().required(),
+  name: string().optional(),
+});
+
+const db = createDb(createBunSqliteAdapter({ connection: ":memory:" }));
+const users = db.table(UserContract);
+
+await users.createTable();
+const exists = await users.exist(); // true
+// ... create, findById, etc.
+await users.drop();
+```
+
+## Docs
+
+- [Drivers](docs/DRIVERS.md) — config per driver, mapping
+
+## Invariants
+
+See [docs/CONTRACT.md](./docs/CONTRACT.md) for detailed invariants and implementation guidance.
+
+## License
+
+MIT © [elydelva](https://github.com/elydelva)

package/dist/adapter.d.ts

@@ -0,0 +1,11 @@
+import type { AnyContract } from "./contract.js";
+import type { MappedTable } from "./table.js";
+export interface BaseAdapter {
+    readonly dialect: "pg" | "mysql" | "sqlite";
+    defineTable<TSource, TContract extends AnyContract>(source: TSource, contract: TContract, mapping: unknown): MappedTable<TContract>;
+    transaction<T>(fn: (tx: this) => Promise<T>): Promise<T>;
+}
+export interface PackageAdapter<TContract extends AnyContract> {
+    table: MappedTable<TContract>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE5C,WAAW,CAAC,OAAO,EAAE,SAAS,SAAS,WAAW,EAChD,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,OAAO,GACf,WAAW,CAAC,SAAS,CAAC,CAAC;IAE1B,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc,CAAC,SAAS,SAAS,WAAW;IAC3D,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CAC/B"}

package/dist/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/base/adapter.d.ts

@@ -0,0 +1,11 @@
+import type { AnyContract } from "@justwant/contract";
+import type { MappedTable } from "./table.js";
+export interface BaseAdapter {
+    readonly dialect: "pg" | "mysql" | "sqlite";
+    defineTable<TSource, TContract extends AnyContract>(source: TSource, contract: TContract, mapping: unknown): MappedTable<TContract>;
+    transaction<T>(fn: (tx: this) => Promise<T>): Promise<T>;
+}
+export interface PackageAdapter<TContract extends AnyContract> {
+    table: MappedTable<TContract>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/base/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/base/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE5C,WAAW,CAAC,OAAO,EAAE,SAAS,SAAS,WAAW,EAChD,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,OAAO,GACf,WAAW,CAAC,SAAS,CAAC,CAAC;IAE1B,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc,CAAC,SAAS,SAAS,WAAW;IAC3D,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CAC/B"}

package/dist/base/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/base/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/base/adapter.ts"],"names":[],"mappings":""}

package/dist/base/conforms.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MappedTable-specific conformity check.
+ */
+import type { AnyContract } from "@justwant/contract";
+import type { TableContract } from "@justwant/contract";
+import type { MappedTable } from "./table.js";
+/**
+ * Runtime assertion + cast: verifies table conforms to expected contract,
+ * then returns table typed as MappedTable<T["fields"]>.
+ */
+export declare function tableConforms<T extends TableContract<AnyContract>>(table: MappedTable<AnyContract>, expected: T): MappedTable<T["fields"]>;
+//# sourceMappingURL=conforms.d.ts.map

package/dist/base/conforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conforms.d.ts","sourceRoot":"","sources":["../../src/base/conforms.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC,EAChE,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,EAC/B,QAAQ,EAAE,CAAC,GACV,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAG1B"}

package/dist/base/conforms.js

@@ -0,0 +1,13 @@
+/**
+ * MappedTable-specific conformity check.
+ */
+import { assertTableConforms as _assertTableConforms } from "@justwant/contract/conforms";
+/**
+ * Runtime assertion + cast: verifies table conforms to expected contract,
+ * then returns table typed as MappedTable<T["fields"]>.
+ */
+export function tableConforms(table, expected) {
+    _assertTableConforms(table, expected);
+    return table;
+}
+//# sourceMappingURL=conforms.js.map

package/dist/base/conforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conforms.js","sourceRoot":"","sources":["../../src/base/conforms.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,mBAAmB,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG1F;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA+B,EAC/B,QAAW;IAEX,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,OAAO,KAAiC,CAAC;AAC3C,CAAC"}

package/dist/base/contract.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Contract - re-exports from @justwant/contract.
+ */
+export { field, type AnyContract, type FieldDef, type InferContract, type Infer, type TableFields, } from "@justwant/contract";
+export { defineContract, type TableContract, type StringMapping, type DefineContractOptions, } from "@justwant/contract";
+//# sourceMappingURL=contract.d.ts.map

package/dist/base/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/base/contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC"}

package/dist/base/contract.js

@@ -0,0 +1,6 @@
+/**
+ * Contract - re-exports from @justwant/contract.
+ */
+export { field, } from "@justwant/contract";
+export { defineContract, } from "@justwant/contract";
+//# sourceMappingURL=contract.js.map

package/dist/base/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/base/contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,GAMN,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,GAIf,MAAM,oBAAoB,CAAC"}

package/dist/base/errors.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Normalized error hierarchy for all adapters.
+ * Agnostic of the underlying implementation (Drizzle, Prisma, custom).
+ *
+ * @see docs/CONTRACT.md for usage and error codes.
+ */
+export type ConstraintType = "FOREIGN_KEY" | "UNIQUE" | "NOT_NULL" | "CHECK" | "OTHER";
+export declare class AdapterError extends Error {
+    readonly code: string;
+    readonly metadata?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, metadata?: Record<string, unknown> | undefined);
+}
+export declare class AdapterNotFoundError extends AdapterError {
+    constructor(message: string, metadata?: {
+        table?: string;
+        id?: string;
+    });
+}
+export declare class AdapterConstraintError extends AdapterError {
+    readonly constraintType: ConstraintType;
+    constructor(message: string, constraintType: ConstraintType, metadata?: {
+        table?: string;
+        column?: string;
+        constraint?: string;
+    });
+}
+export declare class AdapterForeignKeyViolationError extends AdapterConstraintError {
+    constructor(message: string, metadata?: {
+        table?: string;
+        column?: string;
+        referencedTable?: string;
+    });
+}
+export declare class AdapterUniqueViolationError extends AdapterConstraintError {
+    constructor(message: string, metadata?: {
+        table?: string;
+        column?: string;
+        constraint?: string;
+    });
+}
+export declare class AdapterNotNullViolationError extends AdapterConstraintError {
+    constructor(message: string, metadata?: {
+        table?: string;
+        column?: string;
+    });
+}
+export declare class AdapterCheckViolationError extends AdapterConstraintError {
+    constructor(message: string, metadata?: {
+        table?: string;
+        constraint?: string;
+    });
+}
+export declare class AdapterMappingError extends AdapterError {
+    constructor(message: string, metadata?: {
+        field?: string;
+        column?: string;
+    });
+}
+export declare class AdapterUnsupportedError extends AdapterError {
+    constructor(message: string, metadata?: {
+        operation?: string;
+        dialect?: string;
+    });
+}
+export declare class AdapterConnectionError extends AdapterError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class AdapterTransactionError extends AdapterError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class AdapterTimeoutError extends AdapterError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare function isAdapterError(err: unknown): err is AdapterError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/base/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/base/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvF,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFlD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAMrD;AAED,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE;CAKxE;AAED,qBAAa,sBAAuB,SAAQ,YAAY;aAGpC,cAAc,EAAE,cAAc;gBAD9C,OAAO,EAAE,MAAM,EACC,cAAc,EAAE,cAAc,EAC9C,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAMtE;AAED,qBAAa,+BAAgC,SAAQ,sBAAsB;gBAEvE,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE;CAM3E;AAED,qBAAa,2BAA4B,SAAQ,sBAAsB;gBAEnE,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAMtE;AAED,qBAAa,4BAA6B,SAAQ,sBAAsB;gBAC1D,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAK5E;AAED,qBAAa,0BAA2B,SAAQ,sBAAsB;gBACxD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAKhF;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAK5E;AAED,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAKjF;AAED,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKhE;AAED,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKhE;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKhE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY,CAEhE"}

package/dist/base/errors.js

@@ -0,0 +1,100 @@
+/**
+ * Normalized error hierarchy for all adapters.
+ * Agnostic of the underlying implementation (Drizzle, Prisma, custom).
+ *
+ * @see docs/CONTRACT.md for usage and error codes.
+ */
+export class AdapterError extends Error {
+    code;
+    metadata;
+    constructor(message, code, metadata) {
+        super(message);
+        this.code = code;
+        this.metadata = metadata;
+        this.name = "AdapterError";
+        Object.setPrototypeOf(this, AdapterError.prototype);
+    }
+}
+export class AdapterNotFoundError extends AdapterError {
+    constructor(message, metadata) {
+        super(message, "NOT_FOUND", metadata);
+        this.name = "AdapterNotFoundError";
+        Object.setPrototypeOf(this, AdapterNotFoundError.prototype);
+    }
+}
+export class AdapterConstraintError extends AdapterError {
+    constraintType;
+    constructor(message, constraintType, metadata) {
+        super(message, constraintType, metadata);
+        this.constraintType = constraintType;
+        this.name = "AdapterConstraintError";
+        Object.setPrototypeOf(this, AdapterConstraintError.prototype);
+    }
+}
+export class AdapterForeignKeyViolationError extends AdapterConstraintError {
+    constructor(message, metadata) {
+        super(message, "FOREIGN_KEY", metadata);
+        this.name = "AdapterForeignKeyViolationError";
+        Object.setPrototypeOf(this, AdapterForeignKeyViolationError.prototype);
+    }
+}
+export class AdapterUniqueViolationError extends AdapterConstraintError {
+    constructor(message, metadata) {
+        super(message, "UNIQUE", metadata);
+        this.name = "AdapterUniqueViolationError";
+        Object.setPrototypeOf(this, AdapterUniqueViolationError.prototype);
+    }
+}
+export class AdapterNotNullViolationError extends AdapterConstraintError {
+    constructor(message, metadata) {
+        super(message, "NOT_NULL", metadata);
+        this.name = "AdapterNotNullViolationError";
+        Object.setPrototypeOf(this, AdapterNotNullViolationError.prototype);
+    }
+}
+export class AdapterCheckViolationError extends AdapterConstraintError {
+    constructor(message, metadata) {
+        super(message, "CHECK", metadata);
+        this.name = "AdapterCheckViolationError";
+        Object.setPrototypeOf(this, AdapterCheckViolationError.prototype);
+    }
+}
+export class AdapterMappingError extends AdapterError {
+    constructor(message, metadata) {
+        super(message, "MAPPING_ERROR", metadata);
+        this.name = "AdapterMappingError";
+        Object.setPrototypeOf(this, AdapterMappingError.prototype);
+    }
+}
+export class AdapterUnsupportedError extends AdapterError {
+    constructor(message, metadata) {
+        super(message, "UNSUPPORTED", metadata);
+        this.name = "AdapterUnsupportedError";
+        Object.setPrototypeOf(this, AdapterUnsupportedError.prototype);
+    }
+}
+export class AdapterConnectionError extends AdapterError {
+    constructor(message, metadata) {
+        super(message, "CONNECTION", metadata);
+        this.name = "AdapterConnectionError";
+        Object.setPrototypeOf(this, AdapterConnectionError.prototype);
+    }
+}
+export class AdapterTransactionError extends AdapterError {
+    constructor(message, metadata) {
+        super(message, "TRANSACTION", metadata);
+        this.name = "AdapterTransactionError";
+        Object.setPrototypeOf(this, AdapterTransactionError.prototype);
+    }
+}
+export class AdapterTimeoutError extends AdapterError {
+    constructor(message, metadata) {
+        super(message, "TIMEOUT", metadata);
+        this.name = "AdapterTimeoutError";
+        Object.setPrototypeOf(this, AdapterTimeoutError.prototype);
+    }
+}
+export function isAdapterError(err) {
+    return err instanceof AdapterError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/base/errors.js.map

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

package/dist/base/fields.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Fields - re-exports from @justwant/contract/fields.
+ */
+export { uuid, string, number, integer, boolean, date, json, email, url, ip, ipv4, ipv6, hostname, slug, uuidSchema, emailSchema, urlSchema, ipSchema, ipv4Schema, ipv6Schema, hostnameSchema, slugSchema, type FieldBuilder, type FieldBuilderState, } from "@justwant/contract/fields";
+//# sourceMappingURL=fields.d.ts.map

package/dist/base/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/base/fields.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,GAAG,EACH,EAAE,EACF,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAC"}

package/dist/base/fields.js

@@ -0,0 +1,5 @@
+/**
+ * Fields - re-exports from @justwant/contract/fields.
+ */
+export { uuid, string, number, integer, boolean, date, json, email, url, ip, ipv4, ipv6, hostname, slug, uuidSchema, emailSchema, urlSchema, ipSchema, ipv4Schema, ipv6Schema, hostnameSchema, slugSchema, } from "@justwant/contract/fields";
+//# sourceMappingURL=fields.js.map

package/dist/base/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/base/fields.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,GAAG,EACH,EAAE,EACF,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,GAGX,MAAM,2BAA2B,CAAC"}

package/dist/base/index.d.ts

@@ -0,0 +1,5 @@
+export type { BoundQuery, CreateInput, MappedTable, MappedTableInternal, } from "./table.js";
+export { AdapterError, AdapterNotFoundError, AdapterConstraintError, AdapterForeignKeyViolationError, AdapterUniqueViolationError, AdapterNotNullViolationError, AdapterCheckViolationError, AdapterMappingError, AdapterUnsupportedError, AdapterConnectionError, AdapterTransactionError, AdapterTimeoutError, isAdapterError, type ConstraintType, } from "./errors.js";
+export type { BaseAdapter, PackageAdapter } from "./adapter.js";
+export { tableConforms } from "./conforms.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/base/index.js

@@ -0,0 +1,3 @@
+export { AdapterError, AdapterNotFoundError, AdapterConstraintError, AdapterForeignKeyViolationError, AdapterUniqueViolationError, AdapterNotNullViolationError, AdapterCheckViolationError, AdapterMappingError, AdapterUnsupportedError, AdapterConnectionError, AdapterTransactionError, AdapterTimeoutError, isAdapterError, } from "./errors.js";
+export { tableConforms } from "./conforms.js";
+//# sourceMappingURL=index.js.map

package/dist/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,GAEf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/base/table.d.ts

@@ -0,0 +1,61 @@
+import type { AnyContract, InferContract } from "@justwant/contract";
+import type { ValidateResult } from "@justwant/contract/validate";
+/**
+ * Represents a deferred query. Execution is lazy — call execute() to run.
+ * Implementations (e.g. adapter-drizzle) construct these; no factory in this package.
+ *
+ * @see docs/CONTRACT.md for construction guidance.
+ */
+export interface BoundQuery<TResult> {
+    readonly _result: TResult;
+    execute(): Promise<TResult>;
+}
+/**
+ * Input for create operations. Excludes common auto-generated fields.
+ * Override the excluded keys if your schema uses different names.
+ */
+export type CreateInput<TContract extends AnyContract> = Omit<InferContract<TContract>, "id" | "createdAt" | "updatedAt">;
+export interface MappedTableInternal<TContract extends AnyContract> {
+    readonly contract: TContract;
+    readonly sql: {
+        findById(id: string): BoundQuery<InferContract<TContract> | null>;
+        findOne(where: Partial<InferContract<TContract>>): BoundQuery<InferContract<TContract> | null>;
+        findMany(where: Partial<InferContract<TContract>>): BoundQuery<InferContract<TContract>[]>;
+        create(data: CreateInput<TContract>): BoundQuery<InferContract<TContract>>;
+        update(id: string, data: Partial<InferContract<TContract>>): BoundQuery<InferContract<TContract>>;
+        /** Soft delete — marks as deleted, preserves row. */
+        delete(id: string): BoundQuery<void>;
+        /** Hard delete — removes row permanently. */
+        hardDelete(id: string): BoundQuery<void>;
+    };
+}
+export interface MappedTable<TContract extends AnyContract> {
+    readonly infer: InferContract<TContract>;
+    readonly contract: TContract;
+    readonly _internal: MappedTableInternal<TContract>;
+    /** Create a new row. */
+    create(data: CreateInput<TContract>): Promise<InferContract<TContract>>;
+    /** Find by primary key. */
+    findById(id: string): Promise<InferContract<TContract> | null>;
+    /** Find first match. */
+    findOne(where: Partial<InferContract<TContract>>): Promise<InferContract<TContract> | null>;
+    /** Find all matches. */
+    findMany(where: Partial<InferContract<TContract>>): Promise<InferContract<TContract>[]>;
+    /** Update by id. */
+    update(id: string, data: Partial<InferContract<TContract>>): Promise<InferContract<TContract>>;
+    /** Soft delete (or hard if no soft delete column). */
+    delete(id: string): Promise<void>;
+    /** Hard delete. */
+    hardDelete(id: string): Promise<void>;
+    /** Create with validation; returns Result instead of throwing on validation error. */
+    createSafe?(data: CreateInput<TContract>): Promise<ValidateResult<InferContract<TContract>>>;
+    /** Update with validation; returns Result instead of throwing on validation error. */
+    updateSafe?(id: string, data: Partial<InferContract<TContract>>): Promise<ValidateResult<InferContract<TContract>>>;
+    /** Create table (DDL). Waddler only. */
+    createTable?(): Promise<void>;
+    /** Check if table exists. Waddler only. */
+    exist?(): Promise<boolean>;
+    /** Drop table. Waddler only. */
+    drop?(): Promise<void>;
+}
+//# sourceMappingURL=table.d.ts.map

package/dist/base/table.d.ts.map

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

package/dist/base/table.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=table.js.map

package/dist/base/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/base/table.ts"],"names":[],"mappings":""}

package/dist/base/validate.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation - re-exports from @justwant/contract/validate.
+ */
+export { validateContractData, ContractValidationError, type ValidationIssue, type ValidationResult, type ValidationError, type ValidateResult, type ValidateOptions, } from "@justwant/contract/validate";
+//# sourceMappingURL=validate.d.ts.map

package/dist/base/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/base/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,6BAA6B,CAAC"}

package/dist/base/validate.js

@@ -0,0 +1,5 @@
+/**
+ * Validation - re-exports from @justwant/contract/validate.
+ */
+export { validateContractData, ContractValidationError, } from "@justwant/contract/validate";
+//# sourceMappingURL=validate.js.map

package/dist/base/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/base/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAMxB,MAAM,6BAA6B,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pure contract definitions for adapter mapping.
+ * Zero runtime dependencies — types only flow through InferContract.
+ *
+ * @see docs/CONTRACT.md for invariants and edge cases.
+ */
+/**
+ * Generic contract type. All contracts must be Record<string, FieldDef<unknown, boolean>>.
+ * Edge cases: empty contract `{}` is valid; index signatures are not supported.
+ */
+export type AnyContract = Record<string, FieldDef<unknown, boolean>>;
+export type FieldDef<T, Req extends boolean> = {
+    readonly _type: T;
+    readonly _required: Req;
+    readonly _nullable: boolean;
+};
+export declare const field: <T>() => {
+    required: () => FieldDef<T, true>;
+    optional: () => FieldDef<T, false>;
+};
+export type InferContract<TContract extends AnyContract> = {
+    [K in keyof TContract as TContract[K]["_required"] extends true ? K : never]: TContract[K]["_type"];
+} & {
+    [K in keyof TContract as TContract[K]["_required"] extends false ? K : never]?: TContract[K]["_type"];
+};
+export declare function defineContract<T extends AnyContract>(contract: T): T;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAErE,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,GAAG,SAAS,OAAO,IAAI;IAC7C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,CAAC;oBACP,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC;oBAEjB,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC;CAEhC,CAAC;AAEH,MAAM,MAAM,aAAa,CAAC,SAAS,SAAS,WAAW,IAAI;KACxD,CAAC,IAAI,MAAM,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,IAAI,GAC3D,CAAC,GACD,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;CAClC,GAAG;KACD,CAAC,IAAI,MAAM,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,KAAK,GAC5D,CAAC,GACD,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;CACnC,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAEpE"}

package/dist/contract.js

@@ -0,0 +1,14 @@
+/**
+ * Pure contract definitions for adapter mapping.
+ * Zero runtime dependencies — types only flow through InferContract.
+ *
+ * @see docs/CONTRACT.md for invariants and edge cases.
+ */
+export const field = () => ({
+    required: () => ({ _type: undefined, _required: true, _nullable: false }),
+    optional: () => ({ _type: undefined, _required: false, _nullable: true }),
+});
+export function defineContract(contract) {
+    return contract;
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,CAAC,MAAM,KAAK,GAAG,GAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAsB,EAAE,CAChC,CAAC,EAAE,KAAK,EAAE,SAAc,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAsB;IACrF,QAAQ,EAAE,GAAuB,EAAE,CACjC,CAAC,EAAE,KAAK,EAAE,SAAc,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAuB;CACvF,CAAC,CAAC;AAYH,MAAM,UAAU,cAAc,CAAwB,QAAW;IAC/D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/contract.type-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.type-test.d.ts.map

package/dist/contract.type-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.type-test.d.ts","sourceRoot":"","sources":["../src/contract.type-test.ts"],"names":[],"mappings":""}