@geekmidas/studio 0.2.0 → 0.4.0

package/dist/{DataBrowser-hGwiTffZ.d.cts → DataBrowser-B-jz8KBR.d.mts}

@@ -1,5 +1,5 @@
-import { Kysely } from "kysely";
 import { TelescopeStorage } from "@geekmidas/telescope";
+import { Kysely } from "kysely";
 
 //#region src/types.d.ts
 
@@ -214,6 +214,7 @@ interface StudioEvent<T = unknown> {
   /** Event timestamp */
   timestamp: number;
 }
+//# sourceMappingURL=types.d.ts.map
 //#endregion
 //#region src/data/DataBrowser.d.ts
 /**
@@ -262,6 +263,8 @@ declare class DataBrowser<DB = unknown> {
    */
   get database(): Kysely<DB>;
 }
+//# sourceMappingURL=DataBrowser.d.ts.map
+
 //#endregion
 export { ColumnInfo, ColumnType, CursorConfig, DataBrowser, DataBrowserOptions, Direction, FilterCondition, FilterOperator, MonitoringOptions, NormalizedStudioOptions, QueryOptions, QueryResult, SchemaInfo, SortConfig, StudioEvent, StudioEventType, StudioOptions, TableCursorConfig, TableInfo };
-//# sourceMappingURL=DataBrowser-hGwiTffZ.d.cts.map
+//# sourceMappingURL=DataBrowser-B-jz8KBR.d.mts.map

package/dist/DataBrowser-B-jz8KBR.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataBrowser-B-jz8KBR.d.mts","names":[],"sources":["../src/types.ts","../src/data/DataBrowser.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAQY,aARA,SAAA;EA8BK,GAAA,GAAA,KAAA;EAUA,IAAA,GAAA,MAAA;AAWjB;AAoBA;;;AAEK,aAjEO,cAAA;EAiED,EAAA,GAEF,IAAA;EAAY,GAEL,GAAA,KAAA;EAAiB,EAAA,GAAA,IAAA;EAgBhB,GAAA,GAAA,KAAA;EAAa,EAAA,GAAA,IAAA;EAAA,GAEjB,GAAA,KAAA;EAAiB,IAEJ,GAAA,MAAA;EAAE,KAArB,GAAA,OAAA;EAAkB,EAAA,GAAA,IAAA;EAUR,GAAA,GAAA,KAAA;EAAuB,MAAA,GAAA,SAAA;EAAA,SAClB,GAAA,aAAA;;;;;AACP,UA/EE,YAAA,CA+EF;EAYH;EAcK,KAAA,EAAA,MAAU;EAwBV;EAgBA,SAAA,EA7IL,SA6Ie;;;;AAIX;AAUC,UArJA,iBAAA,CAyJN;EAQM,CAAA,SAAA,EAAA,MAAU,CAAA,EAhKL,YAoKD;AAMrB;;;;AAMkB,UAtKD,iBAAA,CAsKC;EAYD;EAAW,OAAA,EAhLlB,gBAgLkB;EAAA;EAAW,cAEhC,CAAA,EAAA,MAAA,EAAA;EAAC;EAkBI,UAAA,CAAA,EAAA,OAAe;EAWV;EAAW,WAAA,CAAA,EAAA,MAAA;EAAA;EAEN,eAEZ,CAAA,EAAA,MAAA;AAAC;;;;ACtPE,UDqDI,kBCrDO,CAAA,KAAA,OAAA,CAAA,CAAA;EAAA;EAAA,EAAA,EDuDnB,MChD6C,CDgDtC,EChDsC,CAAA;EAAE;EAAH,MAA3B,EDkDb,YClDa;EAAQ;EAe4B,YAAlB,CAAA,EDqCxB,iBCrCwB;EAAO;EAkBU,aAAjB,CAAA,EAAA,MAAA,EAAA;EAAO;EAYb,eAAW,CAAA,EAAA,MAAA;EAAW;EAAZ,iBA+EP,CAAA,EAAA,OAAA;;;AAOd;;UD/DN;;cAEJ;;QAEN,mBAAmB;;;;;;;;;UAUT;cACJ,SAAS;QACf,SAAS,mBAAmB;;;;;;;KAYvB,UAAA;;;;UAcK,UAAA;;;;QAIV;;;;;;;;;;;;;;;;;;;UAoBU,SAAA;;;;;;WAMP;;;;;;;;;UAUO,UAAA;;UAER;;aAEG;;;;;UAUK,eAAA;;;;YAIN;;;;;;;UAQM,UAAA;;;;aAIL;;;;;UAMK,YAAA;;;;YAIN;;SAEH;;;;;;;;;;;UAYS,gBAAgB;;QAE1B;;;;;;;;;;;;;KAkBK,eAAA;;;;UAWK;;QAEV;;WAEG;;;;;;;;;AAxQV;AAQA;AAsBA;AAUA;AAWA;AAoBA;;;;;;AAMiC;AAgBhB,cC3EJ,WD2EiB,CAAA,KAAA,OAAA,CAAA,CAAA;EAAA,QAAA,EAAA;EAAA,QAEjB,OAAA;EAAiB,QAEJ,WAAA;EAAE,QAArB,iBAAA;EAAkB,iBAAA,YAAA;EAUR,WAAA,CAAA,OAAA,EClFK,QDkFkB,CClFT,kBDkFS,CClFU,EDkFV,CAAA,CAAA;EAAA;;;;;;EAEzB,SAAA,CAAA,YAAA,CAAA,EAAA,OAAA,CAAA,ECrEyB,ODqEzB,CCrEiC,UDqEjC,CAAA;EAYH;AAcZ;AAwBA;EAgBiB,YAAA,CAAU,SAAA,EAAA,MAAA,CAAA,ECrHa,ODqHb,CCrHqB,SDqHrB,GAAA,IAAA,CAAA;EAAA;;;EAIX,KAAA,CAAA,OAAA,EC7GM,YD6GN,CAAA,EC7GqB,OD6GrB,CC7G6B,WD6G7B,CAAA;EAUC;AAYjB;AAUA;;EAA6B,eAIlB,CAAA,SAAA,EAAA,MAAA,CAAA,EClE0B,YDkE1B;EAAe;AAER;AAYlB;EAA4B,IAAA,QAAA,CAAA,CAAA,ECzEX,MDyEW,CCzEJ,EDyEI,CAAA"}

package/dist/{DataBrowser-SOcqmZb2.d.mts → DataBrowser-BTe9HWJy.d.cts}

@@ -1,5 +1,5 @@
-import { TelescopeStorage } from "@geekmidas/telescope";
 import { Kysely } from "kysely";
+import { TelescopeStorage } from "@geekmidas/telescope";
 
 //#region src/types.d.ts
 
@@ -214,6 +214,7 @@ interface StudioEvent<T = unknown> {
   /** Event timestamp */
   timestamp: number;
 }
+//# sourceMappingURL=types.d.ts.map
 //#endregion
 //#region src/data/DataBrowser.d.ts
 /**
@@ -262,6 +263,8 @@ declare class DataBrowser<DB = unknown> {
    */
   get database(): Kysely<DB>;
 }
+//# sourceMappingURL=DataBrowser.d.ts.map
+
 //#endregion
 export { ColumnInfo, ColumnType, CursorConfig, DataBrowser, DataBrowserOptions, Direction, FilterCondition, FilterOperator, MonitoringOptions, NormalizedStudioOptions, QueryOptions, QueryResult, SchemaInfo, SortConfig, StudioEvent, StudioEventType, StudioOptions, TableCursorConfig, TableInfo };
-//# sourceMappingURL=DataBrowser-SOcqmZb2.d.mts.map
+//# sourceMappingURL=DataBrowser-BTe9HWJy.d.cts.map

package/dist/DataBrowser-BTe9HWJy.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataBrowser-BTe9HWJy.d.cts","names":[],"sources":["../src/types.ts","../src/data/DataBrowser.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAQY,aARA,SAAA;EA8BK,GAAA,GAAA,KAAA;EAUA,IAAA,GAAA,MAAA;AAWjB;AAoBA;;;AAEK,aAjEO,cAAA;EAiED,EAAA,GAEF,IAAA;EAAY,GAEL,GAAA,KAAA;EAAiB,EAAA,GAAA,IAAA;EAgBhB,GAAA,GAAA,KAAA;EAAa,EAAA,GAAA,IAAA;EAAA,GAEjB,GAAA,KAAA;EAAiB,IAEJ,GAAA,MAAA;EAAE,KAArB,GAAA,OAAA;EAAkB,EAAA,GAAA,IAAA;EAUR,GAAA,GAAA,KAAA;EAAuB,MAAA,GAAA,SAAA;EAAA,SAClB,GAAA,aAAA;;;;;AACP,UA/EE,YAAA,CA+EF;EAYH;EAcK,KAAA,EAAA,MAAU;EAwBV;EAgBA,SAAA,EA7IL,SA6Ie;;;;AAIX;AAUC,UArJA,iBAAA,CAyJN;EAQM,CAAA,SAAA,EAAA,MAAU,CAAA,EAhKL,YAoKD;AAMrB;;;;AAMkB,UAtKD,iBAAA,CAsKC;EAYD;EAAW,OAAA,EAhLlB,gBAgLkB;EAAA;EAAW,cAEhC,CAAA,EAAA,MAAA,EAAA;EAAC;EAkBI,UAAA,CAAA,EAAA,OAAe;EAWV;EAAW,WAAA,CAAA,EAAA,MAAA;EAAA;EAEN,eAEZ,CAAA,EAAA,MAAA;AAAC;;;;ACtPE,UDqDI,kBCrDO,CAAA,KAAA,OAAA,CAAA,CAAA;EAAA;EAAA,EAAA,EDuDnB,MChD6C,CDgDtC,EChDsC,CAAA;EAAE;EAAH,MAA3B,EDkDb,YClDa;EAAQ;EAe4B,YAAlB,CAAA,EDqCxB,iBCrCwB;EAAO;EAkBU,aAAjB,CAAA,EAAA,MAAA,EAAA;EAAO;EAYb,eAAW,CAAA,EAAA,MAAA;EAAW;EAAZ,iBA+EP,CAAA,EAAA,OAAA;;;AAOd;;UD/DN;;cAEJ;;QAEN,mBAAmB;;;;;;;;;UAUT;cACJ,SAAS;QACf,SAAS,mBAAmB;;;;;;;KAYvB,UAAA;;;;UAcK,UAAA;;;;QAIV;;;;;;;;;;;;;;;;;;;UAoBU,SAAA;;;;;;WAMP;;;;;;;;;UAUO,UAAA;;UAER;;aAEG;;;;;UAUK,eAAA;;;;YAIN;;;;;;;UAQM,UAAA;;;;aAIL;;;;;UAMK,YAAA;;;;YAIN;;SAEH;;;;;;;;;;;UAYS,gBAAgB;;QAE1B;;;;;;;;;;;;;KAkBK,eAAA;;;;UAWK;;QAEV;;WAEG;;;;;;;;;AAxQV;AAQA;AAsBA;AAUA;AAWA;AAoBA;;;;;;AAMiC;AAgBhB,cC3EJ,WD2EiB,CAAA,KAAA,OAAA,CAAA,CAAA;EAAA,QAAA,EAAA;EAAA,QAEjB,OAAA;EAAiB,QAEJ,WAAA;EAAE,QAArB,iBAAA;EAAkB,iBAAA,YAAA;EAUR,WAAA,CAAA,OAAA,EClFK,QDkFkB,CClFT,kBDkFS,CClFU,EDkFV,CAAA,CAAA;EAAA;;;;;;EAEzB,SAAA,CAAA,YAAA,CAAA,EAAA,OAAA,CAAA,ECrEyB,ODqEzB,CCrEiC,UDqEjC,CAAA;EAYH;AAcZ;AAwBA;EAgBiB,YAAA,CAAU,SAAA,EAAA,MAAA,CAAA,ECrHa,ODqHb,CCrHqB,SDqHrB,GAAA,IAAA,CAAA;EAAA;;;EAIX,KAAA,CAAA,OAAA,EC7GM,YD6GN,CAAA,EC7GqB,OD6GrB,CC7G6B,WD6G7B,CAAA;EAUC;AAYjB;AAUA;;EAA6B,eAIlB,CAAA,SAAA,EAAA,MAAA,CAAA,EClE0B,YDkE1B;EAAe;AAER;AAYlB;EAA4B,IAAA,QAAA,CAAA,CAAA,ECzEX,MDyEW,CCzEJ,EDyEI,CAAA"}

package/dist/{DataBrowser-c-Gs6PZB.cjs → DataBrowser-D8c_pBf4.cjs}

@@ -71,7 +71,7 @@ function validateFilter(filter, columnInfo) {
 			require_types.FilterOperator.IsNotNull
 		]
 	};
-	const allowedOps = typeCompatibility[columnInfo.type] ?? typeCompatibility.unknown;
+	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}'`
@@ -394,11 +394,11 @@ var DataBrowser = class {
 		let prevCursor = null;
 		if (hasMore && resultRows.length > 0) {
 			const lastRow = resultRows[resultRows.length - 1];
-			nextCursor = encodeCursor(lastRow[cursorConfig.field]);
+			if (lastRow) nextCursor = encodeCursor(lastRow[cursorConfig.field]);
 		}
 		if (options.cursor && resultRows.length > 0) {
 			const firstRow = resultRows[0];
-			prevCursor = encodeCursor(firstRow[cursorConfig.field]);
+			if (firstRow) prevCursor = encodeCursor(firstRow[cursorConfig.field]);
 		}
 		return {
 			rows: resultRows,
@@ -429,4 +429,4 @@ Object.defineProperty(exports, 'DataBrowser', {
     return DataBrowser;
   }
 });
-//# sourceMappingURL=DataBrowser-c-Gs6PZB.cjs.map
+//# sourceMappingURL=DataBrowser-D8c_pBf4.cjs.map

package/dist/DataBrowser-D8c_pBf4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataBrowser-D8c_pBf4.cjs","names":["filter: FilterCondition","columnInfo: ColumnInfo","typeCompatibility: Record<string, FilterOperator[]>","FilterOperator","query: SelectQueryBuilder<DB, TB, O>","filters: FilterCondition[]","tableInfo: TableInfo","sorts: SortConfig[]","Direction","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","Direction","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\ttype ColumnInfo,\n\tDirection,\n\ttype FilterCondition,\n\tFilterOperator,\n\ttype SortConfig,\n\ttype TableInfo,\n} from '../types';\n\n/**\n * Validates that a filter is applicable to the given column.\n */\nexport function validateFilter(\n\tfilter: FilterCondition,\n\tcolumnInfo: ColumnInfo,\n): { valid: boolean; error?: string } {\n\t// Validate operator compatibility with column type\n\tconst typeCompatibility: Record<string, FilterOperator[]> = {\n\t\tstring: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Like,\n\t\t\tFilterOperator.Ilike,\n\t\t\tFilterOperator.In,\n\t\t\tFilterOperator.Nin,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tnumber: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Gt,\n\t\t\tFilterOperator.Gte,\n\t\t\tFilterOperator.Lt,\n\t\t\tFilterOperator.Lte,\n\t\t\tFilterOperator.In,\n\t\t\tFilterOperator.Nin,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tboolean: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tdate: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Gt,\n\t\t\tFilterOperator.Gte,\n\t\t\tFilterOperator.Lt,\n\t\t\tFilterOperator.Lte,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tdatetime: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Gt,\n\t\t\tFilterOperator.Gte,\n\t\t\tFilterOperator.Lt,\n\t\t\tFilterOperator.Lte,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tuuid: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.In,\n\t\t\tFilterOperator.Nin,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tjson: [FilterOperator.IsNull, FilterOperator.IsNotNull],\n\t\tbinary: [FilterOperator.IsNull, FilterOperator.IsNotNull],\n\t\tunknown: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t};\n\n\tconst allowedOps =\n\t\ttypeCompatibility[columnInfo.type] ?? typeCompatibility.unknown ?? [];\n\n\tif (!allowedOps.includes(filter.operator)) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `Operator '${filter.operator}' not supported for column type '${columnInfo.type}'`,\n\t\t};\n\t}\n\n\treturn { valid: true };\n}\n\n/**\n * Applies filters to a Kysely query builder.\n */\nexport function applyFilters<DB, TB extends keyof DB, O>(\n\tquery: SelectQueryBuilder<DB, TB, O>,\n\tfilters: FilterCondition[],\n\ttableInfo: TableInfo,\n): SelectQueryBuilder<DB, TB, O> {\n\tlet result = query;\n\n\tfor (const filter of filters) {\n\t\tconst column = tableInfo.columns.find((c) => c.name === filter.column);\n\n\t\tif (!column) {\n\t\t\tthrow new Error(\n\t\t\t\t`Column '${filter.column}' not found in table '${tableInfo.name}'`,\n\t\t\t);\n\t\t}\n\n\t\tconst validation = validateFilter(filter, column);\n\t\tif (!validation.valid) {\n\t\t\tthrow new Error(validation.error);\n\t\t}\n\n\t\tresult = applyFilterCondition(result, filter);\n\t}\n\n\treturn result;\n}\n\nfunction applyFilterCondition<DB, TB extends keyof DB, O>(\n\tquery: SelectQueryBuilder<DB, TB, O>,\n\tfilter: FilterCondition,\n): SelectQueryBuilder<DB, TB, O> {\n\tconst { column, operator, value } = filter;\n\n\tswitch (operator) {\n\t\tcase FilterOperator.Eq:\n\t\t\treturn query.where(column as any, '=', value);\n\t\tcase FilterOperator.Neq:\n\t\t\treturn query.where(column as any, '!=', value);\n\t\tcase FilterOperator.Gt:\n\t\t\treturn query.where(column as any, '>', value);\n\t\tcase FilterOperator.Gte:\n\t\t\treturn query.where(column as any, '>=', value);\n\t\tcase FilterOperator.Lt:\n\t\t\treturn query.where(column as any, '<', value);\n\t\tcase FilterOperator.Lte:\n\t\t\treturn query.where(column as any, '<=', value);\n\t\tcase FilterOperator.Like:\n\t\t\treturn query.where(column as any, 'like', value);\n\t\tcase FilterOperator.Ilike:\n\t\t\treturn query.where(column as any, 'ilike', value);\n\t\tcase FilterOperator.In:\n\t\t\treturn query.where(column as any, 'in', value as any[]);\n\t\tcase FilterOperator.Nin:\n\t\t\treturn query.where(column as any, 'not in', value as any[]);\n\t\tcase FilterOperator.IsNull:\n\t\t\treturn query.where(column as any, 'is', null);\n\t\tcase FilterOperator.IsNotNull:\n\t\t\treturn query.where(column as any, 'is not', null);\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown filter operator: ${operator}`);\n\t}\n}\n\n/**\n * Applies sorting to a Kysely query builder.\n */\nexport function applySorting<DB, TB extends keyof DB, O>(\n\tquery: SelectQueryBuilder<DB, TB, O>,\n\tsorts: SortConfig[],\n\ttableInfo: TableInfo,\n): SelectQueryBuilder<DB, TB, O> {\n\tlet result = query;\n\n\tfor (const sort of sorts) {\n\t\tconst column = tableInfo.columns.find((c) => c.name === sort.column);\n\n\t\tif (!column) {\n\t\t\tthrow new Error(\n\t\t\t\t`Column '${sort.column}' not found in table '${tableInfo.name}'`,\n\t\t\t);\n\t\t}\n\n\t\tresult = result.orderBy(\n\t\t\tsort.column as any,\n\t\t\tsort.direction === Direction.Asc ? 'asc' : 'desc',\n\t\t);\n\t}\n\n\treturn 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\tdb: Kysely<DB>,\n\texcludeTables: string[],\n): Promise<SchemaInfo> {\n\t// Query tables from information_schema\n\tconst excludePlaceholders =\n\t\texcludeTables.length > 0\n\t\t\t? excludeTables.map((_, i) => `$${i + 1}`).join(', ')\n\t\t\t: \"''\";\n\n\tconst 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\tconst tablesResult = await db.executeQuery({\n\t\tsql: tablesQuery,\n\t\tparameters: excludeTables,\n\t} as any);\n\n\tconst tables: TableInfo[] = [];\n\n\tfor (const row of tablesResult.rows as any[]) {\n\t\t// Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n\t\tconst tableName = row.table_name ?? row.tableName;\n\t\tconst tableSchema = row.table_schema ?? row.tableSchema;\n\t\tconst tableInfo = await introspectTable(db, tableName, tableSchema);\n\t\ttables.push(tableInfo);\n\t}\n\n\treturn {\n\t\ttables,\n\t\tupdatedAt: new Date(),\n\t};\n}\n\n/**\n * Introspects a single table to get column information.\n */\nexport async function introspectTable<DB>(\n\tdb: Kysely<DB>,\n\ttableName: string,\n\tschema = 'public',\n): Promise<TableInfo> {\n\t// Query columns\n\tconst 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\tconst columnsResult = await db.executeQuery({\n\t\tsql: columnsQuery,\n\t\tparameters: [tableName, schema],\n\t} as any);\n\n\t// Query foreign keys\n\tconst 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\tconst fkResult = await db.executeQuery({\n\t\tsql: fkQuery,\n\t\tparameters: [tableName, schema],\n\t} as any);\n\n\tconst foreignKeys = new Map<string, { table: string; column: string }>();\n\tfor (const row of fkResult.rows as any[]) {\n\t\t// Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n\t\tconst colName = row.column_name ?? row.columnName;\n\t\tforeignKeys.set(colName, {\n\t\t\ttable: row.foreign_table ?? row.foreignTable,\n\t\t\tcolumn: row.foreign_column ?? row.foreignColumn,\n\t\t});\n\t}\n\n\tconst columns: ColumnInfo[] = (columnsResult.rows as any[]).map((row) => {\n\t\t// Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n\t\tconst colName = row.column_name ?? row.columnName;\n\t\tconst udtName = row.udt_name ?? row.udtName;\n\t\tconst isNullable = row.is_nullable ?? row.isNullable;\n\t\tconst isPrimaryKey = row.is_primary_key ?? row.isPrimaryKey;\n\t\tconst columnDefault = row.column_default ?? row.columnDefault;\n\n\t\tconst fk = foreignKeys.get(colName);\n\t\treturn {\n\t\t\tname: colName,\n\t\t\ttype: mapPostgresType(udtName),\n\t\t\trawType: udtName,\n\t\t\tnullable: isNullable === 'YES',\n\t\t\tisPrimaryKey: isPrimaryKey,\n\t\t\tisForeignKey: !!fk,\n\t\t\tforeignKeyTable: fk?.table,\n\t\t\tforeignKeyColumn: fk?.column,\n\t\t\tdefaultValue: columnDefault ?? undefined,\n\t\t};\n\t});\n\n\tconst primaryKey = columns.filter((c) => c.isPrimaryKey).map((c) => c.name);\n\n\t// Get estimated row count\n\tconst countQuery = `\n    SELECT reltuples::bigint AS estimate\n    FROM pg_class\n    WHERE relname = $1\n  `;\n\n\tlet estimatedRowCount: number | undefined;\n\ttry {\n\t\tconst countResult = await db.executeQuery({\n\t\t\tsql: countQuery,\n\t\t\tparameters: [tableName],\n\t\t} as any);\n\t\tif (countResult.rows.length > 0) {\n\t\t\tconst estimate = (countResult.rows[0] as any).estimate;\n\t\t\testimatedRowCount = estimate > 0 ? Number(estimate) : undefined;\n\t\t}\n\t} catch {\n\t\t// Ignore errors, row count is optional\n\t}\n\n\treturn {\n\t\tname: tableName,\n\t\tschema,\n\t\tcolumns,\n\t\tprimaryKey,\n\t\testimatedRowCount,\n\t};\n}\n\n/**\n * Maps PostgreSQL types to generic column types.\n */\nfunction mapPostgresType(udtName: string): ColumnType {\n\tconst typeMap: Record<string, ColumnType> = {\n\t\t// Strings\n\t\tvarchar: 'string',\n\t\tchar: 'string',\n\t\ttext: 'string',\n\t\tname: 'string',\n\t\tbpchar: 'string',\n\n\t\t// Numbers\n\t\tint2: 'number',\n\t\tint4: 'number',\n\t\tint8: 'number',\n\t\tfloat4: 'number',\n\t\tfloat8: 'number',\n\t\tnumeric: 'number',\n\t\tmoney: 'number',\n\t\tserial: 'number',\n\t\tbigserial: 'number',\n\n\t\t// Boolean\n\t\tbool: 'boolean',\n\n\t\t// Dates\n\t\tdate: 'date',\n\t\ttimestamp: 'datetime',\n\t\ttimestamptz: 'datetime',\n\t\ttime: 'datetime',\n\t\ttimetz: 'datetime',\n\n\t\t// JSON\n\t\tjson: 'json',\n\t\tjsonb: 'json',\n\n\t\t// Binary\n\t\tbytea: 'binary',\n\n\t\t// UUID\n\t\tuuid: 'uuid',\n\t};\n\n\treturn 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\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","import type { Kysely, SelectQueryBuilder } from 'kysely';\nimport {\n\ttype CursorConfig,\n\ttype DataBrowserOptions,\n\tDirection,\n\ttype QueryOptions,\n\ttype QueryResult,\n\ttype SchemaInfo,\n\ttype 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\tprivate db: Kysely<DB>;\n\tprivate options: Required<DataBrowserOptions<DB>>;\n\tprivate schemaCache: SchemaInfo | null = null;\n\tprivate schemaCacheExpiry = 0;\n\tprivate readonly CACHE_TTL_MS = 60 * 1000; // 1 minute\n\n\tconstructor(options: Required<DataBrowserOptions<DB>>) {\n\t\tthis.db = options.db;\n\t\tthis.options = options;\n\t}\n\n\t// ============================================\n\t// Schema Introspection\n\t// ============================================\n\n\t/**\n\t * Get the database schema information.\n\t * Results are cached for 1 minute.\n\t *\n\t * @param forceRefresh - Force a refresh of the cache\n\t */\n\tasync getSchema(forceRefresh = false): Promise<SchemaInfo> {\n\t\tconst now = Date.now();\n\n\t\tif (!forceRefresh && this.schemaCache && now < this.schemaCacheExpiry) {\n\t\t\treturn this.schemaCache;\n\t\t}\n\n\t\tconst schema = await introspectSchema(this.db, this.options.excludeTables);\n\n\t\tthis.schemaCache = schema;\n\t\tthis.schemaCacheExpiry = now + this.CACHE_TTL_MS;\n\n\t\treturn schema;\n\t}\n\n\t/**\n\t * Get information about a specific table.\n\t */\n\tasync getTableInfo(tableName: string): Promise<TableInfo | null> {\n\t\tconst schema = await this.getSchema();\n\t\treturn schema.tables.find((t) => t.name === tableName) ?? null;\n\t}\n\n\t// ============================================\n\t// Data Querying\n\t// ============================================\n\n\t/**\n\t * Query table data with pagination, filtering, and sorting.\n\t */\n\tasync query(options: QueryOptions): Promise<QueryResult> {\n\t\tconst tableInfo = await this.getTableInfo(options.table);\n\n\t\tif (!tableInfo) {\n\t\t\tthrow new Error(`Table '${options.table}' not found`);\n\t\t}\n\n\t\tconst cursorConfig = this.getCursorConfig(options.table);\n\t\tconst pageSize = Math.min(\n\t\t\toptions.pageSize ?? this.options.defaultPageSize,\n\t\t\t100,\n\t\t);\n\n\t\t// Build base query selecting all columns\n\t\tlet query = this.db\n\t\t\t.selectFrom(options.table as any)\n\t\t\t.selectAll() as SelectQueryBuilder<any, any, any>;\n\n\t\t// Apply filters if provided\n\t\tif (options.filters && options.filters.length > 0) {\n\t\t\tquery = applyFilters(query, options.filters, tableInfo);\n\t\t}\n\n\t\t// Apply sorting if provided, otherwise use cursor field\n\t\tif (options.sort && options.sort.length > 0) {\n\t\t\tquery = applySorting(query, options.sort, tableInfo);\n\t\t} else {\n\t\t\tquery = query.orderBy(cursorConfig.field as any, cursorConfig.direction);\n\t\t}\n\n\t\t// Handle cursor-based pagination\n\t\tif (options.cursor) {\n\t\t\tconst cursorValue = decodeCursor(options.cursor);\n\t\t\tconst operator = cursorConfig.direction === Direction.Asc ? '>' : '<';\n\t\t\tquery = query.where(cursorConfig.field as any, operator, cursorValue);\n\t\t}\n\n\t\t// Fetch one extra row to determine if there are more results\n\t\tconst rows = await query.limit(pageSize + 1).execute();\n\n\t\tconst hasMore = rows.length > pageSize;\n\t\tconst resultRows = hasMore ? rows.slice(0, pageSize) : rows;\n\n\t\t// Generate cursors\n\t\tlet nextCursor: string | null = null;\n\t\tlet prevCursor: string | null = null;\n\n\t\tif (hasMore && resultRows.length > 0) {\n\t\t\tconst lastRow = resultRows[resultRows.length - 1];\n\t\t\tif (lastRow) {\n\t\t\t\tnextCursor = encodeCursor(lastRow[cursorConfig.field]);\n\t\t\t}\n\t\t}\n\n\t\t// For prev cursor, we need to know if there are previous results\n\t\t// This would require a separate query, so we'll only set it if there's an input cursor\n\t\tif (options.cursor && resultRows.length > 0) {\n\t\t\tconst firstRow = resultRows[0];\n\t\t\tif (firstRow) {\n\t\t\t\tprevCursor = encodeCursor(firstRow[cursorConfig.field]);\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\trows: resultRows,\n\t\t\thasMore,\n\t\t\tnextCursor,\n\t\t\tprevCursor,\n\t\t};\n\t}\n\n\t// ============================================\n\t// Configuration Access\n\t// ============================================\n\n\t/**\n\t * Get the cursor configuration for a table.\n\t * Returns the table-specific config if defined, otherwise the default.\n\t */\n\tgetCursorConfig(tableName: string): CursorConfig {\n\t\treturn this.options.tableCursors[tableName] ?? this.options.cursor;\n\t}\n\n\t/**\n\t * Get the underlying Kysely database instance.\n\t */\n\tget database(): Kysely<DB> {\n\t\treturn this.db;\n\t}\n}\n"],"mappings":"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"}

package/dist/{DataBrowser-DQ3-ZxdV.mjs → DataBrowser-kgcI9ApJ.mjs}

@@ -71,7 +71,7 @@ function validateFilter(filter, columnInfo) {
 			FilterOperator.IsNotNull
 		]
 	};
-	const allowedOps = typeCompatibility[columnInfo.type] ?? typeCompatibility.unknown;
+	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}'`
@@ -394,11 +394,11 @@ var DataBrowser = class {
 		let prevCursor = null;
 		if (hasMore && resultRows.length > 0) {
 			const lastRow = resultRows[resultRows.length - 1];
-			nextCursor = encodeCursor(lastRow[cursorConfig.field]);
+			if (lastRow) nextCursor = encodeCursor(lastRow[cursorConfig.field]);
 		}
 		if (options.cursor && resultRows.length > 0) {
 			const firstRow = resultRows[0];
-			prevCursor = encodeCursor(firstRow[cursorConfig.field]);
+			if (firstRow) prevCursor = encodeCursor(firstRow[cursorConfig.field]);
 		}
 		return {
 			rows: resultRows,
@@ -424,4 +424,4 @@ var DataBrowser = class {
 
 //#endregion
 export { DataBrowser };
-//# sourceMappingURL=DataBrowser-DQ3-ZxdV.mjs.map
+//# sourceMappingURL=DataBrowser-kgcI9ApJ.mjs.map

package/dist/DataBrowser-kgcI9ApJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataBrowser-kgcI9ApJ.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\ttype ColumnInfo,\n\tDirection,\n\ttype FilterCondition,\n\tFilterOperator,\n\ttype SortConfig,\n\ttype TableInfo,\n} from '../types';\n\n/**\n * Validates that a filter is applicable to the given column.\n */\nexport function validateFilter(\n\tfilter: FilterCondition,\n\tcolumnInfo: ColumnInfo,\n): { valid: boolean; error?: string } {\n\t// Validate operator compatibility with column type\n\tconst typeCompatibility: Record<string, FilterOperator[]> = {\n\t\tstring: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Like,\n\t\t\tFilterOperator.Ilike,\n\t\t\tFilterOperator.In,\n\t\t\tFilterOperator.Nin,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tnumber: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Gt,\n\t\t\tFilterOperator.Gte,\n\t\t\tFilterOperator.Lt,\n\t\t\tFilterOperator.Lte,\n\t\t\tFilterOperator.In,\n\t\t\tFilterOperator.Nin,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tboolean: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tdate: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Gt,\n\t\t\tFilterOperator.Gte,\n\t\t\tFilterOperator.Lt,\n\t\t\tFilterOperator.Lte,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tdatetime: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.Gt,\n\t\t\tFilterOperator.Gte,\n\t\t\tFilterOperator.Lt,\n\t\t\tFilterOperator.Lte,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tuuid: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.In,\n\t\t\tFilterOperator.Nin,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t\tjson: [FilterOperator.IsNull, FilterOperator.IsNotNull],\n\t\tbinary: [FilterOperator.IsNull, FilterOperator.IsNotNull],\n\t\tunknown: [\n\t\t\tFilterOperator.Eq,\n\t\t\tFilterOperator.Neq,\n\t\t\tFilterOperator.IsNull,\n\t\t\tFilterOperator.IsNotNull,\n\t\t],\n\t};\n\n\tconst allowedOps =\n\t\ttypeCompatibility[columnInfo.type] ?? typeCompatibility.unknown ?? [];\n\n\tif (!allowedOps.includes(filter.operator)) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `Operator '${filter.operator}' not supported for column type '${columnInfo.type}'`,\n\t\t};\n\t}\n\n\treturn { valid: true };\n}\n\n/**\n * Applies filters to a Kysely query builder.\n */\nexport function applyFilters<DB, TB extends keyof DB, O>(\n\tquery: SelectQueryBuilder<DB, TB, O>,\n\tfilters: FilterCondition[],\n\ttableInfo: TableInfo,\n): SelectQueryBuilder<DB, TB, O> {\n\tlet result = query;\n\n\tfor (const filter of filters) {\n\t\tconst column = tableInfo.columns.find((c) => c.name === filter.column);\n\n\t\tif (!column) {\n\t\t\tthrow new Error(\n\t\t\t\t`Column '${filter.column}' not found in table '${tableInfo.name}'`,\n\t\t\t);\n\t\t}\n\n\t\tconst validation = validateFilter(filter, column);\n\t\tif (!validation.valid) {\n\t\t\tthrow new Error(validation.error);\n\t\t}\n\n\t\tresult = applyFilterCondition(result, filter);\n\t}\n\n\treturn result;\n}\n\nfunction applyFilterCondition<DB, TB extends keyof DB, O>(\n\tquery: SelectQueryBuilder<DB, TB, O>,\n\tfilter: FilterCondition,\n): SelectQueryBuilder<DB, TB, O> {\n\tconst { column, operator, value } = filter;\n\n\tswitch (operator) {\n\t\tcase FilterOperator.Eq:\n\t\t\treturn query.where(column as any, '=', value);\n\t\tcase FilterOperator.Neq:\n\t\t\treturn query.where(column as any, '!=', value);\n\t\tcase FilterOperator.Gt:\n\t\t\treturn query.where(column as any, '>', value);\n\t\tcase FilterOperator.Gte:\n\t\t\treturn query.where(column as any, '>=', value);\n\t\tcase FilterOperator.Lt:\n\t\t\treturn query.where(column as any, '<', value);\n\t\tcase FilterOperator.Lte:\n\t\t\treturn query.where(column as any, '<=', value);\n\t\tcase FilterOperator.Like:\n\t\t\treturn query.where(column as any, 'like', value);\n\t\tcase FilterOperator.Ilike:\n\t\t\treturn query.where(column as any, 'ilike', value);\n\t\tcase FilterOperator.In:\n\t\t\treturn query.where(column as any, 'in', value as any[]);\n\t\tcase FilterOperator.Nin:\n\t\t\treturn query.where(column as any, 'not in', value as any[]);\n\t\tcase FilterOperator.IsNull:\n\t\t\treturn query.where(column as any, 'is', null);\n\t\tcase FilterOperator.IsNotNull:\n\t\t\treturn query.where(column as any, 'is not', null);\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown filter operator: ${operator}`);\n\t}\n}\n\n/**\n * Applies sorting to a Kysely query builder.\n */\nexport function applySorting<DB, TB extends keyof DB, O>(\n\tquery: SelectQueryBuilder<DB, TB, O>,\n\tsorts: SortConfig[],\n\ttableInfo: TableInfo,\n): SelectQueryBuilder<DB, TB, O> {\n\tlet result = query;\n\n\tfor (const sort of sorts) {\n\t\tconst column = tableInfo.columns.find((c) => c.name === sort.column);\n\n\t\tif (!column) {\n\t\t\tthrow new Error(\n\t\t\t\t`Column '${sort.column}' not found in table '${tableInfo.name}'`,\n\t\t\t);\n\t\t}\n\n\t\tresult = result.orderBy(\n\t\t\tsort.column as any,\n\t\t\tsort.direction === Direction.Asc ? 'asc' : 'desc',\n\t\t);\n\t}\n\n\treturn 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\tdb: Kysely<DB>,\n\texcludeTables: string[],\n): Promise<SchemaInfo> {\n\t// Query tables from information_schema\n\tconst excludePlaceholders =\n\t\texcludeTables.length > 0\n\t\t\t? excludeTables.map((_, i) => `$${i + 1}`).join(', ')\n\t\t\t: \"''\";\n\n\tconst 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\tconst tablesResult = await db.executeQuery({\n\t\tsql: tablesQuery,\n\t\tparameters: excludeTables,\n\t} as any);\n\n\tconst tables: TableInfo[] = [];\n\n\tfor (const row of tablesResult.rows as any[]) {\n\t\t// Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n\t\tconst tableName = row.table_name ?? row.tableName;\n\t\tconst tableSchema = row.table_schema ?? row.tableSchema;\n\t\tconst tableInfo = await introspectTable(db, tableName, tableSchema);\n\t\ttables.push(tableInfo);\n\t}\n\n\treturn {\n\t\ttables,\n\t\tupdatedAt: new Date(),\n\t};\n}\n\n/**\n * Introspects a single table to get column information.\n */\nexport async function introspectTable<DB>(\n\tdb: Kysely<DB>,\n\ttableName: string,\n\tschema = 'public',\n): Promise<TableInfo> {\n\t// Query columns\n\tconst 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\tconst columnsResult = await db.executeQuery({\n\t\tsql: columnsQuery,\n\t\tparameters: [tableName, schema],\n\t} as any);\n\n\t// Query foreign keys\n\tconst 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\tconst fkResult = await db.executeQuery({\n\t\tsql: fkQuery,\n\t\tparameters: [tableName, schema],\n\t} as any);\n\n\tconst foreignKeys = new Map<string, { table: string; column: string }>();\n\tfor (const row of fkResult.rows as any[]) {\n\t\t// Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n\t\tconst colName = row.column_name ?? row.columnName;\n\t\tforeignKeys.set(colName, {\n\t\t\ttable: row.foreign_table ?? row.foreignTable,\n\t\t\tcolumn: row.foreign_column ?? row.foreignColumn,\n\t\t});\n\t}\n\n\tconst columns: ColumnInfo[] = (columnsResult.rows as any[]).map((row) => {\n\t\t// Support both snake_case (raw) and camelCase (with CamelCasePlugin)\n\t\tconst colName = row.column_name ?? row.columnName;\n\t\tconst udtName = row.udt_name ?? row.udtName;\n\t\tconst isNullable = row.is_nullable ?? row.isNullable;\n\t\tconst isPrimaryKey = row.is_primary_key ?? row.isPrimaryKey;\n\t\tconst columnDefault = row.column_default ?? row.columnDefault;\n\n\t\tconst fk = foreignKeys.get(colName);\n\t\treturn {\n\t\t\tname: colName,\n\t\t\ttype: mapPostgresType(udtName),\n\t\t\trawType: udtName,\n\t\t\tnullable: isNullable === 'YES',\n\t\t\tisPrimaryKey: isPrimaryKey,\n\t\t\tisForeignKey: !!fk,\n\t\t\tforeignKeyTable: fk?.table,\n\t\t\tforeignKeyColumn: fk?.column,\n\t\t\tdefaultValue: columnDefault ?? undefined,\n\t\t};\n\t});\n\n\tconst primaryKey = columns.filter((c) => c.isPrimaryKey).map((c) => c.name);\n\n\t// Get estimated row count\n\tconst countQuery = `\n    SELECT reltuples::bigint AS estimate\n    FROM pg_class\n    WHERE relname = $1\n  `;\n\n\tlet estimatedRowCount: number | undefined;\n\ttry {\n\t\tconst countResult = await db.executeQuery({\n\t\t\tsql: countQuery,\n\t\t\tparameters: [tableName],\n\t\t} as any);\n\t\tif (countResult.rows.length > 0) {\n\t\t\tconst estimate = (countResult.rows[0] as any).estimate;\n\t\t\testimatedRowCount = estimate > 0 ? Number(estimate) : undefined;\n\t\t}\n\t} catch {\n\t\t// Ignore errors, row count is optional\n\t}\n\n\treturn {\n\t\tname: tableName,\n\t\tschema,\n\t\tcolumns,\n\t\tprimaryKey,\n\t\testimatedRowCount,\n\t};\n}\n\n/**\n * Maps PostgreSQL types to generic column types.\n */\nfunction mapPostgresType(udtName: string): ColumnType {\n\tconst typeMap: Record<string, ColumnType> = {\n\t\t// Strings\n\t\tvarchar: 'string',\n\t\tchar: 'string',\n\t\ttext: 'string',\n\t\tname: 'string',\n\t\tbpchar: 'string',\n\n\t\t// Numbers\n\t\tint2: 'number',\n\t\tint4: 'number',\n\t\tint8: 'number',\n\t\tfloat4: 'number',\n\t\tfloat8: 'number',\n\t\tnumeric: 'number',\n\t\tmoney: 'number',\n\t\tserial: 'number',\n\t\tbigserial: 'number',\n\n\t\t// Boolean\n\t\tbool: 'boolean',\n\n\t\t// Dates\n\t\tdate: 'date',\n\t\ttimestamp: 'datetime',\n\t\ttimestamptz: 'datetime',\n\t\ttime: 'datetime',\n\t\ttimetz: 'datetime',\n\n\t\t// JSON\n\t\tjson: 'json',\n\t\tjsonb: 'json',\n\n\t\t// Binary\n\t\tbytea: 'binary',\n\n\t\t// UUID\n\t\tuuid: 'uuid',\n\t};\n\n\treturn 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\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","import type { Kysely, SelectQueryBuilder } from 'kysely';\nimport {\n\ttype CursorConfig,\n\ttype DataBrowserOptions,\n\tDirection,\n\ttype QueryOptions,\n\ttype QueryResult,\n\ttype SchemaInfo,\n\ttype 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\tprivate db: Kysely<DB>;\n\tprivate options: Required<DataBrowserOptions<DB>>;\n\tprivate schemaCache: SchemaInfo | null = null;\n\tprivate schemaCacheExpiry = 0;\n\tprivate readonly CACHE_TTL_MS = 60 * 1000; // 1 minute\n\n\tconstructor(options: Required<DataBrowserOptions<DB>>) {\n\t\tthis.db = options.db;\n\t\tthis.options = options;\n\t}\n\n\t// ============================================\n\t// Schema Introspection\n\t// ============================================\n\n\t/**\n\t * Get the database schema information.\n\t * Results are cached for 1 minute.\n\t *\n\t * @param forceRefresh - Force a refresh of the cache\n\t */\n\tasync getSchema(forceRefresh = false): Promise<SchemaInfo> {\n\t\tconst now = Date.now();\n\n\t\tif (!forceRefresh && this.schemaCache && now < this.schemaCacheExpiry) {\n\t\t\treturn this.schemaCache;\n\t\t}\n\n\t\tconst schema = await introspectSchema(this.db, this.options.excludeTables);\n\n\t\tthis.schemaCache = schema;\n\t\tthis.schemaCacheExpiry = now + this.CACHE_TTL_MS;\n\n\t\treturn schema;\n\t}\n\n\t/**\n\t * Get information about a specific table.\n\t */\n\tasync getTableInfo(tableName: string): Promise<TableInfo | null> {\n\t\tconst schema = await this.getSchema();\n\t\treturn schema.tables.find((t) => t.name === tableName) ?? null;\n\t}\n\n\t// ============================================\n\t// Data Querying\n\t// ============================================\n\n\t/**\n\t * Query table data with pagination, filtering, and sorting.\n\t */\n\tasync query(options: QueryOptions): Promise<QueryResult> {\n\t\tconst tableInfo = await this.getTableInfo(options.table);\n\n\t\tif (!tableInfo) {\n\t\t\tthrow new Error(`Table '${options.table}' not found`);\n\t\t}\n\n\t\tconst cursorConfig = this.getCursorConfig(options.table);\n\t\tconst pageSize = Math.min(\n\t\t\toptions.pageSize ?? this.options.defaultPageSize,\n\t\t\t100,\n\t\t);\n\n\t\t// Build base query selecting all columns\n\t\tlet query = this.db\n\t\t\t.selectFrom(options.table as any)\n\t\t\t.selectAll() as SelectQueryBuilder<any, any, any>;\n\n\t\t// Apply filters if provided\n\t\tif (options.filters && options.filters.length > 0) {\n\t\t\tquery = applyFilters(query, options.filters, tableInfo);\n\t\t}\n\n\t\t// Apply sorting if provided, otherwise use cursor field\n\t\tif (options.sort && options.sort.length > 0) {\n\t\t\tquery = applySorting(query, options.sort, tableInfo);\n\t\t} else {\n\t\t\tquery = query.orderBy(cursorConfig.field as any, cursorConfig.direction);\n\t\t}\n\n\t\t// Handle cursor-based pagination\n\t\tif (options.cursor) {\n\t\t\tconst cursorValue = decodeCursor(options.cursor);\n\t\t\tconst operator = cursorConfig.direction === Direction.Asc ? '>' : '<';\n\t\t\tquery = query.where(cursorConfig.field as any, operator, cursorValue);\n\t\t}\n\n\t\t// Fetch one extra row to determine if there are more results\n\t\tconst rows = await query.limit(pageSize + 1).execute();\n\n\t\tconst hasMore = rows.length > pageSize;\n\t\tconst resultRows = hasMore ? rows.slice(0, pageSize) : rows;\n\n\t\t// Generate cursors\n\t\tlet nextCursor: string | null = null;\n\t\tlet prevCursor: string | null = null;\n\n\t\tif (hasMore && resultRows.length > 0) {\n\t\t\tconst lastRow = resultRows[resultRows.length - 1];\n\t\t\tif (lastRow) {\n\t\t\t\tnextCursor = encodeCursor(lastRow[cursorConfig.field]);\n\t\t\t}\n\t\t}\n\n\t\t// For prev cursor, we need to know if there are previous results\n\t\t// This would require a separate query, so we'll only set it if there's an input cursor\n\t\tif (options.cursor && resultRows.length > 0) {\n\t\t\tconst firstRow = resultRows[0];\n\t\t\tif (firstRow) {\n\t\t\t\tprevCursor = encodeCursor(firstRow[cursorConfig.field]);\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\trows: resultRows,\n\t\t\thasMore,\n\t\t\tnextCursor,\n\t\t\tprevCursor,\n\t\t};\n\t}\n\n\t// ============================================\n\t// Configuration Access\n\t// ============================================\n\n\t/**\n\t * Get the cursor configuration for a table.\n\t * Returns the table-specific config if defined, otherwise the default.\n\t */\n\tgetCursorConfig(tableName: string): CursorConfig {\n\t\treturn this.options.tableCursors[tableName] ?? this.options.cursor;\n\t}\n\n\t/**\n\t * Get the underlying Kysely database instance.\n\t */\n\tget database(): Kysely<DB> {\n\t\treturn this.db;\n\t}\n}\n"],"mappings":"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"}

package/dist/Studio-CYzz3wD2.d.cts

@@ -0,0 +1,152 @@
+import { DataBrowser, StudioEvent, StudioOptions } from "./DataBrowser-BTe9HWJy.cjs";
+import { Telescope } from "@geekmidas/telescope";
+
+//#region src/Studio.d.ts
+
+/**
+ * Unified development tools dashboard combining monitoring and database browsing.
+ *
+ * @example
+ * ```typescript
+ * import { Studio, Direction } from '@geekmidas/studio';
+ * import { InMemoryStorage } from '@geekmidas/telescope/storage/memory';
+ *
+ * const studio = new Studio({
+ *   monitoring: {
+ *     storage: new InMemoryStorage(),
+ *   },
+ *   data: {
+ *     db: kyselyInstance,
+ *     cursor: { field: 'id', direction: Direction.Desc },
+ *   },
+ * });
+ * ```
+ */
+declare class Studio<DB = unknown> {
+  private telescope;
+  private dataBrowser;
+  private options;
+  private wsClients;
+  constructor(options: StudioOptions<DB>);
+  /**
+   * Get the Studio dashboard path.
+   */
+  get path(): string;
+  /**
+   * Check if Studio is enabled.
+   */
+  get enabled(): boolean;
+  /**
+   * Get the data browser instance.
+   */
+  get data(): DataBrowser<DB>;
+  /**
+   * Check if body recording is enabled for monitoring.
+   */
+  get recordBody(): boolean;
+  /**
+   * Get max body size for monitoring.
+   */
+  get maxBodySize(): number;
+  /**
+   * Record a request entry.
+   */
+  recordRequest(entry: Parameters<Telescope['recordRequest']>[0]): Promise<string>;
+  /**
+   * Record log entries in batch.
+   */
+  log(entries: Parameters<Telescope['log']>[0]): Promise<void>;
+  /**
+   * Log a debug message.
+   */
+  debug(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log an info message.
+   */
+  info(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log a warning message.
+   */
+  warn(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log an error message.
+   */
+  error(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Record an exception.
+   */
+  exception(error: Error, requestId?: string): Promise<void>;
+  /**
+   * Get requests from storage.
+   */
+  getRequests(options?: Parameters<Telescope['getRequests']>[0]): ReturnType<Telescope['getRequests']>;
+  /**
+   * Get a single request by ID.
+   */
+  getRequest(id: string): ReturnType<Telescope['getRequest']>;
+  /**
+   * Get exceptions from storage.
+   */
+  getExceptions(options?: Parameters<Telescope['getExceptions']>[0]): ReturnType<Telescope['getExceptions']>;
+  /**
+   * Get a single exception by ID.
+   */
+  getException(id: string): ReturnType<Telescope['getException']>;
+  /**
+   * Get logs from storage.
+   */
+  getLogs(options?: Parameters<Telescope['getLogs']>[0]): ReturnType<Telescope['getLogs']>;
+  /**
+   * Get storage statistics.
+   */
+  getStats(): ReturnType<Telescope['getStats']>;
+  /**
+   * Get aggregated request metrics.
+   */
+  getMetrics(options?: Parameters<Telescope['getMetrics']>[0]): ReturnType<Telescope['getMetrics']>;
+  /**
+   * Get metrics grouped by endpoint.
+   */
+  getEndpointMetrics(options?: Parameters<Telescope['getEndpointMetrics']>[0]): ReturnType<Telescope['getEndpointMetrics']>;
+  /**
+   * Get detailed metrics for a specific endpoint.
+   */
+  getEndpointDetails(method: string, path: string, options?: Parameters<Telescope['getEndpointDetails']>[2]): ReturnType<Telescope['getEndpointDetails']>;
+  /**
+   * Get HTTP status code distribution.
+   */
+  getStatusDistribution(options?: Parameters<Telescope['getStatusDistribution']>[0]): ReturnType<Telescope['getStatusDistribution']>;
+  /**
+   * Reset all metrics.
+   */
+  resetMetrics(): void;
+  /**
+   * Add a WebSocket client for real-time updates.
+   */
+  addWsClient(ws: WebSocket): void;
+  /**
+   * Remove a WebSocket client.
+   */
+  removeWsClient(ws: WebSocket): void;
+  /**
+   * Broadcast an event to all connected WebSocket clients.
+   */
+  broadcast(event: StudioEvent): void;
+  /**
+   * Check if a path should be ignored for request recording.
+   */
+  shouldIgnore(path: string): boolean;
+  /**
+   * Manually prune old monitoring entries.
+   */
+  prune(olderThan: Date): Promise<number>;
+  /**
+   * Clean up resources.
+   */
+  destroy(): void;
+  private normalizeOptions;
+}
+//# sourceMappingURL=Studio.d.ts.map
+//#endregion
+export { Studio };
+//# sourceMappingURL=Studio-CYzz3wD2.d.cts.map

package/dist/Studio-CYzz3wD2.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Studio-CYzz3wD2.d.cts","names":[],"sources":["../src/Studio.ts"],"sourcesContent":[],"mappings":";;;;;;AA2BA;;;;;;;;;;;;;;;;;;AA4HY,cA5HC,MA4HD,CAAA,KAAA,OAAA,CAAA,CAAA;EAAM,QAEd,SAAA;EAAO,QAOa,WAAA;EAAK,QAAuB,OAAA;EAAO,QAQpC,SAAA;EAAS,WAApB,CAAA,OAAA,EAvIU,aAuIV,CAvIwB,EAuIxB,CAAA;EAAU;;;EAQ6B,IAApB,IAAA,CAAA,CAAA,EAAA,MAAA;EAAU;;;EASjB,IAApB,OAAA,CAAA,CAAA,EAAA,OAAA;EAAU;;;EAekB,IAApB,IAAA,CAAA,CAAA,EA7HC,WA6HD,CA7Ha,EA6Hb,CAAA;EAAU;;;EAQiB,IAApB,UAAA,CAAA,CAAA,EAAA,OAAA;EAAU;;;EAaL,IAApB,WAAA,CAAA,CAAA,EAAA,MAAA;EAAU;;;EASU,aAApB,CAAA,KAAA,EAjIK,UAiIL,CAjIgB,SAiIhB,CAAA,eAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAhIA,OAgIA,CAAA,MAAA,CAAA;EAAU;;;EAWU,GAApB,CAAA,OAAA,EApIgB,UAoIhB,CApI2B,SAoI3B,CAAA,KAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EApIkD,OAoIlD,CAAA,IAAA,CAAA;EAAU;;;EASU,KAApB,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EApIQ,MAoIR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAlIA,OAkIA,CAAA,IAAA,CAAA;EAAU;;;EAmCe,IA6BL,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAzLZ,MAyLY,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAvLpB,OAuLoB,CAAA,IAAA,CAAA;EAAI;AAAU;;kCA9K1B,8CAER;;;;mCASQ,8CAER;;;;mBAOoB,4BAA4B;;;;wBAQxC,WAAW,+BACnB,WAAW;;;;0BAOgB,WAAW;;;;0BAQ9B,WAAW,iCACnB,WAAW;;;;4BAOkB,WAAW;;;;oBAQhC,WAAW,2BACnB,WAAW;;;;cAOI,WAAW;;;;uBAYlB,WAAW,8BACnB,WAAW;;;;+BAQH,WAAW,sCACnB,WAAW;;;;6DAUH,WAAW,sCACnB,WAAW;;;;kCAQH,WAAW,yCACnB,WAAW;;;;;;;;kBAkBE;;;;qBASG;;;;mBAQF;;;;;;;;mBA6BM,OAAO"}

package/dist/Studio-D5yGscb8.d.mts

@@ -0,0 +1,152 @@
+import { DataBrowser, StudioEvent, StudioOptions } from "./DataBrowser-B-jz8KBR.mjs";
+import { Telescope } from "@geekmidas/telescope";
+
+//#region src/Studio.d.ts
+
+/**
+ * Unified development tools dashboard combining monitoring and database browsing.
+ *
+ * @example
+ * ```typescript
+ * import { Studio, Direction } from '@geekmidas/studio';
+ * import { InMemoryStorage } from '@geekmidas/telescope/storage/memory';
+ *
+ * const studio = new Studio({
+ *   monitoring: {
+ *     storage: new InMemoryStorage(),
+ *   },
+ *   data: {
+ *     db: kyselyInstance,
+ *     cursor: { field: 'id', direction: Direction.Desc },
+ *   },
+ * });
+ * ```
+ */
+declare class Studio<DB = unknown> {
+  private telescope;
+  private dataBrowser;
+  private options;
+  private wsClients;
+  constructor(options: StudioOptions<DB>);
+  /**
+   * Get the Studio dashboard path.
+   */
+  get path(): string;
+  /**
+   * Check if Studio is enabled.
+   */
+  get enabled(): boolean;
+  /**
+   * Get the data browser instance.
+   */
+  get data(): DataBrowser<DB>;
+  /**
+   * Check if body recording is enabled for monitoring.
+   */
+  get recordBody(): boolean;
+  /**
+   * Get max body size for monitoring.
+   */
+  get maxBodySize(): number;
+  /**
+   * Record a request entry.
+   */
+  recordRequest(entry: Parameters<Telescope['recordRequest']>[0]): Promise<string>;
+  /**
+   * Record log entries in batch.
+   */
+  log(entries: Parameters<Telescope['log']>[0]): Promise<void>;
+  /**
+   * Log a debug message.
+   */
+  debug(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log an info message.
+   */
+  info(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log a warning message.
+   */
+  warn(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log an error message.
+   */
+  error(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Record an exception.
+   */
+  exception(error: Error, requestId?: string): Promise<void>;
+  /**
+   * Get requests from storage.
+   */
+  getRequests(options?: Parameters<Telescope['getRequests']>[0]): ReturnType<Telescope['getRequests']>;
+  /**
+   * Get a single request by ID.
+   */
+  getRequest(id: string): ReturnType<Telescope['getRequest']>;
+  /**
+   * Get exceptions from storage.
+   */
+  getExceptions(options?: Parameters<Telescope['getExceptions']>[0]): ReturnType<Telescope['getExceptions']>;
+  /**
+   * Get a single exception by ID.
+   */
+  getException(id: string): ReturnType<Telescope['getException']>;
+  /**
+   * Get logs from storage.
+   */
+  getLogs(options?: Parameters<Telescope['getLogs']>[0]): ReturnType<Telescope['getLogs']>;
+  /**
+   * Get storage statistics.
+   */
+  getStats(): ReturnType<Telescope['getStats']>;
+  /**
+   * Get aggregated request metrics.
+   */
+  getMetrics(options?: Parameters<Telescope['getMetrics']>[0]): ReturnType<Telescope['getMetrics']>;
+  /**
+   * Get metrics grouped by endpoint.
+   */
+  getEndpointMetrics(options?: Parameters<Telescope['getEndpointMetrics']>[0]): ReturnType<Telescope['getEndpointMetrics']>;
+  /**
+   * Get detailed metrics for a specific endpoint.
+   */
+  getEndpointDetails(method: string, path: string, options?: Parameters<Telescope['getEndpointDetails']>[2]): ReturnType<Telescope['getEndpointDetails']>;
+  /**
+   * Get HTTP status code distribution.
+   */
+  getStatusDistribution(options?: Parameters<Telescope['getStatusDistribution']>[0]): ReturnType<Telescope['getStatusDistribution']>;
+  /**
+   * Reset all metrics.
+   */
+  resetMetrics(): void;
+  /**
+   * Add a WebSocket client for real-time updates.
+   */
+  addWsClient(ws: WebSocket): void;
+  /**
+   * Remove a WebSocket client.
+   */
+  removeWsClient(ws: WebSocket): void;
+  /**
+   * Broadcast an event to all connected WebSocket clients.
+   */
+  broadcast(event: StudioEvent): void;
+  /**
+   * Check if a path should be ignored for request recording.
+   */
+  shouldIgnore(path: string): boolean;
+  /**
+   * Manually prune old monitoring entries.
+   */
+  prune(olderThan: Date): Promise<number>;
+  /**
+   * Clean up resources.
+   */
+  destroy(): void;
+  private normalizeOptions;
+}
+//# sourceMappingURL=Studio.d.ts.map
+//#endregion
+export { Studio };
+//# sourceMappingURL=Studio-D5yGscb8.d.mts.map

package/dist/Studio-D5yGscb8.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Studio-D5yGscb8.d.mts","names":[],"sources":["../src/Studio.ts"],"sourcesContent":[],"mappings":";;;;;;AA2BA;;;;;;;;;;;;;;;;;;AA4HY,cA5HC,MA4HD,CAAA,KAAA,OAAA,CAAA,CAAA;EAAM,QAEd,SAAA;EAAO,QAOa,WAAA;EAAK,QAAuB,OAAA;EAAO,QAQpC,SAAA;EAAS,WAApB,CAAA,OAAA,EAvIU,aAuIV,CAvIwB,EAuIxB,CAAA;EAAU;;;EAQ6B,IAApB,IAAA,CAAA,CAAA,EAAA,MAAA;EAAU;;;EASjB,IAApB,OAAA,CAAA,CAAA,EAAA,OAAA;EAAU;;;EAekB,IAApB,IAAA,CAAA,CAAA,EA7HC,WA6HD,CA7Ha,EA6Hb,CAAA;EAAU;;;EAQiB,IAApB,UAAA,CAAA,CAAA,EAAA,OAAA;EAAU;;;EAaL,IAApB,WAAA,CAAA,CAAA,EAAA,MAAA;EAAU;;;EASU,aAApB,CAAA,KAAA,EAjIK,UAiIL,CAjIgB,SAiIhB,CAAA,eAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAhIA,OAgIA,CAAA,MAAA,CAAA;EAAU;;;EAWU,GAApB,CAAA,OAAA,EApIgB,UAoIhB,CApI2B,SAoI3B,CAAA,KAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EApIkD,OAoIlD,CAAA,IAAA,CAAA;EAAU;;;EASU,KAApB,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EApIQ,MAoIR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAlIA,OAkIA,CAAA,IAAA,CAAA;EAAU;;;EAmCe,IA6BL,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAzLZ,MAyLY,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAvLpB,OAuLoB,CAAA,IAAA,CAAA;EAAI;AAAU;;kCA9K1B,8CAER;;;;mCASQ,8CAER;;;;mBAOoB,4BAA4B;;;;wBAQxC,WAAW,+BACnB,WAAW;;;;0BAOgB,WAAW;;;;0BAQ9B,WAAW,iCACnB,WAAW;;;;4BAOkB,WAAW;;;;oBAQhC,WAAW,2BACnB,WAAW;;;;cAOI,WAAW;;;;uBAYlB,WAAW,8BACnB,WAAW;;;;+BAQH,WAAW,sCACnB,WAAW;;;;6DAUH,WAAW,sCACnB,WAAW;;;;kCAQH,WAAW,yCACnB,WAAW;;;;;;;;kBAkBE;;;;qBASG;;;;mBAQF;;;;;;;;mBA6BM,OAAO"}

package/dist/data/index.cjs

@@ -1,4 +1,4 @@
 require('../types-CMttUZYk.cjs');
-const require_DataBrowser = require('../DataBrowser-c-Gs6PZB.cjs');
+const require_DataBrowser = require('../DataBrowser-D8c_pBf4.cjs');
 
 exports.DataBrowser = require_DataBrowser.DataBrowser;

package/dist/data/index.d.cts

@@ -1,2 +1,2 @@
-import { DataBrowser } from "../DataBrowser-hGwiTffZ.cjs";
+import { DataBrowser } from "../DataBrowser-BTe9HWJy.cjs";
 export { DataBrowser };

package/dist/data/index.d.mts

@@ -1,2 +1,2 @@
-import { DataBrowser } from "../DataBrowser-SOcqmZb2.mjs";
+import { DataBrowser } from "../DataBrowser-B-jz8KBR.mjs";
 export { DataBrowser };

package/dist/data/index.mjs

@@ -1,4 +1,4 @@
 import "../types-BZv87Ikv.mjs";
-import { DataBrowser } from "../DataBrowser-DQ3-ZxdV.mjs";
+import { DataBrowser } from "../DataBrowser-kgcI9ApJ.mjs";
 
 export { DataBrowser };

package/dist/index.cjs

@@ -1,8 +1,8 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
 const require_types = require('./types-CMttUZYk.cjs');
-const require_DataBrowser = require('./DataBrowser-c-Gs6PZB.cjs');
-const __geekmidas_telescope = require_chunk.__toESM(require("@geekmidas/telescope"));
+const require_DataBrowser = require('./DataBrowser-D8c_pBf4.cjs');
 const __geekmidas_telescope_storage_memory = require_chunk.__toESM(require("@geekmidas/telescope/storage/memory"));
+const __geekmidas_telescope = require_chunk.__toESM(require("@geekmidas/telescope"));
 
 //#region src/Studio.ts
 /**
@@ -151,6 +151,36 @@ var Studio = class {
 		return this.telescope.getStats();
 	}
 	/**
+	* Get aggregated request metrics.
+	*/
+	getMetrics(options) {
+		return this.telescope.getMetrics(options);
+	}
+	/**
+	* Get metrics grouped by endpoint.
+	*/
+	getEndpointMetrics(options) {
+		return this.telescope.getEndpointMetrics(options);
+	}
+	/**
+	* Get detailed metrics for a specific endpoint.
+	*/
+	getEndpointDetails(method, path, options) {
+		return this.telescope.getEndpointDetails(method, path, options);
+	}
+	/**
+	* Get HTTP status code distribution.
+	*/
+	getStatusDistribution(options) {
+		return this.telescope.getStatusDistribution(options);
+	}
+	/**
+	* Reset all metrics.
+	*/
+	resetMetrics() {
+		this.telescope.resetMetrics();
+	}
+	/**
 	* Add a WebSocket client for real-time updates.
 	*/
 	addWsClient(ws) {
@@ -203,7 +233,7 @@ var Studio = class {
 				ignorePatterns: options.monitoring.ignorePatterns ?? [],
 				recordBody: options.monitoring.recordBody ?? true,
 				maxBodySize: options.monitoring.maxBodySize ?? 64 * 1024,
-				pruneAfterHours: options.monitoring.pruneAfterHours
+				pruneAfterHours: options.monitoring.pruneAfterHours ?? 24
 			},
 			data: {
 				db: options.data.db,