@fragno-dev/db 0.1.14 → 0.2.0

package/dist/query/column-defaults.js

@@ -0,0 +1,27 @@
+import { createId } from "../id.js";
+
+//#region src/query/column-defaults.ts
+/**
+* Generate a runtime default value for a column that has defaultTo$()
+*
+* Only generates values for runtime defaults (defaultTo$), NOT static defaults (defaultTo).
+* Static defaults should be handled by the database via DEFAULT constraints.
+*
+* @param column - The column with a default value configuration
+* @returns The generated default value, or undefined if the column has no runtime default
+*
+* @internal
+*/
+function generateRuntimeDefault(column) {
+	if (!column.default) return;
+	if ("value" in column.default) return;
+	if ("dbSpecial" in column.default) return;
+	const runtime = column.default.runtime;
+	if (runtime === "cuid") return createId();
+	if (runtime === "now") return /* @__PURE__ */ new Date();
+	if (typeof runtime === "function") return runtime();
+}
+
+//#endregion
+export { generateRuntimeDefault };
+//# sourceMappingURL=column-defaults.js.map

package/dist/query/column-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-defaults.js","names":[],"sources":["../../src/query/column-defaults.ts"],"sourcesContent":["import type { AnyColumn } from \"../schema/create\";\nimport { createId } from \"../id\";\n\n/**\n * Generate a runtime default value for a column that has defaultTo$()\n *\n * Only generates values for runtime defaults (defaultTo$), NOT static defaults (defaultTo).\n * Static defaults should be handled by the database via DEFAULT constraints.\n *\n * @param column - The column with a default value configuration\n * @returns The generated default value, or undefined if the column has no runtime default\n *\n * @internal\n */\nexport function generateRuntimeDefault(column: AnyColumn): unknown {\n  // Check if column has a default value configuration\n  if (!column.default) {\n    return undefined;\n  }\n\n  // If it's a static default value (defaultTo), return undefined\n  // as the database should handle this via DEFAULT constraint\n  if (\"value\" in column.default) {\n    return undefined;\n  }\n\n  // If it's a database-level special function (defaultTo(b => b.now())), return undefined\n  // as the database should handle this via DEFAULT NOW() or equivalent\n  if (\"dbSpecial\" in column.default) {\n    return undefined;\n  }\n\n  // Handle runtime defaults (defaultTo$)\n  const runtime = column.default.runtime;\n\n  if (runtime === \"cuid\") {\n    return createId();\n  }\n\n  if (runtime === \"now\") {\n    return new Date();\n  }\n\n  if (typeof runtime === \"function\") {\n    return runtime();\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,uBAAuB,QAA4B;AAEjE,KAAI,CAAC,OAAO,QACV;AAKF,KAAI,WAAW,OAAO,QACpB;AAKF,KAAI,eAAe,OAAO,QACxB;CAIF,MAAM,UAAU,OAAO,QAAQ;AAE/B,KAAI,YAAY,OACd,QAAO,UAAU;AAGnB,KAAI,YAAY,MACd,wBAAO,IAAI,MAAM;AAGnB,KAAI,OAAO,YAAY,WACrB,QAAO,SAAS"}

package/dist/query/cursor.d.ts

@@ -1,5 +1,5 @@
 import { AnyColumn } from "../schema/create.js";
-import { SQLProvider } from "../shared/providers.js";
+import { DriverConfig } from "../adapters/generic-sql/driver-config.js";
 
 //#region src/query/cursor.d.ts
 
@@ -47,6 +47,10 @@ interface CursorResult<T> {
    * Cursor to fetch the next page (undefined if no more results)
    */
   cursor?: Cursor;
+  /**
+   * Whether there are more results available after this page
+   */
+  hasNextPage: boolean;
 }
 /**
  * Cursor data structure for serialization
@@ -100,12 +104,16 @@ declare function createCursorFromRecord(record: Record<string, unknown>, indexCo
 /**
  * Serialize cursor values for database queries
  *
- * Converts cursor values (which are in application format) to database format
- * using the column serialization rules.
+ * Converts cursor values (which are in JSON-compatible format after decode)
+ * to database format using the column serialization rules.
+ *
+ * This function performs a two-step process:
+ * 1. Deserialize from JSON format to application format (e.g., ISO string → Date)
+ * 2. Serialize from application format to database format (e.g., Date → driver format)
  *
  * @param cursor - The cursor object
  * @param indexColumns - The columns that make up the index
- * @param provider - The SQL provider
+ * @param driverConfig - The driver configuration
  * @returns Serialized values ready for database queries
  *
  * @example
@@ -113,11 +121,11 @@ declare function createCursorFromRecord(record: Record<string, unknown>, indexCo
  * const serialized = serializeCursorValues(
  *   cursor,
  *   [table.columns.createdAt],
- *   "postgresql"
+ *   driverConfig
  * );
  * ```
  */
-declare function serializeCursorValues(cursor: Cursor, indexColumns: AnyColumn[], provider: SQLProvider): Record<string, unknown>;
+declare function serializeCursorValues(cursor: Cursor, indexColumns: AnyColumn[], driverConfig: DriverConfig): Record<string, unknown>;
 //#endregion
 export { Cursor, CursorData, CursorResult, createCursorFromRecord, decodeCursor, serializeCursorValues };
 //# sourceMappingURL=cursor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cursor.d.ts","names":[],"sources":["../../src/query/cursor.ts"],"sourcesContent":[],"mappings":";;;;;;;AAOA;AAgEiB,cAhEJ,MAAA,CAgEgB;EAcZ,CAAA,OAAA;EAgCD,WAAA,CAAA,IAAY,EAAA;IA8DZ,SAAA,EAAA,MAAA;IACN,cAAA,EAAA,KAAA,GAAA,MAAA;IACM,QAAA,EAAA,MAAA;IAMb,WAAA,EA1Kc,MA0Kd,CAAA,MAAA,EAAA,OAAA,CAAA;EAAM,CAAA;EAmCO;;;EAGJ,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EACT;;;;;;;;;;;qBAjLkB;;;;;;;;;UAsBJ;;;;SAIR;;;;WAIE;;;;;UAMM,UAAA;;;;;eAKF;;;;;;;;;;;;;;iBA2BC,YAAA,kBAA8B;;;;;;;;;;;;;;;;;;;;;;iBA8D9B,sBAAA,SACN,uCACM;;;;IAMb;;;;;;;;;;;;;;;;;;;;;iBAmCa,qBAAA,SACN,sBACM,uBACJ,cACT"}
+{"version":3,"file":"cursor.d.ts","names":[],"sources":["../../src/query/cursor.ts"],"sourcesContent":[],"mappings":";;;;;;;AAQA;AAgEiB,cAhEJ,MAAA,CAgEgB;EAkBZ,CAAA,OAAA;EAgCD,WAAA,CAAA,IAAY,EAAA;IA8DZ,SAAA,EAAA,MAAA;IACN,cAAA,EAAA,KAAA,GAAA,MAAA;IACM,QAAA,EAAA,MAAA;IAMb,WAAA,EA9Kc,MA8Kd,CAAA,MAAA,EAAA,OAAA,CAAA;EAAM,CAAA;EAuCO;;;EAGA,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EACb;;;;;;;;;;;qBAzLkB;;;;;;;;;UAsBJ;;;;SAIR;;;;WAIE;;;;;;;;;UAUM,UAAA;;;;;eAKF;;;;;;;;;;;;;;iBA2BC,YAAA,kBAA8B;;;;;;;;;;;;;;;;;;;;;;iBA8D9B,sBAAA,SACN,uCACM;;;;IAMb;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCa,qBAAA,SACN,sBACM,2BACA,eACb"}

package/dist/query/cursor.js

@@ -1,4 +1,5 @@
-import { serialize } from "../schema/serialize.js";
+import { createSQLSerializer } from "./serialize/create-sql-serializer.js";
+import { resolveFragnoIdValue } from "./value-encoding.js";
 
 //#region src/query/cursor.ts
 /**
@@ -125,12 +126,16 @@ function createCursorFromRecord(record, indexColumns, metadata) {
 /**
 * Serialize cursor values for database queries
 *
-* Converts cursor values (which are in application format) to database format
-* using the column serialization rules.
+* Converts cursor values (which are in JSON-compatible format after decode)
+* to database format using the column serialization rules.
+*
+* This function performs a two-step process:
+* 1. Deserialize from JSON format to application format (e.g., ISO string → Date)
+* 2. Serialize from application format to database format (e.g., Date → driver format)
 *
 * @param cursor - The cursor object
 * @param indexColumns - The columns that make up the index
-* @param provider - The SQL provider
+* @param driverConfig - The driver configuration
 * @returns Serialized values ready for database queries
 *
 * @example
@@ -138,15 +143,19 @@ function createCursorFromRecord(record, indexColumns, metadata) {
 * const serialized = serializeCursorValues(
 *   cursor,
 *   [table.columns.createdAt],
-*   "postgresql"
+*   driverConfig
 * );
 * ```
 */
-function serializeCursorValues(cursor, indexColumns, provider) {
+function serializeCursorValues(cursor, indexColumns, driverConfig) {
+	const serializer = createSQLSerializer(driverConfig);
 	const serialized = {};
 	for (const col of indexColumns) {
 		const value = cursor.indexValues[col.ormName];
-		if (value !== void 0) serialized[col.ormName] = serialize(value, col, provider);
+		if (value !== void 0) {
+			const resolved = resolveFragnoIdValue(serializer.deserialize(value, col), col);
+			serialized[col.ormName] = serializer.serialize(resolved, col);
+		}
 	}
 	return serialized;
 }

package/dist/query/cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.js","names":["#indexName","#orderDirection","#pageSize","#indexValues","json: string","indexValues: Record<string, unknown>","serialized: Record<string, unknown>"],"sources":["../../src/query/cursor.ts"],"sourcesContent":["import type { AnyColumn } from \"../schema/create\";\nimport { serialize } from \"../schema/serialize\";\nimport type { SQLProvider } from \"../shared/providers\";\n\n/**\n * Cursor object containing all information needed for pagination\n */\nexport class Cursor {\n  readonly #indexName: string;\n  readonly #orderDirection: \"asc\" | \"desc\";\n  readonly #pageSize: number;\n  readonly #indexValues: Record<string, unknown>;\n\n  constructor(data: {\n    indexName: string;\n    orderDirection: \"asc\" | \"desc\";\n    pageSize: number;\n    indexValues: Record<string, unknown>;\n  }) {\n    this.#indexName = data.indexName;\n    this.#orderDirection = data.orderDirection;\n    this.#pageSize = data.pageSize;\n    this.#indexValues = data.indexValues;\n  }\n\n  /**\n   * Get the index name being used for pagination\n   */\n  get indexName(): string {\n    return this.#indexName;\n  }\n\n  /**\n   * Get the ordering direction\n   */\n  get orderDirection(): \"asc\" | \"desc\" {\n    return this.#orderDirection;\n  }\n\n  /**\n   * Get the page size\n   */\n  get pageSize(): number {\n    return this.#pageSize;\n  }\n\n  /**\n   * Get the cursor position values\n   */\n  get indexValues(): Record<string, unknown> {\n    return this.#indexValues;\n  }\n\n  /**\n   * Encode cursor to an opaque base64 string (safe to send to client)\n   */\n  encode(): string {\n    const data: CursorData = {\n      v: 1,\n      indexName: this.#indexName,\n      orderDirection: this.#orderDirection,\n      pageSize: this.#pageSize,\n      indexValues: this.#indexValues,\n    };\n    return encodeCursorData(data);\n  }\n}\n\n/**\n * Result of a cursor-based query containing items and pagination cursor\n */\nexport interface CursorResult<T> {\n  /**\n   * The query results\n   */\n  items: T[];\n  /**\n   * Cursor to fetch the next page (undefined if no more results)\n   */\n  cursor?: Cursor;\n}\n\n/**\n * Cursor data structure for serialization\n */\nexport interface CursorData {\n  v: number; // version\n  indexName: string;\n  orderDirection: \"asc\" | \"desc\";\n  pageSize: number;\n  indexValues: Record<string, unknown>;\n}\n\n/**\n * Encode cursor data to a base64 string (internal)\n */\nfunction encodeCursorData(data: CursorData): string {\n  const json = JSON.stringify(data);\n  // Use Buffer in Node.js or btoa in browsers\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.from(json, \"utf-8\").toString(\"base64\");\n  }\n  return btoa(json);\n}\n\n/**\n * Decode a base64 cursor string back to a Cursor object\n *\n * @param cursor - The base64-encoded cursor string\n * @returns Decoded Cursor object\n * @throws Error if cursor is invalid or malformed\n *\n * @example\n * ```ts\n * const cursor = decodeCursor(\"eyJpbmRleFZhbHVlcyI6e30sImRpcmVjdGlvbiI6ImZvcndhcmQifQ==\");\n * ```\n */\nexport function decodeCursor(cursor: string): Cursor {\n  try {\n    let json: string;\n    if (typeof Buffer !== \"undefined\") {\n      json = Buffer.from(cursor, \"base64\").toString(\"utf-8\");\n    } else {\n      json = atob(cursor);\n    }\n    const data = JSON.parse(json);\n\n    // Validate structure\n    if (\n      !data ||\n      typeof data !== \"object\" ||\n      !data.indexValues ||\n      typeof data.indexValues !== \"object\" ||\n      typeof data.pageSize !== \"number\" ||\n      !data.indexName ||\n      !data.orderDirection ||\n      (data.orderDirection !== \"asc\" && data.orderDirection !== \"desc\")\n    ) {\n      throw new Error(\"Invalid cursor structure\");\n    }\n\n    // Only support v1\n    const version = typeof data.v === \"number\" ? data.v : 0;\n    if (version !== 1) {\n      throw new Error(`Unsupported cursor version: ${version}. Only v1 is supported.`);\n    }\n\n    return new Cursor({\n      indexName: data.indexName,\n      orderDirection: data.orderDirection,\n      pageSize: data.pageSize,\n      indexValues: data.indexValues,\n    });\n  } catch (error) {\n    throw new Error(`Invalid cursor: ${error instanceof Error ? error.message : \"malformed data\"}`);\n  }\n}\n\n/**\n * Create a cursor from a record and pagination metadata\n *\n * @param record - The database record\n * @param indexColumns - The columns that make up the index\n * @param metadata - Pagination metadata (index name, order direction, page size)\n * @returns Cursor object\n *\n * @example\n * ```ts\n * const cursor = createCursorFromRecord(\n *   { id: \"abc\", name: \"Alice\", createdAt: 123 },\n *   [table.columns.createdAt, table.columns.id],\n *   {\n *     indexName: \"idx_created\",\n *     orderDirection: \"asc\",\n *     pageSize: 10\n *   }\n * );\n * ```\n */\nexport function createCursorFromRecord(\n  record: Record<string, unknown>,\n  indexColumns: AnyColumn[],\n  metadata: {\n    indexName: string;\n    orderDirection: \"asc\" | \"desc\";\n    pageSize: number;\n  },\n): Cursor {\n  const indexValues: Record<string, unknown> = {};\n\n  for (const col of indexColumns) {\n    indexValues[col.ormName] = record[col.ormName];\n  }\n\n  return new Cursor({\n    indexName: metadata.indexName,\n    orderDirection: metadata.orderDirection,\n    pageSize: metadata.pageSize,\n    indexValues,\n  });\n}\n\n/**\n * Serialize cursor values for database queries\n *\n * Converts cursor values (which are in application format) to database format\n * using the column serialization rules.\n *\n * @param cursor - The cursor object\n * @param indexColumns - The columns that make up the index\n * @param provider - The SQL provider\n * @returns Serialized values ready for database queries\n *\n * @example\n * ```ts\n * const serialized = serializeCursorValues(\n *   cursor,\n *   [table.columns.createdAt],\n *   \"postgresql\"\n * );\n * ```\n */\nexport function serializeCursorValues(\n  cursor: Cursor,\n  indexColumns: AnyColumn[],\n  provider: SQLProvider,\n): Record<string, unknown> {\n  const serialized: Record<string, unknown> = {};\n\n  for (const col of indexColumns) {\n    const value = cursor.indexValues[col.ormName];\n    if (value !== undefined) {\n      serialized[col.ormName] = serialize(value, col, provider);\n    }\n  }\n\n  return serialized;\n}\n"],"mappings":";;;;;;AAOA,IAAa,SAAb,MAAoB;CAClB,CAASA;CACT,CAASC;CACT,CAASC;CACT,CAASC;CAET,YAAY,MAKT;AACD,QAAKH,YAAa,KAAK;AACvB,QAAKC,iBAAkB,KAAK;AAC5B,QAAKC,WAAY,KAAK;AACtB,QAAKC,cAAe,KAAK;;;;;CAM3B,IAAI,YAAoB;AACtB,SAAO,MAAKH;;;;;CAMd,IAAI,iBAAiC;AACnC,SAAO,MAAKC;;;;;CAMd,IAAI,WAAmB;AACrB,SAAO,MAAKC;;;;;CAMd,IAAI,cAAuC;AACzC,SAAO,MAAKC;;;;;CAMd,SAAiB;AAQf,SAAO,iBAPkB;GACvB,GAAG;GACH,WAAW,MAAKH;GAChB,gBAAgB,MAAKC;GACrB,UAAU,MAAKC;GACf,aAAa,MAAKC;GACnB,CAC4B;;;;;;AAgCjC,SAAS,iBAAiB,MAA0B;CAClD,MAAM,OAAO,KAAK,UAAU,KAAK;AAEjC,KAAI,OAAO,WAAW,YACpB,QAAO,OAAO,KAAK,MAAM,QAAQ,CAAC,SAAS,SAAS;AAEtD,QAAO,KAAK,KAAK;;;;;;;;;;;;;;AAenB,SAAgB,aAAa,QAAwB;AACnD,KAAI;EACF,IAAIC;AACJ,MAAI,OAAO,WAAW,YACpB,QAAO,OAAO,KAAK,QAAQ,SAAS,CAAC,SAAS,QAAQ;MAEtD,QAAO,KAAK,OAAO;EAErB,MAAM,OAAO,KAAK,MAAM,KAAK;AAG7B,MACE,CAAC,QACD,OAAO,SAAS,YAChB,CAAC,KAAK,eACN,OAAO,KAAK,gBAAgB,YAC5B,OAAO,KAAK,aAAa,YACzB,CAAC,KAAK,aACN,CAAC,KAAK,kBACL,KAAK,mBAAmB,SAAS,KAAK,mBAAmB,OAE1D,OAAM,IAAI,MAAM,2BAA2B;EAI7C,MAAM,UAAU,OAAO,KAAK,MAAM,WAAW,KAAK,IAAI;AACtD,MAAI,YAAY,EACd,OAAM,IAAI,MAAM,+BAA+B,QAAQ,yBAAyB;AAGlF,SAAO,IAAI,OAAO;GAChB,WAAW,KAAK;GAChB,gBAAgB,KAAK;GACrB,UAAU,KAAK;GACf,aAAa,KAAK;GACnB,CAAC;UACK,OAAO;AACd,QAAM,IAAI,MAAM,mBAAmB,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;AAyBnG,SAAgB,uBACd,QACA,cACA,UAKQ;CACR,MAAMC,cAAuC,EAAE;AAE/C,MAAK,MAAM,OAAO,aAChB,aAAY,IAAI,WAAW,OAAO,IAAI;AAGxC,QAAO,IAAI,OAAO;EAChB,WAAW,SAAS;EACpB,gBAAgB,SAAS;EACzB,UAAU,SAAS;EACnB;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;;AAuBJ,SAAgB,sBACd,QACA,cACA,UACyB;CACzB,MAAMC,aAAsC,EAAE;AAE9C,MAAK,MAAM,OAAO,cAAc;EAC9B,MAAM,QAAQ,OAAO,YAAY,IAAI;AACrC,MAAI,UAAU,OACZ,YAAW,IAAI,WAAW,UAAU,OAAO,KAAK,SAAS;;AAI7D,QAAO"}
+{"version":3,"file":"cursor.js","names":["#indexName","#orderDirection","#pageSize","#indexValues","json: string","indexValues: Record<string, unknown>","serialized: Record<string, unknown>"],"sources":["../../src/query/cursor.ts"],"sourcesContent":["import type { AnyColumn } from \"../schema/create\";\nimport { createSQLSerializer } from \"./serialize/create-sql-serializer\";\nimport { resolveFragnoIdValue } from \"./value-encoding\";\nimport type { DriverConfig } from \"../adapters/generic-sql/driver-config\";\n\n/**\n * Cursor object containing all information needed for pagination\n */\nexport class Cursor {\n  readonly #indexName: string;\n  readonly #orderDirection: \"asc\" | \"desc\";\n  readonly #pageSize: number;\n  readonly #indexValues: Record<string, unknown>;\n\n  constructor(data: {\n    indexName: string;\n    orderDirection: \"asc\" | \"desc\";\n    pageSize: number;\n    indexValues: Record<string, unknown>;\n  }) {\n    this.#indexName = data.indexName;\n    this.#orderDirection = data.orderDirection;\n    this.#pageSize = data.pageSize;\n    this.#indexValues = data.indexValues;\n  }\n\n  /**\n   * Get the index name being used for pagination\n   */\n  get indexName(): string {\n    return this.#indexName;\n  }\n\n  /**\n   * Get the ordering direction\n   */\n  get orderDirection(): \"asc\" | \"desc\" {\n    return this.#orderDirection;\n  }\n\n  /**\n   * Get the page size\n   */\n  get pageSize(): number {\n    return this.#pageSize;\n  }\n\n  /**\n   * Get the cursor position values\n   */\n  get indexValues(): Record<string, unknown> {\n    return this.#indexValues;\n  }\n\n  /**\n   * Encode cursor to an opaque base64 string (safe to send to client)\n   */\n  encode(): string {\n    const data: CursorData = {\n      v: 1,\n      indexName: this.#indexName,\n      orderDirection: this.#orderDirection,\n      pageSize: this.#pageSize,\n      indexValues: this.#indexValues,\n    };\n    return encodeCursorData(data);\n  }\n}\n\n/**\n * Result of a cursor-based query containing items and pagination cursor\n */\nexport interface CursorResult<T> {\n  /**\n   * The query results\n   */\n  items: T[];\n  /**\n   * Cursor to fetch the next page (undefined if no more results)\n   */\n  cursor?: Cursor;\n  /**\n   * Whether there are more results available after this page\n   */\n  hasNextPage: boolean;\n}\n\n/**\n * Cursor data structure for serialization\n */\nexport interface CursorData {\n  v: number; // version\n  indexName: string;\n  orderDirection: \"asc\" | \"desc\";\n  pageSize: number;\n  indexValues: Record<string, unknown>;\n}\n\n/**\n * Encode cursor data to a base64 string (internal)\n */\nfunction encodeCursorData(data: CursorData): string {\n  const json = JSON.stringify(data);\n  // Use Buffer in Node.js or btoa in browsers\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.from(json, \"utf-8\").toString(\"base64\");\n  }\n  return btoa(json);\n}\n\n/**\n * Decode a base64 cursor string back to a Cursor object\n *\n * @param cursor - The base64-encoded cursor string\n * @returns Decoded Cursor object\n * @throws Error if cursor is invalid or malformed\n *\n * @example\n * ```ts\n * const cursor = decodeCursor(\"eyJpbmRleFZhbHVlcyI6e30sImRpcmVjdGlvbiI6ImZvcndhcmQifQ==\");\n * ```\n */\nexport function decodeCursor(cursor: string): Cursor {\n  try {\n    let json: string;\n    if (typeof Buffer !== \"undefined\") {\n      json = Buffer.from(cursor, \"base64\").toString(\"utf-8\");\n    } else {\n      json = atob(cursor);\n    }\n    const data = JSON.parse(json);\n\n    // Validate structure\n    if (\n      !data ||\n      typeof data !== \"object\" ||\n      !data.indexValues ||\n      typeof data.indexValues !== \"object\" ||\n      typeof data.pageSize !== \"number\" ||\n      !data.indexName ||\n      !data.orderDirection ||\n      (data.orderDirection !== \"asc\" && data.orderDirection !== \"desc\")\n    ) {\n      throw new Error(\"Invalid cursor structure\");\n    }\n\n    // Only support v1\n    const version = typeof data.v === \"number\" ? data.v : 0;\n    if (version !== 1) {\n      throw new Error(`Unsupported cursor version: ${version}. Only v1 is supported.`);\n    }\n\n    return new Cursor({\n      indexName: data.indexName,\n      orderDirection: data.orderDirection,\n      pageSize: data.pageSize,\n      indexValues: data.indexValues,\n    });\n  } catch (error) {\n    throw new Error(`Invalid cursor: ${error instanceof Error ? error.message : \"malformed data\"}`);\n  }\n}\n\n/**\n * Create a cursor from a record and pagination metadata\n *\n * @param record - The database record\n * @param indexColumns - The columns that make up the index\n * @param metadata - Pagination metadata (index name, order direction, page size)\n * @returns Cursor object\n *\n * @example\n * ```ts\n * const cursor = createCursorFromRecord(\n *   { id: \"abc\", name: \"Alice\", createdAt: 123 },\n *   [table.columns.createdAt, table.columns.id],\n *   {\n *     indexName: \"idx_created\",\n *     orderDirection: \"asc\",\n *     pageSize: 10\n *   }\n * );\n * ```\n */\nexport function createCursorFromRecord(\n  record: Record<string, unknown>,\n  indexColumns: AnyColumn[],\n  metadata: {\n    indexName: string;\n    orderDirection: \"asc\" | \"desc\";\n    pageSize: number;\n  },\n): Cursor {\n  const indexValues: Record<string, unknown> = {};\n\n  for (const col of indexColumns) {\n    indexValues[col.ormName] = record[col.ormName];\n  }\n\n  return new Cursor({\n    indexName: metadata.indexName,\n    orderDirection: metadata.orderDirection,\n    pageSize: metadata.pageSize,\n    indexValues,\n  });\n}\n\n/**\n * Serialize cursor values for database queries\n *\n * Converts cursor values (which are in JSON-compatible format after decode)\n * to database format using the column serialization rules.\n *\n * This function performs a two-step process:\n * 1. Deserialize from JSON format to application format (e.g., ISO string → Date)\n * 2. Serialize from application format to database format (e.g., Date → driver format)\n *\n * @param cursor - The cursor object\n * @param indexColumns - The columns that make up the index\n * @param driverConfig - The driver configuration\n * @returns Serialized values ready for database queries\n *\n * @example\n * ```ts\n * const serialized = serializeCursorValues(\n *   cursor,\n *   [table.columns.createdAt],\n *   driverConfig\n * );\n * ```\n */\nexport function serializeCursorValues(\n  cursor: Cursor,\n  indexColumns: AnyColumn[],\n  driverConfig: DriverConfig,\n): Record<string, unknown> {\n  const serializer = createSQLSerializer(driverConfig);\n  const serialized: Record<string, unknown> = {};\n\n  for (const col of indexColumns) {\n    const value = cursor.indexValues[col.ormName];\n    if (value !== undefined) {\n      // First deserialize from JSON format to application format\n      // (e.g., \"2025-11-07T09:36:57.959Z\" string → Date object)\n      const deserialized = serializer.deserialize(value, col);\n      // Resolve FragnoId/FragnoReference to primitive values (if present)\n      const resolved = resolveFragnoIdValue(deserialized, col);\n      // Then serialize to database format\n      // (e.g., Date → database driver format)\n      serialized[col.ormName] = serializer.serialize(resolved, col);\n    }\n  }\n\n  return serialized;\n}\n"],"mappings":";;;;;;;AAQA,IAAa,SAAb,MAAoB;CAClB,CAASA;CACT,CAASC;CACT,CAASC;CACT,CAASC;CAET,YAAY,MAKT;AACD,QAAKH,YAAa,KAAK;AACvB,QAAKC,iBAAkB,KAAK;AAC5B,QAAKC,WAAY,KAAK;AACtB,QAAKC,cAAe,KAAK;;;;;CAM3B,IAAI,YAAoB;AACtB,SAAO,MAAKH;;;;;CAMd,IAAI,iBAAiC;AACnC,SAAO,MAAKC;;;;;CAMd,IAAI,WAAmB;AACrB,SAAO,MAAKC;;;;;CAMd,IAAI,cAAuC;AACzC,SAAO,MAAKC;;;;;CAMd,SAAiB;AAQf,SAAO,iBAPkB;GACvB,GAAG;GACH,WAAW,MAAKH;GAChB,gBAAgB,MAAKC;GACrB,UAAU,MAAKC;GACf,aAAa,MAAKC;GACnB,CAC4B;;;;;;AAoCjC,SAAS,iBAAiB,MAA0B;CAClD,MAAM,OAAO,KAAK,UAAU,KAAK;AAEjC,KAAI,OAAO,WAAW,YACpB,QAAO,OAAO,KAAK,MAAM,QAAQ,CAAC,SAAS,SAAS;AAEtD,QAAO,KAAK,KAAK;;;;;;;;;;;;;;AAenB,SAAgB,aAAa,QAAwB;AACnD,KAAI;EACF,IAAIC;AACJ,MAAI,OAAO,WAAW,YACpB,QAAO,OAAO,KAAK,QAAQ,SAAS,CAAC,SAAS,QAAQ;MAEtD,QAAO,KAAK,OAAO;EAErB,MAAM,OAAO,KAAK,MAAM,KAAK;AAG7B,MACE,CAAC,QACD,OAAO,SAAS,YAChB,CAAC,KAAK,eACN,OAAO,KAAK,gBAAgB,YAC5B,OAAO,KAAK,aAAa,YACzB,CAAC,KAAK,aACN,CAAC,KAAK,kBACL,KAAK,mBAAmB,SAAS,KAAK,mBAAmB,OAE1D,OAAM,IAAI,MAAM,2BAA2B;EAI7C,MAAM,UAAU,OAAO,KAAK,MAAM,WAAW,KAAK,IAAI;AACtD,MAAI,YAAY,EACd,OAAM,IAAI,MAAM,+BAA+B,QAAQ,yBAAyB;AAGlF,SAAO,IAAI,OAAO;GAChB,WAAW,KAAK;GAChB,gBAAgB,KAAK;GACrB,UAAU,KAAK;GACf,aAAa,KAAK;GACnB,CAAC;UACK,OAAO;AACd,QAAM,IAAI,MAAM,mBAAmB,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;AAyBnG,SAAgB,uBACd,QACA,cACA,UAKQ;CACR,MAAMC,cAAuC,EAAE;AAE/C,MAAK,MAAM,OAAO,aAChB,aAAY,IAAI,WAAW,OAAO,IAAI;AAGxC,QAAO,IAAI,OAAO;EAChB,WAAW,SAAS;EACpB,gBAAgB,SAAS;EACzB,UAAU,SAAS;EACnB;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BJ,SAAgB,sBACd,QACA,cACA,cACyB;CACzB,MAAM,aAAa,oBAAoB,aAAa;CACpD,MAAMC,aAAsC,EAAE;AAE9C,MAAK,MAAM,OAAO,cAAc;EAC9B,MAAM,QAAQ,OAAO,YAAY,IAAI;AACrC,MAAI,UAAU,QAAW;GAKvB,MAAM,WAAW,qBAFI,WAAW,YAAY,OAAO,IAAI,EAEH,IAAI;AAGxD,cAAW,IAAI,WAAW,WAAW,UAAU,UAAU,IAAI;;;AAIjE,QAAO"}

package/dist/query/orm/orm.d.ts

@@ -1,6 +1,6 @@
 import { AnyColumn, AnyRelation } from "../../schema/create.js";
 import { Condition } from "../condition-builder.js";
-import { AnySelectClause, FindManyOptions, OrderBy } from "../query.js";
+import { AnySelectClause, FindManyOptions, OrderBy } from "../simple-query-interface.js";
 
 //#region src/query/orm/orm.d.ts
 interface CompiledJoin {

package/dist/query/orm/orm.js.map

@@ -1 +1 @@
-{"version":3,"file":"orm.js","names":["compiled: CompiledJoin[]","builder: Record<string, unknown>"],"sources":["../../../src/query/orm/orm.ts"],"sourcesContent":["import type {\n  AnySelectClause,\n  FindFirstOptions,\n  FindManyOptions,\n  JoinBuilder,\n  OrderBy,\n} from \"../query\";\nimport { buildCondition, type Condition } from \"../condition-builder\";\nimport type { AnyColumn, AnyRelation, AnyTable } from \"../../schema/create\";\n\nexport interface CompiledJoin {\n  relation: AnyRelation;\n  options: SimplifyFindOptions<FindManyOptions> | false;\n}\n\nfunction isOrderByArray(v: OrderBy | OrderBy[]): v is OrderBy[] {\n  return Array.isArray(v) && Array.isArray(v[0]);\n}\n\nfunction simplifyOrderBy(\n  columns: Record<string, AnyColumn>,\n  orderBy: OrderBy | OrderBy[] | undefined,\n): OrderBy<AnyColumn>[] | undefined {\n  if (!orderBy || orderBy.length === 0) {\n    return;\n  }\n\n  if (!isOrderByArray(orderBy)) {\n    orderBy = [orderBy];\n  }\n  return orderBy.map(([name, value]) => {\n    const col = columns[name];\n    if (!col) {\n      throw new Error(`unknown column name ${name}.`);\n    }\n\n    return [col, value];\n  });\n}\n\nexport function buildFindOptions(\n  table: AnyTable,\n  { select = true, where, orderBy, join, ...options }: FindManyOptions,\n): SimplifyFindOptions<FindManyOptions> | false {\n  let conditions = where ? buildCondition(table.columns, where) : undefined;\n  if (conditions === true) {\n    conditions = undefined;\n  }\n  if (conditions === false) {\n    return false;\n  }\n\n  return {\n    select,\n    where: conditions,\n    orderBy: simplifyOrderBy(table.columns, orderBy),\n    join: join ? buildJoin(table, join) : undefined,\n    ...options,\n  };\n}\n\nfunction buildJoin<TTable extends AnyTable>(\n  table: AnyTable,\n  fn: (builder: JoinBuilder<TTable>) => void,\n): CompiledJoin[] {\n  const compiled: CompiledJoin[] = [];\n  const builder: Record<string, unknown> = {};\n\n  for (const name in table.relations) {\n    const relation = table.relations[name]!;\n\n    builder[name] = (options: FindFirstOptions | FindManyOptions = {}) => {\n      compiled.push({\n        relation,\n        options: buildFindOptions(relation.table, options),\n      });\n\n      delete builder[name];\n      return builder;\n    };\n  }\n\n  fn(builder as JoinBuilder<TTable>);\n  return compiled;\n}\n\nexport type SimplifyFindOptions<O> = Omit<O, \"where\" | \"orderBy\" | \"select\" | \"join\"> & {\n  select: AnySelectClause;\n  where?: Condition | undefined;\n  orderBy?: OrderBy<AnyColumn>[];\n  join?: CompiledJoin[];\n};\n"],"mappings":";;;AAeA,SAAS,eAAe,GAAwC;AAC9D,QAAO,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,GAAG;;AAGhD,SAAS,gBACP,SACA,SACkC;AAClC,KAAI,CAAC,WAAW,QAAQ,WAAW,EACjC;AAGF,KAAI,CAAC,eAAe,QAAQ,CAC1B,WAAU,CAAC,QAAQ;AAErB,QAAO,QAAQ,KAAK,CAAC,MAAM,WAAW;EACpC,MAAM,MAAM,QAAQ;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,uBAAuB,KAAK,GAAG;AAGjD,SAAO,CAAC,KAAK,MAAM;GACnB;;AAGJ,SAAgB,iBACd,OACA,EAAE,SAAS,MAAM,OAAO,SAAS,KAAM,GAAG,WACI;CAC9C,IAAI,aAAa,QAAQ,eAAe,MAAM,SAAS,MAAM,GAAG;AAChE,KAAI,eAAe,KACjB,cAAa;AAEf,KAAI,eAAe,MACjB,QAAO;AAGT,QAAO;EACL;EACA,OAAO;EACP,SAAS,gBAAgB,MAAM,SAAS,QAAQ;EAChD,MAAM,OAAO,UAAU,OAAO,KAAK,GAAG;EACtC,GAAG;EACJ;;AAGH,SAAS,UACP,OACA,IACgB;CAChB,MAAMA,WAA2B,EAAE;CACnC,MAAMC,UAAmC,EAAE;AAE3C,MAAK,MAAM,QAAQ,MAAM,WAAW;EAClC,MAAM,WAAW,MAAM,UAAU;AAEjC,UAAQ,SAAS,UAA8C,EAAE,KAAK;AACpE,YAAS,KAAK;IACZ;IACA,SAAS,iBAAiB,SAAS,OAAO,QAAQ;IACnD,CAAC;AAEF,UAAO,QAAQ;AACf,UAAO;;;AAIX,IAAG,QAA+B;AAClC,QAAO"}
+{"version":3,"file":"orm.js","names":["compiled: CompiledJoin[]","builder: Record<string, unknown>"],"sources":["../../../src/query/orm/orm.ts"],"sourcesContent":["import type {\n  AnySelectClause,\n  FindFirstOptions,\n  FindManyOptions,\n  JoinBuilder,\n  OrderBy,\n} from \"../simple-query-interface\";\nimport { buildCondition, type Condition } from \"../condition-builder\";\nimport type { AnyColumn, AnyRelation, AnyTable } from \"../../schema/create\";\n\nexport interface CompiledJoin {\n  relation: AnyRelation;\n  options: SimplifyFindOptions<FindManyOptions> | false;\n}\n\nfunction isOrderByArray(v: OrderBy | OrderBy[]): v is OrderBy[] {\n  return Array.isArray(v) && Array.isArray(v[0]);\n}\n\nfunction simplifyOrderBy(\n  columns: Record<string, AnyColumn>,\n  orderBy: OrderBy | OrderBy[] | undefined,\n): OrderBy<AnyColumn>[] | undefined {\n  if (!orderBy || orderBy.length === 0) {\n    return;\n  }\n\n  if (!isOrderByArray(orderBy)) {\n    orderBy = [orderBy];\n  }\n  return orderBy.map(([name, value]) => {\n    const col = columns[name];\n    if (!col) {\n      throw new Error(`unknown column name ${name}.`);\n    }\n\n    return [col, value];\n  });\n}\n\nexport function buildFindOptions(\n  table: AnyTable,\n  { select = true, where, orderBy, join, ...options }: FindManyOptions,\n): SimplifyFindOptions<FindManyOptions> | false {\n  let conditions = where ? buildCondition(table.columns, where) : undefined;\n  if (conditions === true) {\n    conditions = undefined;\n  }\n  if (conditions === false) {\n    return false;\n  }\n\n  return {\n    select,\n    where: conditions,\n    orderBy: simplifyOrderBy(table.columns, orderBy),\n    join: join ? buildJoin(table, join) : undefined,\n    ...options,\n  };\n}\n\nfunction buildJoin<TTable extends AnyTable>(\n  table: AnyTable,\n  fn: (builder: JoinBuilder<TTable>) => void,\n): CompiledJoin[] {\n  const compiled: CompiledJoin[] = [];\n  const builder: Record<string, unknown> = {};\n\n  for (const name in table.relations) {\n    const relation = table.relations[name]!;\n\n    builder[name] = (options: FindFirstOptions | FindManyOptions = {}) => {\n      compiled.push({\n        relation,\n        options: buildFindOptions(relation.table, options),\n      });\n\n      delete builder[name];\n      return builder;\n    };\n  }\n\n  fn(builder as JoinBuilder<TTable>);\n  return compiled;\n}\n\nexport type SimplifyFindOptions<O> = Omit<O, \"where\" | \"orderBy\" | \"select\" | \"join\"> & {\n  select: AnySelectClause;\n  where?: Condition | undefined;\n  orderBy?: OrderBy<AnyColumn>[];\n  join?: CompiledJoin[];\n};\n"],"mappings":";;;AAeA,SAAS,eAAe,GAAwC;AAC9D,QAAO,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,GAAG;;AAGhD,SAAS,gBACP,SACA,SACkC;AAClC,KAAI,CAAC,WAAW,QAAQ,WAAW,EACjC;AAGF,KAAI,CAAC,eAAe,QAAQ,CAC1B,WAAU,CAAC,QAAQ;AAErB,QAAO,QAAQ,KAAK,CAAC,MAAM,WAAW;EACpC,MAAM,MAAM,QAAQ;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,uBAAuB,KAAK,GAAG;AAGjD,SAAO,CAAC,KAAK,MAAM;GACnB;;AAGJ,SAAgB,iBACd,OACA,EAAE,SAAS,MAAM,OAAO,SAAS,KAAM,GAAG,WACI;CAC9C,IAAI,aAAa,QAAQ,eAAe,MAAM,SAAS,MAAM,GAAG;AAChE,KAAI,eAAe,KACjB,cAAa;AAEf,KAAI,eAAe,MACjB,QAAO;AAGT,QAAO;EACL;EACA,OAAO;EACP,SAAS,gBAAgB,MAAM,SAAS,QAAQ;EAChD,MAAM,OAAO,UAAU,OAAO,KAAK,GAAG;EACtC,GAAG;EACJ;;AAGH,SAAS,UACP,OACA,IACgB;CAChB,MAAMA,WAA2B,EAAE;CACnC,MAAMC,UAAmC,EAAE;AAE3C,MAAK,MAAM,QAAQ,MAAM,WAAW;EAClC,MAAM,WAAW,MAAM,UAAU;AAEjC,UAAQ,SAAS,UAA8C,EAAE,KAAK;AACpE,YAAS,KAAK;IACZ;IACA,SAAS,iBAAiB,SAAS,OAAO,QAAQ;IACnD,CAAC;AAEF,UAAO,QAAQ;AACf,UAAO;;;AAIX,IAAG,QAA+B;AAClC,QAAO"}

package/dist/query/serialize/create-sql-serializer.js

@@ -0,0 +1,30 @@
+import { SQLSerializer } from "./sql-serializer.js";
+import { SQLiteSerializer } from "./dialect/sqlite-serializer.js";
+import { PostgreSQLSerializer } from "./dialect/postgres-serializer.js";
+import { MySQLSerializer } from "./dialect/mysql-serializer.js";
+
+//#region src/query/serialize/create-sql-serializer.ts
+/**
+* Factory function to create a dialect-specific SQL serializer from a DriverConfig.
+*
+* Based on the database type, returns the appropriate serializer implementation
+* (PostgreSQL, MySQL, or SQLite).
+*
+* @param driverConfig - The driver configuration
+* @returns Dialect-specific SQLSerializer instance
+*/
+function createSQLSerializer(driverConfig) {
+	switch (driverConfig.databaseType) {
+		case "postgresql": return new PostgreSQLSerializer(driverConfig);
+		case "mysql": return new MySQLSerializer(driverConfig);
+		case "sqlite": return new SQLiteSerializer(driverConfig);
+		default: {
+			const exhaustiveCheck = driverConfig.databaseType;
+			throw new Error(`Unsupported database type: ${exhaustiveCheck}`);
+		}
+	}
+}
+
+//#endregion
+export { createSQLSerializer };
+//# sourceMappingURL=create-sql-serializer.js.map

package/dist/query/serialize/create-sql-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sql-serializer.js","names":["exhaustiveCheck: never"],"sources":["../../../src/query/serialize/create-sql-serializer.ts"],"sourcesContent":["import type { DriverConfig } from \"../../adapters/generic-sql/driver-config\";\nimport { SQLSerializer } from \"./sql-serializer\";\nimport { SQLiteSerializer } from \"./dialect/sqlite-serializer\";\nimport { PostgreSQLSerializer } from \"./dialect/postgres-serializer\";\nimport { MySQLSerializer } from \"./dialect/mysql-serializer\";\n\n// Re-export SQLSerializer for convenience\nexport { SQLSerializer } from \"./sql-serializer\";\n\n/**\n * Factory function to create a dialect-specific SQL serializer from a DriverConfig.\n *\n * Based on the database type, returns the appropriate serializer implementation\n * (PostgreSQL, MySQL, or SQLite).\n *\n * @param driverConfig - The driver configuration\n * @returns Dialect-specific SQLSerializer instance\n */\nexport function createSQLSerializer(driverConfig: DriverConfig): SQLSerializer {\n  // TODO: The serializers are pretty lenient in what they accept (lost of typeof checks), it may\n  //       be beneficial to implement serializers per DriverConfig, and be less lenient.\n  switch (driverConfig.databaseType) {\n    case \"postgresql\":\n      return new PostgreSQLSerializer(driverConfig);\n    case \"mysql\":\n      return new MySQLSerializer(driverConfig);\n    case \"sqlite\":\n      return new SQLiteSerializer(driverConfig);\n    default: {\n      const exhaustiveCheck: never = driverConfig.databaseType;\n      throw new Error(`Unsupported database type: ${exhaustiveCheck}`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,SAAgB,oBAAoB,cAA2C;AAG7E,SAAQ,aAAa,cAArB;EACE,KAAK,aACH,QAAO,IAAI,qBAAqB,aAAa;EAC/C,KAAK,QACH,QAAO,IAAI,gBAAgB,aAAa;EAC1C,KAAK,SACH,QAAO,IAAI,iBAAiB,aAAa;EAC3C,SAAS;GACP,MAAMA,kBAAyB,aAAa;AAC5C,SAAM,IAAI,MAAM,8BAA8B,kBAAkB"}

package/dist/query/serialize/dialect/mysql-serializer.js

@@ -0,0 +1,87 @@
+import { SQLSerializer } from "../sql-serializer.js";
+
+//#region src/query/serialize/dialect/mysql-serializer.ts
+/**
+* MySQL-specific serializer.
+*
+* MySQL has good native type support:
+* - Native JSON support (MySQL 5.7+)
+* - Native boolean type (TINYINT(1))
+* - Native timestamp/datetime/date types
+* - Native bigint support
+*
+* Similar to PostgreSQL, most values pass through without conversion.
+* Timestamps/dates are returned as strings and need to be parsed.
+*/
+var MySQLSerializer = class extends SQLSerializer {
+	constructor(driverConfig) {
+		super(driverConfig);
+	}
+	serializeDate(value) {
+		return value;
+	}
+	serializeBoolean(value) {
+		return value;
+	}
+	serializeBigInt(value, _col) {
+		return value;
+	}
+	deserializeDate(value) {
+		if (value instanceof Date) return value;
+		if (typeof value === "string") return new Date(value);
+		throw new Error(`Cannot deserialize date from value: ${value}`);
+	}
+	deserializeBoolean(value) {
+		if (typeof value === "boolean") return value;
+		if (typeof value === "number") return value === 1;
+		throw new Error(`Cannot deserialize boolean from value: ${value}`);
+	}
+	deserializeBigInt(value) {
+		if (typeof value === "bigint") return value;
+		if (typeof value === "string") return BigInt(value);
+		if (typeof value === "number") return BigInt(value);
+		throw new Error(`Cannot deserialize bigint from value: ${value}`);
+	}
+	serializeJson(value) {
+		return value;
+	}
+	deserializeJson(value) {
+		return value;
+	}
+	deserializeBinary(value) {
+		if (value instanceof Buffer) return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+		if (value instanceof Uint8Array) return value;
+		if (value instanceof ArrayBuffer) return new Uint8Array(value);
+		throw new Error(`Cannot deserialize binary from value: ${typeof value}`);
+	}
+	deserializeInteger(value) {
+		if (typeof value === "number") return value;
+		if (typeof value === "string") {
+			const num = Number(value);
+			if (isNaN(num)) throw new Error(`Cannot deserialize integer from invalid string: ${value}`);
+			return num;
+		}
+		if (typeof value === "bigint") {
+			if (value > Number.MAX_SAFE_INTEGER || value < Number.MIN_SAFE_INTEGER) throw new RangeError(`Cannot deserialize integer value ${value}: exceeds safe integer range`);
+			return Number(value);
+		}
+		throw new Error(`Cannot deserialize integer from value: ${typeof value}`);
+	}
+	deserializeDecimal(value) {
+		if (typeof value === "number") return value;
+		if (typeof value === "string") {
+			const num = parseFloat(value);
+			if (isNaN(num)) throw new Error(`Cannot deserialize decimal from invalid string: ${value}`);
+			return num;
+		}
+		throw new Error(`Cannot deserialize decimal from value: ${typeof value}`);
+	}
+	deserializeString(value) {
+		if (typeof value === "string") return value;
+		throw new Error(`Cannot deserialize string from value: ${typeof value}`);
+	}
+};
+
+//#endregion
+export { MySQLSerializer };
+//# sourceMappingURL=mysql-serializer.js.map

package/dist/query/serialize/dialect/mysql-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-serializer.js","names":[],"sources":["../../../../src/query/serialize/dialect/mysql-serializer.ts"],"sourcesContent":["import type { AnyColumn } from \"../../../schema/create\";\nimport { SQLSerializer } from \"../sql-serializer\";\nimport type { DriverConfig } from \"../../../adapters/generic-sql/driver-config\";\n\n/**\n * MySQL-specific serializer.\n *\n * MySQL has good native type support:\n * - Native JSON support (MySQL 5.7+)\n * - Native boolean type (TINYINT(1))\n * - Native timestamp/datetime/date types\n * - Native bigint support\n *\n * Similar to PostgreSQL, most values pass through without conversion.\n * Timestamps/dates are returned as strings and need to be parsed.\n */\nexport class MySQLSerializer extends SQLSerializer {\n  constructor(driverConfig: DriverConfig) {\n    super(driverConfig);\n  }\n\n  protected serializeDate(value: Date): Date {\n    // MySQL handles Date objects natively\n    return value;\n  }\n\n  protected serializeBoolean(value: boolean): boolean {\n    // MySQL handles boolean natively (as TINYINT(1))\n    return value;\n  }\n\n  protected serializeBigInt(value: bigint, _col: AnyColumn): bigint {\n    // MySQL handles bigint natively\n    return value;\n  }\n\n  protected deserializeDate(value: unknown): Date {\n    if (value instanceof Date) {\n      return value;\n    }\n    // MySQL returns timestamps/dates as strings\n    if (typeof value === \"string\") {\n      return new Date(value);\n    }\n    throw new Error(`Cannot deserialize date from value: ${value}`);\n  }\n\n  protected deserializeBoolean(value: unknown): boolean {\n    if (typeof value === \"boolean\") {\n      return value;\n    }\n    // MySQL may return booleans as numbers (0/1)\n    if (typeof value === \"number\") {\n      return value === 1;\n    }\n    throw new Error(`Cannot deserialize boolean from value: ${value}`);\n  }\n\n  protected deserializeBigInt(value: unknown): bigint {\n    if (typeof value === \"bigint\") {\n      return value;\n    }\n    // MySQL may return bigints as strings\n    if (typeof value === \"string\") {\n      return BigInt(value);\n    }\n    if (typeof value === \"number\") {\n      return BigInt(value);\n    }\n    throw new Error(`Cannot deserialize bigint from value: ${value}`);\n  }\n\n  protected serializeJson(value: unknown): unknown {\n    // MySQL supports native JSON, pass through as-is\n    return value;\n  }\n\n  protected deserializeJson(value: unknown): unknown {\n    // MySQL returns parsed JSON objects, pass through as-is\n    return value;\n  }\n\n  protected deserializeBinary(value: unknown): Uint8Array {\n    // MySQL can return Buffer or Uint8Array for BLOB columns\n    if (value instanceof Buffer) {\n      return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n    }\n    if (value instanceof Uint8Array) {\n      return value;\n    }\n    if (value instanceof ArrayBuffer) {\n      return new Uint8Array(value);\n    }\n    throw new Error(`Cannot deserialize binary from value: ${typeof value}`);\n  }\n\n  protected deserializeInteger(value: unknown): number {\n    if (typeof value === \"number\") {\n      return value;\n    }\n    // MySQL may return integers as strings\n    if (typeof value === \"string\") {\n      const num = Number(value);\n      if (isNaN(num)) {\n        throw new Error(`Cannot deserialize integer from invalid string: ${value}`);\n      }\n      return num;\n    }\n    // MySQL may return bigint for large integers\n    if (typeof value === \"bigint\") {\n      if (value > Number.MAX_SAFE_INTEGER || value < Number.MIN_SAFE_INTEGER) {\n        throw new RangeError(\n          `Cannot deserialize integer value ${value}: exceeds safe integer range`,\n        );\n      }\n      return Number(value);\n    }\n    throw new Error(`Cannot deserialize integer from value: ${typeof value}`);\n  }\n\n  protected deserializeDecimal(value: unknown): number {\n    // MySQL can return decimals as numbers or strings\n    if (typeof value === \"number\") {\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const num = parseFloat(value);\n      if (isNaN(num)) {\n        throw new Error(`Cannot deserialize decimal from invalid string: ${value}`);\n      }\n      return num;\n    }\n    throw new Error(`Cannot deserialize decimal from value: ${typeof value}`);\n  }\n\n  protected deserializeString(value: unknown): string {\n    if (typeof value === \"string\") {\n      return value;\n    }\n    throw new Error(`Cannot deserialize string from value: ${typeof value}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,IAAa,kBAAb,cAAqC,cAAc;CACjD,YAAY,cAA4B;AACtC,QAAM,aAAa;;CAGrB,AAAU,cAAc,OAAmB;AAEzC,SAAO;;CAGT,AAAU,iBAAiB,OAAyB;AAElD,SAAO;;CAGT,AAAU,gBAAgB,OAAe,MAAyB;AAEhE,SAAO;;CAGT,AAAU,gBAAgB,OAAsB;AAC9C,MAAI,iBAAiB,KACnB,QAAO;AAGT,MAAI,OAAO,UAAU,SACnB,QAAO,IAAI,KAAK,MAAM;AAExB,QAAM,IAAI,MAAM,uCAAuC,QAAQ;;CAGjE,AAAU,mBAAmB,OAAyB;AACpD,MAAI,OAAO,UAAU,UACnB,QAAO;AAGT,MAAI,OAAO,UAAU,SACnB,QAAO,UAAU;AAEnB,QAAM,IAAI,MAAM,0CAA0C,QAAQ;;CAGpE,AAAU,kBAAkB,OAAwB;AAClD,MAAI,OAAO,UAAU,SACnB,QAAO;AAGT,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAEtB,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAEtB,QAAM,IAAI,MAAM,yCAAyC,QAAQ;;CAGnE,AAAU,cAAc,OAAyB;AAE/C,SAAO;;CAGT,AAAU,gBAAgB,OAAyB;AAEjD,SAAO;;CAGT,AAAU,kBAAkB,OAA4B;AAEtD,MAAI,iBAAiB,OACnB,QAAO,IAAI,WAAW,MAAM,QAAQ,MAAM,YAAY,MAAM,WAAW;AAEzE,MAAI,iBAAiB,WACnB,QAAO;AAET,MAAI,iBAAiB,YACnB,QAAO,IAAI,WAAW,MAAM;AAE9B,QAAM,IAAI,MAAM,yCAAyC,OAAO,QAAQ;;CAG1E,AAAU,mBAAmB,OAAwB;AACnD,MAAI,OAAO,UAAU,SACnB,QAAO;AAGT,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,OAAO,MAAM;AACzB,OAAI,MAAM,IAAI,CACZ,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAGT,MAAI,OAAO,UAAU,UAAU;AAC7B,OAAI,QAAQ,OAAO,oBAAoB,QAAQ,OAAO,iBACpD,OAAM,IAAI,WACR,oCAAoC,MAAM,8BAC3C;AAEH,UAAO,OAAO,MAAM;;AAEtB,QAAM,IAAI,MAAM,0CAA0C,OAAO,QAAQ;;CAG3E,AAAU,mBAAmB,OAAwB;AAEnD,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,WAAW,MAAM;AAC7B,OAAI,MAAM,IAAI,CACZ,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAET,QAAM,IAAI,MAAM,0CAA0C,OAAO,QAAQ;;CAG3E,AAAU,kBAAkB,OAAwB;AAClD,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,QAAM,IAAI,MAAM,yCAAyC,OAAO,QAAQ"}

package/dist/query/serialize/dialect/postgres-serializer.js

@@ -0,0 +1,80 @@
+import { SQLSerializer } from "../sql-serializer.js";
+
+//#region src/query/serialize/dialect/postgres-serializer.ts
+/**
+* PostgreSQL-specific serializer.
+*
+* PostgreSQL has excellent native type support:
+* - Native JSON support
+* - Native boolean type
+* - Native timestamp/date types
+* - Native bigint support
+*
+* Most values pass through without conversion, only strings need to be parsed to Date.
+*/
+var PostgreSQLSerializer = class extends SQLSerializer {
+	constructor(driverConfig) {
+		super(driverConfig);
+	}
+	serializeDate(value) {
+		return value;
+	}
+	serializeBoolean(value) {
+		return value;
+	}
+	serializeBigInt(value, _col) {
+		return value;
+	}
+	deserializeDate(value) {
+		if (value instanceof Date) return value;
+		if (typeof value === "string") return new Date(value);
+		throw new Error(`Cannot deserialize date from value: ${value}`);
+	}
+	deserializeBoolean(value) {
+		if (typeof value === "boolean") return value;
+		throw new Error(`Cannot deserialize boolean from value: ${value}`);
+	}
+	deserializeBigInt(value) {
+		if (typeof value === "bigint") return value;
+		if (typeof value === "string") return BigInt(value);
+		if (typeof value === "number") return BigInt(value);
+		throw new Error(`Cannot deserialize bigint from value: ${value}`);
+	}
+	serializeJson(value) {
+		return value;
+	}
+	deserializeJson(value) {
+		return value;
+	}
+	deserializeBinary(value) {
+		if (value instanceof Buffer) return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+		if (value instanceof Uint8Array) return value;
+		if (value instanceof ArrayBuffer) return new Uint8Array(value);
+		throw new Error(`Cannot deserialize binary from value: ${typeof value}`);
+	}
+	deserializeInteger(value) {
+		if (typeof value === "number") return value;
+		if (typeof value === "bigint") {
+			if (value > Number.MAX_SAFE_INTEGER || value < Number.MIN_SAFE_INTEGER) throw new RangeError(`Cannot deserialize integer value ${value}: exceeds safe integer range`);
+			return Number(value);
+		}
+		throw new Error(`Cannot deserialize integer from value: ${typeof value}`);
+	}
+	deserializeDecimal(value) {
+		if (typeof value === "number") return value;
+		if (typeof value === "string") {
+			const num = parseFloat(value);
+			if (isNaN(num)) throw new Error(`Cannot deserialize decimal from invalid string: ${value}`);
+			return num;
+		}
+		throw new Error(`Cannot deserialize decimal from value: ${typeof value}`);
+	}
+	deserializeString(value) {
+		if (typeof value === "string") return value;
+		throw new Error(`Cannot deserialize string from value: ${typeof value}`);
+	}
+};
+
+//#endregion
+export { PostgreSQLSerializer };
+//# sourceMappingURL=postgres-serializer.js.map

package/dist/query/serialize/dialect/postgres-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-serializer.js","names":[],"sources":["../../../../src/query/serialize/dialect/postgres-serializer.ts"],"sourcesContent":["import type { AnyColumn } from \"../../../schema/create\";\nimport { SQLSerializer } from \"../sql-serializer\";\nimport type { DriverConfig } from \"../../../adapters/generic-sql/driver-config\";\n\n/**\n * PostgreSQL-specific serializer.\n *\n * PostgreSQL has excellent native type support:\n * - Native JSON support\n * - Native boolean type\n * - Native timestamp/date types\n * - Native bigint support\n *\n * Most values pass through without conversion, only strings need to be parsed to Date.\n */\nexport class PostgreSQLSerializer extends SQLSerializer {\n  constructor(driverConfig: DriverConfig) {\n    super(driverConfig);\n  }\n\n  protected serializeDate(value: Date): Date {\n    // PostgreSQL handles Date objects natively\n    return value;\n  }\n\n  protected serializeBoolean(value: boolean): boolean {\n    // PostgreSQL handles boolean natively\n    return value;\n  }\n\n  protected serializeBigInt(value: bigint, _col: AnyColumn): bigint {\n    // PostgreSQL handles bigint natively\n    return value;\n  }\n\n  protected deserializeDate(value: unknown): Date {\n    if (value instanceof Date) {\n      return value;\n    }\n    // PostgreSQL returns timestamps/dates as strings\n    if (typeof value === \"string\") {\n      return new Date(value);\n    }\n    throw new Error(`Cannot deserialize date from value: ${value}`);\n  }\n\n  protected deserializeBoolean(value: unknown): boolean {\n    if (typeof value === \"boolean\") {\n      return value;\n    }\n    throw new Error(`Cannot deserialize boolean from value: ${value}`);\n  }\n\n  protected deserializeBigInt(value: unknown): bigint {\n    if (typeof value === \"bigint\") {\n      return value;\n    }\n    // PostgreSQL may return bigints as strings\n    if (typeof value === \"string\") {\n      return BigInt(value);\n    }\n    if (typeof value === \"number\") {\n      return BigInt(value);\n    }\n    throw new Error(`Cannot deserialize bigint from value: ${value}`);\n  }\n\n  protected serializeJson(value: unknown): unknown {\n    // PostgreSQL supports native JSON, pass through as-is\n    return value;\n  }\n\n  protected deserializeJson(value: unknown): unknown {\n    // PostgreSQL returns parsed JSON objects, pass through as-is\n    return value;\n  }\n\n  protected deserializeBinary(value: unknown): Uint8Array {\n    // PostgreSQL can return Buffer or Uint8Array for BYTEA columns\n    if (value instanceof Buffer) {\n      return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n    }\n    if (value instanceof Uint8Array) {\n      return value;\n    }\n    if (value instanceof ArrayBuffer) {\n      return new Uint8Array(value);\n    }\n    throw new Error(`Cannot deserialize binary from value: ${typeof value}`);\n  }\n\n  protected deserializeInteger(value: unknown): number {\n    if (typeof value === \"number\") {\n      return value;\n    }\n    // PostgreSQL may return bigint for large integers\n    if (typeof value === \"bigint\") {\n      if (value > Number.MAX_SAFE_INTEGER || value < Number.MIN_SAFE_INTEGER) {\n        throw new RangeError(\n          `Cannot deserialize integer value ${value}: exceeds safe integer range`,\n        );\n      }\n      return Number(value);\n    }\n    throw new Error(`Cannot deserialize integer from value: ${typeof value}`);\n  }\n\n  protected deserializeDecimal(value: unknown): number {\n    // PostgreSQL can return decimals as numbers or strings depending on precision\n    if (typeof value === \"number\") {\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const num = parseFloat(value);\n      if (isNaN(num)) {\n        throw new Error(`Cannot deserialize decimal from invalid string: ${value}`);\n      }\n      return num;\n    }\n    throw new Error(`Cannot deserialize decimal from value: ${typeof value}`);\n  }\n\n  protected deserializeString(value: unknown): string {\n    if (typeof value === \"string\") {\n      return value;\n    }\n    throw new Error(`Cannot deserialize string from value: ${typeof value}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,IAAa,uBAAb,cAA0C,cAAc;CACtD,YAAY,cAA4B;AACtC,QAAM,aAAa;;CAGrB,AAAU,cAAc,OAAmB;AAEzC,SAAO;;CAGT,AAAU,iBAAiB,OAAyB;AAElD,SAAO;;CAGT,AAAU,gBAAgB,OAAe,MAAyB;AAEhE,SAAO;;CAGT,AAAU,gBAAgB,OAAsB;AAC9C,MAAI,iBAAiB,KACnB,QAAO;AAGT,MAAI,OAAO,UAAU,SACnB,QAAO,IAAI,KAAK,MAAM;AAExB,QAAM,IAAI,MAAM,uCAAuC,QAAQ;;CAGjE,AAAU,mBAAmB,OAAyB;AACpD,MAAI,OAAO,UAAU,UACnB,QAAO;AAET,QAAM,IAAI,MAAM,0CAA0C,QAAQ;;CAGpE,AAAU,kBAAkB,OAAwB;AAClD,MAAI,OAAO,UAAU,SACnB,QAAO;AAGT,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAEtB,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAEtB,QAAM,IAAI,MAAM,yCAAyC,QAAQ;;CAGnE,AAAU,cAAc,OAAyB;AAE/C,SAAO;;CAGT,AAAU,gBAAgB,OAAyB;AAEjD,SAAO;;CAGT,AAAU,kBAAkB,OAA4B;AAEtD,MAAI,iBAAiB,OACnB,QAAO,IAAI,WAAW,MAAM,QAAQ,MAAM,YAAY,MAAM,WAAW;AAEzE,MAAI,iBAAiB,WACnB,QAAO;AAET,MAAI,iBAAiB,YACnB,QAAO,IAAI,WAAW,MAAM;AAE9B,QAAM,IAAI,MAAM,yCAAyC,OAAO,QAAQ;;CAG1E,AAAU,mBAAmB,OAAwB;AACnD,MAAI,OAAO,UAAU,SACnB,QAAO;AAGT,MAAI,OAAO,UAAU,UAAU;AAC7B,OAAI,QAAQ,OAAO,oBAAoB,QAAQ,OAAO,iBACpD,OAAM,IAAI,WACR,oCAAoC,MAAM,8BAC3C;AAEH,UAAO,OAAO,MAAM;;AAEtB,QAAM,IAAI,MAAM,0CAA0C,OAAO,QAAQ;;CAG3E,AAAU,mBAAmB,OAAwB;AAEnD,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,WAAW,MAAM;AAC7B,OAAI,MAAM,IAAI,CACZ,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAET,QAAM,IAAI,MAAM,0CAA0C,OAAO,QAAQ;;CAG3E,AAAU,kBAAkB,OAAwB;AAClD,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,QAAM,IAAI,MAAM,yCAAyC,OAAO,QAAQ"}

package/dist/query/serialize/dialect/sqlite-serializer.js

@@ -0,0 +1,93 @@
+import { SQLSerializer } from "../sql-serializer.js";
+
+//#region src/query/serialize/dialect/sqlite-serializer.ts
+/**
+* SQLite-specific serializer.
+*
+* SQLite has limited native type support and requires conversions:
+* - JSON → strings (no native JSON support)
+* - Dates → numbers (timestamps)
+* - Booleans → 0/1
+* - BigInts → Buffer (except for internal-id and reference columns → number)
+* - Numbers/strings → Date for timestamps/dates
+*/
+var SQLiteSerializer = class extends SQLSerializer {
+	constructor(driverConfig) {
+		super(driverConfig);
+	}
+	serializeDate(value) {
+		return value.getTime();
+	}
+	serializeBoolean(value) {
+		return value ? 1 : 0;
+	}
+	serializeBigInt(value, col) {
+		if (col.role === "reference" || col.role === "internal-id") {
+			if (Math.abs(Number(value)) > Number.MAX_SAFE_INTEGER) throw new RangeError(`Cannot serialize bigint value ${value} for column "${col.name}": value exceeds Number.MAX_SAFE_INTEGER (${Number.MAX_SAFE_INTEGER}). SQLite reference and internal-id columns use INTEGER type which requires values to fit within JavaScript's safe integer range.`);
+			return Number(value);
+		}
+		const buf = Buffer.alloc(8);
+		buf.writeBigInt64BE(value);
+		return buf;
+	}
+	deserializeDate(value) {
+		if (value instanceof Date) return value;
+		if (typeof value === "number" || typeof value === "string") return new Date(value);
+		throw new Error(`Cannot deserialize date from value: ${value}`);
+	}
+	deserializeBoolean(value) {
+		if (typeof value === "boolean") return value;
+		if (typeof value === "number") return value === 1;
+		throw new Error(`Cannot deserialize boolean from value: ${value}`);
+	}
+	deserializeBigInt(value) {
+		if (typeof value === "bigint") return value;
+		if (value instanceof Buffer) return value.readBigInt64BE(0);
+		if (typeof value === "string") return BigInt(value);
+		if (typeof value === "number") return BigInt(value);
+		throw new Error(`Cannot deserialize bigint from value: ${value}`);
+	}
+	serializeJson(value) {
+		return JSON.stringify(value);
+	}
+	deserializeJson(value) {
+		if (typeof value !== "string") throw new Error(`Expected JSON string but got ${typeof value}`);
+		return JSON.parse(value);
+	}
+	deserializeBinary(value) {
+		if (value instanceof Buffer) return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+		if (value instanceof Uint8Array) return value;
+		if (value instanceof ArrayBuffer) return new Uint8Array(value);
+		throw new Error(`Cannot deserialize binary from value: ${typeof value}`);
+	}
+	deserializeInteger(value) {
+		if (typeof value === "number") return value;
+		if (typeof value === "string") {
+			const num = Number(value);
+			if (isNaN(num)) throw new Error(`Cannot deserialize integer from invalid string: ${value}`);
+			return num;
+		}
+		if (typeof value === "bigint") {
+			if (value > Number.MAX_SAFE_INTEGER || value < Number.MIN_SAFE_INTEGER) throw new RangeError(`Cannot deserialize integer value ${value}: exceeds safe integer range`);
+			return Number(value);
+		}
+		throw new Error(`Cannot deserialize integer from value: ${typeof value}`);
+	}
+	deserializeDecimal(value) {
+		if (typeof value === "number") return value;
+		if (typeof value === "string") {
+			const num = parseFloat(value);
+			if (isNaN(num)) throw new Error(`Cannot deserialize decimal from invalid string: ${value}`);
+			return num;
+		}
+		throw new Error(`Cannot deserialize decimal from value: ${typeof value}`);
+	}
+	deserializeString(value) {
+		if (typeof value === "string") return value;
+		throw new Error(`Cannot deserialize string from value: ${typeof value}`);
+	}
+};
+
+//#endregion
+export { SQLiteSerializer };
+//# sourceMappingURL=sqlite-serializer.js.map

package/dist/query/serialize/dialect/sqlite-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-serializer.js","names":[],"sources":["../../../../src/query/serialize/dialect/sqlite-serializer.ts"],"sourcesContent":["import type { AnyColumn } from \"../../../schema/create\";\nimport { SQLSerializer } from \"../sql-serializer\";\nimport type { DriverConfig } from \"../../../adapters/generic-sql/driver-config\";\n\n/**\n * SQLite-specific serializer.\n *\n * SQLite has limited native type support and requires conversions:\n * - JSON → strings (no native JSON support)\n * - Dates → numbers (timestamps)\n * - Booleans → 0/1\n * - BigInts → Buffer (except for internal-id and reference columns → number)\n * - Numbers/strings → Date for timestamps/dates\n */\nexport class SQLiteSerializer extends SQLSerializer {\n  constructor(driverConfig: DriverConfig) {\n    super(driverConfig);\n  }\n\n  protected serializeDate(value: Date): number {\n    return value.getTime();\n  }\n\n  protected serializeBoolean(value: boolean): number {\n    return value ? 1 : 0;\n  }\n\n  protected serializeBigInt(value: bigint, col: AnyColumn): number | Buffer {\n    // SQLite special case: internal-id and reference columns use integer, not blob\n    // These should be converted to numbers for SQLite\n    if (col.role === \"reference\" || col.role === \"internal-id\") {\n      // Check if the bigint is within the safe integer range to avoid precision loss\n      if (Math.abs(Number(value)) > Number.MAX_SAFE_INTEGER) {\n        throw new RangeError(\n          `Cannot serialize bigint value ${value} for column \"${col.name}\": ` +\n            `value exceeds Number.MAX_SAFE_INTEGER (${Number.MAX_SAFE_INTEGER}). ` +\n            `SQLite reference and internal-id columns use INTEGER type which requires values ` +\n            `to fit within JavaScript's safe integer range.`,\n        );\n      }\n      return Number(value);\n    }\n    const buf = Buffer.alloc(8);\n    buf.writeBigInt64BE(value);\n    return buf;\n  }\n\n  protected deserializeDate(value: unknown): Date {\n    if (value instanceof Date) {\n      return value;\n    }\n    if (typeof value === \"number\" || typeof value === \"string\") {\n      return new Date(value);\n    }\n    throw new Error(`Cannot deserialize date from value: ${value}`);\n  }\n\n  protected deserializeBoolean(value: unknown): boolean {\n    if (typeof value === \"boolean\") {\n      return value;\n    }\n    if (typeof value === \"number\") {\n      return value === 1;\n    }\n    throw new Error(`Cannot deserialize boolean from value: ${value}`);\n  }\n\n  protected deserializeBigInt(value: unknown): bigint {\n    if (typeof value === \"bigint\") {\n      return value;\n    }\n    if (value instanceof Buffer) {\n      return value.readBigInt64BE(0);\n    }\n    if (typeof value === \"string\") {\n      return BigInt(value);\n    }\n    if (typeof value === \"number\") {\n      return BigInt(value);\n    }\n    throw new Error(`Cannot deserialize bigint from value: ${value}`);\n  }\n\n  protected serializeJson(value: unknown): string {\n    // SQLite doesn't support native JSON, so we stringify\n    return JSON.stringify(value);\n  }\n\n  protected deserializeJson(value: unknown): unknown {\n    // SQLite stores JSON as strings, so we need to parse\n    if (typeof value !== \"string\") {\n      throw new Error(`Expected JSON string but got ${typeof value}`);\n    }\n    return JSON.parse(value);\n  }\n\n  protected deserializeBinary(value: unknown): Uint8Array {\n    // SQLite can return Buffer or Uint8Array for BLOB columns\n    if (value instanceof Buffer) {\n      return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n    }\n    if (value instanceof Uint8Array) {\n      return value;\n    }\n    if (value instanceof ArrayBuffer) {\n      return new Uint8Array(value);\n    }\n    throw new Error(`Cannot deserialize binary from value: ${typeof value}`);\n  }\n\n  protected deserializeInteger(value: unknown): number {\n    if (typeof value === \"number\") {\n      return value;\n    }\n    // SQLite may return integers as strings for large values\n    if (typeof value === \"string\") {\n      const num = Number(value);\n      if (isNaN(num)) {\n        throw new Error(`Cannot deserialize integer from invalid string: ${value}`);\n      }\n      return num;\n    }\n    // SQLite may return bigint for large integers\n    if (typeof value === \"bigint\") {\n      if (value > Number.MAX_SAFE_INTEGER || value < Number.MIN_SAFE_INTEGER) {\n        throw new RangeError(\n          `Cannot deserialize integer value ${value}: exceeds safe integer range`,\n        );\n      }\n      return Number(value);\n    }\n    throw new Error(`Cannot deserialize integer from value: ${typeof value}`);\n  }\n\n  protected deserializeDecimal(value: unknown): number {\n    // SQLite stores decimals as REAL (floating point) or TEXT\n    if (typeof value === \"number\") {\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const num = parseFloat(value);\n      if (isNaN(num)) {\n        throw new Error(`Cannot deserialize decimal from invalid string: ${value}`);\n      }\n      return num;\n    }\n    throw new Error(`Cannot deserialize decimal from value: ${typeof value}`);\n  }\n\n  protected deserializeString(value: unknown): string {\n    if (typeof value === \"string\") {\n      return value;\n    }\n    throw new Error(`Cannot deserialize string from value: ${typeof value}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,IAAa,mBAAb,cAAsC,cAAc;CAClD,YAAY,cAA4B;AACtC,QAAM,aAAa;;CAGrB,AAAU,cAAc,OAAqB;AAC3C,SAAO,MAAM,SAAS;;CAGxB,AAAU,iBAAiB,OAAwB;AACjD,SAAO,QAAQ,IAAI;;CAGrB,AAAU,gBAAgB,OAAe,KAAiC;AAGxE,MAAI,IAAI,SAAS,eAAe,IAAI,SAAS,eAAe;AAE1D,OAAI,KAAK,IAAI,OAAO,MAAM,CAAC,GAAG,OAAO,iBACnC,OAAM,IAAI,WACR,iCAAiC,MAAM,eAAe,IAAI,KAAK,4CACnB,OAAO,iBAAiB,mIAGrE;AAEH,UAAO,OAAO,MAAM;;EAEtB,MAAM,MAAM,OAAO,MAAM,EAAE;AAC3B,MAAI,gBAAgB,MAAM;AAC1B,SAAO;;CAGT,AAAU,gBAAgB,OAAsB;AAC9C,MAAI,iBAAiB,KACnB,QAAO;AAET,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,SAChD,QAAO,IAAI,KAAK,MAAM;AAExB,QAAM,IAAI,MAAM,uCAAuC,QAAQ;;CAGjE,AAAU,mBAAmB,OAAyB;AACpD,MAAI,OAAO,UAAU,UACnB,QAAO;AAET,MAAI,OAAO,UAAU,SACnB,QAAO,UAAU;AAEnB,QAAM,IAAI,MAAM,0CAA0C,QAAQ;;CAGpE,AAAU,kBAAkB,OAAwB;AAClD,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,MAAI,iBAAiB,OACnB,QAAO,MAAM,eAAe,EAAE;AAEhC,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAEtB,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAEtB,QAAM,IAAI,MAAM,yCAAyC,QAAQ;;CAGnE,AAAU,cAAc,OAAwB;AAE9C,SAAO,KAAK,UAAU,MAAM;;CAG9B,AAAU,gBAAgB,OAAyB;AAEjD,MAAI,OAAO,UAAU,SACnB,OAAM,IAAI,MAAM,gCAAgC,OAAO,QAAQ;AAEjE,SAAO,KAAK,MAAM,MAAM;;CAG1B,AAAU,kBAAkB,OAA4B;AAEtD,MAAI,iBAAiB,OACnB,QAAO,IAAI,WAAW,MAAM,QAAQ,MAAM,YAAY,MAAM,WAAW;AAEzE,MAAI,iBAAiB,WACnB,QAAO;AAET,MAAI,iBAAiB,YACnB,QAAO,IAAI,WAAW,MAAM;AAE9B,QAAM,IAAI,MAAM,yCAAyC,OAAO,QAAQ;;CAG1E,AAAU,mBAAmB,OAAwB;AACnD,MAAI,OAAO,UAAU,SACnB,QAAO;AAGT,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,OAAO,MAAM;AACzB,OAAI,MAAM,IAAI,CACZ,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAGT,MAAI,OAAO,UAAU,UAAU;AAC7B,OAAI,QAAQ,OAAO,oBAAoB,QAAQ,OAAO,iBACpD,OAAM,IAAI,WACR,oCAAoC,MAAM,8BAC3C;AAEH,UAAO,OAAO,MAAM;;AAEtB,QAAM,IAAI,MAAM,0CAA0C,OAAO,QAAQ;;CAG3E,AAAU,mBAAmB,OAAwB;AAEnD,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,WAAW,MAAM;AAC7B,OAAI,MAAM,IAAI,CACZ,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAET,QAAM,IAAI,MAAM,0CAA0C,OAAO,QAAQ;;CAG3E,AAAU,kBAAkB,OAAwB;AAClD,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,QAAM,IAAI,MAAM,yCAAyC,OAAO,QAAQ"}

package/dist/query/serialize/sql-serializer.js

@@ -0,0 +1,67 @@
+//#region src/query/serialize/sql-serializer.ts
+/**
+* Abstract base class for SQL value serialization/deserialization.
+*
+* Similar to SQLTypeMapper, this class provides a framework for converting values
+* between application format and database format. Each database dialect extends
+* this class and implements abstract methods for dialect-specific conversions.
+*
+* Handles:
+* - Type conversions (Date, boolean, BigInt, etc.)
+* - JSON handling (delegated to dialect-specific implementations)
+* - Binary data conversion (Uint8Array ↔ Buffer)
+*/
+var SQLSerializer = class {
+	driverConfig;
+	constructor(driverConfig) {
+		this.driverConfig = driverConfig;
+	}
+	/**
+	* Deserialize a value from database format to application format.
+	*
+	* @param value - The raw database value
+	* @param col - The column schema definition
+	* @returns The deserialized value in application format
+	* @throws Error if value cannot be deserialized to the expected type
+	*/
+	deserialize(value, col) {
+		if (value === null) return null;
+		if (col.type === "json") return this.deserializeJson(value);
+		if (col.type === "timestamp" || col.type === "date") return this.deserializeDate(value);
+		if (col.type === "bool") return this.deserializeBoolean(value);
+		if (col.type === "bigint") return this.deserializeBigInt(value);
+		if (col.type === "binary") return this.deserializeBinary(value);
+		if (col.type === "integer") return this.deserializeInteger(value);
+		if (col.type === "decimal") return this.deserializeDecimal(value);
+		if (col.type === "string" || typeof col.type === "string" && col.type.startsWith("varchar")) return this.deserializeString(value);
+		throw new Error(`Unsupported column type for deserialization: ${col.type}`);
+	}
+	/**
+	* Serialize a value from application format to database format.
+	*
+	* Note: This method expects FragnoId/FragnoReference objects to be resolved
+	* to primitive values before calling. Use resolveFragnoIdValue() from
+	* value-encoding.ts for this purpose.
+	*
+	* @param value - The application value to serialize (should not be FragnoId/FragnoReference)
+	* @param col - The column schema definition
+	* @param skipDriverConversions - Skip driver-level type conversions (Date->number, boolean->0/1, bigint->Buffer).
+	*                                 Set to true when using ORMs like Drizzle that handle these conversions internally.
+	* @returns The serialized value in database format
+	*/
+	serialize(value, col, skipDriverConversions = false) {
+		if (value === null) return null;
+		if (col.type === "json") return this.serializeJson(value);
+		if (!skipDriverConversions) {
+			if (value instanceof Date) return this.serializeDate(value);
+			if (typeof value === "boolean") return this.serializeBoolean(value);
+			if (typeof value === "bigint") return this.serializeBigInt(value, col);
+		}
+		if (col.type === "binary" && value instanceof Uint8Array) return Buffer.from(value);
+		return value;
+	}
+};
+
+//#endregion
+export { SQLSerializer };
+//# sourceMappingURL=sql-serializer.js.map