@vibeorm/adapter-bun 2.4.0 → 3.0.0

package/dist/params.d.ts

@@ -1,21 +1,24 @@
 /**
- * Parameter serialization for bun:sql.
+ * Parameter serialization for bun:sql: the values node-postgres would send.
  *
- * Verified against Bun 1.3 (re-verified on 1.3.14; `tests/live.test.ts` and
- * the notes below):
- * - a plain object or array bound to a `json`/`jsonb` column is JSON-encoded by
- *   bun:sql itself — encoding it here as well double-encodes it and stores a
- *   JSON *string* (`jsonb_typeof` = `"string"`), so the ORM path must not touch it;
+ * Live-verified on Bun 1.4.1 and 1.4.3 (`tests/node-postgres-parity.live.test.ts`):
+ * - bun:sql types a JS number itself (int32 → `int4`, anything else →
+ *   `float8`) and lets the SERVER cast from that type, so numbers, bigints and
+ *   booleans go out as text and the server reads them as the slot's own type;
  * - a plain JS array bound to a scalar-list column (`text[]`, `int[]`) is NOT
  *   turned into a PostgreSQL array literal by bun:sql — it arrives as `a,b` and
  *   the server rejects it with `malformed array literal`. Scalar lists therefore
  *   have to be pre-rendered with {@link toPgArrayLiteral}, which is exactly what
- *   the adapter's `formatArrayParam` returns.
+ *   the adapter's `formatArrayParam` returns;
+ * - with NAMED statements (`preparedStatements: true`) bun:sql learns each
+ *   slot's type first and JSON-encodes whatever is bound to a `json`/`jsonb`
+ *   slot, a string included; with unnamed statements (the default) a string is
+ *   sent as text and the server parses it, like node-postgres.
  *
- * Hence the split (LEARNINGS.md): the ORM path passes values through (scalar
- * lists already arrived as literal strings), while the raw path renders plain JS
- * arrays as array literals so `db.$queryRawUnsafe('… = ANY($1)', [1, 2, 3])`
- * matches rows.
+ * Hence the split (LEARNINGS.md): the ORM path only respells scalars (scalar
+ * lists already arrived as literal strings, Json values as JSON text bound
+ * through `::text::jsonb`), while the raw path renders plain JS arrays as array
+ * literals so `db.$queryRawUnsafe('… = ANY($1)', [1, 2, 3])` matches rows.
  */
 /**
  * Render a JS array as a PostgreSQL array literal string.
@@ -29,9 +32,10 @@
  * - any other object, **including a nested array** → quoted `JSON.stringify`,
  *   which is what a `Json[]` scalar list needs (PostgreSQL scalar lists are
  *   one-dimensional, so a nested array is a JSON value, not a matrix)
- * - binary (`Uint8Array` / `ArrayBuffer`) → unsupported, throws
+ * - `Uint8Array` (including `Buffer`) → quoted PostgreSQL bytea hex
+ * - other binary views / `ArrayBuffer` → unsupported, throws
  *
- * @throws VibeError `VIBE_VALIDATION` for binary elements.
+ * @throws VibeError `VIBE_VALIDATION` for unsupported binary elements.
  */
 export declare function toPgArrayLiteral(values: readonly unknown[]): string;
 /**
@@ -52,26 +56,36 @@ export declare function serializeDate(params: {
     value: Date;
 }): unknown;
 /**
- * ORM hot path: pass every value straight to bun:sql, except `Date`
- * ({@link serializeDate}).
+ * ORM hot path, node-postgres's rules (`@vibeorm/adapter-pg` `serializeParams`):
+ * scalars as text ({@link serializeScalar}), `Date` as UTC ISO text
+ * ({@link serializeDate}), any other object or array as `JSON.stringify` text,
+ * binary untouched.
  *
- * Scalar lists already arrived as array-literal strings from
- * `formatArrayParam`, and bun:sql JSON-encodes objects and arrays for
- * `json`/`jsonb` columns by itself — re-encoding here would store a
- * double-encoded JSON string.
+ * The runtime itself binds no objects here — scalar lists arrive as
+ * array-literal strings from `formatArrayParam`, Json values as JSON text bound
+ * through `::text::jsonb`, Bytes as `Uint8Array` — but a direct
+ * `adapter.execute` caller binding a document gets the same result as on
+ * adapter-pg. With `namedStatements` (the adapter's `preparedStatements: true`)
+ * objects stay objects: bun:sql JSON-encodes them for a `json`/`jsonb` slot
+ * itself, and would encode pre-stringified text a second time.
  */
 export declare function serializeParams(params: {
     values: readonly unknown[];
+    namedStatements?: boolean;
 }): unknown[];
 /**
- * Raw path: render plain JS arrays as PostgreSQL array literals so
- * `db.$queryRawUnsafe('… WHERE "id" = ANY($1)', [1, 2, 3])` matches rows;
- * everything else (objects included) goes to bun:sql untouched.
+ * Raw path: the node-postgres rules (`prepareValue`), so a raw statement binds
+ * the same text on both postgres adapters — plain JS arrays as PostgreSQL
+ * array literals (`db.$queryRawUnsafe('… WHERE "id" = ANY($1)', [1, 2, 3])`
+ * matches rows), any other object except binary as `JSON.stringify` text,
+ * scalars as text ({@link serializeScalar}). `namedStatements` keeps objects as
+ * objects, for the reason given at {@link serializeParams}.
  *
  * Trade-off (v1 lesson): binding a JS array **into** a `jsonb` column from a raw
  * query means calling `JSON.stringify` yourself.
  */
 export declare function serializeParamsRaw(params: {
     values: readonly unknown[];
+    namedStatements?: boolean;
 }): unknown[];
 //# sourceMappingURL=params.d.ts.map

package/dist/template-cache.d.ts

@@ -27,6 +27,8 @@ export type PreparedTemplate = {
     readonly template: TemplateStringsArray;
     /** 1-based `$n` for each gap, in TEXT order (`SELECT $2, $1` → `[2, 1]`). */
     readonly indices: readonly number[];
+    /** Every gap is $1, $2, ... exactly once, with no reordering. */
+    readonly identityOrder: boolean;
 };
 /** LRU map from SQL text to the synthetic template used to execute it. */
 export type TemplateCache = {

package/dist/transaction-sql.d.ts

@@ -8,10 +8,37 @@
 import type { IsolationLevel } from "@vibeorm/runtime";
 /** VibeORM isolation level → PostgreSQL isolation level keyword. */
 export declare const ISOLATION_LEVEL_SQL: Readonly<Record<IsolationLevel, string>>;
-/** `BEGIN`, with an `ISOLATION LEVEL` clause when the caller asked for one. */
+/**
+ * `BEGIN`, with an `ISOLATION LEVEL` clause and/or `READ ONLY` when the caller
+ * asked for them (`BEGIN ISOLATION LEVEL SERIALIZABLE, READ ONLY`).
+ */
 export declare function beginStatement(params: {
     isolationLevel?: IsolationLevel;
+    readOnly?: boolean;
 }): string;
+/**
+ * The whole opening of a reserved-path transaction as ONE simple-protocol
+ * message (round-trip EPIC 3, A-05): `BEGIN …` alone, or `BEGIN …; SET LOCAL
+ * statement_timeout = N` when a timeout is requested — one wait instead of
+ * two. Parameterless text from validated values; PostgreSQL stops at the first
+ * failing statement and the driver rejects with that error, so the caller sees
+ * BEGIN's or the SET's own error exactly as when they were two messages.
+ *
+ * @throws VibeError `VIBE_VALIDATION` for an invalid timeout (before anything
+ * is sent).
+ */
+export declare function openTransactionStatement(params: {
+    isolationLevel?: IsolationLevel;
+    readOnly?: boolean;
+    timeout?: number;
+}): string;
+/**
+ * The cancel deadline's per-statement bound (round-trip EPIC 6): a CONSTANT
+ * extended-protocol text, with the milliseconds bound as a string `$1`, so
+ * bun:sql keeps it prepared and pipelines it with the statement it bounds.
+ * `is_local = true` makes it transaction-scoped, like `SET LOCAL`.
+ */
+export declare const STATEMENT_BOUND_TEXT: string;
 /**
  * `SET LOCAL statement_timeout = <ms>` — transaction-scoped, so PostgreSQL
  * cancels an over-long statement with SQLSTATE 57014 (mapped to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeorm/adapter-bun",
-  "version": "2.4.0",
+  "version": "3.0.0",
   "description": "bun:sql (Postgres) adapter for VibeORM v2",
   "keywords": [
     "orm",
@@ -35,15 +35,17 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "!dist/**/*.d.ts.map",
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
-    "bun": ">=1.2.0"
+    "bun": ">=1.4.1"
   },
   "dependencies": {
-    "@vibeorm/runtime": "2.5.0",
-    "@vibeorm/schema": "2.5.0",
-    "@vibeorm/sql": "2.5.0"
+    "@vibeorm/runtime": "3.0.0",
+    "@vibeorm/schema": "3.0.0",
+    "@vibeorm/sql": "3.0.0"
   },
   "publishConfig": {
     "access": "public"

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAKlF,CAAC"}

package/dist/connection-url.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connection-url.d.ts","sourceRoot":"","sources":["../src/connection-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,GAAG,SAAS,CAerB;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAS3F"}

package/dist/driver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,GAAG,CAE5F"}

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAyC3E,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhE,CAAC;AAYH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAS/E;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CA8BvE;AAED,wEAAwE;AACxE,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnE"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAEV,eAAe,EAMhB,MAAM,kBAAkB,CAAC;AAsB1B,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyEnG,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oGAAoG;IACpG,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC,CAAC;AA8CF;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAwiBvE;AAgCD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/params.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAmBnE;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG,OAAO,CAM9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,OAAO,EAAE,CAEjF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,OAAO,EAAE,CAMpF"}

package/dist/template-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template-cache.d.ts","sourceRoot":"","sources":["../src/template-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAC1B,4EAA4E;IAC5E,WAAW,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB,CAAC;IACxD,8DAA8D;IAC9D,IAAI,IAAI,MAAM,CAAC;CAChB,CAAC;AA0EF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CA4C3E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAEjE;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CAC5B,GAAG,OAAO,EAAE,CAYZ;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA2B1E"}

package/dist/transaction-sql.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction-sql.d.ts","sourceRoot":"","sources":["../src/transaction-sql.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAIvE,CAAC;AAEH,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,cAAc,CAAC,EAAE,cAAc,CAAA;CAAE,GAAG,MAAM,CAKlF;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAU7E;AAID,+EAA+E;AAC/E,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAK5D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,qBAAqB,CAI7F;AAMD,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC"}