@geekmidas/db 10.0.0-alpha.9 → 10.0.0-alpha.90

package/dist/introspect/introspection.mjs

@@ -0,0 +1,146 @@
+import { sql } from "kysely";
+//#region src/introspect/introspection.ts
+/**
+* The schemas the database has, without Postgres's own (`pg_catalog`,
+* `pg_toast`, `information_schema`, …).
+*/
+async function listSchemas(db) {
+	const { rows } = await sql`
+		SELECT nspname AS name
+		FROM pg_catalog.pg_namespace
+		WHERE nspname <> 'information_schema'
+			AND nspname NOT LIKE 'pg\\_%'
+		ORDER BY nspname
+	`.execute(db);
+	return rows.map((row) => row.name);
+}
+/**
+* Every base table in the given schemas, with its columns, primary key and
+* foreign keys. Views are left out: they have no key to page by.
+*/
+async function introspectSchema(db, options = {}) {
+	const schemas = options.schemas ?? ["public"];
+	const excluded = options.excludeTables ?? [];
+	const { rows } = await sql`
+		SELECT table_name AS name, table_schema AS schema
+		FROM information_schema.tables
+		WHERE table_schema = ANY(${schemas})
+			AND table_type = 'BASE TABLE'
+			AND NOT (table_name = ANY(${excluded}))
+		ORDER BY table_schema, table_name
+	`.execute(db);
+	return {
+		tables: await Promise.all(rows.map((row) => introspectTable(db, row.name, row.schema))),
+		updatedAt: /* @__PURE__ */ new Date()
+	};
+}
+/**
+* One table's columns, primary key, foreign keys and estimated row count.
+*/
+async function introspectTable(db, tableName, schema = "public") {
+	const [columns, foreignKeys, estimate] = await Promise.all([
+		sql`
+			SELECT
+				c.column_name AS name,
+				c.udt_name AS udt,
+				c.is_nullable AS nullable,
+				c.column_default AS fallback,
+				EXISTS (
+					SELECT 1
+					FROM information_schema.table_constraints tc
+					JOIN information_schema.key_column_usage ku
+						ON tc.constraint_name = ku.constraint_name
+						AND tc.table_schema = ku.table_schema
+					WHERE tc.table_name = c.table_name
+						AND tc.table_schema = c.table_schema
+						AND tc.constraint_type = 'PRIMARY KEY'
+						AND ku.column_name = c.column_name
+				) AS pk
+			FROM information_schema.columns c
+			WHERE c.table_name = ${tableName}
+				AND c.table_schema = ${schema}
+			ORDER BY c.ordinal_position
+		`.execute(db),
+		sql`
+			SELECT
+				kcu.column_name AS name,
+				ccu.table_name AS target,
+				ccu.column_name AS referenced
+			FROM information_schema.table_constraints tc
+			JOIN information_schema.key_column_usage kcu
+				ON tc.constraint_name = kcu.constraint_name
+				AND tc.table_schema = kcu.table_schema
+			JOIN information_schema.constraint_column_usage ccu
+				ON tc.constraint_name = ccu.constraint_name
+				AND tc.table_schema = ccu.table_schema
+			WHERE tc.table_name = ${tableName}
+				AND tc.table_schema = ${schema}
+				AND tc.constraint_type = 'FOREIGN KEY'
+		`.execute(db),
+		sql`
+			SELECT c.reltuples::bigint AS estimate
+			FROM pg_catalog.pg_class c
+			JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
+			WHERE c.relname = ${tableName}
+				AND n.nspname = ${schema}
+		`.execute(db)
+	]);
+	const references = new Map(foreignKeys.rows.map((row) => [row.name, {
+		table: row.target,
+		column: row.referenced
+	}]));
+	const columnInfo = columns.rows.map((row) => {
+		const reference = references.get(row.name);
+		return {
+			name: row.name,
+			type: mapPostgresType(row.udt),
+			rawType: row.udt,
+			nullable: row.nullable === "YES",
+			isPrimaryKey: row.pk,
+			isForeignKey: !!reference,
+			foreignKeyTable: reference?.table,
+			foreignKeyColumn: reference?.column,
+			defaultValue: row.fallback ?? void 0
+		};
+	});
+	const rowEstimate = Number(estimate.rows[0]?.estimate ?? 0);
+	return {
+		name: tableName,
+		schema,
+		columns: columnInfo,
+		primaryKey: columnInfo.filter((c) => c.isPrimaryKey).map((c) => c.name),
+		estimatedRowCount: rowEstimate > 0 ? rowEstimate : void 0
+	};
+}
+const POSTGRES_TYPES = {
+	varchar: "string",
+	char: "string",
+	text: "string",
+	name: "string",
+	bpchar: "string",
+	citext: "string",
+	int2: "number",
+	int4: "number",
+	int8: "number",
+	float4: "number",
+	float8: "number",
+	numeric: "number",
+	money: "number",
+	bool: "boolean",
+	date: "date",
+	timestamp: "datetime",
+	timestamptz: "datetime",
+	time: "datetime",
+	timetz: "datetime",
+	json: "json",
+	jsonb: "json",
+	bytea: "binary",
+	uuid: "uuid"
+};
+function mapPostgresType(udtName) {
+	return POSTGRES_TYPES[udtName] ?? "unknown";
+}
+//#endregion
+export { introspectSchema, introspectTable, listSchemas };
+
+//# sourceMappingURL=introspection.mjs.map

package/dist/introspect/introspection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.mjs","names":[],"sources":["../../src/introspect/introspection.ts"],"sourcesContent":["import { type Kysely, sql } from 'kysely';\nimport type { ColumnInfo, ColumnType, SchemaInfo, TableInfo } from './types';\n\n// Every query aliases its columns to a single lower-case word. A `Kysely` built\n// with `CamelCasePlugin` rewrites result keys, so `column_name` would come back\n// as `columnName` from one client and `column_name` from another; a one-word\n// alias reads the same through both.\n\n/**\n * The schemas the database has, without Postgres's own (`pg_catalog`,\n * `pg_toast`, `information_schema`, …).\n */\nexport async function listSchemas<DB>(db: Kysely<DB>): Promise<string[]> {\n\tconst { rows } = await sql<{ name: string }>`\n\t\tSELECT nspname AS name\n\t\tFROM pg_catalog.pg_namespace\n\t\tWHERE nspname <> 'information_schema'\n\t\t\tAND nspname NOT LIKE 'pg\\\\_%'\n\t\tORDER BY nspname\n\t`.execute(db);\n\n\treturn rows.map((row) => row.name);\n}\n\nexport interface IntrospectSchemaOptions {\n\t/** The schemas to read tables from (default: `['public']`). */\n\tschemas?: string[];\n\t/** Tables to leave out, by name. */\n\texcludeTables?: string[];\n}\n\n/**\n * Every base table in the given schemas, with its columns, primary key and\n * foreign keys. Views are left out: they have no key to page by.\n */\nexport async function introspectSchema<DB>(\n\tdb: Kysely<DB>,\n\toptions: IntrospectSchemaOptions = {},\n): Promise<SchemaInfo> {\n\tconst schemas = options.schemas ?? ['public'];\n\tconst excluded = options.excludeTables ?? [];\n\n\tconst { rows } = await sql<{ name: string; schema: string }>`\n\t\tSELECT table_name AS name, table_schema AS schema\n\t\tFROM information_schema.tables\n\t\tWHERE table_schema = ANY(${schemas})\n\t\t\tAND table_type = 'BASE TABLE'\n\t\t\tAND NOT (table_name = ANY(${excluded}))\n\t\tORDER BY table_schema, table_name\n\t`.execute(db);\n\n\tconst tables = await Promise.all(\n\t\trows.map((row) => introspectTable(db, row.name, row.schema)),\n\t);\n\n\treturn { tables, updatedAt: new Date() };\n}\n\n/**\n * One table's columns, primary key, foreign keys and estimated row count.\n */\nexport async function introspectTable<DB>(\n\tdb: Kysely<DB>,\n\ttableName: string,\n\tschema = 'public',\n): Promise<TableInfo> {\n\tconst [columns, foreignKeys, estimate] = await Promise.all([\n\t\tsql<{\n\t\t\tname: string;\n\t\t\tudt: string;\n\t\t\tnullable: string;\n\t\t\tfallback: string | null;\n\t\t\tpk: boolean;\n\t\t}>`\n\t\t\tSELECT\n\t\t\t\tc.column_name AS name,\n\t\t\t\tc.udt_name AS udt,\n\t\t\t\tc.is_nullable AS nullable,\n\t\t\t\tc.column_default AS fallback,\n\t\t\t\tEXISTS (\n\t\t\t\t\tSELECT 1\n\t\t\t\t\tFROM information_schema.table_constraints tc\n\t\t\t\t\tJOIN information_schema.key_column_usage ku\n\t\t\t\t\t\tON tc.constraint_name = ku.constraint_name\n\t\t\t\t\t\tAND tc.table_schema = ku.table_schema\n\t\t\t\t\tWHERE tc.table_name = c.table_name\n\t\t\t\t\t\tAND tc.table_schema = c.table_schema\n\t\t\t\t\t\tAND tc.constraint_type = 'PRIMARY KEY'\n\t\t\t\t\t\tAND ku.column_name = c.column_name\n\t\t\t\t) AS pk\n\t\t\tFROM information_schema.columns c\n\t\t\tWHERE c.table_name = ${tableName}\n\t\t\t\tAND c.table_schema = ${schema}\n\t\t\tORDER BY c.ordinal_position\n\t\t`.execute(db),\n\t\tsql<{ name: string; target: string; referenced: string }>`\n\t\t\tSELECT\n\t\t\t\tkcu.column_name AS name,\n\t\t\t\tccu.table_name AS target,\n\t\t\t\tccu.column_name AS referenced\n\t\t\tFROM information_schema.table_constraints tc\n\t\t\tJOIN information_schema.key_column_usage kcu\n\t\t\t\tON tc.constraint_name = kcu.constraint_name\n\t\t\t\tAND tc.table_schema = kcu.table_schema\n\t\t\tJOIN information_schema.constraint_column_usage ccu\n\t\t\t\tON tc.constraint_name = ccu.constraint_name\n\t\t\t\tAND tc.table_schema = ccu.table_schema\n\t\t\tWHERE tc.table_name = ${tableName}\n\t\t\t\tAND tc.table_schema = ${schema}\n\t\t\t\tAND tc.constraint_type = 'FOREIGN KEY'\n\t\t`.execute(db),\n\t\t// The planner's estimate rather than `count(*)`, which scans the table.\n\t\t// It is -1 for a table never analysed, which is \"unknown\", not empty.\n\t\tsql<{ estimate: string | number }>`\n\t\t\tSELECT c.reltuples::bigint AS estimate\n\t\t\tFROM pg_catalog.pg_class c\n\t\t\tJOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace\n\t\t\tWHERE c.relname = ${tableName}\n\t\t\t\tAND n.nspname = ${schema}\n\t\t`.execute(db),\n\t]);\n\n\tconst references = new Map(\n\t\tforeignKeys.rows.map((row) => [\n\t\t\trow.name,\n\t\t\t{ table: row.target, column: row.referenced },\n\t\t]),\n\t);\n\n\tconst columnInfo: ColumnInfo[] = columns.rows.map((row) => {\n\t\tconst reference = references.get(row.name);\n\t\treturn {\n\t\t\tname: row.name,\n\t\t\ttype: mapPostgresType(row.udt),\n\t\t\trawType: row.udt,\n\t\t\tnullable: row.nullable === 'YES',\n\t\t\tisPrimaryKey: row.pk,\n\t\t\tisForeignKey: !!reference,\n\t\t\tforeignKeyTable: reference?.table,\n\t\t\tforeignKeyColumn: reference?.column,\n\t\t\tdefaultValue: row.fallback ?? undefined,\n\t\t};\n\t});\n\n\tconst rowEstimate = Number(estimate.rows[0]?.estimate ?? 0);\n\n\treturn {\n\t\tname: tableName,\n\t\tschema,\n\t\tcolumns: columnInfo,\n\t\tprimaryKey: columnInfo.filter((c) => c.isPrimaryKey).map((c) => c.name),\n\t\testimatedRowCount: rowEstimate > 0 ? rowEstimate : undefined,\n\t};\n}\n\nconst POSTGRES_TYPES: Record<string, ColumnType> = {\n\tvarchar: 'string',\n\tchar: 'string',\n\ttext: 'string',\n\tname: 'string',\n\tbpchar: 'string',\n\tcitext: 'string',\n\n\tint2: 'number',\n\tint4: 'number',\n\tint8: 'number',\n\tfloat4: 'number',\n\tfloat8: 'number',\n\tnumeric: 'number',\n\tmoney: 'number',\n\n\tbool: 'boolean',\n\n\tdate: 'date',\n\ttimestamp: 'datetime',\n\ttimestamptz: 'datetime',\n\ttime: 'datetime',\n\ttimetz: 'datetime',\n\n\tjson: 'json',\n\tjsonb: 'json',\n\n\tbytea: 'binary',\n\n\tuuid: 'uuid',\n};\n\nfunction mapPostgresType(udtName: string): ColumnType {\n\treturn POSTGRES_TYPES[udtName] ?? 'unknown';\n}\n"],"mappings":";;;;;;AAYA,eAAsB,YAAgB,IAAmC;CACxE,MAAM,EAAE,SAAS,MAAM,GAAqB;;;;;;GAM1C,QAAQ,EAAE;CAEZ,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI;AAClC;;;;;AAaA,eAAsB,iBACrB,IACA,UAAmC,CAAC,GACd;CACtB,MAAM,UAAU,QAAQ,WAAW,CAAC,QAAQ;CAC5C,MAAM,WAAW,QAAQ,iBAAiB,CAAC;CAE3C,MAAM,EAAE,SAAS,MAAM,GAAqC;;;6BAGhC,QAAQ;;+BAEN,SAAS;;GAErC,QAAQ,EAAE;CAMZ,OAAO;EAAE,QAAA,MAJY,QAAQ,IAC5B,KAAK,KAAK,QAAQ,gBAAgB,IAAI,IAAI,MAAM,IAAI,MAAM,CAAC,CAC5D;EAEiB,2BAAW,IAAI,KAAK;CAAE;AACxC;;;;AAKA,eAAsB,gBACrB,IACA,WACA,SAAS,UACY;CACrB,MAAM,CAAC,SAAS,aAAa,YAAY,MAAM,QAAQ,IAAI;EAC1D,GAME;;;;;;;;;;;;;;;;;;0BAkBsB,UAAU;2BACT,OAAO;;IAE9B,QAAQ,EAAE;EACZ,GAAyD;;;;;;;;;;;;2BAYhC,UAAU;4BACT,OAAO;;IAE/B,QAAQ,EAAE;EAGZ,GAAkC;;;;uBAIb,UAAU;sBACX,OAAO;IACzB,QAAQ,EAAE;CACb,CAAC;CAED,MAAM,aAAa,IAAI,IACtB,YAAY,KAAK,KAAK,QAAQ,CAC7B,IAAI,MACJ;EAAE,OAAO,IAAI;EAAQ,QAAQ,IAAI;CAAW,CAC7C,CAAC,CACF;CAEA,MAAM,aAA2B,QAAQ,KAAK,KAAK,QAAQ;EAC1D,MAAM,YAAY,WAAW,IAAI,IAAI,IAAI;EACzC,OAAO;GACN,MAAM,IAAI;GACV,MAAM,gBAAgB,IAAI,GAAG;GAC7B,SAAS,IAAI;GACb,UAAU,IAAI,aAAa;GAC3B,cAAc,IAAI;GAClB,cAAc,CAAC,CAAC;GAChB,iBAAiB,WAAW;GAC5B,kBAAkB,WAAW;GAC7B,cAAc,IAAI,YAAY,KAAA;EAC/B;CACD,CAAC;CAED,MAAM,cAAc,OAAO,SAAS,KAAK,EAAE,EAAE,YAAY,CAAC;CAE1D,OAAO;EACN,MAAM;EACN;EACA,SAAS;EACT,YAAY,WAAW,QAAQ,MAAM,EAAE,YAAY,CAAC,CAAC,KAAK,MAAM,EAAE,IAAI;EACtE,mBAAmB,cAAc,IAAI,cAAc,KAAA;CACpD;AACD;AAEA,MAAM,iBAA6C;CAClD,SAAS;CACT,MAAM;CACN,MAAM;CACN,MAAM;CACN,QAAQ;CACR,QAAQ;CAER,MAAM;CACN,MAAM;CACN,MAAM;CACN,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,OAAO;CAEP,MAAM;CAEN,MAAM;CACN,WAAW;CACX,aAAa;CACb,MAAM;CACN,QAAQ;CAER,MAAM;CACN,OAAO;CAEP,OAAO;CAEP,MAAM;AACP;AAEA,SAAS,gBAAgB,SAA6B;CACrD,OAAO,eAAe,YAAY;AACnC"}

package/dist/introspect/types.cjs

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#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
+exports.FilterOperator = FilterOperator;
+
+//# sourceMappingURL=types.cjs.map

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

@@ -1,5 +1,5 @@
-const require_pagination = require('../pagination-Bu1dqOy0.cjs');
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_pagination = require("../pagination.cjs");
 //#region src/kysely/pagination.ts
 /**
 * Generic paginated search function that handles:
@@ -24,12 +24,11 @@ const require_pagination = require('../pagination-Bu1dqOy0.cjs');
 * });
 * ```
 */
-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;
+async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField = "id", cursorDirection = "asc" }) {
+	const count = (await query.clearSelect().clearOrderBy().select((eb) => eb.fn.countAll().as("count")).executeTakeFirstOrThrow()).count;
 	let paginatedQuery = query;
 	if (cursor) {
-		const operator = cursorDirection === require_pagination.Direction.Asc ? ">" : "<";
+		const operator = cursorDirection === "asc" ? ">" : "<";
 		paginatedQuery = paginatedQuery.where(cursorField, operator, cursor);
 	}
 	const data = await paginatedQuery.orderBy(cursorField, cursorDirection).limit(limit + 1).execute();
@@ -38,9 +37,8 @@ async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField
 	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,
+		items: await Promise.all(rows.map(mapper)),
 		pagination: {
 			total: Number(count),
 			hasMore,
@@ -48,10 +46,11 @@ 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;
+
 //# sourceMappingURL=pagination.cjs.map

package/dist/kysely/pagination.cjs.map

@@ -1 +1 @@
-{"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"}
+{"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,12 +1,10 @@
-import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination-BAFX7C1I.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
-
 /**
  * Options for paginated search.
  */
-interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow> {
+export 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) */
@@ -43,15 +41,7 @@ interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown =
  * });
  * ```
  */
-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>>>>;
-//# sourceMappingURL=pagination.d.ts.map
+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, PaginatedSearchOptions, PaginationResult, decodeCursor, encodeCursor, paginatedSearch };
+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"],"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"}
+{"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,12 +1,10 @@
-import { Direction, PaginationResult, decodeCursor, encodeCursor } from "../pagination-kv-KWS-7.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
-
 /**
  * Options for paginated search.
  */
-interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown = (row: TRow) => TRow> {
+export 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) */
@@ -43,15 +41,7 @@ interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown =
  * });
  * ```
  */
-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>>>>;
-//# sourceMappingURL=pagination.d.ts.map
+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, PaginatedSearchOptions, PaginationResult, decodeCursor, encodeCursor, paginatedSearch };
+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"],"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"}
+{"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"}