@geekmidas/db 10.0.0-alpha.16 → 10.0.0-alpha.161

package/dist/introspect/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/introspect/types.ts"],"sourcesContent":["import type { Kysely } from 'kysely';\nimport type { Direction } from '../pagination';\n\n/**\n * Filter operators a row query accepts.\n */\nexport enum FilterOperator {\n\tEq = 'eq',\n\tNeq = 'neq',\n\tGt = 'gt',\n\tGte = 'gte',\n\tLt = 'lt',\n\tLte = 'lte',\n\tLike = 'like',\n\tIlike = 'ilike',\n\tIn = 'in',\n\tNin = 'nin',\n\tIsNull = 'is_null',\n\tIsNotNull = 'is_not_null',\n}\n\n/**\n * The column a table's rows are paged by, and in which direction.\n */\nexport interface CursorConfig {\n\t/** A column whose values are unique and ordered, e.g. `id` or `created_at`. */\n\tfield: string;\n\tdirection: Direction;\n}\n\n/**\n * Options for a {@link DataBrowser}.\n */\nexport interface DataBrowserOptions<DB = unknown> {\n\tdb: Kysely<DB>;\n\t/**\n\t * The schemas to read tables from (default: `['public']`). Every schema the\n\t * database has is listed by `listSchemas` regardless; this is which of them\n\t * are browsable.\n\t */\n\tschemas?: string[];\n\t/**\n\t * The cursor every table pages by. When omitted, a table pages by its\n\t * primary key when that is a single column, ascending — the one ordering\n\t * that is unique for any table that has one.\n\t */\n\tcursor?: CursorConfig;\n\t/** Per-table cursors, by table name, for tables the default does not fit. */\n\ttableCursors?: Record<string, CursorConfig>;\n\t/** Tables left out of introspection, by name. */\n\texcludeTables?: string[];\n\t/** Rows per page when a query names none (default: 50, at most 100). */\n\tdefaultPageSize?: number;\n}\n\n/**\n * A column's type, classified independently of the engine.\n */\nexport type ColumnType =\n\t| 'string'\n\t| 'number'\n\t| 'boolean'\n\t| 'date'\n\t| 'datetime'\n\t| 'json'\n\t| 'binary'\n\t| 'uuid'\n\t| 'unknown';\n\nexport interface ColumnInfo {\n\tname: string;\n\ttype: ColumnType;\n\t/** The engine's own type name, e.g. `varchar` or `int4`. */\n\trawType: string;\n\tnullable: boolean;\n\tisPrimaryKey: boolean;\n\tisForeignKey: boolean;\n\t/** The table a foreign key references. */\n\tforeignKeyTable?: string;\n\t/** The column a foreign key references. */\n\tforeignKeyColumn?: string;\n\t/** The default value expression, as the database stores it. */\n\tdefaultValue?: string;\n}\n\nexport interface TableInfo {\n\tname: string;\n\tschema: string;\n\tcolumns: ColumnInfo[];\n\t/** Primary key column names, in key order. */\n\tprimaryKey: string[];\n\t/** Postgres's planner estimate, when it has one. */\n\testimatedRowCount?: number;\n}\n\nexport interface SchemaInfo {\n\ttables: TableInfo[];\n\t/** When the schema was introspected. */\n\tupdatedAt: Date;\n}\n\nexport interface FilterCondition {\n\tcolumn: string;\n\toperator: FilterOperator;\n\t/** Omitted for `is_null` / `is_not_null`. */\n\tvalue?: unknown;\n}\n\nexport interface SortConfig {\n\tcolumn: string;\n\tdirection: Direction;\n}\n\nexport interface QueryOptions {\n\ttable: string;\n\t/** The schema the table lives in (default: the first browsable schema). */\n\tschema?: string;\n\tfilters?: FilterCondition[];\n\tsort?: SortConfig[];\n\tcursor?: string | null;\n\tpageSize?: number;\n}\n\nexport interface QueryResult<T = Record<string, unknown>> {\n\trows: T[];\n\thasMore: boolean;\n\t/** Null when there is no next page, or the table has no cursor column. */\n\tnextCursor: string | null;\n\tprevCursor: string | null;\n}\n"],"mappings":";;;;;AAMA,IAAY,iBAAL,yBAAA,gBAAA;CACN,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,UAAA;CACA,eAAA,WAAA;CACA,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,YAAA;CACA,eAAA,eAAA;;AACD,EAAA,CAAA,CAAA"}

package/dist/introspect/types.d.cts

@@ -0,0 +1,113 @@
+import { t as Direction } from "../pagination-CrU89125.cjs";
+import { Kysely } from "kysely";
+//#region src/introspect/types.d.ts
+/**
+ * Filter operators a row query accepts.
+ */
+export declare enum FilterOperator {
+  Eq = "eq",
+  Neq = "neq",
+  Gt = "gt",
+  Gte = "gte",
+  Lt = "lt",
+  Lte = "lte",
+  Like = "like",
+  Ilike = "ilike",
+  In = "in",
+  Nin = "nin",
+  IsNull = "is_null",
+  IsNotNull = "is_not_null"
+}
+/**
+ * The column a table's rows are paged by, and in which direction.
+ */
+export interface CursorConfig {
+  /** A column whose values are unique and ordered, e.g. `id` or `created_at`. */
+  field: string;
+  direction: Direction;
+}
+/**
+ * Options for a {@link DataBrowser}.
+ */
+export interface DataBrowserOptions<DB = unknown> {
+  db: Kysely<DB>;
+  /**
+   * The schemas to read tables from (default: `['public']`). Every schema the
+   * database has is listed by `listSchemas` regardless; this is which of them
+   * are browsable.
+   */
+  schemas?: string[];
+  /**
+   * The cursor every table pages by. When omitted, a table pages by its
+   * primary key when that is a single column, ascending — the one ordering
+   * that is unique for any table that has one.
+   */
+  cursor?: CursorConfig;
+  /** Per-table cursors, by table name, for tables the default does not fit. */
+  tableCursors?: Record<string, CursorConfig>;
+  /** Tables left out of introspection, by name. */
+  excludeTables?: string[];
+  /** Rows per page when a query names none (default: 50, at most 100). */
+  defaultPageSize?: number;
+}
+/**
+ * A column's type, classified independently of the engine.
+ */
+export type ColumnType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'json' | 'binary' | 'uuid' | 'unknown';
+export interface ColumnInfo {
+  name: string;
+  type: ColumnType;
+  /** The engine's own type name, e.g. `varchar` or `int4`. */
+  rawType: string;
+  nullable: boolean;
+  isPrimaryKey: boolean;
+  isForeignKey: boolean;
+  /** The table a foreign key references. */
+  foreignKeyTable?: string;
+  /** The column a foreign key references. */
+  foreignKeyColumn?: string;
+  /** The default value expression, as the database stores it. */
+  defaultValue?: string;
+}
+export interface TableInfo {
+  name: string;
+  schema: string;
+  columns: ColumnInfo[];
+  /** Primary key column names, in key order. */
+  primaryKey: string[];
+  /** Postgres's planner estimate, when it has one. */
+  estimatedRowCount?: number;
+}
+export interface SchemaInfo {
+  tables: TableInfo[];
+  /** When the schema was introspected. */
+  updatedAt: Date;
+}
+export interface FilterCondition {
+  column: string;
+  operator: FilterOperator;
+  /** Omitted for `is_null` / `is_not_null`. */
+  value?: unknown;
+}
+export interface SortConfig {
+  column: string;
+  direction: Direction;
+}
+export interface QueryOptions {
+  table: string;
+  /** The schema the table lives in (default: the first browsable schema). */
+  schema?: string;
+  filters?: FilterCondition[];
+  sort?: SortConfig[];
+  cursor?: string | null;
+  pageSize?: number;
+}
+export interface QueryResult<T = Record<string, unknown>> {
+  rows: T[];
+  hasMore: boolean;
+  /** Null when there is no next page, or the table has no cursor column. */
+  nextCursor: string | null;
+  prevCursor: string | null;
+}
+//#endregion
+//# sourceMappingURL=types.d.cts.map

package/dist/introspect/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/introspect/types.ts"],"mappings":";;;;;;oBAMY;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAMgB;;EAEhB;EACA,WAAW;;;;;iBAMK,mBAAmB;EACnC,IAAI,OAAO;;;;;;EAMX;;;;;;EAMA,SAAS;;EAET,eAAe,eAAe;;EAE9B;;EAEA;;;;;YAMW;iBAWK;EAChB;EACA,MAAM;;EAEN;EACA;EACA;EACA;;EAEA;;EAEA;;EAEA;;iBAGgB;EAChB;EACA;EACA,SAAS;;EAET;;EAEA;;iBAGgB;EAChB,QAAQ;;EAER,WAAW;;iBAGK;EAChB;EACA,UAAU;;EAEV;;iBAGgB;EAChB;EACA,WAAW;;iBAGK;EAChB;;EAEA;EACA,UAAU;EACV,OAAO;EACP;EACA;;iBAGgB,YAAY,IAAI;EAChC,MAAM;EACN;;EAEA;EACA"}

package/dist/introspect/types.d.mts

@@ -0,0 +1,113 @@
+import { t as Direction } from "../pagination-CrU89125.mjs";
+import { Kysely } from "kysely";
+//#region src/introspect/types.d.ts
+/**
+ * Filter operators a row query accepts.
+ */
+export declare enum FilterOperator {
+  Eq = "eq",
+  Neq = "neq",
+  Gt = "gt",
+  Gte = "gte",
+  Lt = "lt",
+  Lte = "lte",
+  Like = "like",
+  Ilike = "ilike",
+  In = "in",
+  Nin = "nin",
+  IsNull = "is_null",
+  IsNotNull = "is_not_null"
+}
+/**
+ * The column a table's rows are paged by, and in which direction.
+ */
+export interface CursorConfig {
+  /** A column whose values are unique and ordered, e.g. `id` or `created_at`. */
+  field: string;
+  direction: Direction;
+}
+/**
+ * Options for a {@link DataBrowser}.
+ */
+export interface DataBrowserOptions<DB = unknown> {
+  db: Kysely<DB>;
+  /**
+   * The schemas to read tables from (default: `['public']`). Every schema the
+   * database has is listed by `listSchemas` regardless; this is which of them
+   * are browsable.
+   */
+  schemas?: string[];
+  /**
+   * The cursor every table pages by. When omitted, a table pages by its
+   * primary key when that is a single column, ascending — the one ordering
+   * that is unique for any table that has one.
+   */
+  cursor?: CursorConfig;
+  /** Per-table cursors, by table name, for tables the default does not fit. */
+  tableCursors?: Record<string, CursorConfig>;
+  /** Tables left out of introspection, by name. */
+  excludeTables?: string[];
+  /** Rows per page when a query names none (default: 50, at most 100). */
+  defaultPageSize?: number;
+}
+/**
+ * A column's type, classified independently of the engine.
+ */
+export type ColumnType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'json' | 'binary' | 'uuid' | 'unknown';
+export interface ColumnInfo {
+  name: string;
+  type: ColumnType;
+  /** The engine's own type name, e.g. `varchar` or `int4`. */
+  rawType: string;
+  nullable: boolean;
+  isPrimaryKey: boolean;
+  isForeignKey: boolean;
+  /** The table a foreign key references. */
+  foreignKeyTable?: string;
+  /** The column a foreign key references. */
+  foreignKeyColumn?: string;
+  /** The default value expression, as the database stores it. */
+  defaultValue?: string;
+}
+export interface TableInfo {
+  name: string;
+  schema: string;
+  columns: ColumnInfo[];
+  /** Primary key column names, in key order. */
+  primaryKey: string[];
+  /** Postgres's planner estimate, when it has one. */
+  estimatedRowCount?: number;
+}
+export interface SchemaInfo {
+  tables: TableInfo[];
+  /** When the schema was introspected. */
+  updatedAt: Date;
+}
+export interface FilterCondition {
+  column: string;
+  operator: FilterOperator;
+  /** Omitted for `is_null` / `is_not_null`. */
+  value?: unknown;
+}
+export interface SortConfig {
+  column: string;
+  direction: Direction;
+}
+export interface QueryOptions {
+  table: string;
+  /** The schema the table lives in (default: the first browsable schema). */
+  schema?: string;
+  filters?: FilterCondition[];
+  sort?: SortConfig[];
+  cursor?: string | null;
+  pageSize?: number;
+}
+export interface QueryResult<T = Record<string, unknown>> {
+  rows: T[];
+  hasMore: boolean;
+  /** Null when there is no next page, or the table has no cursor column. */
+  nextCursor: string | null;
+  prevCursor: string | null;
+}
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/introspect/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/introspect/types.ts"],"mappings":";;;;;;oBAMY;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAMgB;;EAEhB;EACA,WAAW;;;;;iBAMK,mBAAmB;EACnC,IAAI,OAAO;;;;;;EAMX;;;;;;EAMA,SAAS;;EAET,eAAe,eAAe;;EAE9B;;EAEA;;;;;YAMW;iBAWK;EAChB;EACA,MAAM;;EAEN;EACA;EACA;EACA;;EAEA;;EAEA;;EAEA;;iBAGgB;EAChB;EACA;EACA,SAAS;;EAET;;EAEA;;iBAGgB;EAChB,QAAQ;;EAER,WAAW;;iBAGK;EAChB;EACA,UAAU;;EAEV;;iBAGgB;EAChB;EACA,WAAW;;iBAGK;EAChB;;EAEA;EACA,UAAU;EACV,OAAO;EACP;EACA;;iBAGgB,YAAY,IAAI;EAChC,MAAM;EACN;;EAEA;EACA"}

package/dist/introspect/types.mjs

@@ -0,0 +1,23 @@
+//#region src/introspect/types.ts
+/**
+* Filter operators a row query accepts.
+*/
+let FilterOperator = /* @__PURE__ */ function(FilterOperator) {
+	FilterOperator["Eq"] = "eq";
+	FilterOperator["Neq"] = "neq";
+	FilterOperator["Gt"] = "gt";
+	FilterOperator["Gte"] = "gte";
+	FilterOperator["Lt"] = "lt";
+	FilterOperator["Lte"] = "lte";
+	FilterOperator["Like"] = "like";
+	FilterOperator["Ilike"] = "ilike";
+	FilterOperator["In"] = "in";
+	FilterOperator["Nin"] = "nin";
+	FilterOperator["IsNull"] = "is_null";
+	FilterOperator["IsNotNull"] = "is_not_null";
+	return FilterOperator;
+}({});
+//#endregion
+export { FilterOperator };
+
+//# sourceMappingURL=types.mjs.map

package/dist/introspect/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/introspect/types.ts"],"sourcesContent":["import type { Kysely } from 'kysely';\nimport type { Direction } from '../pagination';\n\n/**\n * Filter operators a row query accepts.\n */\nexport enum FilterOperator {\n\tEq = 'eq',\n\tNeq = 'neq',\n\tGt = 'gt',\n\tGte = 'gte',\n\tLt = 'lt',\n\tLte = 'lte',\n\tLike = 'like',\n\tIlike = 'ilike',\n\tIn = 'in',\n\tNin = 'nin',\n\tIsNull = 'is_null',\n\tIsNotNull = 'is_not_null',\n}\n\n/**\n * The column a table's rows are paged by, and in which direction.\n */\nexport interface CursorConfig {\n\t/** A column whose values are unique and ordered, e.g. `id` or `created_at`. */\n\tfield: string;\n\tdirection: Direction;\n}\n\n/**\n * Options for a {@link DataBrowser}.\n */\nexport interface DataBrowserOptions<DB = unknown> {\n\tdb: Kysely<DB>;\n\t/**\n\t * The schemas to read tables from (default: `['public']`). Every schema the\n\t * database has is listed by `listSchemas` regardless; this is which of them\n\t * are browsable.\n\t */\n\tschemas?: string[];\n\t/**\n\t * The cursor every table pages by. When omitted, a table pages by its\n\t * primary key when that is a single column, ascending — the one ordering\n\t * that is unique for any table that has one.\n\t */\n\tcursor?: CursorConfig;\n\t/** Per-table cursors, by table name, for tables the default does not fit. */\n\ttableCursors?: Record<string, CursorConfig>;\n\t/** Tables left out of introspection, by name. */\n\texcludeTables?: string[];\n\t/** Rows per page when a query names none (default: 50, at most 100). */\n\tdefaultPageSize?: number;\n}\n\n/**\n * A column's type, classified independently of the engine.\n */\nexport type ColumnType =\n\t| 'string'\n\t| 'number'\n\t| 'boolean'\n\t| 'date'\n\t| 'datetime'\n\t| 'json'\n\t| 'binary'\n\t| 'uuid'\n\t| 'unknown';\n\nexport interface ColumnInfo {\n\tname: string;\n\ttype: ColumnType;\n\t/** The engine's own type name, e.g. `varchar` or `int4`. */\n\trawType: string;\n\tnullable: boolean;\n\tisPrimaryKey: boolean;\n\tisForeignKey: boolean;\n\t/** The table a foreign key references. */\n\tforeignKeyTable?: string;\n\t/** The column a foreign key references. */\n\tforeignKeyColumn?: string;\n\t/** The default value expression, as the database stores it. */\n\tdefaultValue?: string;\n}\n\nexport interface TableInfo {\n\tname: string;\n\tschema: string;\n\tcolumns: ColumnInfo[];\n\t/** Primary key column names, in key order. */\n\tprimaryKey: string[];\n\t/** Postgres's planner estimate, when it has one. */\n\testimatedRowCount?: number;\n}\n\nexport interface SchemaInfo {\n\ttables: TableInfo[];\n\t/** When the schema was introspected. */\n\tupdatedAt: Date;\n}\n\nexport interface FilterCondition {\n\tcolumn: string;\n\toperator: FilterOperator;\n\t/** Omitted for `is_null` / `is_not_null`. */\n\tvalue?: unknown;\n}\n\nexport interface SortConfig {\n\tcolumn: string;\n\tdirection: Direction;\n}\n\nexport interface QueryOptions {\n\ttable: string;\n\t/** The schema the table lives in (default: the first browsable schema). */\n\tschema?: string;\n\tfilters?: FilterCondition[];\n\tsort?: SortConfig[];\n\tcursor?: string | null;\n\tpageSize?: number;\n}\n\nexport interface QueryResult<T = Record<string, unknown>> {\n\trows: T[];\n\thasMore: boolean;\n\t/** Null when there is no next page, or the table has no cursor column. */\n\tnextCursor: string | null;\n\tprevCursor: string | null;\n}\n"],"mappings":";;;;AAMA,IAAY,iBAAL,yBAAA,gBAAA;CACN,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,UAAA;CACA,eAAA,WAAA;CACA,eAAA,QAAA;CACA,eAAA,SAAA;CACA,eAAA,YAAA;CACA,eAAA,eAAA;;AACD,EAAA,CAAA,CAAA"}

package/dist/kysely/pagination.cjs

@@ -48,6 +48,7 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 }
 //#endregion
 exports.Direction = require_pagination.Direction;
+exports.InvalidCursor = require_pagination.InvalidCursor;
 exports.decodeCursor = require_pagination.decodeCursor;
 exports.encodeCursor = require_pagination.encodeCursor;
 exports.paginatedSearch = paginatedSearch;

package/dist/kysely/pagination.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.cjs","names":[],"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,kBAAA,SAGC;CAQD,MAAM,SAAQ,MANY,MACxB,YAAY,CAAC,CACb,aAAa,CAAC,CACd,QAAQ,OAAO,GAAG,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAC5C,wBAAwB,EAAA,CAEA;CAG1B,IAAI,iBAAiB;CACrB,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAC/B,aACA,UACA,MACD;CACD;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,eAAe,CAAC,CAC5C,MAAM,QAAQ,CAAC,CAAC,CAChB,QAAQ;CAEV,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,YAAY,IAAI,KAAA;CAErD,MAAM,SAAS,YAAY,QAAc;CAKzC,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX,OAAO,OAAO,KAAK;GACnB;GACA,QAAQ;EACT;CACD;AACD"}
+{"version":3,"file":"pagination.cjs","names":[],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\nimport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n} from '../pagination';\n\nexport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n};\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":";;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAA,SAGC;CAQD,MAAM,SAAQ,MANY,MACxB,YAAY,CAAC,CACb,aAAa,CAAC,CACd,QAAQ,OAAO,GAAG,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAC5C,wBAAwB,EAAA,CAEA;CAG1B,IAAI,iBAAiB;CACrB,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAC/B,aACA,UACA,MACD;CACD;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,eAAe,CAAC,CAC5C,MAAM,QAAQ,CAAC,CAAC,CAChB,QAAQ;CAEV,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,YAAY,IAAI,KAAA;CAErD,MAAM,SAAS,YAAY,QAAc;CAKzC,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX,OAAO,OAAO,KAAK;GACnB;GACA,QAAQ;EACT;CACD;AACD"}

package/dist/kysely/pagination.d.cts

@@ -1,4 +1,4 @@
-import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination.cjs";
+import { a as encodeCursor, i as decodeCursor, n as InvalidCursor, r as PaginationResult, t as Direction } from "../pagination-CrU89125.cjs";
 import { SelectQueryBuilder } from "kysely";
 //#region src/kysely/pagination.d.ts
 /**
@@ -43,5 +43,5 @@ export interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unk
  */
 export declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow>({ query, cursor, limit, mapRow, cursorField, cursorDirection }: PaginatedSearchOptions<TRow, TMapRow>): Promise<PaginationResult<Awaited<ReturnType<TMapRow>>>>;
 //#endregion
-export { Direction, type PaginationResult, decodeCursor, encodeCursor };
+export { Direction, InvalidCursor, type PaginationResult, decodeCursor, encodeCursor };
 //# sourceMappingURL=pagination.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.cts","names":[],"sources":["../../src/kysely/pagination.ts"],"mappings":";;;;;;iBAaiB,uBAChB,MACA,iBAAiB,KAAK,oBAAoB,KAAK,SAAS;;EAGxD,OAAO,6BAA6B;;EAEpC;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;wBA0BG,gBACrB,aAAa,yBACb,iBAAiB,KAAK,oBAAoB,KAAK,SAAS,QAExD,OACA,QACA,OACA,QACA,aACA,mBACE,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW"}
+{"version":3,"file":"pagination.d.cts","names":[],"sources":["../../src/kysely/pagination.ts"],"mappings":";;;;;;iBAoBiB,uBAChB,MACA,iBAAiB,KAAK,oBAAoB,KAAK,SAAS;;EAGxD,OAAO,6BAA6B;;EAEpC;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;wBA0BG,gBACrB,aAAa,yBACb,iBAAiB,KAAK,oBAAoB,KAAK,SAAS,QAExD,OACA,QACA,OACA,QACA,aACA,mBACE,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW"}

package/dist/kysely/pagination.d.mts

@@ -1,4 +1,4 @@
-import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination.mjs";
+import { a as encodeCursor, i as decodeCursor, n as InvalidCursor, r as PaginationResult, t as Direction } from "../pagination-CrU89125.mjs";
 import { SelectQueryBuilder } from "kysely";
 //#region src/kysely/pagination.d.ts
 /**
@@ -43,5 +43,5 @@ export interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unk
  */
 export declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow>({ query, cursor, limit, mapRow, cursorField, cursorDirection }: PaginatedSearchOptions<TRow, TMapRow>): Promise<PaginationResult<Awaited<ReturnType<TMapRow>>>>;
 //#endregion
-export { Direction, type PaginationResult, decodeCursor, encodeCursor };
+export { Direction, InvalidCursor, type PaginationResult, decodeCursor, encodeCursor };
 //# sourceMappingURL=pagination.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../src/kysely/pagination.ts"],"mappings":";;;;;;iBAaiB,uBAChB,MACA,iBAAiB,KAAK,oBAAoB,KAAK,SAAS;;EAGxD,OAAO,6BAA6B;;EAEpC;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;wBA0BG,gBACrB,aAAa,yBACb,iBAAiB,KAAK,oBAAoB,KAAK,SAAS,QAExD,OACA,QACA,OACA,QACA,aACA,mBACE,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW"}
+{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../src/kysely/pagination.ts"],"mappings":";;;;;;iBAoBiB,uBAChB,MACA,iBAAiB,KAAK,oBAAoB,KAAK,SAAS;;EAGxD,OAAO,6BAA6B;;EAEpC;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;wBA0BG,gBACrB,aAAa,yBACb,iBAAiB,KAAK,oBAAoB,KAAK,SAAS,QAExD,OACA,QACA,OACA,QACA,aACA,mBACE,uBAAuB,MAAM,WAAW,QAC1C,iBAAiB,QAAQ,WAAW"}

package/dist/kysely/pagination.mjs

@@ -1,4 +1,4 @@
-import { Direction, decodeCursor, encodeCursor } from "../pagination.mjs";
+import { Direction, InvalidCursor, decodeCursor, encodeCursor } from "../pagination.mjs";
 //#region src/kysely/pagination.ts
 /**
 * Generic paginated search function that handles:
@@ -46,6 +46,6 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 	};
 }
 //#endregion
-export { Direction, decodeCursor, encodeCursor, paginatedSearch };
+export { Direction, InvalidCursor, decodeCursor, encodeCursor, paginatedSearch };
 
 //# sourceMappingURL=pagination.mjs.map

package/dist/kysely/pagination.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.mjs","names":[],"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,kBAAA,SAGC;CAQD,MAAM,SAAQ,MANY,MACxB,YAAY,CAAC,CACb,aAAa,CAAC,CACd,QAAQ,OAAO,GAAG,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAC5C,wBAAwB,EAAA,CAEA;CAG1B,IAAI,iBAAiB;CACrB,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAC/B,aACA,UACA,MACD;CACD;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,eAAe,CAAC,CAC5C,MAAM,QAAQ,CAAC,CAAC,CAChB,QAAQ;CAEV,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,YAAY,IAAI,KAAA;CAErD,MAAM,SAAS,YAAY,QAAc;CAKzC,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX,OAAO,OAAO,KAAK;GACnB;GACA,QAAQ;EACT;CACD;AACD"}
+{"version":3,"file":"pagination.mjs","names":[],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\nimport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n} from '../pagination';\n\nexport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n};\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":";;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAA,SAGC;CAQD,MAAM,SAAQ,MANY,MACxB,YAAY,CAAC,CACb,aAAa,CAAC,CACd,QAAQ,OAAO,GAAG,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAC5C,wBAAwB,EAAA,CAEA;CAG1B,IAAI,iBAAiB;CACrB,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAC/B,aACA,UACA,MACD;CACD;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAoB,eAAe,CAAC,CAC5C,MAAM,QAAQ,CAAC,CAAC,CAChB,QAAQ;CAEV,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UAAU,OAAO,QAAQ,YAAY,IAAI,KAAA;CAErD,MAAM,SAAS,YAAY,QAAc;CAKzC,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX,OAAO,OAAO,KAAK;GACnB;GACA,QAAQ;EACT;CACD;AACD"}

package/dist/objection/pagination.cjs

@@ -42,6 +42,7 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 }
 //#endregion
 exports.Direction = require_pagination.Direction;
+exports.InvalidCursor = require_pagination.InvalidCursor;
 exports.decodeCursor = require_pagination.decodeCursor;
 exports.encodeCursor = require_pagination.encodeCursor;
 exports.paginatedSearch = paginatedSearch;

package/dist/objection/pagination.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.cjs","names":[],"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,kBAAA,SAGC;CAED,MAAM,QAAQ,MAAM,MAAM,WAAW;CAGrC,IAAI,iBAAiB,MAAM,MAAM;CACjC,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAAM,aAAa,UAAU,MAAM;CACpE;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAa,eAAe,CAAC,CACrC,MAAM,QAAQ,CAAC;CAEjB,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UACR,OAAQ,QAAoC,YAAY,IACxD,KAAA;CAEJ,MAAM,SAAS,YAAY,QAAgB;CAK3C,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX;GACA;GACA,QAAQ;EACT;CACD;AACD"}
+{"version":3,"file":"pagination.cjs","names":[],"sources":["../../src/objection/pagination.ts"],"sourcesContent":["import type { Model, QueryBuilder } from 'objection';\nimport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n} from '../pagination';\n\nexport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n};\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":";;;;;;;;;;;;;;;;;;;;AAuDA,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAA,SAGC;CAED,MAAM,QAAQ,MAAM,MAAM,WAAW;CAGrC,IAAI,iBAAiB,MAAM,MAAM;CACjC,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAAM,aAAa,UAAU,MAAM;CACpE;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAa,eAAe,CAAC,CACrC,MAAM,QAAQ,CAAC;CAEjB,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UACR,OAAQ,QAAoC,YAAY,IACxD,KAAA;CAEJ,MAAM,SAAS,YAAY,QAAgB;CAK3C,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX;GACA;GACA,QAAQ;EACT;CACD;AACD"}

package/dist/objection/pagination.d.cts

@@ -1,4 +1,4 @@
-import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination.cjs";
+import { a as encodeCursor, i as decodeCursor, n as InvalidCursor, r as PaginationResult, t as Direction } from "../pagination-CrU89125.cjs";
 import { Model, QueryBuilder } from "objection";
 //#region src/objection/pagination.d.ts
 /**
@@ -37,5 +37,5 @@ export interface ObjectionPaginatedSearchOptions<TModel extends Model, TMapRow e
  */
 export 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>>>>;
 //#endregion
-export { Direction, type PaginationResult, decodeCursor, encodeCursor };
+export { Direction, InvalidCursor, type PaginationResult, decodeCursor, encodeCursor };
 //# sourceMappingURL=pagination.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.cts","names":[],"sources":["../../src/objection/pagination.ts"],"mappings":";;;;;;iBAaiB,gCAChB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW;;EAG5D,OAAO,aAAa;;EAEpB;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;wBAoBG,gBACrB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW,UAE5D,OACA,QACA,OACA,QACA,aACA,mBACE,gCAAgC,QAAQ,WAAW,QACrD,iBAAiB,QAAQ,WAAW"}
+{"version":3,"file":"pagination.d.cts","names":[],"sources":["../../src/objection/pagination.ts"],"mappings":";;;;;;iBAoBiB,gCAChB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW;;EAG5D,OAAO,aAAa;;EAEpB;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;wBAoBG,gBACrB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW,UAE5D,OACA,QACA,OACA,QACA,aACA,mBACE,gCAAgC,QAAQ,WAAW,QACrD,iBAAiB,QAAQ,WAAW"}

package/dist/objection/pagination.d.mts

@@ -1,4 +1,4 @@
-import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination.mjs";
+import { a as encodeCursor, i as decodeCursor, n as InvalidCursor, r as PaginationResult, t as Direction } from "../pagination-CrU89125.mjs";
 import { Model, QueryBuilder } from "objection";
 //#region src/objection/pagination.d.ts
 /**
@@ -37,5 +37,5 @@ export interface ObjectionPaginatedSearchOptions<TModel extends Model, TMapRow e
  */
 export 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>>>>;
 //#endregion
-export { Direction, type PaginationResult, decodeCursor, encodeCursor };
+export { Direction, InvalidCursor, type PaginationResult, decodeCursor, encodeCursor };
 //# sourceMappingURL=pagination.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../src/objection/pagination.ts"],"mappings":";;;;;;iBAaiB,gCAChB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW;;EAG5D,OAAO,aAAa;;EAEpB;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;wBAoBG,gBACrB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW,UAE5D,OACA,QACA,OACA,QACA,aACA,mBACE,gCAAgC,QAAQ,WAAW,QACrD,iBAAiB,QAAQ,WAAW"}
+{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../src/objection/pagination.ts"],"mappings":";;;;;;iBAoBiB,gCAChB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW;;EAG5D,OAAO,aAAa;;EAEpB;;EAEA;;EAEA,SAAS;;EAET;;EAEA,kBAAkB;;;;;;;;;;;;;;;;;;;wBAoBG,gBACrB,eAAe,OACf,iBAAiB,KAAK,sBAAsB,KAAK,WAAW,UAE5D,OACA,QACA,OACA,QACA,aACA,mBACE,gCAAgC,QAAQ,WAAW,QACrD,iBAAiB,QAAQ,WAAW"}

package/dist/objection/pagination.mjs

@@ -1,4 +1,4 @@
-import { Direction, decodeCursor, encodeCursor } from "../pagination.mjs";
+import { Direction, InvalidCursor, decodeCursor, encodeCursor } from "../pagination.mjs";
 //#region src/objection/pagination.ts
 /**
 * Cursor-based paginated search for Objection.js models.
@@ -40,6 +40,6 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 	};
 }
 //#endregion
-export { Direction, decodeCursor, encodeCursor, paginatedSearch };
+export { Direction, InvalidCursor, decodeCursor, encodeCursor, paginatedSearch };
 
 //# sourceMappingURL=pagination.mjs.map

package/dist/objection/pagination.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.mjs","names":[],"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,kBAAA,SAGC;CAED,MAAM,QAAQ,MAAM,MAAM,WAAW;CAGrC,IAAI,iBAAiB,MAAM,MAAM;CACjC,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAAM,aAAa,UAAU,MAAM;CACpE;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAa,eAAe,CAAC,CACrC,MAAM,QAAQ,CAAC;CAEjB,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UACR,OAAQ,QAAoC,YAAY,IACxD,KAAA;CAEJ,MAAM,SAAS,YAAY,QAAgB;CAK3C,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX;GACA;GACA,QAAQ;EACT;CACD;AACD"}
+{"version":3,"file":"pagination.mjs","names":[],"sources":["../../src/objection/pagination.ts"],"sourcesContent":["import type { Model, QueryBuilder } from 'objection';\nimport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n} from '../pagination';\n\nexport {\n\tDirection,\n\tdecodeCursor,\n\tencodeCursor,\n\tInvalidCursor,\n\ttype PaginationResult,\n};\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":";;;;;;;;;;;;;;;;;;;AAuDA,eAAsB,gBAGpB,EACD,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAA,SAGC;CAED,MAAM,QAAQ,MAAM,MAAM,WAAW;CAGrC,IAAI,iBAAiB,MAAM,MAAM;CACjC,IAAI,QAAQ;EACX,MAAM,WAAW,oBAAA,QAAoC,MAAM;EAC3D,iBAAiB,eAAe,MAAM,aAAa,UAAU,MAAM;CACpE;CAGA,MAAM,OAAO,MAAM,eACjB,QAAQ,aAAa,eAAe,CAAC,CACrC,MAAM,QAAQ,CAAC;CAEjB,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACL,WAAW,UACR,OAAQ,QAAoC,YAAY,IACxD,KAAA;CAEJ,MAAM,SAAS,YAAY,QAAgB;CAK3C,OAAO;EACN,OAAA,MALoB,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;EAMhD,YAAY;GACX;GACA;GACA,QAAQ;EACT;CACD;AACD"}

package/dist/pagination-CrU89125.d.cts

@@ -0,0 +1,42 @@
+//#region src/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;
+  };
+}
+/**
+ * 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;
+/**
+ * A cursor that did not come from `encodeCursor`.
+ *
+ * Usually a cursor from a different page size or sort that was edited by hand,
+ * or truncated on its way through a URL. The fix is the same either way: start
+ * again from the first page.
+ */
+declare class InvalidCursor extends Error {
+  readonly cursor: string;
+  constructor(cursor: string);
+}
+//#endregion
+export { encodeCursor as a, decodeCursor as i, InvalidCursor as n, PaginationResult as r, Direction as t };
+//# sourceMappingURL=pagination-CrU89125.d.cts.map

package/dist/pagination-CrU89125.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-CrU89125.d.cts","names":[],"sources":["../src/pagination.ts"],"mappings":";;;;aAGY;EACX;EACA;;;;;UAMgB,iBAAiB;EACjC,OAAO;EACP;IACC;IACA;IACA;;;;;;;iBAQc,aAAa;;;;iBAWb,aAAa;;;;;;;;cAsBhB,sBAAsB;WACb;EAArB,YAAqB"}

package/dist/pagination-CrU89125.d.mts

@@ -0,0 +1,42 @@
+//#region src/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;
+  };
+}
+/**
+ * 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;
+/**
+ * A cursor that did not come from `encodeCursor`.
+ *
+ * Usually a cursor from a different page size or sort that was edited by hand,
+ * or truncated on its way through a URL. The fix is the same either way: start
+ * again from the first page.
+ */
+declare class InvalidCursor extends Error {
+  readonly cursor: string;
+  constructor(cursor: string);
+}
+//#endregion
+export { encodeCursor as a, decodeCursor as i, InvalidCursor as n, PaginationResult as r, Direction as t };
+//# sourceMappingURL=pagination-CrU89125.d.mts.map

package/dist/pagination-CrU89125.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-CrU89125.d.mts","names":[],"sources":["../src/pagination.ts"],"mappings":";;;;aAGY;EACX;EACA;;;;;UAMgB,iBAAiB;EACjC,OAAO;EACP;IACC;IACA;IACA;;;;;;;iBAQc,aAAa;;;;iBAWb,aAAa;;;;;;;;cAsBhB,sBAAsB;WACb;EAArB,YAAqB"}

package/dist/pagination.cjs

@@ -29,11 +29,27 @@ function decodeCursor(cursor) {
 		if (payload.t === "date") return new Date(payload.v);
 		return payload.v;
 	} catch {
-		throw new Error("Invalid cursor format");
+		throw new InvalidCursor(cursor);
 	}
 }
+/**
+* A cursor that did not come from `encodeCursor`.
+*
+* Usually a cursor from a different page size or sort that was edited by hand,
+* or truncated on its way through a URL. The fix is the same either way: start
+* again from the first page.
+*/
+var InvalidCursor = class extends Error {
+	cursor;
+	constructor(cursor) {
+		super("This cursor was not produced by encodeCursor. Drop it and request the first page again.");
+		this.cursor = cursor;
+		this.name = "InvalidCursor";
+	}
+};
 //#endregion
 exports.Direction = Direction;
+exports.InvalidCursor = InvalidCursor;
 exports.decodeCursor = decodeCursor;
 exports.encodeCursor = encodeCursor;
 

package/dist/pagination.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.cjs","names":[],"sources":["../src/pagination.ts"],"sourcesContent":["/**\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 * 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":";;;;;AAGA,IAAY,YAAL,yBAAA,WAAA;CACN,UAAA,SAAA;CACA,UAAA,UAAA;;AACD,EAAA,CAAA,CAAA;;;;;AAkBA,SAAgB,aAAa,OAAwB;CACpD,MAAM,UAAU;EACf,GAAG,iBAAiB,OAAO,MAAM,YAAY,IAAI;EACjD,GAAG,iBAAiB,OAAO,SAAS,OAAO;CAC5C;CACA,OAAO,OAAO,KAAK,KAAK,UAAU,OAAO,CAAC,CAAC,CAAC,SAAS,WAAW;AACjE;;;;AAKA,SAAgB,aAAa,QAAyB;CACrD,IAAI;EACH,MAAM,OAAO,OAAO,KAAK,QAAQ,WAAW,CAAC,CAAC,SAAS,OAAO;EAC9D,MAAM,UAAU,KAAK,MAAM,IAAI;EAE/B,IAAI,QAAQ,MAAM,QACjB,OAAO,IAAI,KAAK,QAAQ,CAAC;EAG1B,OAAO,QAAQ;CAChB,QAAQ;EACP,MAAM,IAAI,MAAM,uBAAuB;CACxC;AACD"}
+{"version":3,"file":"pagination.cjs","names":[],"sources":["../src/pagination.ts"],"sourcesContent":["/**\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 * 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 InvalidCursor(cursor);\n\t}\n}\n\n/**\n * A cursor that did not come from `encodeCursor`.\n *\n * Usually a cursor from a different page size or sort that was edited by hand,\n * or truncated on its way through a URL. The fix is the same either way: start\n * again from the first page.\n */\nexport class InvalidCursor extends Error {\n\tconstructor(readonly cursor: string) {\n\t\tsuper(\n\t\t\t'This cursor was not produced by encodeCursor. Drop it and request the first page again.',\n\t\t);\n\t\tthis.name = 'InvalidCursor';\n\t}\n}\n"],"mappings":";;;;;AAGA,IAAY,YAAL,yBAAA,WAAA;CACN,UAAA,SAAA;CACA,UAAA,UAAA;;AACD,EAAA,CAAA,CAAA;;;;;AAkBA,SAAgB,aAAa,OAAwB;CACpD,MAAM,UAAU;EACf,GAAG,iBAAiB,OAAO,MAAM,YAAY,IAAI;EACjD,GAAG,iBAAiB,OAAO,SAAS,OAAO;CAC5C;CACA,OAAO,OAAO,KAAK,KAAK,UAAU,OAAO,CAAC,CAAC,CAAC,SAAS,WAAW;AACjE;;;;AAKA,SAAgB,aAAa,QAAyB;CACrD,IAAI;EACH,MAAM,OAAO,OAAO,KAAK,QAAQ,WAAW,CAAC,CAAC,SAAS,OAAO;EAC9D,MAAM,UAAU,KAAK,MAAM,IAAI;EAE/B,IAAI,QAAQ,MAAM,QACjB,OAAO,IAAI,KAAK,QAAQ,CAAC;EAG1B,OAAO,QAAQ;CAChB,QAAQ;EACP,MAAM,IAAI,cAAc,MAAM;CAC/B;AACD;;;;;;;;AASA,IAAa,gBAAb,cAAmC,MAAM;CACnB;CAArB,YAAY,QAAyB;EACpC,MACC,yFACD;EAHoB,KAAA,SAAA;EAIpB,KAAK,OAAO;CACb;AACD"}