@justwant/warehouse 0.1.1

package/README.md

@@ -0,0 +1,60 @@
+# @justwant/warehouse
+
+DAL for data warehouses (OLAP). Contract-first, append-only. Batch insert, query, aggregate.
+
+## Install
+
+```bash
+bun add @justwant/warehouse @justwant/contract waddler
+```
+
+For ClickHouse: `bun add @clickhouse/client`  
+For DuckDB: `bun add @duckdb/node-api`
+
+## Usage
+
+```ts
+import { defineContract, uuid, string, number, date } from "@justwant/contract";
+import { createWarehouse } from "@justwant/warehouse";
+import { createDuckDbAdapter } from "@justwant/warehouse/duckdb";
+
+const EventContract = defineContract("events", {
+  timestamp: date().required(),
+  user_id: uuid().required(),
+  event_type: string().required(),
+  amount: number().optional(),
+});
+
+const warehouse = createWarehouse(createDuckDbAdapter({ path: ":memory:" }));
+const events = warehouse.table(EventContract);
+await events.createTable();
+
+await events.insert([
+  { timestamp: new Date(), user_id: crypto.randomUUID(), event_type: "purchase", amount: 99 },
+  { timestamp: new Date(), user_id: crypto.randomUUID(), event_type: "view" },
+]);
+
+const rows = await events.query({ where: { event_type: "purchase" }, limit: 100 });
+const agg = await events.aggregate({
+  groupBy: ["event_type"],
+  select: { total: "sum(amount)", count: "count()" },
+});
+```
+
+## Drivers
+
+- **ClickHouse**: `createClickHouseAdapter` from `@justwant/warehouse/clickhouse`
+- **DuckDB**: `createDuckDbAdapter` from `@justwant/warehouse/duckdb`
+
+Pass the driver config to `createWarehouse` for tree-shaking (import only the driver you need).
+
+## Docs
+
+- [Drivers](docs/DRIVERS.md) — config per driver, mapping
+
+## API
+
+- `createWarehouse(config)` — builds a `Warehouse` from driver config (createDuckDbAdapter, etc.)
+- `createWarehouseFromSql(sql, { dialect })` — low-level: build from Waddler SQL client directly
+- `table(contract)` — returns `WarehouseMappedTable` with `createTable`, `exist`, `drop`, `insert`, `query`, `aggregate`
+- `adapter.createTable(contract)` — legacy DDL (prefer `table(contract).createTable()`)

package/dist/buildOrderBy.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build ORDER BY clause for warehouse SQL.
+ * Uses sql template to produce appendable SQLQuery (waddler expects .sqlWrapper).
+ */
+import type { WaddlerQuery, WaddlerSql } from "./types.js";
+export type OrderDirection = "asc" | "desc";
+/** Appends ORDER BY clause to the query. Mutates query in place. */
+export declare function appendOrderBy(sql: WaddlerSql, query: WaddlerQuery, mapping: Record<string, {
+    name: string;
+}>, orderBy: Record<string, OrderDirection>): void;
+//# sourceMappingURL=buildOrderBy.d.ts.map

package/dist/buildOrderBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildOrderBy.d.ts","sourceRoot":"","sources":["../src/buildOrderBy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C,oEAAoE;AACpE,wBAAgB,aAAa,CAC3B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC,IAAI,CAwBN"}

package/dist/buildOrderBy.js

@@ -0,0 +1,34 @@
+/**
+ * Build ORDER BY clause for warehouse SQL.
+ * Uses sql template to produce appendable SQLQuery (waddler expects .sqlWrapper).
+ */
+/** Appends ORDER BY clause to the query. Mutates query in place. */
+export function appendOrderBy(sql, query, mapping, orderBy) {
+    const entries = Object.entries(orderBy)
+        .filter(([key]) => mapping[key])
+        .map(([key]) => {
+        const col = mapping[key];
+        const dir = orderBy[key];
+        if (!col || dir === undefined)
+            throw new Error("Unreachable");
+        return { colName: col.name, dir };
+    });
+    if (entries.length === 0)
+        return;
+    const append = query.append;
+    if (!append)
+        return;
+    const first = entries[0];
+    if (!first)
+        return;
+    let orderByClause = sql ` ORDER BY ${sql.identifier(first.colName)} ${sql.raw(first.dir === "desc" ? "DESC" : "ASC")}`;
+    for (let i = 1; i < entries.length; i++) {
+        const entry = entries[i];
+        if (!entry)
+            continue;
+        const { colName, dir } = entry;
+        orderByClause = sql `${orderByClause}, ${sql.identifier(colName)} ${sql.raw(dir === "desc" ? "DESC" : "ASC")}`;
+    }
+    append.call(query, orderByClause);
+}
+//# sourceMappingURL=buildOrderBy.js.map

package/dist/buildOrderBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildOrderBy.js","sourceRoot":"","sources":["../src/buildOrderBy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAC3B,GAAe,EACf,KAAmB,EACnB,OAAyC,EACzC,OAAuC;IAEvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SACpC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;SAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9D,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IACL,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,aAAa,GAAG,GAAG,CAAA,aAAa,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IACtH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QAC/B,aAAa,GAAG,GAAG,CAAA,GAAG,aAAa,KAAK,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAChH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AACpC,CAAC"}

package/dist/buildWhere.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build WHERE clause for warehouse SQL (parameterized).
+ */
+import type { WaddlerQuery, WaddlerSql } from "./types.js";
+export interface AppendWhereOptions {
+    firstConnector?: " WHERE " | " AND ";
+}
+/** Appends WHERE conditions to the query. Mutates query in place. */
+export declare function appendWhere(sql: WaddlerSql, query: WaddlerQuery, mapping: Record<string, {
+    name: string;
+}>, where: Record<string, unknown>, options?: AppendWhereOptions): void;
+//# sourceMappingURL=buildWhere.d.ts.map

package/dist/buildWhere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildWhere.d.ts","sourceRoot":"","sources":["../src/buildWhere.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACtC;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI,CAmBN"}

package/dist/buildWhere.js

@@ -0,0 +1,26 @@
+/**
+ * Build WHERE clause for warehouse SQL (parameterized).
+ */
+/** Appends WHERE conditions to the query. Mutates query in place. */
+export function appendWhere(sql, query, mapping, where, options) {
+    const entries = Object.entries(where).filter(([, v]) => v !== undefined);
+    if (entries.length === 0)
+        return;
+    const append = query.append;
+    if (!append)
+        return;
+    const useAnd = options?.firstConnector === " AND ";
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        if (entry === undefined)
+            continue;
+        const [key, val] = entry;
+        const colName = mapping[key]?.name;
+        if (!colName)
+            continue;
+        const connector = i === 0 && !useAnd ? sql ` WHERE ` : sql ` AND `;
+        append.call(query, connector);
+        append.call(query, sql `${sql.identifier(colName)} = ${val}`);
+    }
+}
+//# sourceMappingURL=buildWhere.js.map

package/dist/buildWhere.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildWhere.js","sourceRoot":"","sources":["../src/buildWhere.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,qEAAqE;AACrE,MAAM,UAAU,WAAW,CACzB,GAAe,EACf,KAAmB,EACnB,OAAyC,EACzC,KAA8B,EAC9B,OAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,MAAM,GAAG,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAA,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA,OAAO,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAA,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/clickhouse/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Warehouse connection for ClickHouse.
+ * @see https://waddler.drizzle.team/docs/clickhouse/get-started/clickhouse-new
+ *
+ * Peer deps: waddler, @clickhouse/client
+ */
+import type { WarehouseConnectionConfig } from "../types.js";
+export interface CreateClickHouseAdapterConfig {
+    connection?: string;
+    client?: unknown;
+}
+/**
+ * Creates a ClickHouse connection config. Pass to createWarehouse.
+ * Pass connection string (e.g. http://localhost:8123) or existing ClickHouse client.
+ */
+export declare function createClickHouseAdapter(config: CreateClickHouseAdapterConfig): WarehouseConnectionConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clickhouse/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAc,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAIzE,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,yBAAyB,CAQ3B"}

package/dist/clickhouse/index.js

@@ -0,0 +1,20 @@
+/**
+ * Warehouse connection for ClickHouse.
+ * @see https://waddler.drizzle.team/docs/clickhouse/get-started/clickhouse-new
+ *
+ * Peer deps: waddler, @clickhouse/client
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/**
+ * Creates a ClickHouse connection config. Pass to createWarehouse.
+ * Pass connection string (e.g. http://localhost:8123) or existing ClickHouse client.
+ */
+export function createClickHouseAdapter(config) {
+    const { waddler } = require("waddler/clickhouse");
+    const sql = config.client
+        ? waddler({ client: config.client })
+        : waddler(config.connection ?? "http://localhost:8123");
+    return { sql, dialect: "clickhouse", driver: config.client };
+}
+//# sourceMappingURL=index.js.map

package/dist/clickhouse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clickhouse/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,uBAAuB,CACrC,MAAqC;IAErC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAE/C,CAAC;IACF,MAAM,GAAG,GAAe,MAAM,CAAC,MAAM;QACnC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,uBAAuB,CAAC,CAAC;IAC1D,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC/D,CAAC"}

package/dist/core.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Warehouse adapter core - batch insert, query, aggregate.
+ */
+import type { WaddlerSql, Warehouse, WarehouseConnectionConfig, WarehouseDialect } from "./types.js";
+export interface CreateWarehouseFromSqlOptions {
+    dialect: WarehouseDialect;
+    driver?: unknown;
+}
+/**
+ * Creates a warehouse from connection config. Use with driver factories (createDuckDbAdapter, etc.).
+ */
+export declare function createWarehouse(config: WarehouseConnectionConfig): Warehouse;
+/**
+ * Creates a warehouse from a Waddler SQL client.
+ * Low-level: use createWarehouse with a driver factory for the common case.
+ */
+export declare function createWarehouseFromSql(sql: WaddlerSql, options: CreateWarehouseFromSqlOptions): Warehouse;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAIV,UAAU,EACV,SAAS,EACT,yBAAyB,EACzB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AA0BpB,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAM5E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,6BAA6B,GACrC,SAAS,CA4IX"}

package/dist/core.js

@@ -0,0 +1,178 @@
+/**
+ * Warehouse adapter core - batch insert, query, aggregate.
+ */
+import { appendOrderBy } from "./buildOrderBy.js";
+import { appendWhere } from "./buildWhere.js";
+import { getCreateTableSQL, getDropTableSQL, getExistTableSQL } from "./ddl/index.js";
+import { parseWarehouseError } from "./errors.js";
+import { mapContractToRow, mapRowToContract } from "./mapping.js";
+/** Normalize query result to row array. */
+function toRows(result) {
+    if (Array.isArray(result))
+        return result;
+    const r = result;
+    return (r?.rows ?? []);
+}
+/** Normalize BigInt to number in aggregate results (DuckDB, ClickHouse return BigInt for count/sum). */
+function normalizeAggregateRow(row) {
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+        out[k] = typeof v === "bigint" ? Number(v) : v;
+    }
+    return out;
+}
+/** Parse exist() query result to boolean. */
+function parseExistResult(rows) {
+    const row = rows[0];
+    if (!row)
+        return false;
+    const val = Object.values(row)[0];
+    return val === 1 || val === true || (typeof val === "number" && val !== 0);
+}
+/**
+ * Creates a warehouse from connection config. Use with driver factories (createDuckDbAdapter, etc.).
+ */
+export function createWarehouse(config) {
+    const wh = createWarehouseFromSql(config.sql, config);
+    if (config.close) {
+        return { ...wh, close: config.close };
+    }
+    return wh;
+}
+/**
+ * Creates a warehouse from a Waddler SQL client.
+ * Low-level: use createWarehouse with a driver factory for the common case.
+ */
+export function createWarehouseFromSql(sql, options) {
+    const { dialect, driver } = options;
+    const adapter = {
+        sql,
+        dialect,
+        driver,
+        async createTable(contract) {
+            try {
+                const ddl = getCreateTableSQL(contract, dialect);
+                await sql `${sql.raw(ddl)}`;
+            }
+            catch (err) {
+                throw parseWarehouseError(err);
+            }
+        },
+        table(contract) {
+            const mapping = contract.mapping;
+            const tableName = contract.tableName;
+            const tableId = sql.identifier(tableName);
+            const fromDbRow = (row) => mapRowToContract(row, mapping, contract.fields);
+            const mapped = {
+                contract,
+                async createTable() {
+                    try {
+                        const ddl = getCreateTableSQL(contract, dialect, { ifNotExists: true });
+                        await sql `${sql.raw(ddl)}`;
+                    }
+                    catch (err) {
+                        throw parseWarehouseError(err);
+                    }
+                },
+                async exist() {
+                    try {
+                        const existSql = getExistTableSQL(tableName, dialect);
+                        const rows = toRows(await sql `${sql.raw(existSql)}`);
+                        return parseExistResult(rows);
+                    }
+                    catch (err) {
+                        throw parseWarehouseError(err);
+                    }
+                },
+                async drop() {
+                    try {
+                        const dropSql = getDropTableSQL(tableName, dialect);
+                        await sql `${sql.raw(dropSql)}`;
+                    }
+                    catch (err) {
+                        throw parseWarehouseError(err);
+                    }
+                },
+                async insert(rows) {
+                    if (rows.length === 0)
+                        return;
+                    try {
+                        const colOrder = Object.entries(mapping).map(([, col]) => col.name);
+                        const sqlDefault = sql.default;
+                        const tuples = rows.map((row) => {
+                            const dbRow = mapContractToRow(row, mapping);
+                            return colOrder.map((col) => {
+                                const val = dbRow[col];
+                                return val === undefined && sqlDefault !== undefined ? sqlDefault : val;
+                            });
+                        });
+                        const colList = colOrder.map((c) => `"${String(c).replace(/"/g, '""')}"`).join(", ");
+                        await sql `INSERT INTO ${tableId} (${sql.raw(colList)}) VALUES ${sql.values(tuples)}`;
+                    }
+                    catch (err) {
+                        throw parseWarehouseError(err);
+                    }
+                },
+                async query(options) {
+                    try {
+                        const query = sql `SELECT * FROM ${tableId}`;
+                        const append = query.append;
+                        if (append && options) {
+                            const where = (options.where ?? {});
+                            const hasWhere = Object.entries(where).some(([, v]) => v !== undefined);
+                            if (hasWhere) {
+                                appendWhere(sql, query, mapping, where);
+                            }
+                            if (options.orderBy && Object.keys(options.orderBy).length > 0) {
+                                appendOrderBy(sql, query, mapping, options.orderBy);
+                            }
+                            if (options.limit !== undefined) {
+                                append.call(query, sql ` LIMIT ${options.limit}`);
+                            }
+                            if (options.offset !== undefined) {
+                                append.call(query, sql ` OFFSET ${options.offset}`);
+                            }
+                        }
+                        const rows = toRows(await query);
+                        return rows.map((r) => fromDbRow(r));
+                    }
+                    catch (err) {
+                        throw parseWarehouseError(err);
+                    }
+                },
+                async aggregate(options) {
+                    try {
+                        const groupBy = options.groupBy ?? [];
+                        const selectEntries = Object.entries(options.select);
+                        const selectExprs = selectEntries.map(([alias, expr]) => `${expr} AS ${alias}`);
+                        const groupByCols = groupBy.map((k) => mapping[k]?.name).filter(Boolean);
+                        const selectClause = groupByCols.length > 0
+                            ? [...groupByCols.map((c) => `"${c}"`), ...selectExprs].join(", ")
+                            : selectExprs.join(", ");
+                        const groupByClause = groupByCols.length > 0
+                            ? ` GROUP BY ${groupByCols.map((c) => `"${c}"`).join(", ")}`
+                            : "";
+                        const query = sql `SELECT ${sql.raw(selectClause)} FROM ${tableId}`;
+                        const append = query.append;
+                        const where = (options.where ?? {});
+                        const hasWhere = Object.entries(where).some(([, v]) => v !== undefined);
+                        if (append && hasWhere) {
+                            appendWhere(sql, query, mapping, where);
+                        }
+                        if (append && groupByClause) {
+                            append.call(query, sql `${sql.raw(groupByClause)}`);
+                        }
+                        const rows = toRows(await query);
+                        return rows.map((r) => normalizeAggregateRow(r));
+                    }
+                    catch (err) {
+                        throw parseWarehouseError(err);
+                    }
+                },
+            };
+            return mapped;
+        },
+    };
+    return adapter;
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/ddl/clickhouse.d.ts

@@ -0,0 +1,14 @@
+/**
+ * DDL for ClickHouse.
+ * MergeTree requires ORDER BY - use first column from mapping.
+ */
+import type { FieldDef } from "@justwant/contract";
+import type { TableContract } from "@justwant/contract";
+/**
+ * Generates CREATE TABLE SQL for ClickHouse (MergeTree).
+ * ORDER BY is required - uses first column from mapping.
+ */
+export declare function getCreateTableSQL(contract: TableContract<Record<string, FieldDef<unknown, boolean>>>, options?: {
+    ifNotExists?: boolean;
+}): string;
+//# sourceMappingURL=clickhouse.d.ts.map

package/dist/ddl/clickhouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../src/ddl/clickhouse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAiBxD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,MAAM,CAkBR"}

package/dist/ddl/clickhouse.js

@@ -0,0 +1,40 @@
+/**
+ * DDL for ClickHouse.
+ * MergeTree requires ORDER BY - use first column from mapping.
+ */
+function escapeIdentifier(name) {
+    return `"${String(name).replace(/"/g, '""')}"`;
+}
+function columnTypeForClickHouse(field) {
+    const ct = field._columnType ?? "TEXT";
+    const map = {
+        TEXT: "String",
+        INTEGER: "Int64",
+        REAL: "Float64",
+        BOOLEAN: "UInt8",
+    };
+    return map[ct] ?? "String";
+}
+/**
+ * Generates CREATE TABLE SQL for ClickHouse (MergeTree).
+ * ORDER BY is required - uses first column from mapping.
+ */
+export function getCreateTableSQL(contract, options) {
+    const { tableName, fields, mapping } = contract;
+    const entries = Object.entries(mapping);
+    const parts = [];
+    for (const [key, col] of entries) {
+        const field = fields[key];
+        if (!field)
+            continue;
+        const colName = col.name;
+        const type = columnTypeForClickHouse(field);
+        const nullable = !field._required ? " Nullable" : "";
+        parts.push(`${escapeIdentifier(colName)} ${type}${nullable}`);
+    }
+    const tableId = escapeIdentifier(tableName);
+    const orderByCol = entries[0]?.[1]?.name ?? "id";
+    const ifNotExists = options?.ifNotExists ? " IF NOT EXISTS" : "";
+    return `CREATE TABLE${ifNotExists} ${tableId} (${parts.join(", ")}) ENGINE = MergeTree() ORDER BY (${escapeIdentifier(orderByCol)})`;
+}
+//# sourceMappingURL=clickhouse.js.map

package/dist/ddl/clickhouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.js","sourceRoot":"","sources":["../../src/ddl/clickhouse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAiC;IAChE,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC;IACvC,MAAM,GAAG,GAA2B;QAClC,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;KACjB,CAAC;IACF,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAmE,EACnE,OAAmC;IAEnC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,GAA0B,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,eAAe,WAAW,IAAI,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC;AACvI,CAAC"}

package/dist/ddl/drop.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SQL to drop a table.
+ */
+import type { WarehouseDialect } from "../types.js";
+export declare function getDropTableSQL(tableName: string, dialect: WarehouseDialect): string;
+//# sourceMappingURL=drop.d.ts.map

package/dist/ddl/drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../src/ddl/drop.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAGpF"}

package/dist/ddl/drop.js

@@ -0,0 +1,11 @@
+/**
+ * SQL to drop a table.
+ */
+function escapeIdentifier(name) {
+    return `"${String(name).replace(/"/g, '""')}"`;
+}
+export function getDropTableSQL(tableName, dialect) {
+    const escaped = escapeIdentifier(tableName);
+    return `DROP TABLE IF EXISTS ${escaped}`;
+}
+//# sourceMappingURL=drop.js.map

package/dist/ddl/drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.js","sourceRoot":"","sources":["../../src/ddl/drop.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAyB;IAC1E,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,wBAAwB,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/ddl/duckdb.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DDL for DuckDB.
+ */
+import type { FieldDef } from "@justwant/contract";
+import type { TableContract } from "@justwant/contract";
+/**
+ * Generates CREATE TABLE SQL for DuckDB.
+ */
+export declare function getCreateTableSQL(contract: TableContract<Record<string, FieldDef<unknown, boolean>>>, options?: {
+    ifNotExists?: boolean;
+}): string;
+//# sourceMappingURL=duckdb.d.ts.map

package/dist/ddl/duckdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.d.ts","sourceRoot":"","sources":["../../src/ddl/duckdb.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAmBxD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,MAAM,CAeR"}

package/dist/ddl/duckdb.js

@@ -0,0 +1,37 @@
+/**
+ * DDL for DuckDB.
+ */
+function escapeIdentifier(name) {
+    return `"${String(name).replace(/"/g, '""')}"`;
+}
+function columnTypeForDuckDb(field) {
+    const ct = field._columnType ?? "TEXT";
+    const map = {
+        TEXT: "VARCHAR",
+        INTEGER: "BIGINT",
+        REAL: "DOUBLE",
+        BOOLEAN: "BOOLEAN",
+        DATE: "DATE",
+        JSON: "JSON",
+    };
+    return map[ct] ?? "VARCHAR";
+}
+/**
+ * Generates CREATE TABLE SQL for DuckDB.
+ */
+export function getCreateTableSQL(contract, options) {
+    const { tableName, fields, mapping } = contract;
+    const parts = [];
+    for (const [key, col] of Object.entries(mapping)) {
+        const field = fields[key];
+        if (!field)
+            continue;
+        const colName = col.name;
+        const type = columnTypeForDuckDb(field);
+        parts.push(`${escapeIdentifier(colName)} ${type}`);
+    }
+    const tableId = escapeIdentifier(tableName);
+    const ifNotExists = options?.ifNotExists ? " IF NOT EXISTS" : "";
+    return `CREATE TABLE${ifNotExists} ${tableId} (${parts.join(", ")})`;
+}
+//# sourceMappingURL=duckdb.js.map

package/dist/ddl/duckdb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.js","sourceRoot":"","sources":["../../src/ddl/duckdb.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAiC;IAC5D,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC;IACvC,MAAM,GAAG,GAA2B;QAClC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;KACb,CAAC;IACF,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAmE,EACnE,OAAmC;IAEnC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAA0B,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,eAAe,WAAW,IAAI,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACvE,CAAC"}

package/dist/ddl/exist.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SQL to check if a table exists.
+ */
+import type { WarehouseDialect } from "../types.js";
+export declare function getExistTableSQL(tableName: string, dialect: WarehouseDialect): string;
+//# sourceMappingURL=exist.d.ts.map

package/dist/ddl/exist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exist.d.ts","sourceRoot":"","sources":["../../src/ddl/exist.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAQrF"}

package/dist/ddl/exist.js

@@ -0,0 +1,19 @@
+/**
+ * SQL to check if a table exists.
+ */
+function escapeIdentifier(name) {
+    return `"${String(name).replace(/"/g, '""')}"`;
+}
+function escapeStringLiteral(value) {
+    return `'${String(value).replace(/'/g, "''")}'`;
+}
+export function getExistTableSQL(tableName, dialect) {
+    if (dialect === "clickhouse") {
+        return `EXISTS TABLE ${escapeIdentifier(tableName)}`;
+    }
+    if (dialect === "duckdb") {
+        return `SELECT EXISTS (SELECT 1 FROM information_schema.tables WHERE table_name = ${escapeStringLiteral(tableName)})`;
+    }
+    throw new Error(`Unsupported warehouse dialect: ${dialect}`);
+}
+//# sourceMappingURL=exist.js.map

package/dist/ddl/exist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exist.js","sourceRoot":"","sources":["../../src/ddl/exist.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAyB;IAC3E,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QAC7B,OAAO,gBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,6EAA6E,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC;IACxH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/ddl/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DDL generation for warehouse dialects.
+ */
+import type { FieldDef, TableContract } from "@justwant/contract";
+import type { WarehouseDialect } from "../types.js";
+export { getCreateTableSQL as getCreateTableSQLClickHouse } from "./clickhouse.js";
+export { getCreateTableSQL as getCreateTableSQLDuckDb } from "./duckdb.js";
+export { getExistTableSQL } from "./exist.js";
+export { getDropTableSQL } from "./drop.js";
+export declare function getCreateTableSQL(contract: TableContract<Record<string, FieldDef<unknown, boolean>>>, dialect: WarehouseDialect, options?: {
+    ifNotExists?: boolean;
+}): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ddl/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,OAAO,EAAE,iBAAiB,IAAI,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,iBAAiB,IAAI,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnE,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,MAAM,CASR"}

package/dist/ddl/index.js

@@ -0,0 +1,20 @@
+/**
+ * DDL generation for warehouse dialects.
+ */
+import { getCreateTableSQL as getClickHouseDDL } from "./clickhouse.js";
+import { getCreateTableSQL as getDuckDbDDL } from "./duckdb.js";
+export { getCreateTableSQL as getCreateTableSQLClickHouse } from "./clickhouse.js";
+export { getCreateTableSQL as getCreateTableSQLDuckDb } from "./duckdb.js";
+export { getExistTableSQL } from "./exist.js";
+export { getDropTableSQL } from "./drop.js";
+export function getCreateTableSQL(contract, dialect, options) {
+    switch (dialect) {
+        case "clickhouse":
+            return getClickHouseDDL(contract, options);
+        case "duckdb":
+            return getDuckDbDDL(contract, options);
+        default:
+            throw new Error(`Unsupported warehouse dialect: ${dialect}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/ddl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ddl/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,iBAAiB,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,iBAAiB,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,iBAAiB,IAAI,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,iBAAiB,IAAI,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAC/B,QAAmE,EACnE,OAAyB,EACzB,OAAmC;IAEnC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,YAAY;YACf,OAAO,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzC;YACE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/duckdb/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Warehouse connection for DuckDB.
+ * @see https://waddler.drizzle.team/docs/duckdb/connect-duckdb-neo
+ *
+ * Peer deps: waddler, @duckdb/node-api
+ */
+import type { WarehouseConnectionConfig } from "../types.js";
+export interface CreateDuckDbAdapterConfig {
+    path?: string;
+    client?: unknown;
+}
+/**
+ * Creates a DuckDB connection config. Pass to createWarehouse.
+ * Pass path (e.g. ":memory:" or file path) or existing DuckDB client.
+ */
+export declare function createDuckDbAdapter(config: CreateDuckDbAdapterConfig): WarehouseConnectionConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/duckdb/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAc,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAIzE,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CAQhG"}

package/dist/duckdb/index.js

@@ -0,0 +1,20 @@
+/**
+ * Warehouse connection for DuckDB.
+ * @see https://waddler.drizzle.team/docs/duckdb/connect-duckdb-neo
+ *
+ * Peer deps: waddler, @duckdb/node-api
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/**
+ * Creates a DuckDB connection config. Pass to createWarehouse.
+ * Pass path (e.g. ":memory:" or file path) or existing DuckDB client.
+ */
+export function createDuckDbAdapter(config) {
+    const { waddler } = require("waddler/duckdb-neo");
+    const sql = config.client
+        ? waddler({ client: config.client })
+        : waddler({ url: config.path ?? ":memory:" });
+    return { sql, dialect: "duckdb", driver: config.client };
+}
+//# sourceMappingURL=index.js.map

package/dist/duckdb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/duckdb/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,mBAAmB,CAAC,MAAiC;IACnE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAE/C,CAAC;IACF,MAAM,GAAG,GAAe,MAAM,CAAC,MAAM;QACnC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC;IAChD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC3D,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Parse warehouse (ClickHouse, DuckDB) errors into normalized errors.
+ */
+export declare class WarehouseError extends Error {
+    readonly code: string;
+    readonly metadata?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, metadata?: Record<string, unknown> | undefined);
+}
+export declare class WarehouseConnectionError extends WarehouseError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class WarehouseTimeoutError extends WarehouseError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare function parseWarehouseError(raw: unknown): WarehouseError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,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,wBAAyB,SAAQ,cAAc;gBAC9C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKhE;AAED,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKhE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAqBhE"}

package/dist/errors.js

@@ -0,0 +1,48 @@
+/**
+ * Parse warehouse (ClickHouse, DuckDB) errors into normalized errors.
+ */
+export class WarehouseError extends Error {
+    code;
+    metadata;
+    constructor(message, code, metadata) {
+        super(message);
+        this.code = code;
+        this.metadata = metadata;
+        this.name = "WarehouseError";
+        Object.setPrototypeOf(this, WarehouseError.prototype);
+    }
+}
+export class WarehouseConnectionError extends WarehouseError {
+    constructor(message, metadata) {
+        super(message, "CONNECTION", metadata);
+        this.name = "WarehouseConnectionError";
+        Object.setPrototypeOf(this, WarehouseConnectionError.prototype);
+    }
+}
+export class WarehouseTimeoutError extends WarehouseError {
+    constructor(message, metadata) {
+        super(message, "TIMEOUT", metadata);
+        this.name = "WarehouseTimeoutError";
+        Object.setPrototypeOf(this, WarehouseTimeoutError.prototype);
+    }
+}
+export function parseWarehouseError(raw) {
+    const err = raw;
+    const message = typeof err?.message === "string" ? err.message : String(raw ?? "Unknown error");
+    const causeMsg = typeof err?.cause?.message === "string"
+        ? err.cause.message
+        : "";
+    const msgToCheck = causeMsg || message;
+    const code = err?.code;
+    if (typeof code === "string") {
+        switch (code) {
+            case "ECONNREFUSED":
+            case "ECONNRESET":
+                return new WarehouseConnectionError(message, { code });
+            case "ETIMEDOUT":
+                return new WarehouseTimeoutError(message, { code });
+        }
+    }
+    return new WarehouseError(String(message), "UNKNOWN", { original: raw });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,QAAkC;QAElD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAA0B;QAGlD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAC1D,YAAY,OAAe,EAAE,QAAkC;QAC7D,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD,YAAY,OAAe,EAAE,QAAkC;QAC7D,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC,CAAC;IAChG,MAAM,QAAQ,GACZ,OAAQ,GAAG,EAAE,KAA8B,EAAE,OAAO,KAAK,QAAQ;QAC/D,CAAC,CAAE,GAAG,CAAC,KAA6B,CAAC,OAAO;QAC5C,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,CAAC;IACvC,MAAM,IAAI,GAAG,GAAG,EAAE,IAA0B,CAAC;IAE7C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,cAAc,CAAC;YACpB,KAAK,YAAY;gBACf,OAAO,IAAI,wBAAwB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,KAAK,WAAW;gBACd,OAAO,IAAI,qBAAqB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @justwant/warehouse - DAL for data warehouses (OLAP).
+ */
+export { createWarehouse, createWarehouseFromSql } from "./core.js";
+export type { Warehouse, WarehouseConnectionConfig, WarehouseDialect, WarehouseMappedTable, QueryOptions, AggregateOptions, WaddlerSql, WaddlerQuery, StringMapping, } from "./types.js";
+export { parseWarehouseError, WarehouseError, WarehouseConnectionError, WarehouseTimeoutError, } from "./errors.js";
+export { getCreateTableSQL, getCreateTableSQLClickHouse, getCreateTableSQLDuckDb, } from "./ddl/index.js";
+export { appendWhere } from "./buildWhere.js";
+export { appendOrderBy, type OrderDirection } from "./buildOrderBy.js";
+export { mapRowToContract, mapContractToRow } from "./mapping.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EACV,SAAS,EACT,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @justwant/warehouse - DAL for data warehouses (OLAP).
+ */
+export { createWarehouse, createWarehouseFromSql } from "./core.js";
+export { parseWarehouseError, WarehouseError, WarehouseConnectionError, WarehouseTimeoutError, } from "./errors.js";
+export { getCreateTableSQL, getCreateTableSQLClickHouse, getCreateTableSQLDuckDb, } from "./ddl/index.js";
+export { appendWhere } from "./buildWhere.js";
+export { appendOrderBy } from "./buildOrderBy.js";
+export { mapRowToContract, mapContractToRow } from "./mapping.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAYpE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/mapping.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Map warehouse row to contract shape.
+ */
+import type { AnyContract } from "@justwant/contract";
+/** Column-like with a name for row lookup. */
+export interface ColumnLike {
+    name: string;
+}
+/**
+ * Maps a warehouse row to contract shape.
+ * Converts null to undefined for optional fields.
+ * Converts ISO date strings to Date for date fields.
+ */
+export declare function mapRowToContract<T>(row: Record<string, unknown>, mapping: Record<string, ColumnLike>, contract: AnyContract): T;
+/**
+ * Maps contract row to DB values for insert.
+ * Date → ISO string, etc.
+ */
+export declare function mapContractToRow(row: Record<string, unknown>, mapping: Record<string, ColumnLike>): Record<string, unknown>;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACnC,QAAQ,EAAE,WAAW,GACpB,CAAC,CAoBH;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/mapping.js

@@ -0,0 +1,52 @@
+/**
+ * Map warehouse row to contract shape.
+ */
+/**
+ * Maps a warehouse row to contract shape.
+ * Converts null to undefined for optional fields.
+ * Converts ISO date strings to Date for date fields.
+ */
+export function mapRowToContract(row, mapping, contract) {
+    const result = {};
+    for (const [contractKey, col] of Object.entries(mapping)) {
+        const colName = col.name;
+        let value = row[colName];
+        const fieldDef = contract[contractKey];
+        if (fieldDef && !fieldDef._required && value === null) {
+            result[contractKey] = undefined;
+        }
+        else {
+            if (value !== null && value !== undefined && typeof value === "string" && fieldDef) {
+                const ct = fieldDef._columnType;
+                if (ct === "TEXT" && /^\d{4}-\d{2}-\d{2}/.test(value)) {
+                    const d = new Date(value);
+                    if (!Number.isNaN(d.getTime()))
+                        value = d;
+                }
+            }
+            result[contractKey] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Maps contract row to DB values for insert.
+ * Date → ISO string, etc.
+ */
+export function mapContractToRow(row, mapping) {
+    const result = {};
+    for (const [contractKey, col] of Object.entries(mapping)) {
+        const value = row[contractKey];
+        if (!(contractKey in row))
+            continue;
+        const colName = col.name;
+        if (value instanceof Date) {
+            result[colName] = value.toISOString();
+        }
+        else {
+            result[colName] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=mapping.js.map

package/dist/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAA4B,EAC5B,OAAmC,EACnC,QAAqB;IAErB,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,IAAI,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAoC,CAAC,CAAC;QAChE,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBACnF,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC;gBAChC,IAAI,EAAE,KAAK,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACtD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;wBAAE,KAAK,GAAG,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YACD,MAAM,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAA4B,EAC5B,OAAmC;IAEnC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC;YAAE,SAAS;QACpC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Warehouse adapter types.
+ * OLAP: append-only, batch insert, query, aggregate.
+ */
+import type { InferContract, TableContract, TableFields } from "@justwant/contract";
+export type WarehouseDialect = "clickhouse" | "duckdb";
+/** Connection config passed to createWarehouse. Returned by driver factories (createDuckDbAdapter, etc.). */
+export interface WarehouseConnectionConfig {
+    sql: WaddlerSql;
+    dialect: WarehouseDialect;
+    driver?: unknown;
+    /** Release connection when done. Call warehouse.close() or await on shutdown. */
+    close?: () => Promise<void>;
+}
+/** String-based mapping: contract key → column name. */
+export type StringMapping<T extends Record<string, unknown>> = {
+    [K in keyof T]: {
+        name: string;
+    };
+};
+/**
+ * Waddler SQL client interface.
+ * Compatible with waddler/clickhouse, waddler/duckdb-neo.
+ */
+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;
+    default?: 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 QueryOptions<T> {
+    where?: Partial<InferContract<T>>;
+    orderBy?: Record<string, "asc" | "desc">;
+    limit?: number;
+    offset?: number;
+}
+export interface AggregateOptions<T extends TableFields, A> {
+    groupBy?: (keyof T)[];
+    select: Record<string, string>;
+    where?: Partial<InferContract<T>>;
+}
+export interface WarehouseMappedTable<T extends TableFields> {
+    readonly contract: TableContract<T>;
+    createTable(): Promise<void>;
+    exist(): Promise<boolean>;
+    drop(): Promise<void>;
+    insert(rows: InferContract<TableContract<T>>[]): Promise<void>;
+    query(options?: QueryOptions<TableContract<T>>): Promise<InferContract<TableContract<T>>[]>;
+    aggregate<A>(options: AggregateOptions<T, A>): Promise<A[]>;
+}
+export interface Warehouse {
+    readonly sql: WaddlerSql;
+    readonly dialect: WarehouseDialect;
+    readonly driver?: unknown;
+    table<T extends TableFields>(contract: TableContract<T>): WarehouseMappedTable<T>;
+    createTable(contract: TableContract<TableFields>): Promise<void>;
+    /** Release connection. No-op if config had no close. */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Warehouse adapter types.
+ * OLAP: append-only, batch insert, query, aggregate.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/docs/DRIVERS.md

@@ -0,0 +1,69 @@
+# Warehouse Drivers
+
+Pass the driver config to `createWarehouse` for tree-shaking. Import only the driver you need.
+
+## DuckDB
+
+**Package:** `@justwant/warehouse/duckdb`  
+**Peer deps:** waddler, @duckdb/node-api
+
+```ts
+import { createWarehouse } from "@justwant/warehouse";
+import { createDuckDbAdapter } from "@justwant/warehouse/duckdb";
+
+const warehouse = createWarehouse(createDuckDbAdapter({ path: ":memory:" }));
+// or with file
+const warehouse = createWarehouse(createDuckDbAdapter({ path: "./data.duckdb" }));
+// or with existing client
+const warehouse = createWarehouse(createDuckDbAdapter({ client: myDuckDbClient }));
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `path` | `string` | `:memory:` or file path. Default: `:memory:` |
+| `client` | `unknown` | Existing DuckDB client |
+
+## ClickHouse
+
+**Package:** `@justwant/warehouse/clickhouse`  
+**Peer deps:** waddler, @clickhouse/client
+
+```ts
+import { createWarehouse } from "@justwant/warehouse";
+import { createClickHouseAdapter } from "@justwant/warehouse/clickhouse";
+
+const warehouse = createWarehouse(
+  createClickHouseAdapter({ connection: "http://localhost:8123" })
+);
+// or with existing client
+const warehouse = createWarehouse(createClickHouseAdapter({ client: myClickHouseClient }));
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `connection` | `string` | URL (e.g. http://localhost:8123). Default: `http://localhost:8123` |
+| `client` | `unknown` | Existing ClickHouse client |
+
+## Mapping
+
+Contracts use `defineContract(tableName, fields, options?)`. By default, contract keys map 1:1 to column names.
+
+```ts
+defineContract("events", { user_id: string().required() });
+// → column "user_id"
+```
+
+**camelCase → snake_case:** use `defaultMapping: "camelToSnake"`:
+
+```ts
+defineContract("events", { userId: string().required() }, { defaultMapping: "camelToSnake" });
+// → column "user_id"
+```
+
+**Override specific keys:** use `mapping`:
+
+```ts
+defineContract("events", { userId: string().required() }, {
+  mapping: { userId: { name: "user_id" } },
+});
+```

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@justwant/warehouse",
+  "version": "0.1.1",
+  "description": "DAL for data warehouses (OLAP). Batch insert, query, aggregate. ClickHouse, DuckDB.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elydelva/justwant",
+    "directory": "packages/warehouse"
+  },
+  "keywords": ["warehouse", "olap", "clickhouse", "duckdb", "dal", "contract"],
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./clickhouse": {
+      "types": "./dist/clickhouse/index.d.ts",
+      "import": "./dist/clickhouse/index.js",
+      "default": "./dist/clickhouse/index.js"
+    },
+    "./duckdb": {
+      "types": "./dist/duckdb/index.d.ts",
+      "import": "./dist/duckdb/index.js",
+      "default": "./dist/duckdb/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "files": ["dist", "README.md", "docs"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@justwant/contract": "0.2.1"
+  },
+  "peerDependencies": {
+    "waddler": "*"
+  },
+  "peerDependenciesMeta": {
+    "waddler": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@duckdb/node-api": "*",
+    "@justwant/tsconfig": "0.0.0",
+    "typescript": "^5.7.0",
+    "waddler": "*"
+  }
+}