@geekmidas/studio 0.0.1

package/dist/DataBrowser-DQ3-ZxdV.mjs

@@ -0,0 +1,427 @@
+import { Direction, FilterOperator } from "./types-BZv87Ikv.mjs";
+
+//#region src/data/filtering.ts
+/**
+* Validates that a filter is applicable to the given column.
+*/
+function validateFilter(filter, columnInfo) {
+	const typeCompatibility = {
+		string: [
+			FilterOperator.Eq,
+			FilterOperator.Neq,
+			FilterOperator.Like,
+			FilterOperator.Ilike,
+			FilterOperator.In,
+			FilterOperator.Nin,
+			FilterOperator.IsNull,
+			FilterOperator.IsNotNull
+		],
+		number: [
+			FilterOperator.Eq,
+			FilterOperator.Neq,
+			FilterOperator.Gt,
+			FilterOperator.Gte,
+			FilterOperator.Lt,
+			FilterOperator.Lte,
+			FilterOperator.In,
+			FilterOperator.Nin,
+			FilterOperator.IsNull,
+			FilterOperator.IsNotNull
+		],
+		boolean: [
+			FilterOperator.Eq,
+			FilterOperator.Neq,
+			FilterOperator.IsNull,
+			FilterOperator.IsNotNull
+		],
+		date: [
+			FilterOperator.Eq,
+			FilterOperator.Neq,
+			FilterOperator.Gt,
+			FilterOperator.Gte,
+			FilterOperator.Lt,
+			FilterOperator.Lte,
+			FilterOperator.IsNull,
+			FilterOperator.IsNotNull
+		],
+		datetime: [
+			FilterOperator.Eq,
+			FilterOperator.Neq,
+			FilterOperator.Gt,
+			FilterOperator.Gte,
+			FilterOperator.Lt,
+			FilterOperator.Lte,
+			FilterOperator.IsNull,
+			FilterOperator.IsNotNull
+		],
+		uuid: [
+			FilterOperator.Eq,
+			FilterOperator.Neq,
+			FilterOperator.In,
+			FilterOperator.Nin,
+			FilterOperator.IsNull,
+			FilterOperator.IsNotNull
+		],
+		json: [FilterOperator.IsNull, FilterOperator.IsNotNull],
+		binary: [FilterOperator.IsNull, FilterOperator.IsNotNull],
+		unknown: [
+			FilterOperator.Eq,
+			FilterOperator.Neq,
+			FilterOperator.IsNull,
+			FilterOperator.IsNotNull
+		]
+	};
+	const allowedOps = typeCompatibility[columnInfo.type] ?? typeCompatibility.unknown;
+	if (!allowedOps.includes(filter.operator)) return {
+		valid: false,
+		error: `Operator '${filter.operator}' not supported for column type '${columnInfo.type}'`
+	};
+	return { valid: true };
+}
+/**
+* Applies filters to a Kysely query builder.
+*/
+function applyFilters(query, filters, tableInfo) {
+	let result = query;
+	for (const filter of filters) {
+		const column = tableInfo.columns.find((c) => c.name === filter.column);
+		if (!column) throw new Error(`Column '${filter.column}' not found in table '${tableInfo.name}'`);
+		const validation = validateFilter(filter, column);
+		if (!validation.valid) throw new Error(validation.error);
+		result = applyFilterCondition(result, filter);
+	}
+	return result;
+}
+function applyFilterCondition(query, filter) {
+	const { column, operator, value } = filter;
+	switch (operator) {
+		case FilterOperator.Eq: return query.where(column, "=", value);
+		case FilterOperator.Neq: return query.where(column, "!=", value);
+		case FilterOperator.Gt: return query.where(column, ">", value);
+		case FilterOperator.Gte: return query.where(column, ">=", value);
+		case FilterOperator.Lt: return query.where(column, "<", value);
+		case FilterOperator.Lte: return query.where(column, "<=", value);
+		case FilterOperator.Like: return query.where(column, "like", value);
+		case FilterOperator.Ilike: return query.where(column, "ilike", value);
+		case FilterOperator.In: return query.where(column, "in", value);
+		case FilterOperator.Nin: return query.where(column, "not in", value);
+		case FilterOperator.IsNull: return query.where(column, "is", null);
+		case FilterOperator.IsNotNull: return query.where(column, "is not", null);
+		default: throw new Error(`Unknown filter operator: ${operator}`);
+	}
+}
+/**
+* Applies sorting to a Kysely query builder.
+*/
+function applySorting(query, sorts, tableInfo) {
+	let result = query;
+	for (const sort of sorts) {
+		const column = tableInfo.columns.find((c) => c.name === sort.column);
+		if (!column) throw new Error(`Column '${sort.column}' not found in table '${tableInfo.name}'`);
+		result = result.orderBy(sort.column, sort.direction === Direction.Asc ? "asc" : "desc");
+	}
+	return result;
+}
+
+//#endregion
+//#region src/data/introspection.ts
+/**
+* Introspects the database schema to discover tables and columns.
+* Uses PostgreSQL information_schema for metadata.
+*/
+async function introspectSchema(db, excludeTables) {
+	const excludePlaceholders = excludeTables.length > 0 ? excludeTables.map((_, i) => `$${i + 1}`).join(", ") : "''";
+	const tablesQuery = `
+    SELECT
+      table_name,
+      table_schema
+    FROM information_schema.tables
+    WHERE table_schema = 'public'
+      AND table_type = 'BASE TABLE'
+      ${excludeTables.length > 0 ? `AND table_name NOT IN (${excludePlaceholders})` : ""}
+    ORDER BY table_name
+  `;
+	const tablesResult = await db.executeQuery({
+		sql: tablesQuery,
+		parameters: excludeTables
+	});
+	const tables = [];
+	for (const row of tablesResult.rows) {
+		const tableName = row.table_name ?? row.tableName;
+		const tableSchema = row.table_schema ?? row.tableSchema;
+		const tableInfo = await introspectTable(db, tableName, tableSchema);
+		tables.push(tableInfo);
+	}
+	return {
+		tables,
+		updatedAt: /* @__PURE__ */ new Date()
+	};
+}
+/**
+* Introspects a single table to get column information.
+*/
+async function introspectTable(db, tableName, schema = "public") {
+	const columnsQuery = `
+    SELECT
+      c.column_name,
+      c.data_type,
+      c.udt_name,
+      c.is_nullable,
+      c.column_default,
+      CASE WHEN pk.column_name IS NOT NULL THEN true ELSE false END as is_primary_key
+    FROM information_schema.columns c
+    LEFT JOIN (
+      SELECT ku.column_name
+      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 = $1
+        AND tc.table_schema = $2
+        AND tc.constraint_type = 'PRIMARY KEY'
+    ) pk ON c.column_name = pk.column_name
+    WHERE c.table_name = $1
+      AND c.table_schema = $2
+    ORDER BY c.ordinal_position
+  `;
+	const columnsResult = await db.executeQuery({
+		sql: columnsQuery,
+		parameters: [tableName, schema]
+	});
+	const fkQuery = `
+    SELECT
+      kcu.column_name,
+      ccu.table_name AS foreign_table,
+      ccu.column_name AS foreign_column
+    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 = $1
+      AND tc.table_schema = $2
+      AND tc.constraint_type = 'FOREIGN KEY'
+  `;
+	const fkResult = await db.executeQuery({
+		sql: fkQuery,
+		parameters: [tableName, schema]
+	});
+	const foreignKeys = /* @__PURE__ */ new Map();
+	for (const row of fkResult.rows) {
+		const colName = row.column_name ?? row.columnName;
+		foreignKeys.set(colName, {
+			table: row.foreign_table ?? row.foreignTable,
+			column: row.foreign_column ?? row.foreignColumn
+		});
+	}
+	const columns = columnsResult.rows.map((row) => {
+		const colName = row.column_name ?? row.columnName;
+		const udtName = row.udt_name ?? row.udtName;
+		const isNullable = row.is_nullable ?? row.isNullable;
+		const isPrimaryKey = row.is_primary_key ?? row.isPrimaryKey;
+		const columnDefault = row.column_default ?? row.columnDefault;
+		const fk = foreignKeys.get(colName);
+		return {
+			name: colName,
+			type: mapPostgresType(udtName),
+			rawType: udtName,
+			nullable: isNullable === "YES",
+			isPrimaryKey,
+			isForeignKey: !!fk,
+			foreignKeyTable: fk?.table,
+			foreignKeyColumn: fk?.column,
+			defaultValue: columnDefault ?? void 0
+		};
+	});
+	const primaryKey = columns.filter((c) => c.isPrimaryKey).map((c) => c.name);
+	const countQuery = `
+    SELECT reltuples::bigint AS estimate
+    FROM pg_class
+    WHERE relname = $1
+  `;
+	let estimatedRowCount;
+	try {
+		const countResult = await db.executeQuery({
+			sql: countQuery,
+			parameters: [tableName]
+		});
+		if (countResult.rows.length > 0) {
+			const estimate = countResult.rows[0].estimate;
+			estimatedRowCount = estimate > 0 ? Number(estimate) : void 0;
+		}
+	} catch {}
+	return {
+		name: tableName,
+		schema,
+		columns,
+		primaryKey,
+		estimatedRowCount
+	};
+}
+/**
+* Maps PostgreSQL types to generic column types.
+*/
+function mapPostgresType(udtName) {
+	const typeMap = {
+		varchar: "string",
+		char: "string",
+		text: "string",
+		name: "string",
+		bpchar: "string",
+		int2: "number",
+		int4: "number",
+		int8: "number",
+		float4: "number",
+		float8: "number",
+		numeric: "number",
+		money: "number",
+		serial: "number",
+		bigserial: "number",
+		bool: "boolean",
+		date: "date",
+		timestamp: "datetime",
+		timestamptz: "datetime",
+		time: "datetime",
+		timetz: "datetime",
+		json: "json",
+		jsonb: "json",
+		bytea: "binary",
+		uuid: "uuid"
+	};
+	return typeMap[udtName] ?? "unknown";
+}
+
+//#endregion
+//#region src/data/pagination.ts
+/**
+* Cursor encoding/decoding utilities for pagination.
+*/
+/**
+* Encode a cursor value for safe URL transmission.
+* Supports various types: string, number, Date, etc.
+*/
+function encodeCursor(value) {
+	const payload = {
+		v: value instanceof Date ? value.toISOString() : value,
+		t: value instanceof Date ? "date" : typeof value
+	};
+	return Buffer.from(JSON.stringify(payload)).toString("base64url");
+}
+/**
+* Decode a cursor string back to its original value.
+*/
+function decodeCursor(cursor) {
+	try {
+		const json = Buffer.from(cursor, "base64url").toString("utf-8");
+		const payload = JSON.parse(json);
+		if (payload.t === "date") return new Date(payload.v);
+		return payload.v;
+	} catch {
+		throw new Error("Invalid cursor format");
+	}
+}
+
+//#endregion
+//#region src/data/DataBrowser.ts
+/**
+* Database browser for introspecting and querying PostgreSQL databases.
+*
+* @example
+* ```typescript
+* const browser = new DataBrowser({
+*   db: kyselyInstance,
+*   cursor: { field: 'id', direction: Direction.Desc },
+* });
+*
+* const schema = await browser.getSchema();
+* const result = await browser.query({ table: 'users', pageSize: 20 });
+* ```
+*/
+var DataBrowser = class {
+	db;
+	options;
+	schemaCache = null;
+	schemaCacheExpiry = 0;
+	CACHE_TTL_MS = 60 * 1e3;
+	constructor(options) {
+		this.db = options.db;
+		this.options = options;
+	}
+	/**
+	* Get the database schema information.
+	* Results are cached for 1 minute.
+	*
+	* @param forceRefresh - Force a refresh of the cache
+	*/
+	async getSchema(forceRefresh = false) {
+		const now = Date.now();
+		if (!forceRefresh && this.schemaCache && now < this.schemaCacheExpiry) return this.schemaCache;
+		const schema = await introspectSchema(this.db, this.options.excludeTables);
+		this.schemaCache = schema;
+		this.schemaCacheExpiry = now + this.CACHE_TTL_MS;
+		return schema;
+	}
+	/**
+	* Get information about a specific table.
+	*/
+	async getTableInfo(tableName) {
+		const schema = await this.getSchema();
+		return schema.tables.find((t) => t.name === tableName) ?? null;
+	}
+	/**
+	* Query table data with pagination, filtering, and sorting.
+	*/
+	async query(options) {
+		const tableInfo = await this.getTableInfo(options.table);
+		if (!tableInfo) throw new Error(`Table '${options.table}' not found`);
+		const cursorConfig = this.getCursorConfig(options.table);
+		const pageSize = Math.min(options.pageSize ?? this.options.defaultPageSize, 100);
+		let query = this.db.selectFrom(options.table).selectAll();
+		if (options.filters && options.filters.length > 0) query = applyFilters(query, options.filters, tableInfo);
+		if (options.sort && options.sort.length > 0) query = applySorting(query, options.sort, tableInfo);
+		else query = query.orderBy(cursorConfig.field, cursorConfig.direction);
+		if (options.cursor) {
+			const cursorValue = decodeCursor(options.cursor);
+			const operator = cursorConfig.direction === Direction.Asc ? ">" : "<";
+			query = query.where(cursorConfig.field, operator, cursorValue);
+		}
+		const rows = await query.limit(pageSize + 1).execute();
+		const hasMore = rows.length > pageSize;
+		const resultRows = hasMore ? rows.slice(0, pageSize) : rows;
+		let nextCursor = null;
+		let prevCursor = null;
+		if (hasMore && resultRows.length > 0) {
+			const lastRow = resultRows[resultRows.length - 1];
+			nextCursor = encodeCursor(lastRow[cursorConfig.field]);
+		}
+		if (options.cursor && resultRows.length > 0) {
+			const firstRow = resultRows[0];
+			prevCursor = encodeCursor(firstRow[cursorConfig.field]);
+		}
+		return {
+			rows: resultRows,
+			hasMore,
+			nextCursor,
+			prevCursor
+		};
+	}
+	/**
+	* Get the cursor configuration for a table.
+	* Returns the table-specific config if defined, otherwise the default.
+	*/
+	getCursorConfig(tableName) {
+		return this.options.tableCursors[tableName] ?? this.options.cursor;
+	}
+	/**
+	* Get the underlying Kysely database instance.
+	*/
+	get database() {
+		return this.db;
+	}
+};
+
+//#endregion
+export { DataBrowser };
+//# sourceMappingURL=DataBrowser-DQ3-ZxdV.mjs.map

package/dist/DataBrowser-DQ3-ZxdV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataBrowser-DQ3-ZxdV.mjs","names":["filter: FilterCondition","columnInfo: ColumnInfo","typeCompatibility: Record<string, FilterOperator[]>","query: SelectQueryBuilder<DB, TB, O>","filters: FilterCondition[]","tableInfo: TableInfo","sorts: SortConfig[]","db: Kysely<DB>","excludeTables: string[]","tables: TableInfo[]","tableName: string","columns: ColumnInfo[]","estimatedRowCount: number | undefined","udtName: string","typeMap: Record<string, ColumnType>","value: unknown","cursor: string","options: Required<DataBrowserOptions<DB>>","tableName: string","options: QueryOptions","nextCursor: string | null","prevCursor: string | null"],"sources":["../src/data/filtering.ts","../src/data/introspection.ts","../src/data/pagination.ts","../src/data/DataBrowser.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\nimport {\n  type ColumnInfo,\n  Direction,\n  type FilterCondition,\n  FilterOperator,\n  type SortConfig,\n  type TableInfo,\n} from '../types';\n\n/**\n * Validates that a filter is applicable to the given column.\n */\nexport function validateFilter(\n  filter: FilterCondition,\n  columnInfo: ColumnInfo,\n): { valid: boolean; error?: string } {\n  // Validate operator compatibility with column type\n  const typeCompatibility: Record<string, FilterOperator[]> = {\n    string: [\n      FilterOperator.Eq,\n      FilterOperator.Neq,\n      FilterOperator.Like,\n      FilterOperator.Ilike,\n      FilterOperator.In,\n      FilterOperator.Nin,\n      FilterOperator.IsNull,\n      FilterOperator.IsNotNull,\n    ],\n    number: [\n      FilterOperator.Eq,\n      FilterOperator.Neq,\n      FilterOperator.Gt,\n      FilterOperator.Gte,\n      FilterOperator.Lt,\n      FilterOperator.Lte,\n      FilterOperator.In,\n      FilterOperator.Nin,\n      FilterOperator.IsNull,\n      FilterOperator.IsNotNull,\n    ],\n    boolean: [\n      FilterOperator.Eq,\n      FilterOperator.Neq,\n      FilterOperator.IsNull,\n      FilterOperator.IsNotNull,\n    ],\n    date: [\n      FilterOperator.Eq,\n      FilterOperator.Neq,\n      FilterOperator.Gt,\n      FilterOperator.Gte,\n      FilterOperator.Lt,\n      FilterOperator.Lte,\n      FilterOperator.IsNull,\n      FilterOperator.IsNotNull,\n    ],\n    datetime: [\n      FilterOperator.Eq,\n      FilterOperator.Neq,\n      FilterOperator.Gt,\n      FilterOperator.Gte,\n      FilterOperator.Lt,\n      FilterOperator.Lte,\n      FilterOperator.IsNull,\n      FilterOperator.IsNotNull,\n    ],\n    uuid: [\n      FilterOperator.Eq,\n      FilterOperator.Neq,\n      FilterOperator.In,\n      FilterOperator.Nin,\n      FilterOperator.IsNull,\n      FilterOperator.IsNotNull,\n    ],\n    json: [FilterOperator.IsNull, FilterOperator.IsNotNull],\n    binary: [FilterOperator.IsNull, FilterOperator.IsNotNull],\n    unknown: [\n      FilterOperator.Eq,\n      FilterOperator.Neq,\n      FilterOperator.IsNull,\n      FilterOperator.IsNotNull,\n    ],\n  };\n\n  const allowedOps =\n    typeCompatibility[columnInfo.type] ?? typeCompatibility.unknown;\n\n  if (!allowedOps.includes(filter.operator)) {\n    return {\n      valid: false,\n      error: `Operator '${filter.operator}' not supported for column type '${columnInfo.type}'`,\n    };\n  }\n\n  return { valid: true };\n}\n\n/**\n * Applies filters to a Kysely query builder.\n */\nexport function applyFilters<DB, TB extends keyof DB, O>(\n  query: SelectQueryBuilder<DB, TB, O>,\n  filters: FilterCondition[],\n  tableInfo: TableInfo,\n): SelectQueryBuilder<DB, TB, O> {\n  let result = query;\n\n  for (const filter of filters) {\n    const column = tableInfo.columns.find((c) => c.name === filter.column);\n\n    if (!column) {\n      throw new Error(\n        `Column '${filter.column}' not found in table '${tableInfo.name}'`,\n      );\n    }\n\n    const validation = validateFilter(filter, column);\n    if (!validation.valid) {\n      throw new Error(validation.error);\n    }\n\n    result = applyFilterCondition(result, filter);\n  }\n\n  return result;\n}\n\nfunction applyFilterCondition<DB, TB extends keyof DB, O>(\n  query: SelectQueryBuilder<DB, TB, O>,\n  filter: FilterCondition,\n): SelectQueryBuilder<DB, TB, O> {\n  const { column, operator, value } = filter;\n\n  switch (operator) {\n    case FilterOperator.Eq:\n      return query.where(column as any, '=', value);\n    case FilterOperator.Neq:\n      return query.where(column as any, '!=', value);\n    case FilterOperator.Gt:\n      return query.where(column as any, '>', value);\n    case FilterOperator.Gte:\n      return query.where(column as any, '>=', value);\n    case FilterOperator.Lt:\n      return query.where(column as any, '<', value);\n    case FilterOperator.Lte:\n      return query.where(column as any, '<=', value);\n    case FilterOperator.Like:\n      return query.where(column as any, 'like', value);\n    case FilterOperator.Ilike:\n      return query.where(column as any, 'ilike', value);\n    case FilterOperator.In:\n      return query.where(column as any, 'in', value as any[]);\n    case FilterOperator.Nin:\n      return query.where(column as any, 'not in', value as any[]);\n    case FilterOperator.IsNull:\n      return query.where(column as any, 'is', null);\n    case FilterOperator.IsNotNull:\n      return query.where(column as any, 'is not', null);\n    default:\n      throw new Error(`Unknown filter operator: ${operator}`);\n  }\n}\n\n/**\n * Applies sorting to a Kysely query builder.\n */\nexport function applySorting<DB, TB extends keyof DB, O>(\n  query: SelectQueryBuilder<DB, TB, O>,\n  sorts: SortConfig[],\n  tableInfo: TableInfo,\n): SelectQueryBuilder<DB, TB, O> {\n  let result = query;\n\n  for (const sort of sorts) {\n    const column = tableInfo.columns.find((c) => c.name === sort.column);\n\n    if (!column) {\n      throw new Error(\n        `Column '${sort.column}' not found in table '${tableInfo.name}'`,\n      );\n    }\n\n    result = result.orderBy(\n      sort.column as any,\n      sort.direction === Direction.Asc ? 'asc' : 'desc',\n    );\n  }\n\n  return result;\n}\n","import type { Kysely } from 'kysely';\nimport type { ColumnInfo, ColumnType, SchemaInfo, TableInfo } from '../types';\n\n/**\n * Introspects the database schema to discover tables and columns.\n * Uses PostgreSQL information_schema for metadata.\n */\nexport async function introspectSchema<DB>(\n  db: Kysely<DB>,\n  excludeTables: string[],\n): Promise<SchemaInfo> {\n  // Query tables from information_schema\n  const excludePlaceholders =\n    excludeTables.length > 0\n      ? excludeTables.map((_, i) => `$${i + 1}`).join(', ')\n      : \"''\";\n\n  const tablesQuery = `\n    SELECT\n      table_name,\n      table_schema\n    FROM information_schema.tables\n    WHERE table_schema = 'public'\n      AND table_type = 'BASE TABLE'\n      ${excludeTables.length > 0 ? `AND table_name NOT IN (${excludePlaceholders})` : ''}\n    ORDER BY table_name\n  `;\n\n  const tablesResult = await db.executeQuery({\n    sql: tablesQuery,\n    parameters: excludeTables,\n  } as any);\n\n  const tables: TableInfo[] = [];\n\n  for (const row of tablesResult.rows as any[]) {\n    // Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n    const tableName = row.table_name ?? row.tableName;\n    const tableSchema = row.table_schema ?? row.tableSchema;\n    const tableInfo = await introspectTable(db, tableName, tableSchema);\n    tables.push(tableInfo);\n  }\n\n  return {\n    tables,\n    updatedAt: new Date(),\n  };\n}\n\n/**\n * Introspects a single table to get column information.\n */\nexport async function introspectTable<DB>(\n  db: Kysely<DB>,\n  tableName: string,\n  schema = 'public',\n): Promise<TableInfo> {\n  // Query columns\n  const columnsQuery = `\n    SELECT\n      c.column_name,\n      c.data_type,\n      c.udt_name,\n      c.is_nullable,\n      c.column_default,\n      CASE WHEN pk.column_name IS NOT NULL THEN true ELSE false END as is_primary_key\n    FROM information_schema.columns c\n    LEFT JOIN (\n      SELECT ku.column_name\n      FROM information_schema.table_constraints tc\n      JOIN information_schema.key_column_usage ku\n        ON tc.constraint_name = ku.constraint_name\n        AND tc.table_schema = ku.table_schema\n      WHERE tc.table_name = $1\n        AND tc.table_schema = $2\n        AND tc.constraint_type = 'PRIMARY KEY'\n    ) pk ON c.column_name = pk.column_name\n    WHERE c.table_name = $1\n      AND c.table_schema = $2\n    ORDER BY c.ordinal_position\n  `;\n\n  const columnsResult = await db.executeQuery({\n    sql: columnsQuery,\n    parameters: [tableName, schema],\n  } as any);\n\n  // Query foreign keys\n  const fkQuery = `\n    SELECT\n      kcu.column_name,\n      ccu.table_name AS foreign_table,\n      ccu.column_name AS foreign_column\n    FROM information_schema.table_constraints tc\n    JOIN information_schema.key_column_usage kcu\n      ON tc.constraint_name = kcu.constraint_name\n      AND tc.table_schema = kcu.table_schema\n    JOIN information_schema.constraint_column_usage ccu\n      ON tc.constraint_name = ccu.constraint_name\n      AND tc.table_schema = ccu.table_schema\n    WHERE tc.table_name = $1\n      AND tc.table_schema = $2\n      AND tc.constraint_type = 'FOREIGN KEY'\n  `;\n\n  const fkResult = await db.executeQuery({\n    sql: fkQuery,\n    parameters: [tableName, schema],\n  } as any);\n\n  const foreignKeys = new Map<string, { table: string; column: string }>();\n  for (const row of fkResult.rows as any[]) {\n    // Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n    const colName = row.column_name ?? row.columnName;\n    foreignKeys.set(colName, {\n      table: row.foreign_table ?? row.foreignTable,\n      column: row.foreign_column ?? row.foreignColumn,\n    });\n  }\n\n  const columns: ColumnInfo[] = (columnsResult.rows as any[]).map((row) => {\n    // Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n    const colName = row.column_name ?? row.columnName;\n    const udtName = row.udt_name ?? row.udtName;\n    const isNullable = row.is_nullable ?? row.isNullable;\n    const isPrimaryKey = row.is_primary_key ?? row.isPrimaryKey;\n    const columnDefault = row.column_default ?? row.columnDefault;\n\n    const fk = foreignKeys.get(colName);\n    return {\n      name: colName,\n      type: mapPostgresType(udtName),\n      rawType: udtName,\n      nullable: isNullable === 'YES',\n      isPrimaryKey: isPrimaryKey,\n      isForeignKey: !!fk,\n      foreignKeyTable: fk?.table,\n      foreignKeyColumn: fk?.column,\n      defaultValue: columnDefault ?? undefined,\n    };\n  });\n\n  const primaryKey = columns.filter((c) => c.isPrimaryKey).map((c) => c.name);\n\n  // Get estimated row count\n  const countQuery = `\n    SELECT reltuples::bigint AS estimate\n    FROM pg_class\n    WHERE relname = $1\n  `;\n\n  let estimatedRowCount: number | undefined;\n  try {\n    const countResult = await db.executeQuery({\n      sql: countQuery,\n      parameters: [tableName],\n    } as any);\n    if (countResult.rows.length > 0) {\n      const estimate = (countResult.rows[0] as any).estimate;\n      estimatedRowCount = estimate > 0 ? Number(estimate) : undefined;\n    }\n  } catch {\n    // Ignore errors, row count is optional\n  }\n\n  return {\n    name: tableName,\n    schema,\n    columns,\n    primaryKey,\n    estimatedRowCount,\n  };\n}\n\n/**\n * Maps PostgreSQL types to generic column types.\n */\nfunction mapPostgresType(udtName: string): ColumnType {\n  const typeMap: Record<string, ColumnType> = {\n    // Strings\n    varchar: 'string',\n    char: 'string',\n    text: 'string',\n    name: 'string',\n    bpchar: 'string',\n\n    // Numbers\n    int2: 'number',\n    int4: 'number',\n    int8: 'number',\n    float4: 'number',\n    float8: 'number',\n    numeric: 'number',\n    money: 'number',\n    serial: 'number',\n    bigserial: 'number',\n\n    // Boolean\n    bool: 'boolean',\n\n    // Dates\n    date: 'date',\n    timestamp: 'datetime',\n    timestamptz: 'datetime',\n    time: 'datetime',\n    timetz: 'datetime',\n\n    // JSON\n    json: 'json',\n    jsonb: 'json',\n\n    // Binary\n    bytea: 'binary',\n\n    // UUID\n    uuid: 'uuid',\n  };\n\n  return typeMap[udtName] ?? 'unknown';\n}\n","/**\n * Cursor encoding/decoding utilities for pagination.\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  const payload = {\n    v: value instanceof Date ? value.toISOString() : value,\n    t: value instanceof Date ? 'date' : typeof value,\n  };\n  return 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  try {\n    const json = Buffer.from(cursor, 'base64url').toString('utf-8');\n    const payload = JSON.parse(json);\n\n    if (payload.t === 'date') {\n      return new Date(payload.v);\n    }\n\n    return payload.v;\n  } catch {\n    throw new Error('Invalid cursor format');\n  }\n}\n","import type { Kysely, SelectQueryBuilder } from 'kysely';\nimport {\n  type CursorConfig,\n  type DataBrowserOptions,\n  Direction,\n  type QueryOptions,\n  type QueryResult,\n  type SchemaInfo,\n  type TableInfo,\n} from '../types';\nimport { applyFilters, applySorting } from './filtering';\nimport { introspectSchema } from './introspection';\nimport { decodeCursor, encodeCursor } from './pagination';\n\n/**\n * Database browser for introspecting and querying PostgreSQL databases.\n *\n * @example\n * ```typescript\n * const browser = new DataBrowser({\n *   db: kyselyInstance,\n *   cursor: { field: 'id', direction: Direction.Desc },\n * });\n *\n * const schema = await browser.getSchema();\n * const result = await browser.query({ table: 'users', pageSize: 20 });\n * ```\n */\nexport class DataBrowser<DB = unknown> {\n  private db: Kysely<DB>;\n  private options: Required<DataBrowserOptions<DB>>;\n  private schemaCache: SchemaInfo | null = null;\n  private schemaCacheExpiry = 0;\n  private readonly CACHE_TTL_MS = 60 * 1000; // 1 minute\n\n  constructor(options: Required<DataBrowserOptions<DB>>) {\n    this.db = options.db;\n    this.options = options;\n  }\n\n  // ============================================\n  // Schema Introspection\n  // ============================================\n\n  /**\n   * Get the database schema information.\n   * Results are cached for 1 minute.\n   *\n   * @param forceRefresh - Force a refresh of the cache\n   */\n  async getSchema(forceRefresh = false): Promise<SchemaInfo> {\n    const now = Date.now();\n\n    if (!forceRefresh && this.schemaCache && now < this.schemaCacheExpiry) {\n      return this.schemaCache;\n    }\n\n    const schema = await introspectSchema(this.db, this.options.excludeTables);\n\n    this.schemaCache = schema;\n    this.schemaCacheExpiry = now + this.CACHE_TTL_MS;\n\n    return schema;\n  }\n\n  /**\n   * Get information about a specific table.\n   */\n  async getTableInfo(tableName: string): Promise<TableInfo | null> {\n    const schema = await this.getSchema();\n    return schema.tables.find((t) => t.name === tableName) ?? null;\n  }\n\n  // ============================================\n  // Data Querying\n  // ============================================\n\n  /**\n   * Query table data with pagination, filtering, and sorting.\n   */\n  async query(options: QueryOptions): Promise<QueryResult> {\n    const tableInfo = await this.getTableInfo(options.table);\n\n    if (!tableInfo) {\n      throw new Error(`Table '${options.table}' not found`);\n    }\n\n    const cursorConfig = this.getCursorConfig(options.table);\n    const pageSize = Math.min(\n      options.pageSize ?? this.options.defaultPageSize,\n      100,\n    );\n\n    // Build base query selecting all columns\n    let query = this.db\n      .selectFrom(options.table as any)\n      .selectAll() as SelectQueryBuilder<any, any, any>;\n\n    // Apply filters if provided\n    if (options.filters && options.filters.length > 0) {\n      query = applyFilters(query, options.filters, tableInfo);\n    }\n\n    // Apply sorting if provided, otherwise use cursor field\n    if (options.sort && options.sort.length > 0) {\n      query = applySorting(query, options.sort, tableInfo);\n    } else {\n      query = query.orderBy(cursorConfig.field as any, cursorConfig.direction);\n    }\n\n    // Handle cursor-based pagination\n    if (options.cursor) {\n      const cursorValue = decodeCursor(options.cursor);\n      const operator = cursorConfig.direction === Direction.Asc ? '>' : '<';\n      query = query.where(cursorConfig.field as any, operator, cursorValue);\n    }\n\n    // Fetch one extra row to determine if there are more results\n    const rows = await query.limit(pageSize + 1).execute();\n\n    const hasMore = rows.length > pageSize;\n    const resultRows = hasMore ? rows.slice(0, pageSize) : rows;\n\n    // Generate cursors\n    let nextCursor: string | null = null;\n    let prevCursor: string | null = null;\n\n    if (hasMore && resultRows.length > 0) {\n      const lastRow = resultRows[resultRows.length - 1];\n      nextCursor = encodeCursor(lastRow[cursorConfig.field]);\n    }\n\n    // For prev cursor, we need to know if there are previous results\n    // This would require a separate query, so we'll only set it if there's an input cursor\n    if (options.cursor && resultRows.length > 0) {\n      const firstRow = resultRows[0];\n      prevCursor = encodeCursor(firstRow[cursorConfig.field]);\n    }\n\n    return {\n      rows: resultRows,\n      hasMore,\n      nextCursor,\n      prevCursor,\n    };\n  }\n\n  // ============================================\n  // Configuration Access\n  // ============================================\n\n  /**\n   * Get the cursor configuration for a table.\n   * Returns the table-specific config if defined, otherwise the default.\n   */\n  getCursorConfig(tableName: string): CursorConfig {\n    return this.options.tableCursors[tableName] ?? this.options.cursor;\n  }\n\n  /**\n   * Get the underlying Kysely database instance.\n   */\n  get database(): Kysely<DB> {\n    return this.db;\n  }\n}\n"],"mappings":"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"}