@geekmidas/db 0.3.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @geekmidas/db
+
+## 1.0.1
+
+### Patch Changes
+
+- ✨ [`ac041cc`](https://github.com/geekmidas/toolbox/commit/ac041cc459e87107ffb4e508e85c04c3079bf040) Thanks [@geekmidas](https://github.com/geekmidas)! - Add objection pagination and fix secret loading for server apps
+
+## 1.0.0
+
+### Major Changes
+
+- [`ff7b115`](https://github.com/geekmidas/toolbox/commit/ff7b11599f60f84ac6cdc73714c853ecf786b2e8) Thanks [@geekmidas](https://github.com/geekmidas)! - Version 1 Stable release

package/dist/kysely/pagination.cjs

@@ -1,14 +1,7 @@
+const require_pagination = require('../pagination-Bdoa4PVj.cjs');
 
 //#region src/kysely/pagination.ts
 /**
-* Sort direction for cursor-based pagination.
-*/
-let Direction = /* @__PURE__ */ function(Direction$1) {
-	Direction$1["Asc"] = "asc";
-	Direction$1["Desc"] = "desc";
-	return Direction$1;
-}({});
-/**
 * Generic paginated search function that handles:
 * - Total count calculation
 * - Cursor-based pagination
@@ -17,22 +10,26 @@ let Direction = /* @__PURE__ */ function(Direction$1) {
 *
 * @example
 * ```typescript
+* // With mapRow
 * const result = await paginatedSearch({
 *   query: db.selectFrom('users').selectAll(),
-*   cursor: previousCursor,
 *   limit: 20,
 *   mapRow: (row) => ({ id: row.id, name: row.name }),
-*   cursorField: 'id',
-*   cursorDirection: Direction.Asc,
+* });
+*
+* // Without mapRow — items are the raw row type
+* const result = await paginatedSearch({
+*   query: db.selectFrom('users').selectAll(),
+*   limit: 20,
 * });
 * ```
 */
-async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField = "id", cursorDirection = Direction.Asc }) {
+async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField = "id", cursorDirection = require_pagination.Direction.Asc }) {
 	const countResult = await query.clearSelect().clearOrderBy().select((eb) => eb.fn.countAll().as("count")).executeTakeFirstOrThrow();
 	const count = countResult.count;
 	let paginatedQuery = query;
 	if (cursor) {
-		const operator = cursorDirection === Direction.Asc ? ">" : "<";
+		const operator = cursorDirection === require_pagination.Direction.Asc ? ">" : "<";
 		paginatedQuery = paginatedQuery.where(cursorField, operator, cursor);
 	}
 	const data = await paginatedQuery.orderBy(cursorField, cursorDirection).limit(limit + 1).execute();
@@ -40,7 +37,8 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 	const rows = hasMore ? data.slice(0, limit) : data;
 	const lastRow = rows[rows.length - 1];
 	const nextCursor = hasMore && lastRow ? String(lastRow[cursorField]) : void 0;
-	const items = await Promise.all(rows.map(mapRow));
+	const mapper = mapRow ?? ((row) => row);
+	const items = await Promise.all(rows.map(mapper));
 	return {
 		items,
 		pagination: {
@@ -50,34 +48,10 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 		}
 	};
 }
-/**
-* Encode a cursor value for safe URL transmission.
-* Supports various types: string, number, Date, etc.
-*/
-function encodeCursor(value) {
-	const payload = {
-		v: value instanceof Date ? value.toISOString() : value,
-		t: value instanceof Date ? "date" : typeof value
-	};
-	return Buffer.from(JSON.stringify(payload)).toString("base64url");
-}
-/**
-* Decode a cursor string back to its original value.
-*/
-function decodeCursor(cursor) {
-	try {
-		const json = Buffer.from(cursor, "base64url").toString("utf-8");
-		const payload = JSON.parse(json);
-		if (payload.t === "date") return new Date(payload.v);
-		return payload.v;
-	} catch {
-		throw new Error("Invalid cursor format");
-	}
-}
 
 //#endregion
-exports.Direction = Direction;
-exports.decodeCursor = decodeCursor;
-exports.encodeCursor = encodeCursor;
+exports.Direction = require_pagination.Direction;
+exports.decodeCursor = require_pagination.decodeCursor;
+exports.encodeCursor = require_pagination.encodeCursor;
 exports.paginatedSearch = paginatedSearch;
 //# sourceMappingURL=pagination.cjs.map

package/dist/kysely/pagination.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.cjs","names":["value: unknown","cursor: string"],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\n\n/**\n * Sort direction for cursor-based pagination.\n */\nexport enum Direction {\n\tAsc = 'asc',\n\tDesc = 'desc',\n}\n\n/**\n * Result of a paginated query.\n */\nexport interface PaginationResult<TItem> {\n\titems: TItem[];\n\tpagination: {\n\t\ttotal: number;\n\t\thasMore: boolean;\n\t\tcursor?: string;\n\t};\n}\n\n/**\n * Options for paginated search.\n */\nexport interface PaginatedSearchOptions<\n\tTRow,\n\tTMapRow extends (row: TRow) => unknown,\n> {\n\t/** The base Kysely query to paginate */\n\tquery: SelectQueryBuilder<any, any, TRow>;\n\t/** Cursor value for pagination (value of cursorField from previous page) */\n\tcursor?: string;\n\t/** Maximum number of items per page (default: 20) */\n\tlimit?: number;\n\t/** Function to transform each row to the output format */\n\tmapRow: TMapRow;\n\t/** Field to use for cursor pagination (default: 'id') */\n\tcursorField?: string;\n\t/** Sort direction for cursor field (default: Direction.Asc) */\n\tcursorDirection?: Direction;\n}\n\n/**\n * Generic paginated search function that handles:\n * - Total count calculation\n * - Cursor-based pagination\n * - Fetching one extra row to determine hasMore\n * - Mapping rows to output format\n *\n * @example\n * ```typescript\n * const result = await paginatedSearch({\n *   query: db.selectFrom('users').selectAll(),\n *   cursor: previousCursor,\n *   limit: 20,\n *   mapRow: (row) => ({ id: row.id, name: row.name }),\n *   cursorField: 'id',\n *   cursorDirection: Direction.Asc,\n * });\n * ```\n */\nexport async function paginatedSearch<\n\tTRow extends Record<string, unknown>,\n\tTMapRow extends (row: TRow) => unknown,\n>({\n\tquery,\n\tcursor,\n\tlimit = 20,\n\tmapRow,\n\tcursorField = 'id',\n\tcursorDirection = Direction.Asc,\n}: PaginatedSearchOptions<TRow, TMapRow>): Promise<\n\tPaginationResult<Awaited<ReturnType<TMapRow>>>\n> {\n\t// Get total count (without cursor)\n\tconst countResult = await query\n\t\t.clearSelect()\n\t\t.clearOrderBy()\n\t\t.select((eb) => eb.fn.countAll().as('count'))\n\t\t.executeTakeFirstOrThrow();\n\n\tconst count = countResult.count;\n\n\t// Apply cursor if provided\n\tlet paginatedQuery = query;\n\tif (cursor) {\n\t\tconst operator = cursorDirection === Direction.Asc ? '>' : '<';\n\t\tpaginatedQuery = paginatedQuery.where(\n\t\t\tcursorField as any,\n\t\t\toperator,\n\t\t\tcursor,\n\t\t) as typeof query;\n\t}\n\n\t// Fetch one extra to determine if there are more results\n\tconst data = await paginatedQuery\n\t\t.orderBy(cursorField as any, cursorDirection)\n\t\t.limit(limit + 1)\n\t\t.execute();\n\n\tconst hasMore = data.length > limit;\n\tconst rows = hasMore ? data.slice(0, limit) : data;\n\tconst lastRow = rows[rows.length - 1];\n\tconst nextCursor =\n\t\thasMore && lastRow ? String(lastRow[cursorField]) : undefined;\n\n\tconst items = (await Promise.all(rows.map(mapRow))) as Awaited<\n\t\tReturnType<TMapRow>\n\t>[];\n\n\treturn {\n\t\titems,\n\t\tpagination: {\n\t\t\ttotal: Number(count),\n\t\t\thasMore,\n\t\t\tcursor: nextCursor,\n\t\t},\n\t};\n}\n\n/**\n * Encode a cursor value for safe URL transmission.\n * Supports various types: string, number, Date, etc.\n */\nexport function encodeCursor(value: unknown): string {\n\tconst payload = {\n\t\tv: value instanceof Date ? value.toISOString() : value,\n\t\tt: value instanceof Date ? 'date' : typeof value,\n\t};\n\treturn Buffer.from(JSON.stringify(payload)).toString('base64url');\n}\n\n/**\n * Decode a cursor string back to its original value.\n */\nexport function decodeCursor(cursor: string): unknown {\n\ttry {\n\t\tconst json = Buffer.from(cursor, 'base64url').toString('utf-8');\n\t\tconst payload = JSON.parse(json);\n\n\t\tif (payload.t === 'date') {\n\t\t\treturn new Date(payload.v);\n\t\t}\n\n\t\treturn payload.v;\n\t} catch {\n\t\tthrow new Error('Invalid cursor format');\n\t}\n}\n"],"mappings":";;;;;AAKA,IAAY,kDAAL;AACN;AACA;;AACA;;;;;;;;;;;;;;;;;;;;AAsDD,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAkB,UAAU,KACW,EAEtC;CAED,MAAM,cAAc,MAAM,MACxB,aAAa,CACb,cAAc,CACd,OAAO,CAAC,OAAO,GAAG,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC,CAC5C,yBAAyB;CAE3B,MAAM,QAAQ,YAAY;CAG1B,IAAI,iBAAiB;AACrB,KAAI,QAAQ;EACX,MAAM,WAAW,oBAAoB,UAAU,MAAM,MAAM;AAC3D,mBAAiB,eAAe,MAC/B,aACA,UACA,OACA;CACD;CAGD,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,gBAAgB,CAC5C,MAAM,QAAQ,EAAE,CAChB,SAAS;CAEX,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,MAAM,GAAG;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,aAAa;CAElD,MAAM,QAAS,MAAM,QAAQ,IAAI,KAAK,IAAI,OAAO,CAAC;AAIlD,QAAO;EACN;EACA,YAAY;GACX,OAAO,OAAO,MAAM;GACpB;GACA,QAAQ;EACR;CACD;AACD;;;;;AAMD,SAAgB,aAAaA,OAAwB;CACpD,MAAM,UAAU;EACf,GAAG,iBAAiB,OAAO,MAAM,aAAa,GAAG;EACjD,GAAG,iBAAiB,OAAO,gBAAgB;CAC3C;AACD,QAAO,OAAO,KAAK,KAAK,UAAU,QAAQ,CAAC,CAAC,SAAS,YAAY;AACjE;;;;AAKD,SAAgB,aAAaC,QAAyB;AACrD,KAAI;EACH,MAAM,OAAO,OAAO,KAAK,QAAQ,YAAY,CAAC,SAAS,QAAQ;EAC/D,MAAM,UAAU,KAAK,MAAM,KAAK;AAEhC,MAAI,QAAQ,MAAM,OACjB,QAAO,IAAI,KAAK,QAAQ;AAGzB,SAAO,QAAQ;CACf,QAAO;AACP,QAAM,IAAI,MAAM;CAChB;AACD"}
+{"version":3,"file":"pagination.cjs","names":["Direction","row: TRow"],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\nimport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\ttype PaginationResult,\n} from '../pagination';\n\nexport { Direction, decodeCursor, encodeCursor, type PaginationResult };\n\n/**\n * Options for paginated search.\n */\nexport interface PaginatedSearchOptions<\n\tTRow,\n\tTMapRow extends (row: TRow) => unknown = (row: TRow) => TRow,\n> {\n\t/** The base Kysely query to paginate */\n\tquery: SelectQueryBuilder<any, any, TRow>;\n\t/** Cursor value for pagination (value of cursorField from previous page) */\n\tcursor?: string;\n\t/** Maximum number of items per page (default: 20) */\n\tlimit?: number;\n\t/** Function to transform each row to the output format (default: identity) */\n\tmapRow?: TMapRow;\n\t/** Field to use for cursor pagination (default: 'id') */\n\tcursorField?: string;\n\t/** Sort direction for cursor field (default: Direction.Asc) */\n\tcursorDirection?: Direction;\n}\n\n/**\n * Generic paginated search function that handles:\n * - Total count calculation\n * - Cursor-based pagination\n * - Fetching one extra row to determine hasMore\n * - Mapping rows to output format\n *\n * @example\n * ```typescript\n * // With mapRow\n * const result = await paginatedSearch({\n *   query: db.selectFrom('users').selectAll(),\n *   limit: 20,\n *   mapRow: (row) => ({ id: row.id, name: row.name }),\n * });\n *\n * // Without mapRow — items are the raw row type\n * const result = await paginatedSearch({\n *   query: db.selectFrom('users').selectAll(),\n *   limit: 20,\n * });\n * ```\n */\nexport async function paginatedSearch<\n\tTRow extends Record<string, unknown>,\n\tTMapRow extends (row: TRow) => unknown = (row: TRow) => TRow,\n>({\n\tquery,\n\tcursor,\n\tlimit = 20,\n\tmapRow,\n\tcursorField = 'id',\n\tcursorDirection = Direction.Asc,\n}: PaginatedSearchOptions<TRow, TMapRow>): Promise<\n\tPaginationResult<Awaited<ReturnType<TMapRow>>>\n> {\n\t// Get total count (without cursor)\n\tconst countResult = await query\n\t\t.clearSelect()\n\t\t.clearOrderBy()\n\t\t.select((eb) => eb.fn.countAll().as('count'))\n\t\t.executeTakeFirstOrThrow();\n\n\tconst count = countResult.count;\n\n\t// Apply cursor if provided\n\tlet paginatedQuery = query;\n\tif (cursor) {\n\t\tconst operator = cursorDirection === Direction.Asc ? '>' : '<';\n\t\tpaginatedQuery = paginatedQuery.where(\n\t\t\tcursorField as any,\n\t\t\toperator,\n\t\t\tcursor,\n\t\t) as typeof query;\n\t}\n\n\t// Fetch one extra to determine if there are more results\n\tconst data = await paginatedQuery\n\t\t.orderBy(cursorField as any, cursorDirection)\n\t\t.limit(limit + 1)\n\t\t.execute();\n\n\tconst hasMore = data.length > limit;\n\tconst rows = hasMore ? data.slice(0, limit) : data;\n\tconst lastRow = rows[rows.length - 1];\n\tconst nextCursor =\n\t\thasMore && lastRow ? String(lastRow[cursorField]) : undefined;\n\n\tconst mapper = mapRow ?? ((row: TRow) => row);\n\tconst items = (await Promise.all(rows.map(mapper))) as Awaited<\n\t\tReturnType<TMapRow>\n\t>[];\n\n\treturn {\n\t\titems,\n\t\tpagination: {\n\t\t\ttotal: Number(count),\n\t\t\thasMore,\n\t\t\tcursor: nextCursor,\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAkBA,6BAAU,KACW,EAEtC;CAED,MAAM,cAAc,MAAM,MACxB,aAAa,CACb,cAAc,CACd,OAAO,CAAC,OAAO,GAAG,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC,CAC5C,yBAAyB;CAE3B,MAAM,QAAQ,YAAY;CAG1B,IAAI,iBAAiB;AACrB,KAAI,QAAQ;EACX,MAAM,WAAW,oBAAoBA,6BAAU,MAAM,MAAM;AAC3D,mBAAiB,eAAe,MAC/B,aACA,UACA,OACA;CACD;CAGD,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,gBAAgB,CAC5C,MAAM,QAAQ,EAAE,CAChB,SAAS;CAEX,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,MAAM,GAAG;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,aAAa;CAElD,MAAM,SAAS,WAAW,CAACC,QAAc;CACzC,MAAM,QAAS,MAAM,QAAQ,IAAI,KAAK,IAAI,OAAO,CAAC;AAIlD,QAAO;EACN;EACA,YAAY;GACX,OAAO,OAAO,MAAM;GACpB;GACA,QAAQ;EACR;CACD;AACD"}

package/dist/kysely/pagination.d.cts

@@ -1,37 +1,20 @@
+import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination-BAFX7C1I.cjs";
 import { SelectQueryBuilder } from "kysely";
 
 //#region src/kysely/pagination.d.ts
 
-/**
- * Sort direction for cursor-based pagination.
- */
-declare enum Direction {
-  Asc = "asc",
-  Desc = "desc",
-}
-/**
- * Result of a paginated query.
- */
-interface PaginationResult<TItem> {
-  items: TItem[];
-  pagination: {
-    total: number;
-    hasMore: boolean;
-    cursor?: string;
-  };
-}
 /**
  * Options for paginated search.
  */
-interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown> {
+interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow> {
   /** The base Kysely query to paginate */
   query: SelectQueryBuilder<any, any, TRow>;
   /** Cursor value for pagination (value of cursorField from previous page) */
   cursor?: string;
   /** Maximum number of items per page (default: 20) */
   limit?: number;
-  /** Function to transform each row to the output format */
-  mapRow: TMapRow;
+  /** Function to transform each row to the output format (default: identity) */
+  mapRow?: TMapRow;
   /** Field to use for cursor pagination (default: 'id') */
   cursorField?: string;
   /** Sort direction for cursor field (default: Direction.Asc) */
@@ -46,17 +29,21 @@ interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown> {
  *
  * @example
  * ```typescript
+ * // With mapRow
  * const result = await paginatedSearch({
  *   query: db.selectFrom('users').selectAll(),
- *   cursor: previousCursor,
  *   limit: 20,
  *   mapRow: (row) => ({ id: row.id, name: row.name }),
- *   cursorField: 'id',
- *   cursorDirection: Direction.Asc,
+ * });
+ *
+ * // Without mapRow — items are the raw row type
+ * const result = await paginatedSearch({
+ *   query: db.selectFrom('users').selectAll(),
+ *   limit: 20,
  * });
  * ```
  */
-declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow extends (row: TRow) => unknown>({
+declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow>({
   query,
   cursor,
   limit,
@@ -64,15 +51,6 @@ declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow e
   cursorField,
   cursorDirection
 }: PaginatedSearchOptions<TRow, TMapRow>): Promise<PaginationResult<Awaited<ReturnType<TMapRow>>>>;
-/**
- * Encode a cursor value for safe URL transmission.
- * Supports various types: string, number, Date, etc.
- */
-declare function encodeCursor(value: unknown): string;
-/**
- * Decode a cursor string back to its original value.
- */
-declare function decodeCursor(cursor: string): unknown;
 //# sourceMappingURL=pagination.d.ts.map
 //#endregion
 export { Direction, PaginatedSearchOptions, PaginationResult, decodeCursor, encodeCursor, paginatedSearch };

package/dist/kysely/pagination.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.cts","names":[],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAQiB,aARL,SAAA;EAoBK,GAAA,GAAA,KAAA;EAAsB,IAAA,GAAA,MAAA;;;;;AAepB,UA3BF,gBA2BE,CAAA,KAAA,CAAA,CAAA;EAAS,KAAA,EA1BpB,KA0BoB,EAAA;EAsBN,UAAA,EAAA;IAAe,KAAA,EAAA,MAAA;IACvB,OAAA,EAAA,OAAA;IACS,MAAA,CAAA,EAAA,MAAA;EAAI,CAAA;;;;;AAO1B,UA9CgB,sBA8ChB,CAAA,IAAA,EAAA,gBAAA,CAAA,GAAA,EA5CsB,IA4CtB,EAAA,GAAA,OAAA,CAAA,CAAA;EAA+B;EACF,KAAE,EA1CxB,kBA0CwB,CAAA,GAAA,EAAA,GAAA,EA1CK,IA0CL,CAAA;EAAO;EAAd,MACY,CAAA,EAAA,MAAA;EAAO;EAAR,KAAlB,CAAA,EAAA,MAAA;EAAO;EAAR,MAD0B,EApClC,OAoCkC;EAAO;EAqDlC,WAAA,CAAA,EAAA,MAAY;EAWZ;oBAhGG;;;;;;;;;;;;;;;;;;;;;iBAsBG,6BACR,+CACS;;;;;;;GAQpB,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW;;;;;iBAoDrB,YAAA;;;;iBAWA,YAAA"}
+{"version":3,"file":"pagination.d.cts","names":[],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":[],"mappings":";;;;;;AAaA;;AAEuB,UAFN,sBAEM,CAAA,IAAA,EAAA,gBAAA,CAAA,GAAA,EAAA,IAAA,EAAA,GAAA,OAAA,GAAA,CAAA,GAAA,EAAyB,IAAzB,EAAA,GAAkC,IAAlC,CAAA,CAAA;EAAI;EAAyB,KAAK,EAGjD,kBAHiD,CAAA,GAAA,EAAA,GAAA,EAGpB,IAHoB,CAAA;EAAI;EAGpB,MAAjC,CAAA,EAAA,MAAA;EAAkB;EAMT,KAIE,CAAA,EAAA,MAAA;EAAS;EA0BN,MAAA,CAAA,EA9BZ,OA8BY;EAAe;EAAA,WACvB,CAAA,EAAA,MAAA;EAAM;EACO,eAAqB,CAAA,EA5B7B,SA4B6B;;;;;;;;;;;;;;;;AAQE;;;;;;;;;iBAV5B,6BACR,+CACS,yBAAyB,SAAS;;;;;;;GAQtD,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW"}

package/dist/kysely/pagination.d.mts

@@ -1,37 +1,20 @@
+import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination-BziGl-B8.mjs";
 import { SelectQueryBuilder } from "kysely";
 
 //#region src/kysely/pagination.d.ts
 
-/**
- * Sort direction for cursor-based pagination.
- */
-declare enum Direction {
-  Asc = "asc",
-  Desc = "desc",
-}
-/**
- * Result of a paginated query.
- */
-interface PaginationResult<TItem> {
-  items: TItem[];
-  pagination: {
-    total: number;
-    hasMore: boolean;
-    cursor?: string;
-  };
-}
 /**
  * Options for paginated search.
  */
-interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown> {
+interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow> {
   /** The base Kysely query to paginate */
   query: SelectQueryBuilder<any, any, TRow>;
   /** Cursor value for pagination (value of cursorField from previous page) */
   cursor?: string;
   /** Maximum number of items per page (default: 20) */
   limit?: number;
-  /** Function to transform each row to the output format */
-  mapRow: TMapRow;
+  /** Function to transform each row to the output format (default: identity) */
+  mapRow?: TMapRow;
   /** Field to use for cursor pagination (default: 'id') */
   cursorField?: string;
   /** Sort direction for cursor field (default: Direction.Asc) */
@@ -46,17 +29,21 @@ interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown> {
  *
  * @example
  * ```typescript
+ * // With mapRow
  * const result = await paginatedSearch({
  *   query: db.selectFrom('users').selectAll(),
- *   cursor: previousCursor,
  *   limit: 20,
  *   mapRow: (row) => ({ id: row.id, name: row.name }),
- *   cursorField: 'id',
- *   cursorDirection: Direction.Asc,
+ * });
+ *
+ * // Without mapRow — items are the raw row type
+ * const result = await paginatedSearch({
+ *   query: db.selectFrom('users').selectAll(),
+ *   limit: 20,
  * });
  * ```
  */
-declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow extends (row: TRow) => unknown>({
+declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow>({
   query,
   cursor,
   limit,
@@ -64,15 +51,6 @@ declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow e
   cursorField,
   cursorDirection
 }: PaginatedSearchOptions<TRow, TMapRow>): Promise<PaginationResult<Awaited<ReturnType<TMapRow>>>>;
-/**
- * Encode a cursor value for safe URL transmission.
- * Supports various types: string, number, Date, etc.
- */
-declare function encodeCursor(value: unknown): string;
-/**
- * Decode a cursor string back to its original value.
- */
-declare function decodeCursor(cursor: string): unknown;
 //# sourceMappingURL=pagination.d.ts.map
 //#endregion
 export { Direction, PaginatedSearchOptions, PaginationResult, decodeCursor, encodeCursor, paginatedSearch };

package/dist/kysely/pagination.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAQiB,aARL,SAAA;EAoBK,GAAA,GAAA,KAAA;EAAsB,IAAA,GAAA,MAAA;;;;;AAepB,UA3BF,gBA2BE,CAAA,KAAA,CAAA,CAAA;EAAS,KAAA,EA1BpB,KA0BoB,EAAA;EAsBN,UAAA,EAAA;IAAe,KAAA,EAAA,MAAA;IACvB,OAAA,EAAA,OAAA;IACS,MAAA,CAAA,EAAA,MAAA;EAAI,CAAA;;;;;AAO1B,UA9CgB,sBA8ChB,CAAA,IAAA,EAAA,gBAAA,CAAA,GAAA,EA5CsB,IA4CtB,EAAA,GAAA,OAAA,CAAA,CAAA;EAA+B;EACF,KAAE,EA1CxB,kBA0CwB,CAAA,GAAA,EAAA,GAAA,EA1CK,IA0CL,CAAA;EAAO;EAAd,MACY,CAAA,EAAA,MAAA;EAAO;EAAR,KAAlB,CAAA,EAAA,MAAA;EAAO;EAAR,MAD0B,EApClC,OAoCkC;EAAO;EAqDlC,WAAA,CAAA,EAAA,MAAY;EAWZ;oBAhGG;;;;;;;;;;;;;;;;;;;;;iBAsBG,6BACR,+CACS;;;;;;;GAQpB,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW;;;;;iBAoDrB,YAAA;;;;iBAWA,YAAA"}
+{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":[],"mappings":";;;;;;AAaA;;AAEuB,UAFN,sBAEM,CAAA,IAAA,EAAA,gBAAA,CAAA,GAAA,EAAA,IAAA,EAAA,GAAA,OAAA,GAAA,CAAA,GAAA,EAAyB,IAAzB,EAAA,GAAkC,IAAlC,CAAA,CAAA;EAAI;EAAyB,KAAK,EAGjD,kBAHiD,CAAA,GAAA,EAAA,GAAA,EAGpB,IAHoB,CAAA;EAAI;EAGpB,MAAjC,CAAA,EAAA,MAAA;EAAkB;EAMT,KAIE,CAAA,EAAA,MAAA;EAAS;EA0BN,MAAA,CAAA,EA9BZ,OA8BY;EAAe;EAAA,WACvB,CAAA,EAAA,MAAA;EAAM;EACO,eAAqB,CAAA,EA5B7B,SA4B6B;;;;;;;;;;;;;;;;AAQE;;;;;;;;;iBAV5B,6BACR,+CACS,yBAAyB,SAAS;;;;;;;GAQtD,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW"}

package/dist/kysely/pagination.mjs

@@ -1,13 +1,7 @@
+import { Direction, decodeCursor, encodeCursor } from "../pagination-BDLa7Yb_.mjs";
+
 //#region src/kysely/pagination.ts
 /**
-* Sort direction for cursor-based pagination.
-*/
-let Direction = /* @__PURE__ */ function(Direction$1) {
-	Direction$1["Asc"] = "asc";
-	Direction$1["Desc"] = "desc";
-	return Direction$1;
-}({});
-/**
 * Generic paginated search function that handles:
 * - Total count calculation
 * - Cursor-based pagination
@@ -16,13 +10,17 @@ let Direction = /* @__PURE__ */ function(Direction$1) {
 *
 * @example
 * ```typescript
+* // With mapRow
 * const result = await paginatedSearch({
 *   query: db.selectFrom('users').selectAll(),
-*   cursor: previousCursor,
 *   limit: 20,
 *   mapRow: (row) => ({ id: row.id, name: row.name }),
-*   cursorField: 'id',
-*   cursorDirection: Direction.Asc,
+* });
+*
+* // Without mapRow — items are the raw row type
+* const result = await paginatedSearch({
+*   query: db.selectFrom('users').selectAll(),
+*   limit: 20,
 * });
 * ```
 */
@@ -39,7 +37,8 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 	const rows = hasMore ? data.slice(0, limit) : data;
 	const lastRow = rows[rows.length - 1];
 	const nextCursor = hasMore && lastRow ? String(lastRow[cursorField]) : void 0;
-	const items = await Promise.all(rows.map(mapRow));
+	const mapper = mapRow ?? ((row) => row);
+	const items = await Promise.all(rows.map(mapper));
 	return {
 		items,
 		pagination: {
@@ -49,30 +48,6 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 		}
 	};
 }
-/**
-* Encode a cursor value for safe URL transmission.
-* Supports various types: string, number, Date, etc.
-*/
-function encodeCursor(value) {
-	const payload = {
-		v: value instanceof Date ? value.toISOString() : value,
-		t: value instanceof Date ? "date" : typeof value
-	};
-	return Buffer.from(JSON.stringify(payload)).toString("base64url");
-}
-/**
-* Decode a cursor string back to its original value.
-*/
-function decodeCursor(cursor) {
-	try {
-		const json = Buffer.from(cursor, "base64url").toString("utf-8");
-		const payload = JSON.parse(json);
-		if (payload.t === "date") return new Date(payload.v);
-		return payload.v;
-	} catch {
-		throw new Error("Invalid cursor format");
-	}
-}
 
 //#endregion
 export { Direction, decodeCursor, encodeCursor, paginatedSearch };

package/dist/kysely/pagination.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.mjs","names":["value: unknown","cursor: string"],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\n\n/**\n * Sort direction for cursor-based pagination.\n */\nexport enum Direction {\n\tAsc = 'asc',\n\tDesc = 'desc',\n}\n\n/**\n * Result of a paginated query.\n */\nexport interface PaginationResult<TItem> {\n\titems: TItem[];\n\tpagination: {\n\t\ttotal: number;\n\t\thasMore: boolean;\n\t\tcursor?: string;\n\t};\n}\n\n/**\n * Options for paginated search.\n */\nexport interface PaginatedSearchOptions<\n\tTRow,\n\tTMapRow extends (row: TRow) => unknown,\n> {\n\t/** The base Kysely query to paginate */\n\tquery: SelectQueryBuilder<any, any, TRow>;\n\t/** Cursor value for pagination (value of cursorField from previous page) */\n\tcursor?: string;\n\t/** Maximum number of items per page (default: 20) */\n\tlimit?: number;\n\t/** Function to transform each row to the output format */\n\tmapRow: TMapRow;\n\t/** Field to use for cursor pagination (default: 'id') */\n\tcursorField?: string;\n\t/** Sort direction for cursor field (default: Direction.Asc) */\n\tcursorDirection?: Direction;\n}\n\n/**\n * Generic paginated search function that handles:\n * - Total count calculation\n * - Cursor-based pagination\n * - Fetching one extra row to determine hasMore\n * - Mapping rows to output format\n *\n * @example\n * ```typescript\n * const result = await paginatedSearch({\n *   query: db.selectFrom('users').selectAll(),\n *   cursor: previousCursor,\n *   limit: 20,\n *   mapRow: (row) => ({ id: row.id, name: row.name }),\n *   cursorField: 'id',\n *   cursorDirection: Direction.Asc,\n * });\n * ```\n */\nexport async function paginatedSearch<\n\tTRow extends Record<string, unknown>,\n\tTMapRow extends (row: TRow) => unknown,\n>({\n\tquery,\n\tcursor,\n\tlimit = 20,\n\tmapRow,\n\tcursorField = 'id',\n\tcursorDirection = Direction.Asc,\n}: PaginatedSearchOptions<TRow, TMapRow>): Promise<\n\tPaginationResult<Awaited<ReturnType<TMapRow>>>\n> {\n\t// Get total count (without cursor)\n\tconst countResult = await query\n\t\t.clearSelect()\n\t\t.clearOrderBy()\n\t\t.select((eb) => eb.fn.countAll().as('count'))\n\t\t.executeTakeFirstOrThrow();\n\n\tconst count = countResult.count;\n\n\t// Apply cursor if provided\n\tlet paginatedQuery = query;\n\tif (cursor) {\n\t\tconst operator = cursorDirection === Direction.Asc ? '>' : '<';\n\t\tpaginatedQuery = paginatedQuery.where(\n\t\t\tcursorField as any,\n\t\t\toperator,\n\t\t\tcursor,\n\t\t) as typeof query;\n\t}\n\n\t// Fetch one extra to determine if there are more results\n\tconst data = await paginatedQuery\n\t\t.orderBy(cursorField as any, cursorDirection)\n\t\t.limit(limit + 1)\n\t\t.execute();\n\n\tconst hasMore = data.length > limit;\n\tconst rows = hasMore ? data.slice(0, limit) : data;\n\tconst lastRow = rows[rows.length - 1];\n\tconst nextCursor =\n\t\thasMore && lastRow ? String(lastRow[cursorField]) : undefined;\n\n\tconst items = (await Promise.all(rows.map(mapRow))) as Awaited<\n\t\tReturnType<TMapRow>\n\t>[];\n\n\treturn {\n\t\titems,\n\t\tpagination: {\n\t\t\ttotal: Number(count),\n\t\t\thasMore,\n\t\t\tcursor: nextCursor,\n\t\t},\n\t};\n}\n\n/**\n * Encode a cursor value for safe URL transmission.\n * Supports various types: string, number, Date, etc.\n */\nexport function encodeCursor(value: unknown): string {\n\tconst payload = {\n\t\tv: value instanceof Date ? value.toISOString() : value,\n\t\tt: value instanceof Date ? 'date' : typeof value,\n\t};\n\treturn Buffer.from(JSON.stringify(payload)).toString('base64url');\n}\n\n/**\n * Decode a cursor string back to its original value.\n */\nexport function decodeCursor(cursor: string): unknown {\n\ttry {\n\t\tconst json = Buffer.from(cursor, 'base64url').toString('utf-8');\n\t\tconst payload = JSON.parse(json);\n\n\t\tif (payload.t === 'date') {\n\t\t\treturn new Date(payload.v);\n\t\t}\n\n\t\treturn payload.v;\n\t} catch {\n\t\tthrow new Error('Invalid cursor format');\n\t}\n}\n"],"mappings":";;;;AAKA,IAAY,kDAAL;AACN;AACA;;AACA;;;;;;;;;;;;;;;;;;;;AAsDD,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAkB,UAAU,KACW,EAEtC;CAED,MAAM,cAAc,MAAM,MACxB,aAAa,CACb,cAAc,CACd,OAAO,CAAC,OAAO,GAAG,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC,CAC5C,yBAAyB;CAE3B,MAAM,QAAQ,YAAY;CAG1B,IAAI,iBAAiB;AACrB,KAAI,QAAQ;EACX,MAAM,WAAW,oBAAoB,UAAU,MAAM,MAAM;AAC3D,mBAAiB,eAAe,MAC/B,aACA,UACA,OACA;CACD;CAGD,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,gBAAgB,CAC5C,MAAM,QAAQ,EAAE,CAChB,SAAS;CAEX,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,MAAM,GAAG;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,aAAa;CAElD,MAAM,QAAS,MAAM,QAAQ,IAAI,KAAK,IAAI,OAAO,CAAC;AAIlD,QAAO;EACN;EACA,YAAY;GACX,OAAO,OAAO,MAAM;GACpB;GACA,QAAQ;EACR;CACD;AACD;;;;;AAMD,SAAgB,aAAaA,OAAwB;CACpD,MAAM,UAAU;EACf,GAAG,iBAAiB,OAAO,MAAM,aAAa,GAAG;EACjD,GAAG,iBAAiB,OAAO,gBAAgB;CAC3C;AACD,QAAO,OAAO,KAAK,KAAK,UAAU,QAAQ,CAAC,CAAC,SAAS,YAAY;AACjE;;;;AAKD,SAAgB,aAAaC,QAAyB;AACrD,KAAI;EACH,MAAM,OAAO,OAAO,KAAK,QAAQ,YAAY,CAAC,SAAS,QAAQ;EAC/D,MAAM,UAAU,KAAK,MAAM,KAAK;AAEhC,MAAI,QAAQ,MAAM,OACjB,QAAO,IAAI,KAAK,QAAQ;AAGzB,SAAO,QAAQ;CACf,QAAO;AACP,QAAM,IAAI,MAAM;CAChB;AACD"}
+{"version":3,"file":"pagination.mjs","names":["row: TRow"],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\nimport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\ttype PaginationResult,\n} from '../pagination';\n\nexport { Direction, decodeCursor, encodeCursor, type PaginationResult };\n\n/**\n * Options for paginated search.\n */\nexport interface PaginatedSearchOptions<\n\tTRow,\n\tTMapRow extends (row: TRow) => unknown = (row: TRow) => TRow,\n> {\n\t/** The base Kysely query to paginate */\n\tquery: SelectQueryBuilder<any, any, TRow>;\n\t/** Cursor value for pagination (value of cursorField from previous page) */\n\tcursor?: string;\n\t/** Maximum number of items per page (default: 20) */\n\tlimit?: number;\n\t/** Function to transform each row to the output format (default: identity) */\n\tmapRow?: TMapRow;\n\t/** Field to use for cursor pagination (default: 'id') */\n\tcursorField?: string;\n\t/** Sort direction for cursor field (default: Direction.Asc) */\n\tcursorDirection?: Direction;\n}\n\n/**\n * Generic paginated search function that handles:\n * - Total count calculation\n * - Cursor-based pagination\n * - Fetching one extra row to determine hasMore\n * - Mapping rows to output format\n *\n * @example\n * ```typescript\n * // With mapRow\n * const result = await paginatedSearch({\n *   query: db.selectFrom('users').selectAll(),\n *   limit: 20,\n *   mapRow: (row) => ({ id: row.id, name: row.name }),\n * });\n *\n * // Without mapRow — items are the raw row type\n * const result = await paginatedSearch({\n *   query: db.selectFrom('users').selectAll(),\n *   limit: 20,\n * });\n * ```\n */\nexport async function paginatedSearch<\n\tTRow extends Record<string, unknown>,\n\tTMapRow extends (row: TRow) => unknown = (row: TRow) => TRow,\n>({\n\tquery,\n\tcursor,\n\tlimit = 20,\n\tmapRow,\n\tcursorField = 'id',\n\tcursorDirection = Direction.Asc,\n}: PaginatedSearchOptions<TRow, TMapRow>): Promise<\n\tPaginationResult<Awaited<ReturnType<TMapRow>>>\n> {\n\t// Get total count (without cursor)\n\tconst countResult = await query\n\t\t.clearSelect()\n\t\t.clearOrderBy()\n\t\t.select((eb) => eb.fn.countAll().as('count'))\n\t\t.executeTakeFirstOrThrow();\n\n\tconst count = countResult.count;\n\n\t// Apply cursor if provided\n\tlet paginatedQuery = query;\n\tif (cursor) {\n\t\tconst operator = cursorDirection === Direction.Asc ? '>' : '<';\n\t\tpaginatedQuery = paginatedQuery.where(\n\t\t\tcursorField as any,\n\t\t\toperator,\n\t\t\tcursor,\n\t\t) as typeof query;\n\t}\n\n\t// Fetch one extra to determine if there are more results\n\tconst data = await paginatedQuery\n\t\t.orderBy(cursorField as any, cursorDirection)\n\t\t.limit(limit + 1)\n\t\t.execute();\n\n\tconst hasMore = data.length > limit;\n\tconst rows = hasMore ? data.slice(0, limit) : data;\n\tconst lastRow = rows[rows.length - 1];\n\tconst nextCursor =\n\t\thasMore && lastRow ? String(lastRow[cursorField]) : undefined;\n\n\tconst mapper = mapRow ?? ((row: TRow) => row);\n\tconst items = (await Promise.all(rows.map(mapper))) as Awaited<\n\t\tReturnType<TMapRow>\n\t>[];\n\n\treturn {\n\t\titems,\n\t\tpagination: {\n\t\t\ttotal: Number(count),\n\t\t\thasMore,\n\t\t\tcursor: nextCursor,\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAkB,UAAU,KACW,EAEtC;CAED,MAAM,cAAc,MAAM,MACxB,aAAa,CACb,cAAc,CACd,OAAO,CAAC,OAAO,GAAG,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC,CAC5C,yBAAyB;CAE3B,MAAM,QAAQ,YAAY;CAG1B,IAAI,iBAAiB;AACrB,KAAI,QAAQ;EACX,MAAM,WAAW,oBAAoB,UAAU,MAAM,MAAM;AAC3D,mBAAiB,eAAe,MAC/B,aACA,UACA,OACA;CACD;CAGD,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,gBAAgB,CAC5C,MAAM,QAAQ,EAAE,CAChB,SAAS;CAEX,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,MAAM,GAAG;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,aAAa;CAElD,MAAM,SAAS,WAAW,CAACA,QAAc;CACzC,MAAM,QAAS,MAAM,QAAQ,IAAI,KAAK,IAAI,OAAO,CAAC;AAIlD,QAAO;EACN;EACA,YAAY;GACX,OAAO,OAAO,MAAM;GACpB;GACA,QAAQ;EACR;CACD;AACD"}

package/dist/{kysely-DUdsB0BP.d.mts → kysely-Dm1w5gAY.d.mts}

@@ -10,4 +10,4 @@ type DatabaseConnection<T> = ControlledTransaction<T> | Kysely<T> | Transaction<
 
 //#endregion
 export { DatabaseConnection, TransactionSettings, withTransaction };
-//# sourceMappingURL=kysely-DUdsB0BP.d.mts.map
+//# sourceMappingURL=kysely-Dm1w5gAY.d.mts.map

package/dist/{kysely-DUdsB0BP.d.mts.map → kysely-Dm1w5gAY.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"kysely-DUdsB0BP.d.mts","names":[],"sources":["../src/kysely.ts"],"sourcesContent":[],"mappings":";;;UAOiB,mBAAA;mBACC;AADlB;AAIgB,iBAAA,eAAe,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,EAAA,EAC1B,kBAD0B,CACP,EADO,CAAA,EAAA,EAAA,EAAA,CAAA,GAAA,EAEpB,WAFoB,CAER,EAFQ,CAAA,EAAA,GAEA,OAFA,CAEQ,CAFR,CAAA,EAAA,QAAA,CAAA,EAGnB,mBAHmB,CAAA,EAI5B,OAJ4B,CAIpB,CAJoB,CAAA;AAAA,KAkBnB,kBAlBmB,CAAA,CAAA,CAAA,GAmB5B,qBAnB4B,CAmBN,CAnBM,CAAA,GAoB5B,MApB4B,CAoBrB,CApBqB,CAAA,GAqB5B,WArB4B,CAqBhB,CArBgB,CAAA"}
+{"version":3,"file":"kysely-Dm1w5gAY.d.mts","names":[],"sources":["../src/kysely.ts"],"sourcesContent":[],"mappings":";;;UAOiB,mBAAA;mBACC;AADlB;AAIgB,iBAAA,eAAe,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,EAAA,EAC1B,kBAD0B,CACP,EADO,CAAA,EAAA,EAAA,EAAA,CAAA,GAAA,EAEpB,WAFoB,CAER,EAFQ,CAAA,EAAA,GAEA,OAFA,CAEQ,CAFR,CAAA,EAAA,QAAA,CAAA,EAGnB,mBAHmB,CAAA,EAI5B,OAJ4B,CAIpB,CAJoB,CAAA;AAAA,KAkBnB,kBAlBmB,CAAA,CAAA,CAAA,GAmB5B,qBAnB4B,CAmBN,CAnBM,CAAA,GAoB5B,MApB4B,CAoBrB,CApBqB,CAAA,GAqB5B,WArB4B,CAqBhB,CArBgB,CAAA"}

package/dist/kysely.d.mts

@@ -1,2 +1,2 @@
-import { DatabaseConnection, TransactionSettings, withTransaction } from "./kysely-DUdsB0BP.mjs";
+import { DatabaseConnection, TransactionSettings, withTransaction } from "./kysely-Dm1w5gAY.mjs";
 export { DatabaseConnection, TransactionSettings, withTransaction };

package/dist/objection/pagination.cjs

@@ -0,0 +1,50 @@
+const require_pagination = require('../pagination-Bdoa4PVj.cjs');
+
+//#region src/objection/pagination.ts
+/**
+* Cursor-based paginated search for Objection.js models.
+*
+* Accepts a pre-built QueryBuilder so callers can apply filters,
+* eager loading, and scopes before pagination is layered on top.
+*
+* @example
+* ```typescript
+* const result = await paginatedSearch({
+*   query: User.query(trx).where('orgId', orgId).withGraphFetched('roles'),
+*   cursor: previousCursor,
+*   limit: 20,
+*   cursorField: 'createdAt',
+*   cursorDirection: Direction.Desc,
+* });
+* ```
+*/
+async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField = "id", cursorDirection = require_pagination.Direction.Asc }) {
+	const total = await query.resultSize();
+	let paginatedQuery = query.clone();
+	if (cursor) {
+		const operator = cursorDirection === require_pagination.Direction.Asc ? ">" : "<";
+		paginatedQuery = paginatedQuery.where(cursorField, operator, cursor);
+	}
+	const data = await paginatedQuery.orderBy(cursorField, cursorDirection).limit(limit + 1);
+	const hasMore = data.length > limit;
+	const rows = hasMore ? data.slice(0, limit) : data;
+	const lastRow = rows[rows.length - 1];
+	const nextCursor = hasMore && lastRow ? String(lastRow[cursorField]) : void 0;
+	const mapper = mapRow ?? ((row) => row);
+	const items = await Promise.all(rows.map(mapper));
+	return {
+		items,
+		pagination: {
+			total,
+			hasMore,
+			cursor: nextCursor
+		}
+	};
+}
+
+//#endregion
+exports.Direction = require_pagination.Direction;
+exports.decodeCursor = require_pagination.decodeCursor;
+exports.encodeCursor = require_pagination.encodeCursor;
+exports.paginatedSearch = paginatedSearch;
+//# sourceMappingURL=pagination.cjs.map

package/dist/objection/pagination.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.cjs","names":["Direction","row: TModel"],"sources":["../../src/objection/pagination.ts"],"sourcesContent":["import type { Model, QueryBuilder } from 'objection';\nimport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\ttype PaginationResult,\n} from '../pagination';\n\nexport { Direction, decodeCursor, encodeCursor, type PaginationResult };\n\n/**\n * Options for paginated search with Objection.js models.\n */\nexport interface ObjectionPaginatedSearchOptions<\n\tTModel extends Model,\n\tTMapRow extends (row: TModel) => unknown = (row: TModel) => TModel,\n> {\n\t/** The Objection QueryBuilder to paginate (e.g. User.query(trx).where(...)) */\n\tquery: QueryBuilder<TModel>;\n\t/** Cursor value for pagination (value of cursorField from previous page) */\n\tcursor?: string;\n\t/** Maximum number of items per page (default: 20) */\n\tlimit?: number;\n\t/** Function to transform each row to the output format (default: identity) */\n\tmapRow?: TMapRow;\n\t/** Field to use for cursor pagination (default: 'id') */\n\tcursorField?: string;\n\t/** Sort direction for cursor field (default: Direction.Asc) */\n\tcursorDirection?: Direction;\n}\n\n/**\n * Cursor-based paginated search for Objection.js models.\n *\n * Accepts a pre-built QueryBuilder so callers can apply filters,\n * eager loading, and scopes before pagination is layered on top.\n *\n * @example\n * ```typescript\n * const result = await paginatedSearch({\n *   query: User.query(trx).where('orgId', orgId).withGraphFetched('roles'),\n *   cursor: previousCursor,\n *   limit: 20,\n *   cursorField: 'createdAt',\n *   cursorDirection: Direction.Desc,\n * });\n * ```\n */\nexport async function paginatedSearch<\n\tTModel extends Model,\n\tTMapRow extends (row: TModel) => unknown = (row: TModel) => TModel,\n>({\n\tquery,\n\tcursor,\n\tlimit = 20,\n\tmapRow,\n\tcursorField = 'id',\n\tcursorDirection = Direction.Asc,\n}: ObjectionPaginatedSearchOptions<TModel, TMapRow>): Promise<\n\tPaginationResult<Awaited<ReturnType<TMapRow>>>\n> {\n\t// Get total count (without cursor filtering)\n\tconst total = await query.resultSize();\n\n\t// Apply cursor if provided\n\tlet paginatedQuery = query.clone();\n\tif (cursor) {\n\t\tconst operator = cursorDirection === Direction.Asc ? '>' : '<';\n\t\tpaginatedQuery = paginatedQuery.where(cursorField, operator, cursor);\n\t}\n\n\t// Fetch one extra to determine if there are more results\n\tconst data = await paginatedQuery\n\t\t.orderBy(cursorField, cursorDirection)\n\t\t.limit(limit + 1);\n\n\tconst hasMore = data.length > limit;\n\tconst rows = hasMore ? data.slice(0, limit) : data;\n\tconst lastRow = rows[rows.length - 1];\n\tconst nextCursor =\n\t\thasMore && lastRow\n\t\t\t? String((lastRow as Record<string, unknown>)[cursorField])\n\t\t\t: undefined;\n\n\tconst mapper = mapRow ?? ((row: TModel) => row);\n\tconst items = (await Promise.all(rows.map(mapper))) as Awaited<\n\t\tReturnType<TMapRow>\n\t>[];\n\n\treturn {\n\t\titems,\n\t\tpagination: {\n\t\t\ttotal,\n\t\t\thasMore,\n\t\t\tcursor: nextCursor,\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAgDA,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAkBA,6BAAU,KACsB,EAEjD;CAED,MAAM,QAAQ,MAAM,MAAM,YAAY;CAGtC,IAAI,iBAAiB,MAAM,OAAO;AAClC,KAAI,QAAQ;EACX,MAAM,WAAW,oBAAoBA,6BAAU,MAAM,MAAM;AAC3D,mBAAiB,eAAe,MAAM,aAAa,UAAU,OAAO;CACpE;CAGD,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAa,gBAAgB,CACrC,MAAM,QAAQ,EAAE;CAElB,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,MAAM,GAAG;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UACR,OAAQ,QAAoC,aAAa;CAG7D,MAAM,SAAS,WAAW,CAACC,QAAgB;CAC3C,MAAM,QAAS,MAAM,QAAQ,IAAI,KAAK,IAAI,OAAO,CAAC;AAIlD,QAAO;EACN;EACA,YAAY;GACX;GACA;GACA,QAAQ;EACR;CACD;AACD"}

package/dist/objection/pagination.d.cts

@@ -0,0 +1,51 @@
+import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination-BAFX7C1I.cjs";
+import { Model, QueryBuilder } from "objection";
+
+//#region src/objection/pagination.d.ts
+
+/**
+ * Options for paginated search with Objection.js models.
+ */
+interface ObjectionPaginatedSearchOptions<TModel extends Model, TMapRow extends (row: TModel) => unknown = (row: TModel) => TModel> {
+  /** The Objection QueryBuilder to paginate (e.g. User.query(trx).where(...)) */
+  query: QueryBuilder<TModel>;
+  /** Cursor value for pagination (value of cursorField from previous page) */
+  cursor?: string;
+  /** Maximum number of items per page (default: 20) */
+  limit?: number;
+  /** Function to transform each row to the output format (default: identity) */
+  mapRow?: TMapRow;
+  /** Field to use for cursor pagination (default: 'id') */
+  cursorField?: string;
+  /** Sort direction for cursor field (default: Direction.Asc) */
+  cursorDirection?: Direction;
+}
+/**
+ * Cursor-based paginated search for Objection.js models.
+ *
+ * Accepts a pre-built QueryBuilder so callers can apply filters,
+ * eager loading, and scopes before pagination is layered on top.
+ *
+ * @example
+ * ```typescript
+ * const result = await paginatedSearch({
+ *   query: User.query(trx).where('orgId', orgId).withGraphFetched('roles'),
+ *   cursor: previousCursor,
+ *   limit: 20,
+ *   cursorField: 'createdAt',
+ *   cursorDirection: Direction.Desc,
+ * });
+ * ```
+ */
+declare function paginatedSearch<TModel extends Model, TMapRow extends (row: TModel) => unknown = (row: TModel) => TModel>({
+  query,
+  cursor,
+  limit,
+  mapRow,
+  cursorField,
+  cursorDirection
+}: ObjectionPaginatedSearchOptions<TModel, TMapRow>): Promise<PaginationResult<Awaited<ReturnType<TMapRow>>>>;
+//# sourceMappingURL=pagination.d.ts.map
+//#endregion
+export { Direction, ObjectionPaginatedSearchOptions, PaginationResult, decodeCursor, encodeCursor, paginatedSearch };
+//# sourceMappingURL=pagination.d.cts.map

package/dist/objection/pagination.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.cts","names":[],"sources":["../../src/objection/pagination.ts"],"sourcesContent":[],"mappings":";;;;;;AAaA;;AACgB,UADC,+BACD,CAAA,eAAA,KAAA,EAAA,gBAAA,CAAA,GAAA,EACO,MADP,EAAA,GAAA,OAAA,GAAA,CAAA,GAAA,EACkC,MADlC,EAAA,GAC6C,MAD7C,CAAA,CAAA;EAAK;EACQ,KAAqB,EAG1C,YAH0C,CAG7B,MAH6B,CAAA;EAAM;EAAW,MAG9C,CAAA,EAAA,MAAA;EAAM;EAAP,KAMV,CAAA,EAAA,MAAA;EAAO;EAIW,MAAA,CAAA,EAJlB,OAIkB;EAoBN;EAAe,WAAA,CAAA,EAAA,MAAA;EAAA;EAChB,eACE,CAAA,EAtBJ,SAsBI;;;;;;;;;;;;;;;;;AAQsC;;iBAVvC,+BACN,6BACO,2BAA2B,WAAW;;;;;;;GAQ1D,gCAAgC,QAAQ,WAAW,QACrD,iBAAiB,QAAQ,WAAW"}

package/dist/objection/pagination.d.mts

@@ -0,0 +1,51 @@
+import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination-BziGl-B8.mjs";
+import { Model, QueryBuilder } from "objection";
+
+//#region src/objection/pagination.d.ts
+
+/**
+ * Options for paginated search with Objection.js models.
+ */
+interface ObjectionPaginatedSearchOptions<TModel extends Model, TMapRow extends (row: TModel) => unknown = (row: TModel) => TModel> {
+  /** The Objection QueryBuilder to paginate (e.g. User.query(trx).where(...)) */
+  query: QueryBuilder<TModel>;
+  /** Cursor value for pagination (value of cursorField from previous page) */
+  cursor?: string;
+  /** Maximum number of items per page (default: 20) */
+  limit?: number;
+  /** Function to transform each row to the output format (default: identity) */
+  mapRow?: TMapRow;
+  /** Field to use for cursor pagination (default: 'id') */
+  cursorField?: string;
+  /** Sort direction for cursor field (default: Direction.Asc) */
+  cursorDirection?: Direction;
+}
+/**
+ * Cursor-based paginated search for Objection.js models.
+ *
+ * Accepts a pre-built QueryBuilder so callers can apply filters,
+ * eager loading, and scopes before pagination is layered on top.
+ *
+ * @example
+ * ```typescript
+ * const result = await paginatedSearch({
+ *   query: User.query(trx).where('orgId', orgId).withGraphFetched('roles'),
+ *   cursor: previousCursor,
+ *   limit: 20,
+ *   cursorField: 'createdAt',
+ *   cursorDirection: Direction.Desc,
+ * });
+ * ```
+ */
+declare function paginatedSearch<TModel extends Model, TMapRow extends (row: TModel) => unknown = (row: TModel) => TModel>({
+  query,
+  cursor,
+  limit,
+  mapRow,
+  cursorField,
+  cursorDirection
+}: ObjectionPaginatedSearchOptions<TModel, TMapRow>): Promise<PaginationResult<Awaited<ReturnType<TMapRow>>>>;
+//# sourceMappingURL=pagination.d.ts.map
+//#endregion
+export { Direction, ObjectionPaginatedSearchOptions, PaginationResult, decodeCursor, encodeCursor, paginatedSearch };
+//# sourceMappingURL=pagination.d.mts.map

package/dist/objection/pagination.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../src/objection/pagination.ts"],"sourcesContent":[],"mappings":";;;;;;AAaA;;AACgB,UADC,+BACD,CAAA,eAAA,KAAA,EAAA,gBAAA,CAAA,GAAA,EACO,MADP,EAAA,GAAA,OAAA,GAAA,CAAA,GAAA,EACkC,MADlC,EAAA,GAC6C,MAD7C,CAAA,CAAA;EAAK;EACQ,KAAqB,EAG1C,YAH0C,CAG7B,MAH6B,CAAA;EAAM;EAAW,MAG9C,CAAA,EAAA,MAAA;EAAM;EAAP,KAMV,CAAA,EAAA,MAAA;EAAO;EAIW,MAAA,CAAA,EAJlB,OAIkB;EAoBN;EAAe,WAAA,CAAA,EAAA,MAAA;EAAA;EAChB,eACE,CAAA,EAtBJ,SAsBI;;;;;;;;;;;;;;;;;AAQsC;;iBAVvC,+BACN,6BACO,2BAA2B,WAAW;;;;;;;GAQ1D,gCAAgC,QAAQ,WAAW,QACrD,iBAAiB,QAAQ,WAAW"}