@ketvietlab/ketjs 0.1.1

package/dist/data/migrate.js

@@ -0,0 +1,136 @@
+// Schema is derived from the manifest, never hand-written; migrations are generated
+// as reviewable operations, never applied silently.
+//
+// The Odoo lesson encoded as a rule: destructive operations are still generated so
+// you can see them, but refused unless explicitly allowed. "Don't drop fields"
+// stops being discipline someone has to remember and becomes something the tool enforces.
+import { sqlTypeOf } from '../kernel/types.js';
+export const tableNameFor = (modelKey) => modelKey
+    .replace('.', '_')
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+    .toLowerCase();
+export function schemaFromManifest(manifest) {
+    const tables = {};
+    for (const [modelKey, model] of Object.entries(manifest.models)) {
+        const columns = {};
+        for (const [fname, f] of Object.entries(model.fields)) {
+            columns[fname] = {
+                sql: sqlTypeOf(f),
+                base: f.base,
+                optional: !!f.optional,
+                by: f.by,
+                target: f.target ?? null,
+            };
+        }
+        tables[tableNameFor(modelKey)] = { model: modelKey, owner: model.owner, columns, indexes: model.indexes };
+    }
+    return { version: 1, tables };
+}
+export class DestructiveMigrationError extends Error {
+    code = 'E_DESTRUCTIVE_MIGRATION';
+    ops;
+    constructor(message, ops) {
+        super(message);
+        this.ops = ops;
+    }
+}
+export function planMigration(prev, next, opts = {}) {
+    const ops = [];
+    const prevTables = prev?.tables ?? {};
+    for (const [t, def] of Object.entries(next.tables)) {
+        const before = prevTables[t];
+        if (!before) {
+            ops.push({ op: 'CREATE_TABLE', table: t, columns: def.columns, destructive: false });
+            for (const [name, index] of Object.entries(def.indexes ?? {}))
+                ops.push({ op: 'CREATE_INDEX', table: t, name, def: index, destructive: false });
+            continue;
+        }
+        for (const [c, cd] of Object.entries(def.columns)) {
+            const bc = before.columns[c];
+            if (!bc) {
+                ops.push({ op: 'ADD_COLUMN', table: t, column: c, def: cd, destructive: false });
+                continue;
+            }
+            if (bc.base !== cd.base)
+                ops.push({
+                    op: 'ALTER_COLUMN_TYPE',
+                    table: t,
+                    column: c,
+                    from: bc.base,
+                    to: cd.base,
+                    destructive: true,
+                });
+        }
+        // Indexes are dropped before the columns and created after them. Postgres
+        // drops any index covering a dropped column as part of ALTER TABLE, so a
+        // DROP_INDEX emitted afterwards would fail on an index that is already gone
+        // and abort the migration halfway through.
+        const creates = [];
+        for (const [name, index] of Object.entries(def.indexes ?? {})) {
+            const old = before.indexes?.[name];
+            if (!old)
+                creates.push({ op: 'CREATE_INDEX', table: t, name, def: index, destructive: false });
+            else if (old.unique !== index.unique || old.fields.join('\0') !== index.fields.join('\0')) {
+                ops.push({ op: 'DROP_INDEX', table: t, name, destructive: true });
+                creates.push({ op: 'CREATE_INDEX', table: t, name, def: index, destructive: false });
+            }
+        }
+        for (const name of Object.keys(before.indexes ?? {})) {
+            if (!def.indexes?.[name])
+                ops.push({ op: 'DROP_INDEX', table: t, name, destructive: true });
+        }
+        for (const [c, bc] of Object.entries(before.columns)) {
+            if (!def.columns[c])
+                ops.push({ op: 'DROP_COLUMN', table: t, column: c, by: bc.by, destructive: true });
+        }
+        ops.push(...creates);
+    }
+    for (const t of Object.keys(prevTables)) {
+        if (!next.tables[t])
+            ops.push({ op: 'DROP_TABLE', table: t, destructive: true });
+    }
+    const destructive = ops.filter((o) => o.destructive);
+    if (destructive.length && !opts.allowDestructive) {
+        const list = destructive
+            .map((o) => {
+            const col = 'column' in o ? '.' + o.column : '';
+            const by = 'by' in o ? ` (contributed by ${o.by})` : '';
+            return `  - ${o.op} ${o.table}${col}${by}`;
+        })
+            .join('\n');
+        throw new DestructiveMigrationError(`migration contains ${destructive.length} destructive operation(s):\n${list}\n\n` +
+            `Re-run with --allow-destructive if this is intended. Data in these columns is lost.`, destructive);
+    }
+    return ops;
+}
+export function renderSql(ops, adapter) {
+    const q = (s) => adapter.quoteIdent(s);
+    const out = [];
+    for (const o of ops) {
+        if (o.op === 'CREATE_TABLE') {
+            const cols = Object.entries(o.columns).map(([n, c]) => `${q(n)} ${adapter.columnSql(c)}${c.optional || c.base === 'id' ? '' : ' NOT NULL'}`);
+            out.push(`CREATE TABLE ${q(o.table)} (\n  ${cols.join(',\n  ')}\n)`);
+        }
+        else if (o.op === 'ADD_COLUMN') {
+            out.push(`ALTER TABLE ${q(o.table)} ADD COLUMN ${q(o.column)} ${adapter.columnSql(o.def)}`);
+        }
+        else if (o.op === 'CREATE_INDEX') {
+            const name = `${o.table}__${o.name}`;
+            out.push(`CREATE ${o.def.unique ? 'UNIQUE ' : ''}INDEX ${q(name)} ON ${q(o.table)} (${o.def.fields.map(q).join(', ')})`);
+        }
+        else if (o.op === 'DROP_INDEX') {
+            out.push(`DROP INDEX ${q(`${o.table}__${o.name}`)}`);
+        }
+        else if (o.op === 'DROP_COLUMN') {
+            out.push(`ALTER TABLE ${q(o.table)} DROP COLUMN ${q(o.column)}`);
+        }
+        else if (o.op === 'ALTER_COLUMN_TYPE') {
+            out.push(`-- type change ${o.table}.${o.column}: ${o.from} -> ${o.to} needs a hand-written data migration`);
+        }
+        else {
+            out.push(`DROP TABLE ${q(o.table)}`);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/data/migrate.js.map

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

package/dist/data/pool.d.ts

@@ -0,0 +1,20 @@
+import type { Adapter } from '../types.ts';
+export type PoolOptions = {
+    create(key: string): Adapter;
+    /** How many databases may stay open at once. */
+    max?: number;
+    /** Close an idle database after this long. */
+    idleMs?: number;
+    now?: () => number;
+};
+export type AdapterPool = {
+    acquire(key: string): Promise<Adapter>;
+    release(key: string): void;
+    with<T>(key: string, fn: (adapter: Adapter) => Promise<T>): Promise<T>;
+    evictIdle(): Promise<number>;
+    close(): Promise<void>;
+    readonly open: string[];
+    readonly size: number;
+};
+export declare function createAdapterPool(o: PoolOptions): AdapterPool;
+//# sourceMappingURL=pool.d.ts.map

package/dist/data/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/data/pool.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAC5B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB,CAAA;AAID,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACtE,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CAiF7D"}

package/dist/data/pool.js

@@ -0,0 +1,92 @@
+// One adapter per database, kept warm and bounded.
+//
+// This is where the Odoo model hurts most in practice: a database per tenant means
+// connections multiply by tenant, and a Postgres cluster has a hard ceiling on them.
+// So the pool caps how many databases stay open at once, evicts the least recently
+// used, and refuses to close one that a request is still holding.
+export function createAdapterPool(o) {
+    const max = o.max ?? 32;
+    const idleMs = o.idleMs ?? 5 * 60_000;
+    const now = o.now ?? (() => Date.now());
+    const entries = new Map();
+    const evictOne = async () => {
+        let oldest = null;
+        for (const [k, e] of entries) {
+            if (e.leases > 0)
+                continue;
+            if (!oldest || e.lastUsed < oldest[1].lastUsed)
+                oldest = [k, e];
+        }
+        if (!oldest)
+            return false;
+        entries.delete(oldest[0]);
+        await oldest[1].adapter.close();
+        return true;
+    };
+    const acquire = async (key) => {
+        let e = entries.get(key);
+        if (!e) {
+            // Make room before opening, never after: the cap is on connections actually held.
+            while (entries.size >= max) {
+                if (!(await evictOne())) {
+                    throw new Error(`adapter pool is full (${entries.size}/${max}) and every database is in use`);
+                }
+            }
+            const adapter = o.create(key);
+            e = { adapter, leases: 0, lastUsed: now(), opening: null };
+            entries.set(key, e);
+            e.opening = adapter.open();
+        }
+        if (e.opening) {
+            await e.opening;
+            e.opening = null;
+        }
+        e.leases++;
+        e.lastUsed = now();
+        return e.adapter;
+    };
+    const release = (key) => {
+        const e = entries.get(key);
+        if (!e)
+            return;
+        e.leases = Math.max(0, e.leases - 1);
+        e.lastUsed = now();
+    };
+    return {
+        acquire,
+        release,
+        async with(key, fn) {
+            const adapter = await acquire(key);
+            try {
+                return await fn(adapter);
+            }
+            finally {
+                release(key);
+            }
+        },
+        async evictIdle() {
+            const cutoff = now() - idleMs;
+            let n = 0;
+            for (const [k, e] of [...entries]) {
+                if (e.leases > 0 || e.lastUsed > cutoff)
+                    continue;
+                entries.delete(k);
+                await e.adapter.close();
+                n++;
+            }
+            return n;
+        },
+        async close() {
+            for (const [, e] of entries)
+                await e.adapter.close();
+            entries.clear();
+        },
+        get open() {
+            return [...entries.keys()];
+        },
+        get size() {
+            return entries.size;
+        },
+    };
+}
+//# sourceMappingURL=pool.js.map

package/dist/data/pool.js.map

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

package/dist/data/query.d.ts

@@ -0,0 +1,111 @@
+import type { Col, Expr } from './expr.ts';
+import type { Manifest } from '../types.ts';
+import type { GroupInterval } from './time.ts';
+export type Dialect = 'sqlite' | 'postgres';
+export type Sql = {
+    text: string;
+    params: unknown[];
+    touches: string[];
+};
+export type Order = {
+    col: Col;
+    dir: 'asc' | 'desc';
+};
+export type GroupSpec = {
+    col: Col;
+    interval?: GroupInterval;
+    timezone?: string;
+};
+export type AggregateSpec = {
+    fn: 'count';
+    as: string;
+} | {
+    fn: 'countDistinct' | 'sum' | 'avg' | 'min' | 'max';
+    col: Col;
+    as: string;
+};
+export type GroupOrder = {
+    by: 'key' | 'count' | string;
+    dir: 'asc' | 'desc';
+};
+export type GroupRow = {
+    key: unknown[];
+    count: number;
+    aggregates: Record<string, unknown>;
+};
+export type Table<T = Record<string, Col>> = T & {
+    readonly $model: string;
+    readonly $columns: string[];
+};
+export declare function table(manifest: Manifest, model: string): Table;
+export type QueryKind = 'select' | 'count' | 'delete' | 'group';
+/** Related rows a query has asked for. Never populated by touching a property. */
+export type Preload = {
+    name: string;
+};
+export declare class Query {
+    readonly kind: QueryKind;
+    readonly model: string;
+    readonly columns: readonly string[] | null;
+    readonly condition: Expr | null;
+    readonly order: readonly Order[];
+    readonly limitN: number | null;
+    readonly offsetN: number | null;
+    readonly preloads: readonly Preload[];
+    readonly groups: readonly GroupSpec[];
+    readonly aggregates: readonly AggregateSpec[];
+    readonly groupOrder: readonly GroupOrder[];
+    constructor(init: {
+        kind: QueryKind;
+        model: string;
+        columns?: readonly string[] | null;
+        condition?: Expr | null;
+        order?: readonly Order[];
+        limitN?: number | null;
+        offsetN?: number | null;
+        preloads?: readonly Preload[];
+        groups?: readonly GroupSpec[];
+        aggregates?: readonly AggregateSpec[];
+        groupOrder?: readonly GroupOrder[];
+    });
+    private with;
+    select(...cols: Col[]): Query;
+    /** Additional conditions are ANDed, so a query can be narrowed by several callers. */
+    where(...parts: Expr[]): Query;
+    orderBy(...order: Order[]): Query;
+    limit(n: number): Query;
+    offset(n: number): Query;
+    count(): Query;
+    groupBy(...groups: GroupSpec[]): Query;
+    aggregate(...aggregates: AggregateSpec[]): Query;
+    orderGroupsBy(...order: GroupOrder[]): Query;
+    /**
+     * Ask for a declared relation alongside the rows. Two queries, not one per row:
+     * the parents, then the children by id. There is no lazy alternative, which is
+     * exactly why an accidental N+1 cannot be written here.
+     */
+    preload(...names: string[]): Query;
+    /** Every model this query reads or writes. Checked against declared effects. */
+    get touches(): string[];
+    get effect(): 'read' | 'write';
+    toSQL(dialect?: Dialect): Sql;
+    toJSON(): {
+        kind: QueryKind;
+        model: string;
+        columns: readonly string[] | null;
+        where: Expr | null;
+        order: readonly Order[];
+        limit: number | null;
+        offset: number | null;
+        preloads: string[];
+        groups: readonly GroupSpec[];
+        aggregates: readonly AggregateSpec[];
+        groupOrder: readonly GroupOrder[];
+        touches: string[];
+    };
+}
+export declare const from: (t: Table) => Query;
+export declare const deleteFrom: (t: Table) => Query;
+export declare const asc: (col: Col) => Order;
+export declare const desc: (col: Col) => Order;
+//# sourceMappingURL=query.d.ts.map

package/dist/data/query.d.ts.map

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

package/dist/data/query.js

@@ -0,0 +1,268 @@
+// A query is an immutable value. Builder methods return a new query rather than
+// mutating one, so a query can be passed through several modules and refined by
+// each without any of them stepping on the others — Ecto's composability with a
+// chainable surface.
+import { exprTouches, and } from './expr.js';
+import { tableNameFor } from './migrate.js';
+import { KetError } from '../kernel/errors.js';
+import { assertTimezone } from './time.js';
+// Column handles are built once from the manifest. No proxies, no magic: a column
+// that does not exist simply is not there, and the expression helpers reject it.
+export function table(manifest, model) {
+    const def = manifest.models[model];
+    if (!def) {
+        throw new KetError({
+            code: 'E_UNKNOWN_MODEL',
+            message: `no model "${model}"`,
+            hint: `known models: ${Object.keys(manifest.models).join(', ') || '(none)'}`,
+        });
+    }
+    const t = Object.create(null);
+    for (const name of Object.keys(def.fields))
+        t[name] = Object.freeze({ model, name });
+    t['$model'] = model;
+    t['$columns'] = Object.keys(def.fields);
+    return Object.freeze(t);
+}
+export class Query {
+    kind;
+    model;
+    columns;
+    condition;
+    order;
+    limitN;
+    offsetN;
+    preloads;
+    groups;
+    aggregates;
+    groupOrder;
+    constructor(init) {
+        this.kind = init.kind;
+        this.model = init.model;
+        this.columns = init.columns ?? null;
+        this.condition = init.condition ?? null;
+        this.order = init.order ?? [];
+        this.limitN = init.limitN ?? null;
+        this.offsetN = init.offsetN ?? null;
+        this.preloads = init.preloads ?? [];
+        this.groups = init.groups ?? [];
+        this.aggregates = init.aggregates ?? [];
+        this.groupOrder = init.groupOrder ?? [];
+        Object.freeze(this);
+    }
+    with(patch) {
+        return new Query({
+            kind: this.kind,
+            model: this.model,
+            columns: this.columns,
+            condition: this.condition,
+            order: this.order,
+            limitN: this.limitN,
+            offsetN: this.offsetN,
+            preloads: this.preloads,
+            groups: this.groups,
+            aggregates: this.aggregates,
+            groupOrder: this.groupOrder,
+            ...patch,
+        });
+    }
+    select(...cols) {
+        return this.with({ columns: cols.map((c) => c.name) });
+    }
+    /** Additional conditions are ANDed, so a query can be narrowed by several callers. */
+    where(...parts) {
+        const next = parts.length === 1 ? parts[0] : and(...parts);
+        return this.with({ condition: this.condition ? and(this.condition, next) : next });
+    }
+    orderBy(...order) {
+        return this.with({ order: [...this.order, ...order] });
+    }
+    limit(n) {
+        return this.with({ limitN: n });
+    }
+    offset(n) {
+        return this.with({ offsetN: n });
+    }
+    count() {
+        return this.with({ kind: 'count', columns: null, order: [] });
+    }
+    groupBy(...groups) {
+        if (!groups.length)
+            throw new KetError({ code: 'E_GROUP_EMPTY', message: 'groupBy requires a field' });
+        for (const group of groups) {
+            if (group.col.model !== this.model)
+                throw new KetError({
+                    code: 'E_GROUP_MODEL',
+                    message: `cannot group ${this.model} by ${group.col.model}`,
+                });
+            if (group.interval && group.timezone)
+                assertTimezone(group.timezone);
+        }
+        return this.with({ kind: 'group', columns: null, groups: [...this.groups, ...groups] });
+    }
+    aggregate(...aggregates) {
+        for (const aggregate of aggregates) {
+            if (aggregate.fn !== 'count' && aggregate.col.model !== this.model)
+                throw new KetError({
+                    code: 'E_GROUP_MODEL',
+                    message: `cannot aggregate ${aggregate.col.model} on ${this.model}`,
+                });
+            if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(aggregate.as) || aggregate.as === 'count')
+                throw new KetError({
+                    code: 'E_AGGREGATE_ALIAS',
+                    message: `invalid aggregate alias "${aggregate.as}"`,
+                });
+        }
+        return this.with({ aggregates: [...this.aggregates, ...aggregates] });
+    }
+    orderGroupsBy(...order) {
+        return this.with({ groupOrder: [...this.groupOrder, ...order] });
+    }
+    /**
+     * Ask for a declared relation alongside the rows. Two queries, not one per row:
+     * the parents, then the children by id. There is no lazy alternative, which is
+     * exactly why an accidental N+1 cannot be written here.
+     */
+    preload(...names) {
+        return this.with({ preloads: [...this.preloads, ...names.map((name) => ({ name }))] });
+    }
+    /** Every model this query reads or writes. Checked against declared effects. */
+    get touches() {
+        const s = exprTouches(this.condition);
+        s.add(this.model);
+        for (const group of this.groups)
+            s.add(group.col.model);
+        for (const aggregate of this.aggregates)
+            if (aggregate.fn !== 'count')
+                s.add(aggregate.col.model);
+        return [...s].sort();
+    }
+    get effect() {
+        return this.kind === 'delete' ? 'write' : 'read';
+    }
+    toSQL(dialect = 'sqlite') {
+        const params = [];
+        const q = (s) => `"${s.replace(/"/g, '""')}"`;
+        const ph = () => (dialect === 'postgres' ? `$${params.length}` : '?');
+        const bind = (v) => {
+            params.push(v);
+            return ph();
+        };
+        const colSql = (c) => `${q(tableNameFor(c.model))}.${q(c.name)}`;
+        const render = (e) => {
+            if (e.op === 'and' || e.op === 'or') {
+                if (!e.parts.length)
+                    return e.op === 'and' ? '1 = 1' : '1 = 0';
+                return '(' + e.parts.map(render).join(e.op === 'and' ? ' AND ' : ' OR ') + ')';
+            }
+            if (e.op === 'not')
+                return `NOT (${render(e.expr)})`;
+            if (e.op === 'null')
+                return `${colSql(e.col)} IS ${e.negated ? 'NOT ' : ''}NULL`;
+            if (e.op === 'bucket') {
+                const column = colSql(e.col);
+                if (dialect === 'postgres') {
+                    const format = e.interval === 'quarter'
+                        ? 'YYYY-"Q"Q'
+                        : e.interval === 'year'
+                            ? 'YYYY'
+                            : e.interval === 'month'
+                                ? 'YYYY-MM'
+                                : 'YYYY-MM-DD';
+                    return `TO_CHAR(DATE_TRUNC('${e.interval}', ${column} AT TIME ZONE ${bind(e.timezone)}), '${format}') = ${bind(e.value)}`;
+                }
+                return `ket_date_bucket(${column}, ${bind(e.interval)}, ${bind(e.timezone)}) = ${bind(e.value)}`;
+            }
+            if (e.op === 'like')
+                return `${colSql(e.col)} ${e.insensitive && dialect === 'postgres' ? 'ILIKE' : 'LIKE'} ${bind(e.value)}${e.escape ? ` ESCAPE '\\'` : ''}`;
+            if (e.op === 'in') {
+                if (!e.values.length)
+                    return '1 = 0';
+                return `${colSql(e.col)} IN (${e.values.map(bind).join(', ')})`;
+            }
+            const compared = e.numeric && dialect === 'sqlite' ? `CAST(${colSql(e.col)} AS REAL)` : colSql(e.col);
+            return `${compared} ${e.cmp} ${bind(e.value)}`;
+        };
+        const t = q(tableNameFor(this.model));
+        let text;
+        if (this.kind === 'delete')
+            text = `DELETE FROM ${t}`;
+        else if (this.kind === 'count')
+            text = `SELECT COUNT(*) AS count FROM ${t}`;
+        else if (this.kind === 'group') {
+            const groupSql = this.groups.map((group) => {
+                const column = colSql(group.col);
+                if (!group.interval)
+                    return column;
+                const timezone = group.timezone ?? 'UTC';
+                if (dialect === 'postgres') {
+                    if (group.interval === 'quarter')
+                        return `TO_CHAR(DATE_TRUNC('quarter', ${column} AT TIME ZONE ${bind(timezone)}), 'YYYY-"Q"Q')`;
+                    const format = group.interval === 'year' ? 'YYYY' : group.interval === 'month' ? 'YYYY-MM' : 'YYYY-MM-DD';
+                    return `TO_CHAR(DATE_TRUNC('${group.interval}', ${column} AT TIME ZONE ${bind(timezone)}), '${format}')`;
+                }
+                return `ket_date_bucket(${column}, ${bind(group.interval)}, ${bind(timezone)})`;
+            });
+            const aggregateSql = this.aggregates.map((aggregate) => {
+                if (aggregate.fn === 'count')
+                    return `COUNT(*) AS ${q(aggregate.as)}`;
+                const fn = aggregate.fn === 'countDistinct' ? 'COUNT' : aggregate.fn.toUpperCase();
+                const body = aggregate.fn === 'countDistinct' ? `DISTINCT ${colSql(aggregate.col)}` : colSql(aggregate.col);
+                return `${fn}(${body}) AS ${q(aggregate.as)}`;
+            });
+            text = `SELECT ${groupSql.map((sql, i) => `${sql} AS ${q(`__group${i}`)}`).join(', ')}, COUNT(*) AS ${q('__count')}${aggregateSql.length ? `, ${aggregateSql.join(', ')}` : ''} FROM ${t}`;
+        }
+        else
+            text = `SELECT ${this.columns ? this.columns.map((c) => `${t}.${q(c)}`).join(', ') : `${t}.*`} FROM ${t}`;
+        if (this.condition)
+            text += ` WHERE ${render(this.condition)}`;
+        if (this.kind === 'group') {
+            text += ` GROUP BY ${this.groups.map((_, i) => String(i + 1)).join(', ')}`;
+            if (this.groupOrder.length) {
+                const aliases = new Set(this.aggregates.map((a) => a.as));
+                text += ` ORDER BY ${this.groupOrder
+                    .map((order) => {
+                    const by = order.by === 'key'
+                        ? q('__group0')
+                        : order.by === 'count'
+                            ? q('__count')
+                            : aliases.has(order.by)
+                                ? q(order.by)
+                                : null;
+                    if (!by)
+                        throw new KetError({ code: 'E_GROUP_ORDER', message: `unknown group order "${order.by}"` });
+                    return `${by} ${order.dir.toUpperCase()}`;
+                })
+                    .join(', ')}`;
+            }
+        }
+        else if (this.order.length)
+            text += ` ORDER BY ${this.order.map((o) => `${colSql(o.col)} ${o.dir.toUpperCase()}`).join(', ')}`;
+        if (this.limitN != null)
+            text += ` LIMIT ${bind(this.limitN)}`;
+        if (this.offsetN != null)
+            text += ` OFFSET ${bind(this.offsetN)}`;
+        return { text, params, touches: this.touches };
+    }
+    toJSON() {
+        return {
+            kind: this.kind,
+            model: this.model,
+            columns: this.columns,
+            where: this.condition,
+            order: this.order,
+            limit: this.limitN,
+            offset: this.offsetN,
+            preloads: this.preloads.map((p) => p.name),
+            groups: this.groups,
+            aggregates: this.aggregates,
+            groupOrder: this.groupOrder,
+            touches: this.touches,
+        };
+    }
+}
+export const from = (t) => new Query({ kind: 'select', model: t.$model });
+export const deleteFrom = (t) => new Query({ kind: 'delete', model: t.$model });
+export const asc = (col) => ({ col, dir: 'asc' });
+export const desc = (col) => ({ col, dir: 'desc' });
+//# sourceMappingURL=query.js.map