@b4moss/crudian 0.3.1

package/dist/sqlite/async-crud.js

@@ -0,0 +1,237 @@
+import { CrudianError, assertString, } from "../index.js";
+import { compileWhere, quoteIdent, resolveWhere } from "./sql.js";
+function requireWhere(query, label) {
+    if (query.where === undefined || query.where === null) {
+        throw new CrudianError(`${label} requires where`);
+    }
+}
+function selectColumns(columns) {
+    if (!columns || columns.length === 0)
+        return "*";
+    return columns.map((c) => quoteIdent(c)).join(", ");
+}
+function rowFromObject(value) {
+    if (value === null || typeof value !== "object") {
+        throw new CrudianError("expected row object");
+    }
+    return { ...value };
+}
+export function createAsyncSqliteCrud(db, ex) {
+    const crud = {
+        db,
+        async create(table, cols) {
+            assertString(table, "table");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            const tbl = quoteIdent(table);
+            const colSql = keys.map((k) => quoteIdent(k)).join(", ");
+            const placeholders = keys.map(() => "?").join(", ");
+            const args = keys.map((k) => cols[k]);
+            await ex.run(`INSERT INTO ${tbl} (${colSql}) VALUES (${placeholders})`, args);
+            const idRow = await ex.get("SELECT last_insert_rowid() AS id");
+            const id = Number(idRow?.id);
+            const row = await ex.get(`SELECT * FROM ${tbl} WHERE "id" = ?`, [id]);
+            return rowFromObject(row);
+        },
+        async read(table, query = {}) {
+            assertString(table, "table");
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
+                (where.sql ? ` WHERE ${where.sql}` : "") +
+                ` LIMIT 1`;
+            const row = await ex.get(sql, where.args);
+            return row == null ? null : rowFromObject(row);
+        },
+        async update(table, cols, query) {
+            assertString(table, "table");
+            requireWhere(query, "update");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            if (!where.sql) {
+                throw new CrudianError("update requires where");
+            }
+            const sets = keys.map((k) => `${quoteIdent(k)} = ?`).join(", ");
+            const args = [...keys.map((k) => cols[k]), ...where.args];
+            const result = await ex.run(`UPDATE ${tbl} SET ${sets} WHERE ${where.sql}`, args);
+            if (result.changes === 0)
+                return null;
+            const row = await ex.get(`SELECT * FROM ${tbl} WHERE ${where.sql} LIMIT 1`, where.args);
+            return row == null ? null : rowFromObject(row);
+        },
+        async delete(table, query) {
+            assertString(table, "table");
+            requireWhere(query, "delete");
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            if (!where.sql) {
+                throw new CrudianError("delete requires where");
+            }
+            const result = await ex.run(`DELETE FROM ${tbl} WHERE ${where.sql}`, where.args);
+            return Number(result.changes ?? 0);
+        },
+        async search(table, query = {}) {
+            assertString(table, "table");
+            const limit = query.limit ?? 20;
+            if (typeof limit !== "number" || !Number.isFinite(limit) || limit <= 0) {
+                throw new CrudianError("limit must be a positive number");
+            }
+            if (query.cursor != null &&
+                typeof query.cursor !== "number" &&
+                typeof query.cursor !== "string") {
+                throw new CrudianError("cursor must be a number, string, or null");
+            }
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const args = [...where.args];
+            const parts = [];
+            if (where.sql)
+                parts.push(`(${where.sql})`);
+            if (query.cursor != null) {
+                parts.push(`${quoteIdent("id")} > ?`);
+                args.push(query.cursor);
+            }
+            const whereSql = parts.length > 0 ? ` WHERE ${parts.join(" AND ")}` : "";
+            const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
+                whereSql +
+                ` ORDER BY ${quoteIdent("id")} ASC LIMIT ?`;
+            args.push(limit + 1);
+            const rows = (await ex.all(sql, args)).map((r) => rowFromObject(r));
+            const hasMore = rows.length > limit;
+            const items = hasMore ? rows.slice(0, limit) : rows;
+            const last = items[items.length - 1];
+            const nextCursor = hasMore && last != null && (typeof last.id === "number" || typeof last.id === "string")
+                ? last.id
+                : null;
+            return { items, nextCursor, hasMore };
+        },
+        async list(table, query) {
+            return crud.search(table, query);
+        },
+        async upsert(table, cols) {
+            assertString(table, "table");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            if (!Object.prototype.hasOwnProperty.call(cols, "id")) {
+                throw new CrudianError("upsert requires cols.id");
+            }
+            const id = cols.id;
+            const existing = await crud.read(table, {
+                where: { type: "cond", op: "eq", column: "id", value: id },
+            });
+            if (existing != null) {
+                const { id: _id, ...patch } = cols;
+                if (Object.keys(patch).length === 0)
+                    return existing;
+                const updated = await crud.update(table, patch, {
+                    where: { type: "cond", op: "eq", column: "id", value: id },
+                });
+                if (updated == null) {
+                    throw new CrudianError("upsert update failed");
+                }
+                return updated;
+            }
+            return crud.create(table, cols);
+        },
+        async duplicate(table, query) {
+            assertString(table, "table");
+            requireWhere(query, "duplicate");
+            const source = await crud.read(table, { where: query.where });
+            if (source == null)
+                return null;
+            const { id: _id, ...rest } = source;
+            const overrides = query.overrides != null &&
+                typeof query.overrides === "object" &&
+                !Array.isArray(query.overrides)
+                ? query.overrides
+                : {};
+            const cols = { ...rest, ...overrides };
+            delete cols.id;
+            return crud.create(table, cols);
+        },
+        async bulkCreate(table, rows) {
+            assertString(table, "table");
+            if (!Array.isArray(rows)) {
+                throw new CrudianError("rows must be an array");
+            }
+            if (rows.length === 0)
+                return 0;
+            let count = 0;
+            for (const row of rows) {
+                if (row == null || typeof row !== "object" || Array.isArray(row)) {
+                    throw new CrudianError("each row must be an object");
+                }
+                await crud.create(table, row);
+                count += 1;
+            }
+            return count;
+        },
+        async bulkUpdate(table, cols, query) {
+            assertString(table, "table");
+            requireWhere(query, "bulkUpdate");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            if (!where.sql) {
+                throw new CrudianError("bulkUpdate requires where");
+            }
+            const sets = keys.map((k) => `${quoteIdent(k)} = ?`).join(", ");
+            const args = [...keys.map((k) => cols[k]), ...where.args];
+            const result = await ex.run(`UPDATE ${tbl} SET ${sets} WHERE ${where.sql}`, args);
+            return Number(result.changes ?? 0);
+        },
+        async bulkDelete(table, query) {
+            return crud.delete(table, query);
+        },
+        async bulkUpsert(table, rows) {
+            assertString(table, "table");
+            if (!Array.isArray(rows)) {
+                throw new CrudianError("rows must be an array");
+            }
+            if (rows.length === 0)
+                return 0;
+            let count = 0;
+            for (const row of rows) {
+                if (row == null || typeof row !== "object" || Array.isArray(row)) {
+                    throw new CrudianError("each row must be an object");
+                }
+                if (!Object.prototype.hasOwnProperty.call(row, "id")) {
+                    throw new CrudianError("bulkUpsert requires each row to have id");
+                }
+                await crud.upsert(table, row);
+                count += 1;
+            }
+            return count;
+        },
+        async transaction(fn) {
+            if (typeof fn !== "function") {
+                throw new CrudianError("transaction callback must be a function");
+            }
+            return ex.transaction(fn);
+        },
+    };
+    return crud;
+}

package/dist/sqlite/sql.d.ts

@@ -0,0 +1,8 @@
+import { type WhereInput, type WhereNode } from "../index.js";
+export declare function quoteIdent(name: string): string;
+export declare function resolveWhere(input: WhereInput | undefined): WhereNode | undefined;
+export declare function compileWhere(node: WhereNode | undefined): {
+    sql: string;
+    args: unknown[];
+};
+//# sourceMappingURL=sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/sqlite/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,aAAa,CAAA;AAEpB,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAIjF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAyD1F"}

package/dist/sqlite/sql.js

@@ -0,0 +1,72 @@
+import { CrudianError, assertString, isWhereBuilder, } from "../index.js";
+export function quoteIdent(name) {
+    assertString(name, "identifier");
+    return `"${name.replaceAll('"', '""')}"`;
+}
+export function resolveWhere(input) {
+    if (input === undefined)
+        return undefined;
+    if (isWhereBuilder(input))
+        return input.toNode();
+    return input;
+}
+export function compileWhere(node) {
+    if (!node)
+        return { sql: "", args: [] };
+    if (node.type === "and" || node.type === "or") {
+        if (node.children.length === 0)
+            return { sql: "", args: [] };
+        const parts = [];
+        const args = [];
+        for (const child of node.children) {
+            const compiled = compileWhere(child);
+            if (!compiled.sql)
+                continue;
+            parts.push(`(${compiled.sql})`);
+            args.push(...compiled.args);
+        }
+        if (parts.length === 0)
+            return { sql: "", args: [] };
+        if (parts.length === 1)
+            return { sql: parts[0].slice(1, -1), args };
+        const joiner = node.type === "and" ? " AND " : " OR ";
+        return { sql: parts.join(joiner), args };
+    }
+    if (node.type !== "cond") {
+        throw new CrudianError("invalid where node");
+    }
+    const col = quoteIdent(node.column);
+    switch (node.op) {
+        case "eq":
+            return { sql: `${col} = ?`, args: [node.value] };
+        case "ne":
+            return { sql: `${col} <> ?`, args: [node.value] };
+        case "lt":
+            return { sql: `${col} < ?`, args: [node.value] };
+        case "gt":
+            return { sql: `${col} > ?`, args: [node.value] };
+        case "lte":
+            return { sql: `${col} <= ?`, args: [node.value] };
+        case "gte":
+            return { sql: `${col} >= ?`, args: [node.value] };
+        case "like":
+            return { sql: `${col} LIKE ?`, args: [node.value] };
+        case "isNull":
+            return { sql: `${col} IS NULL`, args: [] };
+        case "isNotNull":
+            return { sql: `${col} IS NOT NULL`, args: [] };
+        case "in": {
+            const values = node.value;
+            if (!Array.isArray(values)) {
+                throw new CrudianError("in value must be an array");
+            }
+            if (values.length === 0) {
+                throw new CrudianError("in requires a non-empty array");
+            }
+            const placeholders = values.map(() => "?").join(", ");
+            return { sql: `${col} IN (${placeholders})`, args: values };
+        }
+        default:
+            throw new CrudianError(`unknown op: ${node.op}`);
+    }
+}

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

@@ -0,0 +1,27 @@
+import { type DeleteQuery, type DuplicateQuery, type ReadQuery, type Row, type SearchQuery, type SearchResult, type UpdateQuery } from "../index.js";
+export type SyncSqliteExecutor = {
+    run(sql: string, args?: unknown[]): {
+        changes: number;
+    };
+    get(sql: string, args?: unknown[]): Row | undefined;
+    all(sql: string, args?: unknown[]): Row[];
+    transaction<T>(fn: () => T): T;
+};
+export type SyncSqliteCrud<TDb> = {
+    readonly db: TDb;
+    create<T extends Row = Row>(table: string, cols: Record<string, unknown>): T;
+    read<T extends Row = Row>(table: string, query?: ReadQuery): T | null;
+    update<T extends Row = Row>(table: string, cols: Record<string, unknown>, query: UpdateQuery): T | null;
+    delete(table: string, query: DeleteQuery): number;
+    upsert<T extends Row = Row>(table: string, cols: Record<string, unknown>): T;
+    duplicate<T extends Row = Row>(table: string, query: DuplicateQuery): T | null;
+    bulkCreate(table: string, rows: Record<string, unknown>[]): number;
+    bulkUpdate(table: string, cols: Record<string, unknown>, query: UpdateQuery): number;
+    bulkDelete(table: string, query: DeleteQuery): number;
+    bulkUpsert(table: string, rows: Record<string, unknown>[]): number;
+    search<T extends Row = Row>(table: string, query?: SearchQuery): SearchResult<T>;
+    list<T extends Row = Row>(table: string, query?: SearchQuery): SearchResult<T>;
+    transaction<T>(fn: () => T): T;
+};
+export declare function createSyncSqliteCrud<TDb>(db: TDb, ex: SyncSqliteExecutor): SyncSqliteCrud<TDb>;
+//# sourceMappingURL=sync-crud.d.ts.map

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

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

package/dist/sqlite/sync-crud.js

@@ -0,0 +1,237 @@
+import { CrudianError, assertString, } from "../index.js";
+import { compileWhere, quoteIdent, resolveWhere } from "./sql.js";
+function requireWhere(query, label) {
+    if (query.where === undefined || query.where === null) {
+        throw new CrudianError(`${label} requires where`);
+    }
+}
+function selectColumns(columns) {
+    if (!columns || columns.length === 0)
+        return "*";
+    return columns.map((c) => quoteIdent(c)).join(", ");
+}
+function rowFromObject(value) {
+    if (value === null || typeof value !== "object") {
+        throw new CrudianError("expected row object");
+    }
+    return { ...value };
+}
+export function createSyncSqliteCrud(db, ex) {
+    const crud = {
+        db,
+        create(table, cols) {
+            assertString(table, "table");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            const tbl = quoteIdent(table);
+            const colSql = keys.map((k) => quoteIdent(k)).join(", ");
+            const placeholders = keys.map(() => "?").join(", ");
+            const args = keys.map((k) => cols[k]);
+            ex.run(`INSERT INTO ${tbl} (${colSql}) VALUES (${placeholders})`, args);
+            const idRow = ex.get("SELECT last_insert_rowid() AS id");
+            const id = Number(idRow?.id);
+            const row = ex.get(`SELECT * FROM ${tbl} WHERE "id" = ?`, [id]);
+            return rowFromObject(row);
+        },
+        read(table, query = {}) {
+            assertString(table, "table");
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
+                (where.sql ? ` WHERE ${where.sql}` : "") +
+                ` LIMIT 1`;
+            const row = ex.get(sql, where.args);
+            return row == null ? null : rowFromObject(row);
+        },
+        update(table, cols, query) {
+            assertString(table, "table");
+            requireWhere(query, "update");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            if (!where.sql) {
+                throw new CrudianError("update requires where");
+            }
+            const sets = keys.map((k) => `${quoteIdent(k)} = ?`).join(", ");
+            const args = [...keys.map((k) => cols[k]), ...where.args];
+            const result = ex.run(`UPDATE ${tbl} SET ${sets} WHERE ${where.sql}`, args);
+            if (result.changes === 0)
+                return null;
+            const row = ex.get(`SELECT * FROM ${tbl} WHERE ${where.sql} LIMIT 1`, where.args);
+            return row == null ? null : rowFromObject(row);
+        },
+        delete(table, query) {
+            assertString(table, "table");
+            requireWhere(query, "delete");
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            if (!where.sql) {
+                throw new CrudianError("delete requires where");
+            }
+            const result = ex.run(`DELETE FROM ${tbl} WHERE ${where.sql}`, where.args);
+            return Number(result.changes ?? 0);
+        },
+        search(table, query = {}) {
+            assertString(table, "table");
+            const limit = query.limit ?? 20;
+            if (typeof limit !== "number" || !Number.isFinite(limit) || limit <= 0) {
+                throw new CrudianError("limit must be a positive number");
+            }
+            if (query.cursor != null &&
+                typeof query.cursor !== "number" &&
+                typeof query.cursor !== "string") {
+                throw new CrudianError("cursor must be a number, string, or null");
+            }
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            const args = [...where.args];
+            const parts = [];
+            if (where.sql)
+                parts.push(`(${where.sql})`);
+            if (query.cursor != null) {
+                parts.push(`${quoteIdent("id")} > ?`);
+                args.push(query.cursor);
+            }
+            const whereSql = parts.length > 0 ? ` WHERE ${parts.join(" AND ")}` : "";
+            const sql = `SELECT ${selectColumns(query.columns)} FROM ${tbl}` +
+                whereSql +
+                ` ORDER BY ${quoteIdent("id")} ASC LIMIT ?`;
+            args.push(limit + 1);
+            const rows = ex.all(sql, args).map((r) => rowFromObject(r));
+            const hasMore = rows.length > limit;
+            const items = hasMore ? rows.slice(0, limit) : rows;
+            const last = items[items.length - 1];
+            const nextCursor = hasMore && last != null && (typeof last.id === "number" || typeof last.id === "string")
+                ? last.id
+                : null;
+            return { items, nextCursor, hasMore };
+        },
+        list(table, query) {
+            return crud.search(table, query);
+        },
+        upsert(table, cols) {
+            assertString(table, "table");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            if (!Object.prototype.hasOwnProperty.call(cols, "id")) {
+                throw new CrudianError("upsert requires cols.id");
+            }
+            const id = cols.id;
+            const existing = crud.read(table, {
+                where: { type: "cond", op: "eq", column: "id", value: id },
+            });
+            if (existing != null) {
+                const { id: _id, ...patch } = cols;
+                if (Object.keys(patch).length === 0)
+                    return existing;
+                const updated = crud.update(table, patch, {
+                    where: { type: "cond", op: "eq", column: "id", value: id },
+                });
+                if (updated == null) {
+                    throw new CrudianError("upsert update failed");
+                }
+                return updated;
+            }
+            return crud.create(table, cols);
+        },
+        duplicate(table, query) {
+            assertString(table, "table");
+            requireWhere(query, "duplicate");
+            const source = crud.read(table, { where: query.where });
+            if (source == null)
+                return null;
+            const { id: _id, ...rest } = source;
+            const overrides = query.overrides != null &&
+                typeof query.overrides === "object" &&
+                !Array.isArray(query.overrides)
+                ? query.overrides
+                : {};
+            const cols = { ...rest, ...overrides };
+            delete cols.id;
+            return crud.create(table, cols);
+        },
+        bulkCreate(table, rows) {
+            assertString(table, "table");
+            if (!Array.isArray(rows)) {
+                throw new CrudianError("rows must be an array");
+            }
+            if (rows.length === 0)
+                return 0;
+            let count = 0;
+            for (const row of rows) {
+                if (row == null || typeof row !== "object" || Array.isArray(row)) {
+                    throw new CrudianError("each row must be an object");
+                }
+                crud.create(table, row);
+                count += 1;
+            }
+            return count;
+        },
+        bulkUpdate(table, cols, query) {
+            assertString(table, "table");
+            requireWhere(query, "bulkUpdate");
+            if (cols == null || typeof cols !== "object" || Array.isArray(cols)) {
+                throw new CrudianError("cols must be an object");
+            }
+            const keys = Object.keys(cols);
+            if (keys.length === 0) {
+                throw new CrudianError("cols must not be empty");
+            }
+            const tbl = quoteIdent(table);
+            const where = compileWhere(resolveWhere(query.where));
+            if (!where.sql) {
+                throw new CrudianError("bulkUpdate requires where");
+            }
+            const sets = keys.map((k) => `${quoteIdent(k)} = ?`).join(", ");
+            const args = [...keys.map((k) => cols[k]), ...where.args];
+            const result = ex.run(`UPDATE ${tbl} SET ${sets} WHERE ${where.sql}`, args);
+            return Number(result.changes ?? 0);
+        },
+        bulkDelete(table, query) {
+            return crud.delete(table, query);
+        },
+        bulkUpsert(table, rows) {
+            assertString(table, "table");
+            if (!Array.isArray(rows)) {
+                throw new CrudianError("rows must be an array");
+            }
+            if (rows.length === 0)
+                return 0;
+            let count = 0;
+            for (const row of rows) {
+                if (row == null || typeof row !== "object" || Array.isArray(row)) {
+                    throw new CrudianError("each row must be an object");
+                }
+                if (!Object.prototype.hasOwnProperty.call(row, "id")) {
+                    throw new CrudianError("bulkUpsert requires each row to have id");
+                }
+                crud.upsert(table, row);
+                count += 1;
+            }
+            return count;
+        },
+        transaction(fn) {
+            if (typeof fn !== "function") {
+                throw new CrudianError("transaction callback must be a function");
+            }
+            return ex.transaction(fn);
+        },
+    };
+    return crud;
+}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+import type { WhereBuilder, WhereNode } from "./where.js";
+export type Row = Record<string, unknown>;
+export type SearchResult<T = Row> = {
+    items: T[];
+    nextCursor: number | string | null;
+    hasMore: boolean;
+};
+export type WhereInput = WhereBuilder | WhereNode;
+export type ReadQuery = {
+    columns?: string[];
+    where?: WhereInput;
+};
+export type SearchQuery = {
+    columns?: string[];
+    where?: WhereInput;
+    limit?: number;
+    /** Raw `id` cursor (keyset). */
+    cursor?: number | string | null;
+};
+export type DeleteQuery = {
+    where: WhereInput;
+};
+export type UpdateQuery = {
+    where: WhereInput;
+};
+export type DuplicateQuery = {
+    where: WhereInput;
+    overrides?: Record<string, unknown>;
+};
+//# 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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI;IAClC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,CAAA;AAEjD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC,CAAA"}

package/dist/types.js

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

package/dist/where.d.ts

@@ -0,0 +1,36 @@
+export type Op = "eq" | "ne" | "lt" | "gt" | "lte" | "gte" | "in" | "like" | "isNull" | "isNotNull";
+export type CondNode = {
+    type: "cond";
+    op: Op;
+    column: string;
+    value?: unknown;
+};
+export type GroupNode = {
+    type: "and" | "or";
+    children: WhereNode[];
+};
+export type WhereNode = CondNode | GroupNode;
+/** Public where builder. Tree shape is an internal representation via `toNode()`. */
+export declare class WhereBuilder {
+    private readonly node;
+    private constructor();
+    static create(): WhereBuilder;
+    static from(node: WhereNode): WhereBuilder;
+    private appendCond;
+    eq(column: string, value: unknown): WhereBuilder;
+    ne(column: string, value: unknown): WhereBuilder;
+    lt(column: string, value: unknown): WhereBuilder;
+    gt(column: string, value: unknown): WhereBuilder;
+    lte(column: string, value: unknown): WhereBuilder;
+    gte(column: string, value: unknown): WhereBuilder;
+    in(column: string, value: unknown[]): WhereBuilder;
+    like(column: string, value: unknown): WhereBuilder;
+    isNull(column: string): WhereBuilder;
+    isNotNull(column: string): WhereBuilder;
+    and(...others: WhereBuilder[]): WhereBuilder;
+    or(...others: WhereBuilder[]): WhereBuilder;
+    toNode(): WhereNode;
+}
+export declare function where(): WhereBuilder;
+export declare function isWhereBuilder(value: unknown): value is WhereBuilder;
+//# sourceMappingURL=where.d.ts.map

package/dist/where.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"where.d.ts","sourceRoot":"","sources":["../src/where.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,EAAE,GACV,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,IAAI,GACJ,MAAM,GACN,QAAQ,GACR,WAAW,CAAA;AAEf,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,EAAE,CAAA;IACN,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAA;IAClB,QAAQ,EAAE,SAAS,EAAE,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAO5C,qFAAqF;AACrF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAEhC,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,YAAY;IAI7B,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY;IAI1C,OAAO,CAAC,UAAU;IAQlB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY;IAIhD,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY;IAIhD,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY;IAIhD,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY;IAIhD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY;IAIjD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY;IAIjD,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY;IAOlD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY;IAIlD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAIpC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAIvC,GAAG,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY;IAK5C,EAAE,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY;IAK3C,MAAM,IAAI,SAAS;CAGpB;AAED,wBAAgB,KAAK,IAAI,YAAY,CAEpC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}