@vibeorm/sql 2.0.0-alpha.1

package/dist/dialect.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The SqlDialect contract: every decision about SQL text, per dialect.
+ *
+ * Renderers (render.ts) contain the shared statement grammar and switch on the
+ * explicit strategy fields declared here — so each divergence between dialects
+ * is named, visible and individually testable.
+ */
+import type { Dialect, DialectCapabilities } from "@vibeorm/schema";
+import type { JsonFilterOp } from "./ast.ts";
+export type SqlDialect = {
+    readonly name: Dialect;
+    /** Frozen feature table — consumed by runtime, migrate, generator, tests. */
+    readonly capabilities: DialectCapabilities;
+    /** Array membership: `col = ANY($n)` with one array param, or `IN (?, ?, …)` expansion. */
+    readonly inArrayStrategy: "any" | "expand";
+    /** Upsert clause form. */
+    readonly upsertForm: "onConflict" | "onDuplicateKey";
+    /**
+     * Skip-conflicting-rows form. `onConflictDoNothing` appends
+     * `ON CONFLICT [(target)] DO NOTHING`; `insertIgnore` turns the statement into
+     * `INSERT IGNORE INTO` — which ignores a wider class of errors than a pure
+     * duplicate-key skip (see the catalog case).
+     */
+    readonly doNothingForm: "onConflictDoNothing" | "insertIgnore";
+    /** Case-insensitive LIKE: native ILIKE or LOWER(col) LIKE LOWER(pattern). */
+    readonly insensitiveLike: "ilike" | "lower";
+    /**
+     * Case-SENSITIVE string matching (`mode: "strict"`, board #20): `native`
+     * where the default `=`/`LIKE` are already byte-sensitive (postgres),
+     * `glob` for sqlite's byte-exact GLOB (its LIKE is ASCII-case-insensitive),
+     * `binary` for mysql's CAST-to-BINARY operand (its `_ci` collations fold
+     * `=`, `IN` and `LIKE`). The pattern forms defeat plain indexes on the
+     * non-native dialects — documented in docs/dialect-notes.md.
+     */
+    readonly strictMatchStrategy: "native" | "glob" | "binary";
+    /** ORDER BY NULLS FIRST/LAST: native clause or `col IS NULL` emulation term. */
+    readonly orderByNullsMode: "native" | "emulate";
+    /** Dialects where OFFSET requires a LIMIT clause declare the filler literal. */
+    readonly offsetRequiresLimit: {
+        readonly limitText: string;
+    } | null;
+    /** Appended verbatim after LIKE patterns (sqlite needs an explicit ESCAPE clause). */
+    readonly likeEscapeClause: string | null;
+    /**
+     * How JSON path predicates render: postgres `#>`/`#>>` operators with a
+     * bound `text[]` path, sqlite `json_extract(col, ?)`, mysql
+     * `JSON_EXTRACT`/`JSON_UNQUOTE`/`JSON_CONTAINS` — all with a bound
+     * `$.a.b[0]` path string.
+     */
+    readonly jsonPathMode: "operators" | "sqliteExtract" | "mysqlExtract";
+    /**
+     * JSON filter ops this dialect can express. The runtime gates at build time
+     * and the renderer refuses too (dialect honesty) — both read this list, so
+     * claim and behaviour cannot drift.
+     */
+    readonly supportedJsonOps: readonly JsonFilterOp[];
+    /**
+     * Cast suffix pinning a Json PARAMETER's type at write and compare sites
+     * (`$n::text::jsonb` on postgres). OID-typed drivers (bun:sql) re-serialize
+     * the JS value as the parameter's resolved type — a pre-stringified Json
+     * param in a bare jsonb slot arrives double-encoded — so the text cast makes
+     * the SERVER parse the document, identically for every driver. Empty where
+     * Json transport is already plain text (sqlite/mysql). Rendered for
+     * {@link JsonParamCell} cells and the json-filter operands.
+     */
+    readonly jsonParamCast: string;
+    /**
+     * Statement that reads back the id generated by the previous INSERT, for
+     * dialects without RETURNING. `null` where RETURNING covers it. The single
+     * result column is always named `id`.
+     */
+    readonly lastInsertIdSql: string | null;
+    /**
+     * Row-lock clause appended for `SelectStatement.lockForUpdate` (" FOR
+     * UPDATE"), or `null` where the dialect has none. Sqlite is `null` and
+     * honestly so: it has no row locks, and its single-writer transactions make
+     * the read-modify-write overlays race-free without one.
+     */
+    readonly selectForUpdate: string | null;
+    /**
+     * Whether a multi-row INSERT may write the per-row `DEFAULT` keyword in a
+     * VALUES cell (postgres/mysql). Sqlite cannot — heterogeneous createMany
+     * rows are grouped by column set into separate statements there (M4).
+     */
+    readonly rowDefaultKeyword: boolean;
+    /**
+     * Conservative bound-parameter budget per statement (M7). Hard limits:
+     * sqlite errors past SQLITE_MAX_VARIABLE_NUMBER (32766 by default), mysql
+     * caps placeholders at 65535, postgres's extended protocol at 65535. The
+     * runtime chunks unbounded parameter producers — relation WHERE…IN batches
+     * on expand dialects, createMany rows — to stay far under them.
+     */
+    readonly paramBudget: number;
+    /** Quote an identifier, escaping embedded quote characters. */
+    quoteIdent(params: {
+        name: string;
+    }): string;
+    /** Positional placeholder for the 1-based parameter index ($n or ?). */
+    placeholder(params: {
+        index: number;
+    }): string;
+};
+//# sourceMappingURL=dialect.d.ts.map

package/dist/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAG3C,2FAA2F;IAC3F,QAAQ,CAAC,eAAe,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3C,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,gBAAgB,CAAC;IACrD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,qBAAqB,GAAG,cAAc,CAAC;IAC/D,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5C;;;;;;;OAOG;IACH,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3D,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChD,gFAAgF;IAChF,QAAQ,CAAC,mBAAmB,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,sFAAsF;IACtF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,eAAe,GAAG,cAAc,CAAC;IACtE;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAG7B,+DAA+D;IAC/D,UAAU,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAC7C,wEAAwE;IACxE,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CAChD,CAAC"}

package/dist/dialects/mysql.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MySQL dialect (mysql2 adapter lands in P4).
+ *
+ * Notes pinned by catalog cases:
+ * - No RETURNING → renderer omits it and flags `returning: "omitted"`; the
+ *   runtime re-selects by PK (app-generated ids) or insertId.
+ * - Upserts use ON DUPLICATE KEY UPDATE (no conflict-target refinement).
+ * - OFFSET requires LIMIT → the documented huge-limit idiom.
+ * - No NULLS FIRST/LAST → `col IS NULL` emulation terms.
+ * - No `ON CONFLICT ... DO NOTHING` → `INSERT IGNORE`, which is broader: it
+ *   downgrades other row-level errors to warnings too.
+ */
+import type { SqlDialect } from "../dialect.ts";
+export declare const mysqlDialect: SqlDialect;
+//# sourceMappingURL=mysql.d.ts.map

package/dist/dialects/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/dialects/mysql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,YAAY,EAAE,UAyC1B,CAAC"}

package/dist/dialects/postgres.d.ts

@@ -0,0 +1,7 @@
+/**
+ * PostgreSQL dialect. Also serves PGlite — the differences are adapter-level
+ * (single connection, bundled extension set), not SQL-text-level.
+ */
+import type { SqlDialect } from "../dialect.ts";
+export declare const postgresDialect: SqlDialect;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/dialects/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/dialects/postgres.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,eAAe,EAAE,UAsC7B,CAAC"}

package/dist/dialects/registry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dialect registry: the one place a `Dialect` name becomes a `SqlDialect`.
+ *
+ * Runtime and adapters resolve through this map so nobody re-implements the
+ * lookup (and nobody can quietly forget a dialect — the Record type is total).
+ */
+import type { Dialect } from "@vibeorm/schema";
+import type { SqlDialect } from "../dialect.ts";
+export declare const SQL_DIALECTS: Readonly<Record<Dialect, SqlDialect>>;
+/** The SQL dialect a dialect name selects. */
+export declare function getSqlDialect(params: {
+    dialect: Dialect;
+}): SqlDialect;
+//# sourceMappingURL=registry.d.ts.map

package/dist/dialects/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/dialects/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAI9D,CAAC;AAEF,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAEtE"}

package/dist/dialects/sqlite.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SQLite dialect (bun:sqlite adapter lands in P4).
+ *
+ * Notes pinned by catalog cases:
+ * - OFFSET requires LIMIT → `LIMIT -1 OFFSET n`.
+ * - LIKE has no default escape character → explicit ` ESCAPE '\'` clause.
+ * - Case-insensitive matching uses LOWER()/LOWER() (default LIKE is only
+ *   ASCII-case-insensitive, and we want deterministic semantics).
+ */
+import type { SqlDialect } from "../dialect.ts";
+export declare const sqliteDialect: SqlDialect;
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/dialects/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,aAAa,EAAE,UAiD3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @vibeorm/sql — dialect-aware SQL layer for VibeORM v2.
+ *
+ * SQL AST + per-dialect renderers + capability tables. Every SQL-text decision
+ * lives in this package; see the root sql-catalog.md for the reviewable surface.
+ */
+export type { AggFn, AggRef, AggSelect, ColRef, ComparisonOp, DeleteStatement, InnerJoin, InsertStatement, JsonFilterOp, LateralJoin, ListSetOperation, OnConflictClause, OnConflictDoNothing, OnConflictUpdate, OrderByAggregate, OrderByColumn, OrderBySubquery, OrderTerm, RowNumberProjection, JsonParamCell, SelectExpr, SelectStatement, SetOperation, SetOperator, SqlExpr, SqlStatement, TableRef, UpdateStatement, } from "./ast.ts";
+export { SQL_DEFAULT_CELL, isJsonParamCell, isListSetOperation, isSetOperation, isSqlDefaultCell, jsonParamCell, } from "./ast.ts";
+export type { SqlDialect } from "./dialect.ts";
+export { postgresDialect } from "./dialects/postgres.ts";
+export { sqliteDialect } from "./dialects/sqlite.ts";
+export { mysqlDialect } from "./dialects/mysql.ts";
+export { SQL_DIALECTS, getSqlDialect } from "./dialects/registry.ts";
+export { DIALECT_CAPABILITIES, MYSQL_CAPABILITIES, POSTGRES_CAPABILITIES, SQLITE_CAPABILITIES, } from "./capabilities.ts";
+export { DIALECT_CODECS, MYSQL_CODECS, POSTGRES_CODECS, SQLITE_CODECS, decodeIsNoop, } from "./codecs.ts";
+export type { CodecTable, ScalarCodec, WireFidelity } from "./codecs.ts";
+export { renderExpr, renderFragment, renderStatement } from "./render.ts";
+export type { RenderedQuery } from "./render.ts";
+export { ParamCollector } from "./params.ts";
+export { containsPattern, endsWithPattern, escapeGlobPattern, escapeLikePattern, startsWithPattern, strictMatchPattern } from "./like.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,YAAY,EACV,KAAK,EACL,MAAM,EACN,SAAS,EACT,MAAM,EACN,YAAY,EACZ,eAAe,EACf,SAAS,EACT,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,UAAU,CAAC;AAIlB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAIrE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}