oakbun 0.1.0

package/dist/db/index.d.ts

@@ -0,0 +1,281 @@
+import type { VelnAdapter, BindingValue, QueryLogEntry } from '../adapter/types';
+import type { SchemaMap, TableDef, InferInsert } from '../schema/table';
+import type { HookExecutor } from '../hooks/executor';
+import { RequestEventQueue } from '../events/index';
+import type { JoinClause, SelectOptions, WhereInput, SqlDialect } from './sql';
+export interface QueryLog {
+    /** Total number of queries executed during this request. */
+    queries: number;
+    /** Cumulative wall-clock duration of all queries in ms. */
+    totalMs: number;
+    /** Individual query entries — populated only when logQueries is true. */
+    entries: QueryLogEntry[];
+    /** Warning threshold — exceeded → N+1 warning. */
+    threshold: number;
+    /** Whether individual query entries should be captured (for logQueries). */
+    logQueries: boolean;
+}
+export interface PendingEvent {
+    name: string;
+    payload: unknown;
+}
+export interface TransactionResult<T> {
+    result: T;
+    events: PendingEvent[];
+}
+export interface EventBus {
+    _emit(event: string, payload: unknown, ctx: unknown): void;
+    on(event: string, handler: (payload: unknown, ctx: unknown) => Promise<void> | void): this;
+    flush(events: PendingEvent[], ctx: unknown): Promise<void>;
+}
+export declare class VelnDB {
+    private readonly adapter;
+    private readonly hooks;
+    constructor(adapter: VelnAdapter, hooks: HookExecutor);
+    /** Return a new BoundVelnDB scoped to the given context. Never mutates this. */
+    withCtx(ctx: unknown, queue?: RequestEventQueue, queryLog?: QueryLog): BoundVelnDB;
+}
+export declare class BoundVelnDB {
+    private readonly hooks;
+    private readonly ctx;
+    private readonly queue?;
+    /** Per-request query counter — incremented for every query() and execute() call on this instance. */
+    _queryCount: number;
+    private readonly adapter;
+    constructor(adapter: VelnAdapter, hooks: HookExecutor, ctx: unknown, queue?: RequestEventQueue, queryLog?: QueryLog);
+    from<T, S extends SchemaMap>(table: TableDef<T, S>): SelectBuilder<T, S>;
+    /**
+     * Start a JOIN query from the given table name.
+     * Returns a JoinBuilder — call .join()/.leftJoin() etc. to add clauses,
+     * then .select() to execute and get Record<string, unknown>[] results.
+     *
+     * @example
+     * const rows = await db.join('orders')
+     *   .columns(['orders.id', 'users.name'])
+     *   .join('users', 'orders.user_id = users.id')
+     *   .where('orders.status = ?', ['pending'])
+     *   .select()
+     */
+    join(tableName: string): JoinBuilder;
+    into<T, S extends SchemaMap>(table: TableDef<T, S>): InsertBuilder<T, S>;
+    /**
+     * DataLoader-pattern relation fetch — single IN-query, no N+1.
+     * Returns a Map keyed by the foreign-key value; each entry is an array of
+     * matching child rows (for one-to-many relations).
+     *
+     * @example
+     * const posts = await db.from(postsTable).select()
+     * const authorMap = await db.loadRelation(posts, 'authorId', usersTable, 'id')
+     * // → SELECT * FROM "users" WHERE "id" IN (1, 2, 3)
+     * const withAuthors = posts.map(p => ({ ...p, author: authorMap.get(p.authorId)?.[0] ?? null }))
+     */
+    loadRelation<TParent extends Record<string, unknown>, TChild, TFk extends keyof TParent & string, TPk extends keyof TChild & string>(parents: TParent[], foreignKey: TFk, childTable: TableDef<TChild>, primaryKey: TPk): Promise<Map<TParent[TFk], TChild[]>>;
+    /**
+     * Convenience variant of loadRelation for belongs-to (many-to-one) relations.
+     * Returns Map<fkValue, TChild> — single child per key instead of an array.
+     *
+     * @example
+     * const authorMap = await db.loadRelationOne(posts, 'authorId', usersTable, 'id')
+     * const author = authorMap.get(post.authorId) ?? null
+     */
+    loadRelationOne<TParent extends Record<string, unknown>, TChild, TFk extends keyof TParent & string, TPk extends keyof TChild & string>(parents: TParent[], foreignKey: TFk, childTable: TableDef<TChild>, primaryKey: TPk): Promise<Map<TParent[TFk], TChild>>;
+    transaction<T>(fn: (db: BoundVelnDB) => Promise<T>): Promise<TransactionResult<T>>;
+    /**
+     * Execute raw SQL and return typed rows.
+     *
+     * Without a schema the return type is `Record<string, unknown>[]`.
+     * With a schema (e.g. a Zod object) every row is validated at runtime
+     * and the return type is inferred from the schema.
+     *
+     * @example
+     * // Untyped
+     * const rows = await ctx.db.raw('SELECT * FROM orders WHERE amount > ?', [100])
+     *
+     * // Typed + validated
+     * const schema = z.object({ id: z.number(), amount: z.number() })
+     * const rows = await ctx.db.raw('SELECT id, amount FROM orders WHERE amount > ?', [100], schema)
+     */
+    raw<T = Record<string, unknown>>(sql: string, params?: BindingValue[], schema?: {
+        parse: (row: unknown) => T;
+    }): Promise<T[]>;
+}
+export declare class SelectBuilder<T, S extends SchemaMap> {
+    private readonly adapter;
+    private readonly hooks;
+    private readonly ctx;
+    private readonly queue;
+    private readonly table;
+    private readonly conditions;
+    private readonly _options;
+    private readonly _rawWhere;
+    private readonly _dialect;
+    constructor(adapter: VelnAdapter, hooks: HookExecutor, ctx: unknown, queue: RequestEventQueue | undefined, table: TableDef<T, S>, conditions: WhereInput<T>, _options?: SelectOptions, _rawWhere?: {
+        sql: string;
+        params: BindingValue[];
+    }[], _dialect?: SqlDialect);
+    private _cloneWith;
+    private _clone;
+    /**
+     * Add WHERE conditions. Accepts:
+     * - Plain equality map:   `.where({ role: 'admin' })`
+     * - Operator condition:   `.where({ age: { op: '>=', value: 18 } })`
+     * - OR group:             `.where({ OR: [{ role: 'admin' }, { role: 'mod' }] })`
+     * - AND group:            `.where({ AND: [...] })`
+     *
+     * Multiple `.where()` calls are combined with AND.
+     */
+    where(conditions: WhereInput<T>): SelectBuilder<T, S>;
+    /**
+     * Append a raw SQL WHERE fragment, combined with AND.
+     * Use for conditions the builder cannot express.
+     *
+     * @example
+     * .whereRaw('"score" > "threshold"', [])
+     * .whereRaw('"created_at" > ?', ['2024-01-01'])
+     */
+    whereRaw(sql: string, params: BindingValue[]): SelectBuilder<T, S>;
+    /** Limit the number of rows returned. Bound as a parameter — never interpolated. */
+    limit(n: number): SelectBuilder<T, S>;
+    /** Skip the first n rows. Bound as a parameter — never interpolated. */
+    offset(n: number): SelectBuilder<T, S>;
+    /** Add an ORDER BY clause. Multiple calls accumulate in order. */
+    orderBy(col: keyof T & string, dir?: 'ASC' | 'DESC'): SelectBuilder<T, S>;
+    /**
+     * Convenience helper for cursor-based pagination.
+     * page(1, 10) → LIMIT 10 OFFSET 0
+     * page(2, 10) → LIMIT 10 OFFSET 10
+     */
+    page(page: number, size: number): SelectBuilder<T, S>;
+    /**
+     * Restrict which columns are returned.
+     * SELECT "id", "name" FROM "table" — instead of SELECT *
+     *
+     * Return type is narrowed to Pick<T, K> for full type safety.
+     */
+    columns<K extends keyof T & string>(...cols: K[]): SelectBuilder<Pick<T, K>, S>;
+    /**
+     * Add a GROUP BY clause. Multiple columns are comma-separated.
+     * Combine with .aggregate() to get grouped aggregate results.
+     */
+    groupBy(...cols: (keyof T & string)[]): SelectBuilder<T, S>;
+    /**
+     * Add a HAVING clause — filters aggregate groups.
+     * Uses the same WhereInput system as .where() (supports operators, OR/AND).
+     *
+     * @example
+     * .groupBy('role').aggregate({ cnt: { fn: 'COUNT' } }).having({ cnt: { op: '>', value: 1 } })
+     */
+    having(conditions: WhereInput<Record<string, unknown>>): SelectBuilder<T, S>;
+    /**
+     * Execute a GROUP BY + aggregate query.
+     * Returns typed rows with group-by columns + aggregate aliases.
+     *
+     * @example
+     * const rows = await db.from(orders)
+     *   .groupBy('status')
+     *   .aggregate({ total: { fn: 'SUM', col: 'amount' }, cnt: { fn: 'COUNT' } })
+     * // rows: { status: string; total: number; cnt: number }[]
+     */
+    aggregate<TAgg extends Record<string, number | string | null>>(aggregates: {
+        [K in keyof TAgg]: {
+            fn: 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX';
+            col?: keyof T & string;
+        };
+    }): Promise<(Partial<T> & TAgg)[]>;
+    /** COUNT(*) or COUNT("col") — returns the count as a number. */
+    count(col?: keyof T & string): Promise<number>;
+    /** SUM("col") — returns the sum as a number (0 if no rows). */
+    sum(col: keyof T & string): Promise<number>;
+    /** AVG("col") — returns the average as a number (0 if no rows). */
+    avg(col: keyof T & string): Promise<number>;
+    /** MIN("col") — returns the minimum value. */
+    min(col: keyof T & string): Promise<number | string | null>;
+    /** MAX("col") — returns the maximum value. */
+    max(col: keyof T & string): Promise<number | string | null>;
+    private _scalarAggregate;
+    private _scalarAggregateRaw;
+    select(): Promise<T[]>;
+    first(): Promise<T | null>;
+    update(patch: Partial<T>): Promise<T>;
+    delete(): Promise<T>;
+}
+export declare class InsertBuilder<T, S extends SchemaMap> {
+    private readonly adapter;
+    private readonly hooks;
+    private readonly ctx;
+    private readonly queue;
+    private readonly table;
+    constructor(adapter: VelnAdapter, hooks: HookExecutor, ctx: unknown, queue: RequestEventQueue | undefined, table: TableDef<T, S>);
+    insert(data: InferInsert<S>): Promise<T>;
+    /** Serialize values for SQLite storage. Date → ISO string. */
+    private _serializeForInsert;
+}
+export declare class JoinBuilder {
+    private readonly adapter;
+    private readonly tableName;
+    private readonly _columns;
+    private readonly _joins;
+    private readonly _where;
+    private readonly _params;
+    private readonly _options;
+    constructor(adapter: VelnAdapter, tableName: string, _columns: string[], _joins: JoinClause[], _where: string, _params: BindingValue[], _options?: SelectOptions);
+    private _cloneOpts;
+    /** Restrict the selected columns (e.g. ['orders.id', 'users.name']). */
+    columns(cols: string[]): JoinBuilder;
+    /** Add an INNER JOIN clause. */
+    join(table: string, on: string): JoinBuilder;
+    /** Add a LEFT JOIN clause. */
+    leftJoin(table: string, on: string): JoinBuilder;
+    /** Add a RIGHT JOIN clause. */
+    rightJoin(table: string, on: string): JoinBuilder;
+    /** Add a FULL JOIN clause. */
+    fullJoin(table: string, on: string): JoinBuilder;
+    /**
+     * Set a typed WHERE clause from a conditions object.
+     * Each key becomes "key" = ? — values are bound safely.
+     *
+     * @example
+     * .where({ status: 'pending', userId })
+     */
+    where(conditions: Record<string, BindingValue>): JoinBuilder;
+    /**
+     * Set a raw WHERE clause.
+     * Use ? as placeholder; pass bind values as the second argument.
+     *
+     * @example
+     * .where('orders.status = ? AND orders.user_id = ?', ['pending', userId])
+     */
+    where(sql: string, params: BindingValue[]): JoinBuilder;
+    /** Limit the number of rows returned. Bound as a parameter — never interpolated. */
+    limit(n: number): JoinBuilder;
+    /** Skip the first n rows. Bound as a parameter — never interpolated. */
+    offset(n: number): JoinBuilder;
+    /**
+     * Add an ORDER BY clause. Multiple calls accumulate in order.
+     * @param col Column reference, e.g. 'orders.created_at' or 'name'.
+     */
+    orderBy(col: string, dir?: 'ASC' | 'DESC'): JoinBuilder;
+    /**
+     * Convenience helper for cursor-based pagination.
+     * page(1, 10) → LIMIT 10 OFFSET 0
+     * page(2, 10) → LIMIT 10 OFFSET 10
+     */
+    page(page: number, size: number): JoinBuilder;
+    /**
+     * Execute the query and return raw rows (no deserialization).
+     *
+     * @remarks
+     * Type parameter T is a manual cast — not validated at runtime.
+     * For runtime validation, use db.raw() with a Zod schema instead.
+     */
+    select<T = Record<string, unknown>>(): Promise<T[]>;
+    /**
+     * Execute the query and return the first row, or null.
+     *
+     * @remarks
+     * Type parameter T is a manual cast — not validated at runtime.
+     */
+    first<T = Record<string, unknown>>(): Promise<T | null>;
+    private _addJoin;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAmB,MAAM,OAAO,CAAA;AAI/F,MAAM,WAAW,QAAQ;IACvB,4DAA4D;IAC5D,OAAO,EAAI,MAAM,CAAA;IACjB,2DAA2D;IAC3D,OAAO,EAAI,MAAM,CAAA;IACjB,yEAAyE;IACzE,OAAO,EAAI,aAAa,EAAE,CAAA;IAC1B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,UAAU,EAAE,OAAO,CAAA;CACpB;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,CAAA;IACT,MAAM,EAAE,YAAY,EAAE,CAAA;CACvB;AAID,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;IAC1F,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAID,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,YAAY;IAGtC,gFAAgF;IAChF,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW;CAGnF;AAID,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAEpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IATzB,qGAAqG;IACrG,WAAW,SAAI;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAGnC,OAAO,EAAE,WAAW,EACH,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,OAAO,EAEZ,KAAK,CAAC,EAAE,iBAAiB,EAI1C,QAAQ,CAAC,EAAE,QAAQ;IAkCrB,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAIxE;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAIpC,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAIxE;;;;;;;;;;OAUG;IACG,YAAY,CAChB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,MAAM,EACN,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EAClC,GAAG,SAAS,MAAM,MAAM,GAAG,MAAM,EAEjC,OAAO,EAAK,OAAO,EAAE,EACrB,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAsBvC;;;;;;;OAOG;IACG,eAAe,CACnB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,MAAM,EACN,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EAClC,GAAG,SAAS,MAAM,MAAM,GAAG,MAAM,EAEjC,OAAO,EAAK,OAAO,EAAE,EACrB,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAgB/B,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAiBxF;;;;;;;;;;;;;;OAcG;IACG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,GAAG,EAAM,MAAM,EACf,MAAM,GAAG,YAAY,EAAO,EAC5B,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAA;KAAE,GACtC,OAAO,CAAC,CAAC,EAAE,CAAC;CAYhB;AAoBD,qBAAa,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS;IAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBATR,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,iBAAiB,GAAG,SAAS,EACpC,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,QAAQ,GAAE,aAAkB,EAE5B,SAAS,GAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,EAAO,EACzD,QAAQ,GAAE,UAAqB;IAGlD,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,MAAM;IAcd;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAKrD;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAIlE,oFAAoF;IACpF,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAIrC,wEAAwE;IACxE,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAItC,kEAAkE;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,GAAE,KAAK,GAAG,MAAc,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAKhF;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAIrD;;;;;OAKG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAM/E;;;OAGG;IACH,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAI3D;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAI5E;;;;;;;;;OASG;IACG,SAAS,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EACjE,UAAU,EAAE;SAAG,CAAC,IAAI,MAAM,IAAI,GAAG;YAAE,EAAE,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;SAAE;KAAE,GACzG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAsBjC,gEAAgE;IAC1D,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD,+DAA+D;IACzD,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD,mEAAmE;IAC7D,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD,8CAA8C;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAIjE,8CAA8C;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;YAInD,gBAAgB;YAMhB,mBAAmB;IAmC3B,MAAM,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IA2EtB,KAAK,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK1B,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA2CrC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;CA4B3B;AAID,qBAAa,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS;IAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAJL,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,iBAAiB,GAAG,SAAS,EACpC,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAGlC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqC9C,8DAA8D;IAC9D,OAAO,CAAC,mBAAmB;CAQ5B;AAOD,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBANR,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,UAAU,EAAE,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,GAAE,aAAkB;IAG/C,OAAO,CAAC,UAAU;IAYlB,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW;IAIpC,gCAAgC;IAChC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW;IAI5C,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW;IAIhD,+BAA+B;IAC/B,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW;IAIjD,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW;IAIhD;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,WAAW;IAC5D;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW;IASvD,oFAAoF;IACpF,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW;IAI7B,wEAAwE;IACxE,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW;IAI9B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,KAAK,GAAG,MAAc,GAAG,WAAW;IAK9D;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAI7C;;;;;;OAMG;IACG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC;IAYzD;;;;;OAKG;IACG,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK7D,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/db/migrations/diff.d.ts

@@ -0,0 +1,5 @@
+import type { TableDef as TableDefSchema } from '../../schema/table';
+import type { SchemaMap } from '../../schema/table';
+import type { SchemaDiff, TableDiff } from './types';
+export declare function compareSchemas(current: Map<string, TableDiff>, target: TableDefSchema<unknown, SchemaMap>[]): SchemaDiff;
+//# sourceMappingURL=diff.d.ts.map

package/dist/db/migrations/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EAKV,MAAM,SAAS,CAAA;AAyChB,wBAAgB,cAAc,CAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,MAAM,EAAG,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,GAC5C,UAAU,CAyEZ"}

package/dist/db/migrations/generator.d.ts

@@ -0,0 +1,26 @@
+import type { VelnAdapter } from '../../adapter/types';
+import type { TableDef } from '../../schema/table';
+import type { SchemaMap } from '../../schema/table';
+export interface GenerateOptions {
+    tables: TableDef<unknown, SchemaMap>[];
+    adapter: VelnAdapter;
+    migrationsDir: string;
+    name?: string;
+    /**
+     * When true, generates executable SQL for column drops and type changes
+     * instead of commented-out warnings.
+     *
+     * @remarks
+     * ⚠️  DESTRUCTIVE: Generates SQL that permanently drops columns or changes types.
+     * Always review generated migrations before applying in production.
+     * Back up your database before running destructive migrations.
+     */
+    allowDestructive?: boolean;
+}
+export interface GenerateResult {
+    filename: string;
+    sql: string;
+    isEmpty: boolean;
+}
+export declare function generateMigration(options: GenerateOptions): Promise<GenerateResult>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/db/migrations/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAKnD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAS,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;IAC7C,OAAO,EAAQ,WAAW,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAU,MAAM,CAAA;IACrB;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAO,MAAM,CAAA;IAChB,OAAO,EAAG,OAAO,CAAA;CAClB;AA0GD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAoBzF"}

package/dist/db/migrations/index.d.ts

@@ -0,0 +1,9 @@
+export { createMigrator } from './migrator';
+export type { Migrator } from './migrator';
+export { generateMigration } from './generator';
+export type { GenerateOptions, GenerateResult } from './generator';
+export { compareSchemas } from './diff';
+export { introspectSchema } from './introspect';
+export { splitSqlStatements } from './runner';
+export type { MigrationRecord, MigrationStatus, MigratorOptions, MigrationResult, SchemaDiff, TableDiff, TableModification, ColumnDef, IndexDef, ColumnModification, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAe,YAAY,CAAA;AACpD,YAAY,EAAE,QAAQ,EAAE,MAAgB,YAAY,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAY,aAAa,CAAA;AACrD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAe,QAAQ,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAa,cAAc,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAW,UAAU,CAAA;AAClD,YAAY,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,kBAAkB,GACnB,MAAM,SAAS,CAAA"}

package/dist/db/migrations/introspect.d.ts

@@ -0,0 +1,8 @@
+import type { VelnAdapter } from '../../adapter/types';
+import type { TableDiff } from './types';
+/**
+ * Detect adapter type and introspect the current DB schema.
+ * Returns a map of table name → TableDiff.
+ */
+export declare function introspectSchema(adapter: VelnAdapter): Promise<Map<string, TableDiff>>;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/db/migrations/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAuB,MAAM,SAAS,CAAA;AAiR7D;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAiB5F"}

package/dist/db/migrations/migrator.d.ts

@@ -0,0 +1,10 @@
+import type { VelnAdapter } from '../../adapter/types';
+import type { AdapterConfig } from '../../adapter/resolve';
+import type { MigrationResult, MigrationStatus, MigratorOptions } from './types';
+export interface Migrator {
+    run(): Promise<MigrationResult[]>;
+    status(): Promise<MigrationStatus[]>;
+    rollback(): Promise<void>;
+}
+export declare function createMigrator(adapterOrConfig: AdapterConfig | VelnAdapter, options: MigratorOptions): Migrator;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/db/migrations/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/migrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGhF,MAAM,WAAW,QAAQ;IACvB,GAAG,IAAS,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACtC,MAAM,IAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACtC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,wBAAgB,cAAc,CAAC,eAAe,EAAE,aAAa,GAAG,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,CAO/G"}

package/dist/db/migrations/runner.d.ts

@@ -0,0 +1,7 @@
+import type { VelnAdapter } from '../../adapter/types';
+import type { MigrationResult, MigrationStatus, MigratorOptions } from './types';
+export declare function splitSqlStatements(sql: string): string[];
+export declare function run(adapter: VelnAdapter, opts: MigratorOptions): Promise<MigrationResult[]>;
+export declare function status(adapter: VelnAdapter, opts: MigratorOptions): Promise<MigrationStatus[]>;
+export declare function rollback(adapter: VelnAdapter, opts: MigratorOptions): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/db/migrations/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AA4BhF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA6ExD;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAgCjG;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAgBpG;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzF"}

package/dist/db/migrations/tracker.d.ts

@@ -0,0 +1,7 @@
+import type { VelnAdapter } from '../../adapter/types';
+import type { MigrationRecord } from './types';
+export declare function ensureTable(adapter: VelnAdapter, tableName: string): Promise<void>;
+export declare function getApplied(adapter: VelnAdapter, tableName: string): Promise<MigrationRecord[]>;
+export declare function markApplied(adapter: VelnAdapter, tableName: string, name: string): Promise<void>;
+export declare function markRolledBack(adapter: VelnAdapter, tableName: string, name: string): Promise<void>;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/db/migrations/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAU9C,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxF;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CASpG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtG;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzG"}

package/dist/db/migrations/types.d.ts

@@ -0,0 +1,70 @@
+export interface MigrationRecord {
+    id: number;
+    name: string;
+    appliedAt: Date;
+}
+export interface MigrationStatus {
+    name: string;
+    status: 'applied' | 'pending';
+    appliedAt?: Date;
+}
+export interface MigratorOptions {
+    migrationsDir: string;
+    tableName?: string;
+    onBeforeMigrate?: (migration: {
+        name: string;
+        sql: string;
+    }) => void | Promise<void>;
+    onAfterMigrate?: (migration: {
+        name: string;
+        sql: string;
+        durationMs: number;
+    }) => void | Promise<void>;
+    onError?: (migration: {
+        name: string;
+        error: Error;
+    }) => void | Promise<void>;
+}
+export interface MigrationResult {
+    name: string;
+    success: boolean;
+    duration: number;
+    error?: Error;
+}
+export interface SchemaDiff {
+    addedTables: TableDiff[];
+    droppedTables: string[];
+    modifiedTables: TableModification[];
+}
+export interface TableDiff {
+    name: string;
+    columns: ColumnDef[];
+    indexes: IndexDef[];
+}
+export interface TableModification {
+    name: string;
+    addedColumns: ColumnDef[];
+    droppedColumns: string[];
+    modifiedColumns: ColumnModification[];
+    addedIndexes: IndexDef[];
+    droppedIndexes: string[];
+}
+export interface ColumnDef {
+    name: string;
+    type: string;
+    nullable: boolean;
+    default?: string;
+    primaryKey: boolean;
+    unique: boolean;
+}
+export interface IndexDef {
+    name: string;
+    columns: string[];
+    unique: boolean;
+}
+export interface ColumnModification {
+    name: string;
+    before: ColumnDef;
+    after: ColumnDef;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/db/migrations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAS,MAAM,CAAA;IACjB,IAAI,EAAO,MAAM,CAAA;IACjB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAO,MAAM,CAAA;IACjB,MAAM,EAAK,SAAS,GAAG,SAAS,CAAA;IAChC,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAK,MAAM,CAAA;IACxB,SAAS,CAAC,EAAQ,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,cAAc,CAAC,EAAG,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxG,OAAO,CAAC,EAAU,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtF;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAM,MAAM,CAAA;IAChB,OAAO,EAAG,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAI,KAAK,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAK,SAAS,EAAE,CAAA;IAC3B,aAAa,EAAG,MAAM,EAAE,CAAA;IACxB,cAAc,EAAE,iBAAiB,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAK,MAAM,CAAA;IACf,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,OAAO,EAAE,QAAQ,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAa,MAAM,CAAA;IACvB,YAAY,EAAK,SAAS,EAAE,CAAA;IAC5B,cAAc,EAAG,MAAM,EAAE,CAAA;IACzB,eAAe,EAAE,kBAAkB,EAAE,CAAA;IACrC,YAAY,EAAK,QAAQ,EAAE,CAAA;IAC3B,cAAc,EAAG,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAQ,MAAM,CAAA;IAClB,IAAI,EAAQ,MAAM,CAAA;IAClB,QAAQ,EAAI,OAAO,CAAA;IACnB,OAAO,CAAC,EAAI,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,EAAM,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAK,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAG,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAI,MAAM,CAAA;IACd,MAAM,EAAE,SAAS,CAAA;IACjB,KAAK,EAAG,SAAS,CAAA;CAClB"}

package/dist/db/sql.d.ts

@@ -0,0 +1,148 @@
+import type { BindingValue } from '../adapter/types';
+import type { TableDef, SchemaMap } from '../schema/table';
+export interface JoinClause {
+    type: 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
+    table: string;
+    on: string;
+}
+export declare function validateAndQuoteOnClause(on: string): string;
+/** SQL dialect — used for ILIKE fallback on non-Postgres adapters. */
+export type SqlDialect = 'sqlite' | 'postgres' | 'mysql';
+/** Explicit operator condition for a single column. */
+export type WhereOp<T> = {
+    op: '=';
+    value: T;
+} | {
+    op: '!=';
+    value: T;
+} | {
+    op: '>';
+    value: T;
+} | {
+    op: '>=';
+    value: T;
+} | {
+    op: '<';
+    value: T;
+} | {
+    op: '<=';
+    value: T;
+} | {
+    op: 'IN';
+    value: T[];
+} | {
+    op: 'NOT IN';
+    value: T[];
+} | {
+    op: 'LIKE';
+    value: string;
+} | {
+    op: 'ILIKE';
+    value: string;
+} | {
+    op: 'IS NULL';
+} | {
+    op: 'IS NOT NULL';
+};
+/** Per-field condition — shorthand (plain value = equality) or explicit operator. */
+export type FieldCondition<T> = T | WhereOp<T>;
+/** Map of column conditions — each field is optional. */
+export type WhereConditions<TRow> = {
+    [K in keyof TRow]?: FieldCondition<TRow[K]>;
+};
+/**
+ * Full WHERE input — either a flat conditions map, OR-group, or AND-group.
+ * OR/AND values are recursively WhereInput allowing nesting.
+ */
+export type WhereInput<TRow> = WhereConditions<TRow> | {
+    OR: WhereInput<TRow>[];
+} | {
+    AND: WhereInput<TRow>[];
+};
+/**
+ * Build a WHERE clause from a WhereInput.
+ *
+ * Supports:
+ * - Shorthand equality:  { name: 'Alice' }           → "name" = ?
+ * - Explicit operator:   { age: { op: '>=', value: 18 } }
+ * - IN / NOT IN:         { id: { op: 'IN', value: [1,2,3] } }
+ * - IS NULL / IS NOT NULL
+ * - LIKE / ILIKE (ILIKE falls back to LOWER() on SQLite/MySQL)
+ * - OR groups:           { OR: [{ role: 'admin' }, { role: 'mod' }] }
+ * - AND groups:          { AND: [...] }
+ * - Nested OR/AND
+ *
+ * Returns { sql: '', params: [] } for empty / all-undefined conditions.
+ */
+export declare function buildWhere(conditions: WhereInput<Record<string, unknown>>, dialect?: SqlDialect): {
+    sql: string;
+    params: BindingValue[];
+};
+/**
+ * Build an INSERT statement.
+ * INSERT INTO "table" ("col1", "col2") VALUES (?, ?) RETURNING *
+ *
+ * RETURNING * (SQLite ≥ 3.35, PostgreSQL) returns the inserted row, avoiding
+ * a second SELECT round-trip. Pass returning: false for databases that do not
+ * support RETURNING (MySQL).
+ */
+export declare function buildInsert(tableName: string, data: Record<string, unknown>, returning?: boolean): {
+    sql: string;
+    params: BindingValue[];
+};
+/**
+ * Build an UPDATE statement.
+ * UPDATE "table" SET "col1" = ?, "col2" = ? WHERE "pk" = ?
+ * The pk param is always last in params.
+ */
+export declare function buildUpdate(tableName: string, patch: Record<string, unknown>, pk: string, pkValue: BindingValue): {
+    sql: string;
+    params: BindingValue[];
+};
+/**
+ * Build a DELETE statement.
+ * DELETE FROM "table" WHERE "pk" = ?
+ */
+export declare function buildDelete(tableName: string, pk: string, pkValue: BindingValue): {
+    sql: string;
+    params: BindingValue[];
+};
+/**
+ * Deserialize a raw DB row into the typed T shape.
+ * Consolidated here to avoid duplication between SelectBuilder and InsertBuilder.
+ * Handles TIMESTAMP columns: SQLite stores them as ISO strings, we convert back to Date.
+ */
+export declare function deserializeRow<T, S extends SchemaMap>(table: TableDef<T, S>, row: Record<string, unknown>): T;
+/** A single aggregate expression: FN("col") AS alias. */
+export interface AggregateClause {
+    alias: string;
+    fn: 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX';
+    col?: string;
+}
+export interface SelectOptions {
+    limit?: number;
+    offset?: number;
+    orderBy?: {
+        col: string;
+        dir: 'ASC' | 'DESC';
+    }[];
+    columns?: string[];
+    groupBy?: string[];
+    aggregates?: AggregateClause[];
+    having?: WhereInput<Record<string, unknown>>;
+}
+/** Build the SELECT column list from options. Exported for use in SelectBuilder's raw-where path. */
+export declare function buildSelectListFromOptions(options?: SelectOptions): string;
+/**
+ * Build a SELECT statement.
+ * SELECT [cols] FROM "table" [WHERE ...] [GROUP BY ...] [HAVING ...] [ORDER BY ...] [LIMIT n] [OFFSET n]
+ */
+export declare function buildSelect(tableName: string, conditions: WhereInput<Record<string, unknown>>, options?: SelectOptions, dialect?: SqlDialect): {
+    sql: string;
+    params: BindingValue[];
+};
+export declare function buildJoinSelect(tableName: string, columns: string[], joins: JoinClause[], where: string, params: BindingValue[], options?: SelectOptions): {
+    sql: string;
+    params: BindingValue[];
+};
+//# sourceMappingURL=sql.d.ts.map

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

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