@fragno-dev/db 0.3.0 → 0.4.1

package/dist/query/cursor-client.d.ts

@@ -0,0 +1,105 @@
+import { AnyColumn } from "../schema/create.js";
+
+//#region src/query/cursor-client.d.ts
+
+/**
+ * Cursor object containing all information needed for pagination
+ */
+declare class Cursor {
+  #private;
+  constructor(data: {
+    indexName: string;
+    orderDirection: "asc" | "desc";
+    pageSize: number;
+    indexValues: Record<string, unknown>;
+  });
+  /**
+   * Get the index name being used for pagination
+   */
+  get indexName(): string;
+  /**
+   * Get the ordering direction
+   */
+  get orderDirection(): "asc" | "desc";
+  /**
+   * Get the page size
+   */
+  get pageSize(): number;
+  /**
+   * Get the cursor position values
+   */
+  get indexValues(): Record<string, unknown>;
+  /**
+   * Encode cursor to an opaque base64 string (safe to send to client)
+   */
+  encode(): string;
+}
+/**
+ * Result of a cursor-based query containing items and pagination cursor
+ */
+interface CursorResult<T> {
+  /**
+   * The query results
+   */
+  items: 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
+ */
+interface CursorData {
+  v: number;
+  indexName: string;
+  orderDirection: "asc" | "desc";
+  pageSize: number;
+  indexValues: Record<string, unknown>;
+}
+/**
+ * Decode a base64 cursor string back to a Cursor object
+ *
+ * @param cursor - The base64-encoded cursor string
+ * @returns Decoded Cursor object
+ * @throws Error if cursor is invalid or malformed
+ *
+ * @example
+ * ```ts
+ * const cursor = decodeCursor("eyJpbmRleFZhbHVlcyI6e30sImRpcmVjdGlvbiI6ImZvcndhcmQifQ==");
+ * ```
+ */
+declare function decodeCursor(cursor: string): Cursor;
+/**
+ * Create a cursor from a record and pagination metadata
+ *
+ * @param record - The database record
+ * @param indexColumns - The columns that make up the index
+ * @param metadata - Pagination metadata (index name, order direction, page size)
+ * @returns Cursor object
+ *
+ * @example
+ * ```ts
+ * const cursor = createCursorFromRecord(
+ *   { id: "abc", name: "Alice", createdAt: 123 },
+ *   [table.columns.createdAt, table.columns.id],
+ *   {
+ *     indexName: "idx_created",
+ *     orderDirection: "asc",
+ *     pageSize: 10
+ *   }
+ * );
+ * ```
+ */
+declare function createCursorFromRecord(record: Record<string, unknown>, indexColumns: AnyColumn[], metadata: {
+  indexName: string;
+  orderDirection: "asc" | "desc";
+  pageSize: number;
+}): Cursor;
+//#endregion
+export { Cursor, CursorData, CursorResult, createCursorFromRecord, decodeCursor };
+//# sourceMappingURL=cursor-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-client.d.ts","names":[],"sources":["../../src/query/cursor-client.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAiEiB,cAjEJ,MAAA,CAiEgB;EAkBZ,CAAA,OAAA;EAkED,WAAA,CAAA,IAAY,EAAA;IA+DZ,SAAA,EAAA,MAAA;IACN,cAAA,EAAA,KAAA,GAAA,MAAA;IACM,QAAA,EAAA,MAAA;IAMb,WAAA,EAlNc,MAkNd,CAAA,MAAA,EAAA,OAAA,CAAA;EAAM,CAAA;;;;;;;;;;;;;;;;qBAlLY;;;;;;;;;UAuBJ;;;;SAIR;;;;WAIE;;;;;;;;;UAUM,UAAA;;;;;eAKF;;;;;;;;;;;;;;iBA6DC,YAAA,kBAA8B;;;;;;;;;;;;;;;;;;;;;;iBA+D9B,sBAAA,SACN,uCACM;;;;IAMb"}

package/dist/query/cursor-client.js

@@ -0,0 +1,165 @@
+//#region src/query/cursor-client.ts
+/**
+* Cursor object containing all information needed for pagination
+*/
+var Cursor = class {
+	#indexName;
+	#orderDirection;
+	#pageSize;
+	#indexValues;
+	constructor(data) {
+		this.#indexName = data.indexName;
+		this.#orderDirection = data.orderDirection;
+		this.#pageSize = data.pageSize;
+		this.#indexValues = data.indexValues;
+	}
+	/**
+	* Get the index name being used for pagination
+	*/
+	get indexName() {
+		return this.#indexName;
+	}
+	/**
+	* Get the ordering direction
+	*/
+	get orderDirection() {
+		return this.#orderDirection;
+	}
+	/**
+	* Get the page size
+	*/
+	get pageSize() {
+		return this.#pageSize;
+	}
+	/**
+	* Get the cursor position values
+	*/
+	get indexValues() {
+		return this.#indexValues;
+	}
+	/**
+	* Encode cursor to an opaque base64 string (safe to send to client)
+	*/
+	encode() {
+		assertSerializableIndexValues(this.#indexValues);
+		return encodeCursorData({
+			v: 1,
+			indexName: this.#indexName,
+			orderDirection: this.#orderDirection,
+			pageSize: this.#pageSize,
+			indexValues: this.#indexValues
+		});
+	}
+};
+const getBase64Helpers = () => {
+	const { btoa, atob, TextEncoder, TextDecoder } = globalThis;
+	if (!btoa || !atob) throw new Error("Base64 helpers (btoa/atob) are not available in this environment.");
+	if (!TextEncoder || !TextDecoder) throw new Error("TextEncoder/TextDecoder are required for cursor encoding.");
+	const encodeBase64 = (input) => {
+		const bytes = new TextEncoder().encode(input);
+		let binary = "";
+		for (const byte of bytes) binary += String.fromCharCode(byte);
+		return btoa(binary);
+	};
+	const decodeBase64 = (input) => {
+		const binary = atob(input);
+		const bytes = new Uint8Array(binary.length);
+		for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
+		return new TextDecoder().decode(bytes);
+	};
+	return {
+		encodeBase64,
+		decodeBase64
+	};
+};
+/**
+* Encode cursor data to a base64 string (internal)
+*/
+function encodeCursorData(data) {
+	let json;
+	try {
+		json = JSON.stringify(data);
+	} catch (error) {
+		throw new Error(`Invalid cursor: ${error instanceof Error ? error.message : "malformed data"}`);
+	}
+	return getBase64Helpers().encodeBase64(json);
+}
+/**
+* Decode a base64 cursor string back to a Cursor object
+*
+* @param cursor - The base64-encoded cursor string
+* @returns Decoded Cursor object
+* @throws Error if cursor is invalid or malformed
+*
+* @example
+* ```ts
+* const cursor = decodeCursor("eyJpbmRleFZhbHVlcyI6e30sImRpcmVjdGlvbiI6ImZvcndhcmQifQ==");
+* ```
+*/
+function decodeCursor(cursor) {
+	try {
+		const json = getBase64Helpers().decodeBase64(cursor);
+		const data = JSON.parse(json);
+		const record = data;
+		if (!isPlainObject(data) || !isPlainObject(record["indexValues"]) || typeof record["indexName"] !== "string" || record["indexName"].length === 0 || typeof record["orderDirection"] !== "string" || record["orderDirection"] !== "asc" && record["orderDirection"] !== "desc" || typeof record["pageSize"] !== "number" || !Number.isFinite(record["pageSize"]) || !Number.isInteger(record["pageSize"]) || record["pageSize"] <= 0) throw new Error("Invalid cursor structure");
+		if (typeof record["v"] !== "number") throw new Error("Unsupported cursor version: missing. Only v1 is supported.");
+		const version = record["v"];
+		if (version !== 1) throw new Error(`Unsupported cursor version: ${version}. Only v1 is supported.`);
+		return new Cursor({
+			indexName: record["indexName"],
+			orderDirection: record["orderDirection"],
+			pageSize: record["pageSize"],
+			indexValues: record["indexValues"]
+		});
+	} catch (error) {
+		throw new Error(`Invalid cursor: ${error instanceof Error ? error.message : "malformed data"}`);
+	}
+}
+/**
+* Create a cursor from a record and pagination metadata
+*
+* @param record - The database record
+* @param indexColumns - The columns that make up the index
+* @param metadata - Pagination metadata (index name, order direction, page size)
+* @returns Cursor object
+*
+* @example
+* ```ts
+* const cursor = createCursorFromRecord(
+*   { id: "abc", name: "Alice", createdAt: 123 },
+*   [table.columns.createdAt, table.columns.id],
+*   {
+*     indexName: "idx_created",
+*     orderDirection: "asc",
+*     pageSize: 10
+*   }
+* );
+* ```
+*/
+function createCursorFromRecord(record, indexColumns, metadata) {
+	const indexValues = {};
+	for (const col of indexColumns) {
+		const value = record[col.name];
+		if (value === void 0) throw new Error(`Record is missing value for index column "${col.name}".`);
+		indexValues[col.name] = value;
+	}
+	return new Cursor({
+		indexName: metadata.indexName,
+		orderDirection: metadata.orderDirection,
+		pageSize: metadata.pageSize,
+		indexValues
+	});
+}
+const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const assertSerializableIndexValues = (values) => {
+	for (const [key, value] of Object.entries(values)) {
+		if (value === void 0) throw new Error(`Cursor index value "${key}" is undefined.`);
+		if (typeof value === "number" && !Number.isFinite(value)) throw new Error(`Cursor index value "${key}" must be a finite number.`);
+		if (typeof value === "bigint") throw new Error(`Cursor index value "${key}" must not be a BigInt.`);
+		if (typeof value === "function" || typeof value === "symbol") throw new Error(`Cursor index value "${key}" is not JSON-serializable.`);
+	}
+};
+
+//#endregion
+export { Cursor, createCursorFromRecord, decodeCursor };
+//# sourceMappingURL=cursor-client.js.map

package/dist/query/cursor-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-client.js","names":["#indexName","#orderDirection","#pageSize","#indexValues","json: string","indexValues: Record<string, unknown>"],"sources":["../../src/query/cursor-client.ts"],"sourcesContent":["import type { AnyColumn } from \"../schema/create\";\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    assertSerializableIndexValues(this.#indexValues);\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\nconst getBase64Helpers = () => {\n  const { btoa, atob, TextEncoder, TextDecoder } = globalThis;\n\n  if (!btoa || !atob) {\n    throw new Error(\"Base64 helpers (btoa/atob) are not available in this environment.\");\n  }\n\n  if (!TextEncoder || !TextDecoder) {\n    throw new Error(\"TextEncoder/TextDecoder are required for cursor encoding.\");\n  }\n\n  const encodeBase64 = (input: string): string => {\n    const bytes = new TextEncoder().encode(input);\n    let binary = \"\";\n    for (const byte of bytes) {\n      binary += String.fromCharCode(byte);\n    }\n    return btoa(binary);\n  };\n\n  const decodeBase64 = (input: string): string => {\n    const binary = atob(input);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i += 1) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return new TextDecoder().decode(bytes);\n  };\n\n  return { encodeBase64, decodeBase64 };\n};\n\n/**\n * Encode cursor data to a base64 string (internal)\n */\nfunction encodeCursorData(data: CursorData): string {\n  let json: string;\n  try {\n    json = JSON.stringify(data);\n  } catch (error) {\n    throw new Error(`Invalid cursor: ${error instanceof Error ? error.message : \"malformed data\"}`);\n  }\n\n  return getBase64Helpers().encodeBase64(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    const json = getBase64Helpers().decodeBase64(cursor);\n    const data = JSON.parse(json);\n    const record = data as Record<string, unknown>;\n\n    // Validate structure\n    if (\n      !isPlainObject(data) ||\n      !isPlainObject(record[\"indexValues\"]) ||\n      typeof record[\"indexName\"] !== \"string\" ||\n      record[\"indexName\"].length === 0 ||\n      typeof record[\"orderDirection\"] !== \"string\" ||\n      (record[\"orderDirection\"] !== \"asc\" && record[\"orderDirection\"] !== \"desc\") ||\n      typeof record[\"pageSize\"] !== \"number\" ||\n      !Number.isFinite(record[\"pageSize\"]) ||\n      !Number.isInteger(record[\"pageSize\"]) ||\n      record[\"pageSize\"] <= 0\n    ) {\n      throw new Error(\"Invalid cursor structure\");\n    }\n\n    // Only support v1\n    if (typeof record[\"v\"] !== \"number\") {\n      throw new Error(\"Unsupported cursor version: missing. Only v1 is supported.\");\n    }\n    const version = record[\"v\"];\n    if (version !== 1) {\n      throw new Error(`Unsupported cursor version: ${version}. Only v1 is supported.`);\n    }\n\n    return new Cursor({\n      indexName: record[\"indexName\"],\n      orderDirection: record[\"orderDirection\"],\n      pageSize: record[\"pageSize\"],\n      indexValues: record[\"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    const value = record[col.name];\n    if (value === undefined) {\n      throw new Error(`Record is missing value for index column \"${col.name}\".`);\n    }\n    indexValues[col.name] = value;\n  }\n\n  return new Cursor({\n    indexName: metadata.indexName,\n    orderDirection: metadata.orderDirection,\n    pageSize: metadata.pageSize,\n    indexValues,\n  });\n}\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst assertSerializableIndexValues = (values: Record<string, unknown>): void => {\n  for (const [key, value] of Object.entries(values)) {\n    if (value === undefined) {\n      throw new Error(`Cursor index value \"${key}\" is undefined.`);\n    }\n    if (typeof value === \"number\" && !Number.isFinite(value)) {\n      throw new Error(`Cursor index value \"${key}\" must be a finite number.`);\n    }\n    if (typeof value === \"bigint\") {\n      throw new Error(`Cursor index value \"${key}\" must not be a BigInt.`);\n    }\n    if (typeof value === \"function\" || typeof value === \"symbol\") {\n      throw new Error(`Cursor index value \"${key}\" is not JSON-serializable.`);\n    }\n  }\n};\n"],"mappings":";;;;AAKA,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;AACf,gCAA8B,MAAKA,YAAa;AAQhD,SAAO,iBAPkB;GACvB,GAAG;GACH,WAAW,MAAKH;GAChB,gBAAgB,MAAKC;GACrB,UAAU,MAAKC;GACf,aAAa,MAAKC;GACnB,CAC4B;;;AAiCjC,MAAM,yBAAyB;CAC7B,MAAM,EAAE,MAAM,MAAM,aAAa,gBAAgB;AAEjD,KAAI,CAAC,QAAQ,CAAC,KACZ,OAAM,IAAI,MAAM,oEAAoE;AAGtF,KAAI,CAAC,eAAe,CAAC,YACnB,OAAM,IAAI,MAAM,4DAA4D;CAG9E,MAAM,gBAAgB,UAA0B;EAC9C,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,MAAM;EAC7C,IAAI,SAAS;AACb,OAAK,MAAM,QAAQ,MACjB,WAAU,OAAO,aAAa,KAAK;AAErC,SAAO,KAAK,OAAO;;CAGrB,MAAM,gBAAgB,UAA0B;EAC9C,MAAM,SAAS,KAAK,MAAM;EAC1B,MAAM,QAAQ,IAAI,WAAW,OAAO,OAAO;AAC3C,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,EACtC,OAAM,KAAK,OAAO,WAAW,EAAE;AAEjC,SAAO,IAAI,aAAa,CAAC,OAAO,MAAM;;AAGxC,QAAO;EAAE;EAAc;EAAc;;;;;AAMvC,SAAS,iBAAiB,MAA0B;CAClD,IAAIC;AACJ,KAAI;AACF,SAAO,KAAK,UAAU,KAAK;UACpB,OAAO;AACd,QAAM,IAAI,MAAM,mBAAmB,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB;;AAGjG,QAAO,kBAAkB,CAAC,aAAa,KAAK;;;;;;;;;;;;;;AAe9C,SAAgB,aAAa,QAAwB;AACnD,KAAI;EACF,MAAM,OAAO,kBAAkB,CAAC,aAAa,OAAO;EACpD,MAAM,OAAO,KAAK,MAAM,KAAK;EAC7B,MAAM,SAAS;AAGf,MACE,CAAC,cAAc,KAAK,IACpB,CAAC,cAAc,OAAO,eAAe,IACrC,OAAO,OAAO,iBAAiB,YAC/B,OAAO,aAAa,WAAW,KAC/B,OAAO,OAAO,sBAAsB,YACnC,OAAO,sBAAsB,SAAS,OAAO,sBAAsB,UACpE,OAAO,OAAO,gBAAgB,YAC9B,CAAC,OAAO,SAAS,OAAO,YAAY,IACpC,CAAC,OAAO,UAAU,OAAO,YAAY,IACrC,OAAO,eAAe,EAEtB,OAAM,IAAI,MAAM,2BAA2B;AAI7C,MAAI,OAAO,OAAO,SAAS,SACzB,OAAM,IAAI,MAAM,6DAA6D;EAE/E,MAAM,UAAU,OAAO;AACvB,MAAI,YAAY,EACd,OAAM,IAAI,MAAM,+BAA+B,QAAQ,yBAAyB;AAGlF,SAAO,IAAI,OAAO;GAChB,WAAW,OAAO;GAClB,gBAAgB,OAAO;GACvB,UAAU,OAAO;GACjB,aAAa,OAAO;GACrB,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,cAAc;EAC9B,MAAM,QAAQ,OAAO,IAAI;AACzB,MAAI,UAAU,OACZ,OAAM,IAAI,MAAM,6CAA6C,IAAI,KAAK,IAAI;AAE5E,cAAY,IAAI,QAAQ;;AAG1B,QAAO,IAAI,OAAO;EAChB,WAAW,SAAS;EACpB,gBAAgB,SAAS;EACzB,UAAU,SAAS;EACnB;EACD,CAAC;;AAGJ,MAAM,iBAAiB,UACrB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;AAEtE,MAAM,iCAAiC,WAA0C;AAC/E,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,EAAE;AACjD,MAAI,UAAU,OACZ,OAAM,IAAI,MAAM,uBAAuB,IAAI,iBAAiB;AAE9D,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,MAAM,CACtD,OAAM,IAAI,MAAM,uBAAuB,IAAI,4BAA4B;AAEzE,MAAI,OAAO,UAAU,SACnB,OAAM,IAAI,MAAM,uBAAuB,IAAI,yBAAyB;AAEtE,MAAI,OAAO,UAAU,cAAc,OAAO,UAAU,SAClD,OAAM,IAAI,MAAM,uBAAuB,IAAI,6BAA6B"}

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

@@ -1 +1 @@
-{"version":3,"file":"cursor.d.ts","names":[],"sources":["../../src/query/cursor.ts"],"sourcesContent":[],"mappings":";;;;;;;;AASA;AAiEiB,cAjEJ,MAAA,CAiEgB;EAkBZ,CAAA,OAAA;EAqCD,WAAA,CAAA,IAAY,EAAA;IAoEZ,SAAA,EAAA,MAAA;IACN,cAAA,EAAA,KAAA,GAAA,MAAA;IACM,QAAA,EAAA,MAAA;IAMb,WAAA,EA1Lc,MA0Ld,CAAA,MAAA,EAAA,OAAA,CAAA;EAAM,CAAA;EA4CO;;;EAGA,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EACM;;;;;;;;;;;qBA1MD;;;;;;;;;UAuBJ;;;;SAIR;;;;WAIE;;;;;;;;;UAUM,UAAA;;;;;eAKF;;;;;;;;;;;;;;iBAgCC,YAAA,kBAA8B;;;;;;;;;;;;;;;;;;;;;;iBAoE9B,sBAAA,SACN,uCACM;;;;IAMb;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4Ca,qBAAA,SACN,sBACM,2BACA,kCACM,oBACnB"}
+{"version":3,"file":"cursor.d.ts","names":[],"sources":["../../src/query/cursor.ts"],"sourcesContent":[],"mappings":";;;;;;;;AASA;AAiEiB,cAjEJ,MAAA,CAiEgB;EAkBZ,CAAA,OAAA;EAqCD,WAAA,CAAA,IAAY,EAAA;IAoEZ,SAAA,EAAA,MAAA;IACN,cAAA,EAAA,KAAA,GAAA,MAAA;IACM,QAAA,EAAA,MAAA;IAMb,WAAA,EA1Lc,MA0Ld,CAAA,MAAA,EAAA,OAAA,CAAA;EAAM,CAAA;EA+CO;;;EAGA,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EACM;;;;;;;;;;;qBA7MD;;;;;;;;;UAuBJ;;;;SAIR;;;;WAIE;;;;;;;;;UAUM,UAAA;;;;;eAKF;;;;;;;;;;;;;;iBAgCC,YAAA,kBAA8B;;;;;;;;;;;;;;;;;;;;;;iBAoE9B,sBAAA,SACN,uCACM;;;;IAMb;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+Ca,qBAAA,SACN,sBACM,2BACA,kCACM,oBACnB"}

package/dist/query/cursor.js

@@ -126,7 +126,8 @@ function createCursorFromRecord(record, indexColumns, metadata) {
 	for (const col of indexColumns) {
 		const value = record[col.name];
 		if (value === void 0) throw new Error(`Record is missing value for index column "${col.name}".`);
-		indexValues[col.name] = value;
+		const resolved = resolveFragnoIdValue(value, col);
+		indexValues[col.name] = typeof resolved === "bigint" ? resolved.toString() : resolved;
 	}
 	return new Cursor({
 		indexName: metadata.indexName,
@@ -170,6 +171,11 @@ function serializeCursorValues(cursor, indexColumns, driverConfig, sqliteStorage
 			missingColumns.push(col.name);
 			continue;
 		}
+		const resolvedDirect = resolveFragnoIdValue(value, col);
+		if (resolvedDirect !== value) {
+			serialized[col.name] = serializer.serialize(resolvedDirect, col);
+			continue;
+		}
 		const resolved = resolveFragnoIdValue(serializer.deserialize(value, col), col);
 		serialized[col.name] = serializer.serialize(resolved, col);
 	}

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>","missingColumns: string[]"],"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\";\nimport type { SQLiteStorageMode } from \"../adapters/generic-sql/sqlite-storage\";\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    assertSerializableIndexValues(this.#indexValues);\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  let json: string;\n  try {\n    json = JSON.stringify(data);\n  } catch (error) {\n    throw new Error(`Invalid cursor: ${error instanceof Error ? error.message : \"malformed data\"}`);\n  }\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    const record = data as Record<string, unknown>;\n\n    // Validate structure\n    if (\n      !isPlainObject(data) ||\n      !isPlainObject(record[\"indexValues\"]) ||\n      typeof record[\"indexName\"] !== \"string\" ||\n      record[\"indexName\"].length === 0 ||\n      typeof record[\"orderDirection\"] !== \"string\" ||\n      (record[\"orderDirection\"] !== \"asc\" && record[\"orderDirection\"] !== \"desc\") ||\n      typeof record[\"pageSize\"] !== \"number\" ||\n      !Number.isFinite(record[\"pageSize\"]) ||\n      !Number.isInteger(record[\"pageSize\"]) ||\n      record[\"pageSize\"] <= 0\n    ) {\n      throw new Error(\"Invalid cursor structure\");\n    }\n\n    // Only support v1\n    if (typeof record[\"v\"] !== \"number\") {\n      throw new Error(\"Unsupported cursor version: missing. Only v1 is supported.\");\n    }\n    const version = record[\"v\"];\n    if (version !== 1) {\n      throw new Error(`Unsupported cursor version: ${version}. Only v1 is supported.`);\n    }\n\n    return new Cursor({\n      indexName: record[\"indexName\"],\n      orderDirection: record[\"orderDirection\"],\n      pageSize: record[\"pageSize\"],\n      indexValues: record[\"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    const value = record[col.name];\n    if (value === undefined) {\n      throw new Error(`Record is missing value for index column \"${col.name}\".`);\n    }\n    indexValues[col.name] = value;\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 * @param sqliteStorageMode - Optional SQLite storage mode override\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  sqliteStorageMode?: SQLiteStorageMode,\n): Record<string, unknown> {\n  const serializer = createSQLSerializer(driverConfig, sqliteStorageMode);\n  const serialized: Record<string, unknown> = {};\n  const missingColumns: string[] = [];\n\n  for (const col of indexColumns) {\n    const value = cursor.indexValues[col.name];\n    if (value === undefined) {\n      missingColumns.push(col.name);\n      continue;\n    }\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.name] = serializer.serialize(resolved, col);\n  }\n\n  if (missingColumns.length > 0) {\n    const suffix = cursor.indexName ? ` for index \"${cursor.indexName}\"` : \"\";\n    const columns = missingColumns.map((name) => `\"${name}\"`).join(\", \");\n    const plural = missingColumns.length === 1 ? \"\" : \"s\";\n    throw new Error(`Cursor is missing values for index column${plural} ${columns}${suffix}.`);\n  }\n\n  return serialized;\n}\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst assertSerializableIndexValues = (values: Record<string, unknown>): void => {\n  for (const [key, value] of Object.entries(values)) {\n    if (value === undefined) {\n      throw new Error(`Cursor index value \"${key}\" is undefined.`);\n    }\n    if (typeof value === \"number\" && !Number.isFinite(value)) {\n      throw new Error(`Cursor index value \"${key}\" must be a finite number.`);\n    }\n    if (typeof value === \"bigint\") {\n      throw new Error(`Cursor index value \"${key}\" must not be a BigInt.`);\n    }\n    if (typeof value === \"function\" || typeof value === \"symbol\") {\n      throw new Error(`Cursor index value \"${key}\" is not JSON-serializable.`);\n    }\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"cursor.js","names":["#indexName","#orderDirection","#pageSize","#indexValues","json: string","indexValues: Record<string, unknown>","serialized: Record<string, unknown>","missingColumns: string[]"],"sources":["../../src/query/cursor.ts"],"sourcesContent":["import type { DriverConfig } from \"../adapters/generic-sql/driver-config\";\nimport type { SQLiteStorageMode } from \"../adapters/generic-sql/sqlite-storage\";\nimport type { AnyColumn } from \"../schema/create\";\nimport { createSQLSerializer } from \"./serialize/create-sql-serializer\";\nimport { resolveFragnoIdValue } from \"./value-encoding\";\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    assertSerializableIndexValues(this.#indexValues);\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  let json: string;\n  try {\n    json = JSON.stringify(data);\n  } catch (error) {\n    throw new Error(`Invalid cursor: ${error instanceof Error ? error.message : \"malformed data\"}`);\n  }\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    const record = data as Record<string, unknown>;\n\n    // Validate structure\n    if (\n      !isPlainObject(data) ||\n      !isPlainObject(record[\"indexValues\"]) ||\n      typeof record[\"indexName\"] !== \"string\" ||\n      record[\"indexName\"].length === 0 ||\n      typeof record[\"orderDirection\"] !== \"string\" ||\n      (record[\"orderDirection\"] !== \"asc\" && record[\"orderDirection\"] !== \"desc\") ||\n      typeof record[\"pageSize\"] !== \"number\" ||\n      !Number.isFinite(record[\"pageSize\"]) ||\n      !Number.isInteger(record[\"pageSize\"]) ||\n      record[\"pageSize\"] <= 0\n    ) {\n      throw new Error(\"Invalid cursor structure\");\n    }\n\n    // Only support v1\n    if (typeof record[\"v\"] !== \"number\") {\n      throw new Error(\"Unsupported cursor version: missing. Only v1 is supported.\");\n    }\n    const version = record[\"v\"];\n    if (version !== 1) {\n      throw new Error(`Unsupported cursor version: ${version}. Only v1 is supported.`);\n    }\n\n    return new Cursor({\n      indexName: record[\"indexName\"],\n      orderDirection: record[\"orderDirection\"],\n      pageSize: record[\"pageSize\"],\n      indexValues: record[\"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    const value = record[col.name];\n    if (value === undefined) {\n      throw new Error(`Record is missing value for index column \"${col.name}\".`);\n    }\n    // Resolve FragnoId/FragnoReference to primitive values for cursor serialization.\n    const resolved = resolveFragnoIdValue(value, col);\n    // BigInt values are not JSON-serializable, so store them as strings.\n    indexValues[col.name] = typeof resolved === \"bigint\" ? resolved.toString() : resolved;\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 * @param sqliteStorageMode - Optional SQLite storage mode override\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  sqliteStorageMode?: SQLiteStorageMode,\n): Record<string, unknown> {\n  const serializer = createSQLSerializer(driverConfig, sqliteStorageMode);\n  const serialized: Record<string, unknown> = {};\n  const missingColumns: string[] = [];\n\n  for (const col of indexColumns) {\n    const value = cursor.indexValues[col.name];\n    if (value === undefined) {\n      missingColumns.push(col.name);\n      continue;\n    }\n\n    // If the cursor value is already a FragnoId/FragnoReference, resolve it directly\n    // to avoid deserializing non-JSON objects.\n    const resolvedDirect = resolveFragnoIdValue(value, col);\n    if (resolvedDirect !== value) {\n      serialized[col.name] = serializer.serialize(resolvedDirect, col);\n      continue;\n    }\n\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.name] = serializer.serialize(resolved, col);\n  }\n\n  if (missingColumns.length > 0) {\n    const suffix = cursor.indexName ? ` for index \"${cursor.indexName}\"` : \"\";\n    const columns = missingColumns.map((name) => `\"${name}\"`).join(\", \");\n    const plural = missingColumns.length === 1 ? \"\" : \"s\";\n    throw new Error(`Cursor is missing values for index column${plural} ${columns}${suffix}.`);\n  }\n\n  return serialized;\n}\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst assertSerializableIndexValues = (values: Record<string, unknown>): void => {\n  for (const [key, value] of Object.entries(values)) {\n    if (value === undefined) {\n      throw new Error(`Cursor index value \"${key}\" is undefined.`);\n    }\n    if (typeof value === \"number\" && !Number.isFinite(value)) {\n      throw new Error(`Cursor index value \"${key}\" must be a finite number.`);\n    }\n    if (typeof value === \"bigint\") {\n      throw new Error(`Cursor index value \"${key}\" must not be a BigInt.`);\n    }\n    if (typeof value === \"function\" || typeof value === \"symbol\") {\n      throw new Error(`Cursor index value \"${key}\" is not JSON-serializable.`);\n    }\n  }\n};\n"],"mappings":"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"}

package/dist/query/db-now.d.ts

@@ -1,8 +1,22 @@
 //#region src/query/db-now.d.ts
+type DbInterval = {
+  tag: "db-interval";
+  ms: number;
+};
+type DbIntervalInput = number | {
+  ms?: number;
+  seconds?: number;
+  minutes?: number;
+  hours?: number;
+  days?: number;
+};
 type DbNow = {
   tag: "db-now";
+  offsetMs?: number;
+  plus: (interval: DbInterval | DbIntervalInput) => DbNow;
 };
 declare const dbNow: () => DbNow;
+declare const dbInterval: (input: DbIntervalInput) => DbInterval;
 //#endregion
-export { DbNow, dbNow };
+export { DbInterval, DbIntervalInput, DbNow, dbInterval, dbNow };
 //# sourceMappingURL=db-now.d.ts.map

package/dist/query/db-now.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-now.d.ts","names":[],"sources":["../../src/query/db-now.ts"],"sourcesContent":[],"mappings":";KAAY,KAAA;EAAA,GAAA,EAAA,QAAK;AAEjB,CAAA;cAAa,aAAY"}
+{"version":3,"file":"db-now.d.ts","names":[],"sources":["../../src/query/db-now.ts"],"sourcesContent":[],"mappings":";KAAY,UAAA;EAAA,GAAA,EAAA,aAAU;EAEV,EAAA,EAAA,MAAA;AAUZ,CAAA;AAGmB,KAbP,eAAA,GAaO,MAAA,GAAA;EAAa,EAAA,CAAA,EAAA,MAAA;EAAoB,OAAA,CAAA,EAAA,MAAA;EAAK,OAAA,CAAA,EAAA,MAAA;EA2C5C,KAAA,CAAA,EAAmC,MAAA;EAQnC,IAAA,CAAA,EAAA,MAGX;;KAzDU,KAAA;;;mBAGO,aAAa,oBAAoB;;cA2CvC,aAAY;cAQZ,oBAAqB,oBAAkB"}

package/dist/query/db-now.js

@@ -1,7 +1,35 @@
 //#region src/query/db-now.ts
-const dbNow = () => ({ tag: "db-now" });
+const toIntervalMs = (input) => {
+	if (typeof input === "number") {
+		if (!Number.isFinite(input)) throw new Error("DB_INTERVAL_INVALID");
+		return input;
+	}
+	if (typeof input === "object" && input !== null && "tag" in input) {
+		const tagged = input;
+		if (tagged.tag === "db-interval") {
+			if (!Number.isFinite(tagged.ms)) throw new Error("DB_INTERVAL_INVALID");
+			return tagged.ms;
+		}
+		throw new Error("DB_INTERVAL_INVALID");
+	}
+	const interval = input;
+	const totalMs = (interval.ms ?? 0) + (interval.seconds ?? 0) * 1e3 + (interval.minutes ?? 0) * 6e4 + (interval.hours ?? 0) * 36e5 + (interval.days ?? 0) * 864e5;
+	if (!Number.isFinite(totalMs)) throw new Error("DB_INTERVAL_INVALID");
+	return totalMs;
+};
+const createDbNow = (offsetMs = 0) => ({
+	tag: "db-now",
+	offsetMs,
+	plus: (interval) => createDbNow(offsetMs + toIntervalMs(interval))
+});
+const dbNow = () => createDbNow(0);
 const isDbNow = (value) => typeof value === "object" && value !== null && value.tag === "db-now";
+const getDbNowOffsetMs = (value) => typeof value.offsetMs === "number" ? value.offsetMs : 0;
+const dbInterval = (input) => ({
+	tag: "db-interval",
+	ms: toIntervalMs(input)
+});
 
 //#endregion
-export { dbNow, isDbNow };
+export { dbInterval, dbNow, getDbNowOffsetMs, isDbNow };
 //# sourceMappingURL=db-now.js.map

package/dist/query/db-now.js.map

@@ -1 +1 @@
-{"version":3,"file":"db-now.js","names":[],"sources":["../../src/query/db-now.ts"],"sourcesContent":["export type DbNow = { tag: \"db-now\" };\n\nexport const dbNow = (): DbNow => ({ tag: \"db-now\" });\n\nexport const isDbNow = (value: unknown): value is DbNow =>\n  typeof value === \"object\" && value !== null && (value as { tag?: string }).tag === \"db-now\";\n"],"mappings":";AAEA,MAAa,eAAsB,EAAE,KAAK,UAAU;AAEpD,MAAa,WAAW,UACtB,OAAO,UAAU,YAAY,UAAU,QAAS,MAA2B,QAAQ"}
+{"version":3,"file":"db-now.js","names":[],"sources":["../../src/query/db-now.ts"],"sourcesContent":["export type DbInterval = { tag: \"db-interval\"; ms: number };\n\nexport type DbIntervalInput =\n  | number\n  | {\n      ms?: number;\n      seconds?: number;\n      minutes?: number;\n      hours?: number;\n      days?: number;\n    };\n\nexport type DbNow = {\n  tag: \"db-now\";\n  offsetMs?: number;\n  plus: (interval: DbInterval | DbIntervalInput) => DbNow;\n};\n\nconst toIntervalMs = (input: DbInterval | DbIntervalInput): number => {\n  if (typeof input === \"number\") {\n    if (!Number.isFinite(input)) {\n      throw new Error(\"DB_INTERVAL_INVALID\");\n    }\n    return input;\n  }\n\n  if (typeof input === \"object\" && input !== null && \"tag\" in input) {\n    const tagged = input as DbInterval;\n    if (tagged.tag === \"db-interval\") {\n      if (!Number.isFinite(tagged.ms)) {\n        throw new Error(\"DB_INTERVAL_INVALID\");\n      }\n      return tagged.ms;\n    }\n    throw new Error(\"DB_INTERVAL_INVALID\");\n  }\n\n  const interval = input as Exclude<DbIntervalInput, number>;\n  const totalMs =\n    (interval.ms ?? 0) +\n    (interval.seconds ?? 0) * 1000 +\n    (interval.minutes ?? 0) * 60_000 +\n    (interval.hours ?? 0) * 3_600_000 +\n    (interval.days ?? 0) * 86_400_000;\n\n  if (!Number.isFinite(totalMs)) {\n    throw new Error(\"DB_INTERVAL_INVALID\");\n  }\n\n  return totalMs;\n};\n\nconst createDbNow = (offsetMs = 0): DbNow => ({\n  tag: \"db-now\",\n  offsetMs,\n  plus: (interval) => createDbNow(offsetMs + toIntervalMs(interval)),\n});\n\nexport const dbNow = (): DbNow => createDbNow(0);\n\nexport const isDbNow = (value: unknown): value is DbNow =>\n  typeof value === \"object\" && value !== null && (value as { tag?: string }).tag === \"db-now\";\n\nexport const getDbNowOffsetMs = (value: DbNow): number =>\n  typeof value.offsetMs === \"number\" ? value.offsetMs : 0;\n\nexport const dbInterval = (input: DbIntervalInput): DbInterval => ({\n  tag: \"db-interval\",\n  ms: toIntervalMs(input),\n});\n\nexport const isDbInterval = (value: unknown): value is DbInterval =>\n  typeof value === \"object\" && value !== null && (value as { tag?: string }).tag === \"db-interval\";\n"],"mappings":";AAkBA,MAAM,gBAAgB,UAAgD;AACpE,KAAI,OAAO,UAAU,UAAU;AAC7B,MAAI,CAAC,OAAO,SAAS,MAAM,CACzB,OAAM,IAAI,MAAM,sBAAsB;AAExC,SAAO;;AAGT,KAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,SAAS,OAAO;EACjE,MAAM,SAAS;AACf,MAAI,OAAO,QAAQ,eAAe;AAChC,OAAI,CAAC,OAAO,SAAS,OAAO,GAAG,CAC7B,OAAM,IAAI,MAAM,sBAAsB;AAExC,UAAO,OAAO;;AAEhB,QAAM,IAAI,MAAM,sBAAsB;;CAGxC,MAAM,WAAW;CACjB,MAAM,WACH,SAAS,MAAM,MACf,SAAS,WAAW,KAAK,OACzB,SAAS,WAAW,KAAK,OACzB,SAAS,SAAS,KAAK,QACvB,SAAS,QAAQ,KAAK;AAEzB,KAAI,CAAC,OAAO,SAAS,QAAQ,CAC3B,OAAM,IAAI,MAAM,sBAAsB;AAGxC,QAAO;;AAGT,MAAM,eAAe,WAAW,OAAc;CAC5C,KAAK;CACL;CACA,OAAO,aAAa,YAAY,WAAW,aAAa,SAAS,CAAC;CACnE;AAED,MAAa,cAAqB,YAAY,EAAE;AAEhD,MAAa,WAAW,UACtB,OAAO,UAAU,YAAY,UAAU,QAAS,MAA2B,QAAQ;AAErF,MAAa,oBAAoB,UAC/B,OAAO,MAAM,aAAa,WAAW,MAAM,WAAW;AAExD,MAAa,cAAc,WAAwC;CACjE,KAAK;CACL,IAAI,aAAa,MAAM;CACxB"}

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 \"../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"}
+{"version":3,"file":"orm.js","names":["compiled: CompiledJoin[]","builder: Record<string, unknown>"],"sources":["../../../src/query/orm/orm.ts"],"sourcesContent":["import type { AnyColumn, AnyRelation, AnyTable } from \"../../schema/create\";\nimport { buildCondition, type Condition } from \"../condition-builder\";\nimport type {\n  AnySelectClause,\n  FindFirstOptions,\n  FindManyOptions,\n  JoinBuilder,\n  OrderBy,\n} from \"../simple-query-interface\";\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

@@ -1,7 +1,7 @@
 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";
+import { PostgreSQLSerializer } from "./dialect/postgres-serializer.js";
+import { SQLiteSerializer } from "./dialect/sqlite-serializer.js";
 
 //#region src/query/serialize/create-sql-serializer.ts
 /**

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

@@ -1 +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 type { SQLiteStorageMode } from \"../../adapters/generic-sql/sqlite-storage\";\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 * @param sqliteStorageMode - Optional SQLite storage mode override\n * @returns Dialect-specific SQLSerializer instance\n */\nexport function createSQLSerializer(\n  driverConfig: DriverConfig,\n  sqliteStorageMode?: SQLiteStorageMode,\n): 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, sqliteStorageMode);\n    default: {\n      const exhaustiveCheck: never = driverConfig.databaseType;\n      throw new Error(`Unsupported database type: ${exhaustiveCheck}`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAoBA,SAAgB,oBACd,cACA,mBACe;AAGf,SAAQ,aAAa,cAArB;EACE,KAAK,aACH,QAAO,IAAI,qBAAqB,aAAa;EAC/C,KAAK,QACH,QAAO,IAAI,gBAAgB,aAAa;EAC1C,KAAK,SACH,QAAO,IAAI,iBAAiB,cAAc,kBAAkB;EAC9D,SAAS;GACP,MAAMA,kBAAyB,aAAa;AAC5C,SAAM,IAAI,MAAM,8BAA8B,kBAAkB"}
+{"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 type { SQLiteStorageMode } from \"../../adapters/generic-sql/sqlite-storage\";\nimport { MySQLSerializer } from \"./dialect/mysql-serializer\";\nimport { PostgreSQLSerializer } from \"./dialect/postgres-serializer\";\nimport { SQLiteSerializer } from \"./dialect/sqlite-serializer\";\nimport { SQLSerializer } from \"./sql-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 * @param sqliteStorageMode - Optional SQLite storage mode override\n * @returns Dialect-specific SQLSerializer instance\n */\nexport function createSQLSerializer(\n  driverConfig: DriverConfig,\n  sqliteStorageMode?: SQLiteStorageMode,\n): 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, sqliteStorageMode);\n    default: {\n      const exhaustiveCheck: never = driverConfig.databaseType;\n      throw new Error(`Unsupported database type: ${exhaustiveCheck}`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAoBA,SAAgB,oBACd,cACA,mBACe;AAGf,SAAQ,aAAa,cAArB;EACE,KAAK,aACH,QAAO,IAAI,qBAAqB,aAAa;EAC/C,KAAK,QACH,QAAO,IAAI,gBAAgB,aAAa;EAC1C,KAAK,SACH,QAAO,IAAI,iBAAiB,cAAc,kBAAkB;EAC9D,SAAS;GACP,MAAMA,kBAAyB,aAAa;AAC5C,SAAM,IAAI,MAAM,8BAA8B,kBAAkB"}

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

@@ -1 +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, _col: AnyColumn): Date {\n    void _col;\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, _col: AnyColumn): Date {\n    void _col;\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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize integer from invalid number: ${value}`);\n      }\n      return value;\n    }\n    // MySQL may return integers as strings\n    if (typeof value === \"string\") {\n      const num = Number(value);\n      if (Number.isNaN(num) || !Number.isFinite(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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize decimal from invalid number: ${value}`);\n      }\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const num = parseFloat(value);\n      if (Number.isNaN(num) || !Number.isFinite(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,OAAa,MAAuB;AAG1D,SAAO;;CAGT,AAAU,iBAAiB,OAAyB;AAElD,SAAO;;CAGT,AAAU,gBAAgB,OAAe,MAAyB;AAEhE,SAAO;;CAGT,AAAU,gBAAgB,OAAgB,MAAuB;AAE/D,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAGT,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,OAAO,MAAM;AACzB,OAAI,OAAO,MAAM,IAAI,IAAI,CAAC,OAAO,SAAS,IAAI,CAC5C,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAET,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,WAAW,MAAM;AAC7B,OAAI,OAAO,MAAM,IAAI,IAAI,CAAC,OAAO,SAAS,IAAI,CAC5C,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"}
+{"version":3,"file":"mysql-serializer.js","names":[],"sources":["../../../../src/query/serialize/dialect/mysql-serializer.ts"],"sourcesContent":["import type { DriverConfig } from \"../../../adapters/generic-sql/driver-config\";\nimport type { AnyColumn } from \"../../../schema/create\";\nimport { SQLSerializer } from \"../sql-serializer\";\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, _col: AnyColumn): Date {\n    void _col;\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, _col: AnyColumn): Date {\n    void _col;\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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize integer from invalid number: ${value}`);\n      }\n      return value;\n    }\n    // MySQL may return integers as strings\n    if (typeof value === \"string\") {\n      const num = Number(value);\n      if (Number.isNaN(num) || !Number.isFinite(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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize decimal from invalid number: ${value}`);\n      }\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const num = parseFloat(value);\n      if (Number.isNaN(num) || !Number.isFinite(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,OAAa,MAAuB;AAG1D,SAAO;;CAGT,AAAU,iBAAiB,OAAyB;AAElD,SAAO;;CAGT,AAAU,gBAAgB,OAAe,MAAyB;AAEhE,SAAO;;CAGT,AAAU,gBAAgB,OAAgB,MAAuB;AAE/D,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAGT,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,OAAO,MAAM;AACzB,OAAI,OAAO,MAAM,IAAI,IAAI,CAAC,OAAO,SAAS,IAAI,CAC5C,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAET,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,WAAW,MAAM;AAC7B,OAAI,OAAO,MAAM,IAAI,IAAI,CAAC,OAAO,SAAS,IAAI,CAC5C,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.map

@@ -1 +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, _col: AnyColumn): Date {\n    void _col;\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, _col: AnyColumn): Date {\n    void _col;\n    if (value instanceof Date) {\n      if (this.driverConfig.driverType === \"pglite\") {\n        return new Date(value.getTime() - value.getTimezoneOffset() * 60_000);\n      }\n      return value;\n    }\n    // PostgreSQL returns timestamps/dates as strings\n    if (typeof value === \"string\") {\n      // Normalize timezone-less timestamps to UTC to avoid local offset drift.\n      return new Date(normalizeTimestampString(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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize integer from invalid number: ${value}`);\n      }\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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize decimal from invalid number: ${value}`);\n      }\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const num = parseFloat(value);\n      if (Number.isNaN(num) || !Number.isFinite(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\nconst normalizeTimestampString = (value: string) => {\n  if (!hasTimeComponent(value) || !isTimestampWithoutTimezone(value)) {\n    return value;\n  }\n  const withTimeSeparator = value.includes(\" \") ? value.replace(\" \", \"T\") : value;\n  return `${withTimeSeparator}Z`;\n};\n\nconst hasTimeComponent = (value: string) => /\\d{2}:\\d{2}:\\d{2}/.test(value);\n\nconst isTimestampWithoutTimezone = (value: string) => {\n  // Detect RFC3339-like timezone indicators: Z or +/-HH(:MM)?\n  if (value.endsWith(\"Z\")) {\n    return false;\n  }\n  return !/[+-]\\d{2}(:?\\d{2})?$/.test(value);\n};\n"],"mappings":";;;;;;;;;;;;;;AAeA,IAAa,uBAAb,cAA0C,cAAc;CACtD,YAAY,cAA4B;AACtC,QAAM,aAAa;;CAGrB,AAAU,cAAc,OAAa,MAAuB;AAG1D,SAAO;;CAGT,AAAU,iBAAiB,OAAyB;AAElD,SAAO;;CAGT,AAAU,gBAAgB,OAAe,MAAyB;AAEhE,SAAO;;CAGT,AAAU,gBAAgB,OAAgB,MAAuB;AAE/D,MAAI,iBAAiB,MAAM;AACzB,OAAI,KAAK,aAAa,eAAe,SACnC,wBAAO,IAAI,KAAK,MAAM,SAAS,GAAG,MAAM,mBAAmB,GAAG,IAAO;AAEvE,UAAO;;AAGT,MAAI,OAAO,UAAU,SAEnB,QAAO,IAAI,KAAK,yBAAyB,MAAM,CAAC;AAElD,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAET,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,WAAW,MAAM;AAC7B,OAAI,OAAO,MAAM,IAAI,IAAI,CAAC,OAAO,SAAS,IAAI,CAC5C,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;;;AAI5E,MAAM,4BAA4B,UAAkB;AAClD,KAAI,CAAC,iBAAiB,MAAM,IAAI,CAAC,2BAA2B,MAAM,CAChE,QAAO;AAGT,QAAO,GADmB,MAAM,SAAS,IAAI,GAAG,MAAM,QAAQ,KAAK,IAAI,GAAG,MAC9C;;AAG9B,MAAM,oBAAoB,UAAkB,oBAAoB,KAAK,MAAM;AAE3E,MAAM,8BAA8B,UAAkB;AAEpD,KAAI,MAAM,SAAS,IAAI,CACrB,QAAO;AAET,QAAO,CAAC,uBAAuB,KAAK,MAAM"}
+{"version":3,"file":"postgres-serializer.js","names":[],"sources":["../../../../src/query/serialize/dialect/postgres-serializer.ts"],"sourcesContent":["import type { DriverConfig } from \"../../../adapters/generic-sql/driver-config\";\nimport type { AnyColumn } from \"../../../schema/create\";\nimport { SQLSerializer } from \"../sql-serializer\";\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, _col: AnyColumn): Date {\n    void _col;\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, _col: AnyColumn): Date {\n    void _col;\n    if (value instanceof Date) {\n      if (this.driverConfig.driverType === \"pglite\") {\n        return new Date(value.getTime() - value.getTimezoneOffset() * 60_000);\n      }\n      return value;\n    }\n    // PostgreSQL returns timestamps/dates as strings\n    if (typeof value === \"string\") {\n      // Normalize timezone-less timestamps to UTC to avoid local offset drift.\n      return new Date(normalizeTimestampString(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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize integer from invalid number: ${value}`);\n      }\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      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot deserialize decimal from invalid number: ${value}`);\n      }\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const num = parseFloat(value);\n      if (Number.isNaN(num) || !Number.isFinite(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\nconst normalizeTimestampString = (value: string) => {\n  if (!hasTimeComponent(value) || !isTimestampWithoutTimezone(value)) {\n    return value;\n  }\n  const withTimeSeparator = value.includes(\" \") ? value.replace(\" \", \"T\") : value;\n  return `${withTimeSeparator}Z`;\n};\n\nconst hasTimeComponent = (value: string) => /\\d{2}:\\d{2}:\\d{2}/.test(value);\n\nconst isTimestampWithoutTimezone = (value: string) => {\n  // Detect RFC3339-like timezone indicators: Z or +/-HH(:MM)?\n  if (value.endsWith(\"Z\")) {\n    return false;\n  }\n  return !/[+-]\\d{2}(:?\\d{2})?$/.test(value);\n};\n"],"mappings":";;;;;;;;;;;;;;AAeA,IAAa,uBAAb,cAA0C,cAAc;CACtD,YAAY,cAA4B;AACtC,QAAM,aAAa;;CAGrB,AAAU,cAAc,OAAa,MAAuB;AAG1D,SAAO;;CAGT,AAAU,iBAAiB,OAAyB;AAElD,SAAO;;CAGT,AAAU,gBAAgB,OAAe,MAAyB;AAEhE,SAAO;;CAGT,AAAU,gBAAgB,OAAgB,MAAuB;AAE/D,MAAI,iBAAiB,MAAM;AACzB,OAAI,KAAK,aAAa,eAAe,SACnC,wBAAO,IAAI,KAAK,MAAM,SAAS,GAAG,MAAM,mBAAmB,GAAG,IAAO;AAEvE,UAAO;;AAGT,MAAI,OAAO,UAAU,SAEnB,QAAO,IAAI,KAAK,yBAAyB,MAAM,CAAC;AAElD,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,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,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,OAAM,IAAI,MAAM,mDAAmD,QAAQ;AAE7E,UAAO;;AAET,MAAI,OAAO,UAAU,UAAU;GAC7B,MAAM,MAAM,WAAW,MAAM;AAC7B,OAAI,OAAO,MAAM,IAAI,IAAI,CAAC,OAAO,SAAS,IAAI,CAC5C,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;;;AAI5E,MAAM,4BAA4B,UAAkB;AAClD,KAAI,CAAC,iBAAiB,MAAM,IAAI,CAAC,2BAA2B,MAAM,CAChE,QAAO;AAGT,QAAO,GADmB,MAAM,SAAS,IAAI,GAAG,MAAM,QAAQ,KAAK,IAAI,GAAG,MAC9C;;AAG9B,MAAM,oBAAoB,UAAkB,oBAAoB,KAAK,MAAM;AAE3E,MAAM,8BAA8B,UAAkB;AAEpD,KAAI,MAAM,SAAS,IAAI,CACrB,QAAO;AAET,QAAO,CAAC,uBAAuB,KAAK,MAAM"}

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

@@ -10,6 +10,10 @@ function parseSQLiteUtcTimestamp(value) {
 	const milliseconds = millis ? Number(millis.padEnd(3, "0")) : 0;
 	return new Date(Date.UTC(Number(year), Number(month) - 1, Number(day), Number(hour), Number(minute), Number(second), milliseconds));
 }
+function readBigInt64BEFromBytes(value) {
+	if (value.byteLength !== 8) throw new Error(`Cannot deserialize bigint from ${value.byteLength} bytes; expected 8.`);
+	return (value instanceof ArrayBuffer ? new DataView(value) : new DataView(value.buffer, value.byteOffset, value.byteLength)).getBigInt64(0, false);
+}
 /**
 * SQLite-specific serializer.
 *
@@ -46,7 +50,7 @@ var SQLiteSerializer = class extends SQLSerializer {
 	deserializeDate(value, col) {
 		if (value instanceof Date) return value;
 		if (typeof value === "string") {
-			if (/^\d+$/.test(value)) {
+			if (/^\d+(?:\.\d+)?$/.test(value)) {
 				const numericDate = new Date(Number(value));
 				if (Number.isNaN(numericDate.getTime())) throw new Error(`Cannot deserialize date from value: ${value}`);
 				return numericDate;
@@ -75,7 +79,7 @@ var SQLiteSerializer = class extends SQLSerializer {
 	}
 	deserializeBigInt(value) {
 		if (typeof value === "bigint") return value;
-		if (value instanceof Buffer) return value.readBigInt64BE(0);
+		if (value instanceof Buffer || value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return readBigInt64BEFromBytes(value);
 		if (typeof value === "string") return BigInt(value);
 		if (typeof value === "number") {
 			if (this.sqliteStorageMode.bigintStorage === "integer") {