@geekmidas/studio 0.0.1

package/dist/types-BZv87Ikv.mjs

@@ -0,0 +1,31 @@
+//#region src/types.ts
+/**
+* Sort direction for cursor-based pagination and sorting.
+*/
+let Direction = /* @__PURE__ */ function(Direction$1) {
+	Direction$1["Asc"] = "asc";
+	Direction$1["Desc"] = "desc";
+	return Direction$1;
+}({});
+/**
+* Filter operators for querying data.
+*/
+let FilterOperator = /* @__PURE__ */ function(FilterOperator$1) {
+	FilterOperator$1["Eq"] = "eq";
+	FilterOperator$1["Neq"] = "neq";
+	FilterOperator$1["Gt"] = "gt";
+	FilterOperator$1["Gte"] = "gte";
+	FilterOperator$1["Lt"] = "lt";
+	FilterOperator$1["Lte"] = "lte";
+	FilterOperator$1["Like"] = "like";
+	FilterOperator$1["Ilike"] = "ilike";
+	FilterOperator$1["In"] = "in";
+	FilterOperator$1["Nin"] = "nin";
+	FilterOperator$1["IsNull"] = "is_null";
+	FilterOperator$1["IsNotNull"] = "is_not_null";
+	return FilterOperator$1;
+}({});
+
+//#endregion
+export { Direction, FilterOperator };
+//# sourceMappingURL=types-BZv87Ikv.mjs.map

package/dist/types-BZv87Ikv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BZv87Ikv.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { TelescopeStorage } from '@geekmidas/telescope';\nimport type { Kysely } from 'kysely';\n\n// ============================================\n// Enums\n// ============================================\n\n/**\n * Sort direction for cursor-based pagination and sorting.\n */\nexport enum Direction {\n  Asc = 'asc',\n  Desc = 'desc',\n}\n\n/**\n * Filter operators for querying data.\n */\nexport enum FilterOperator {\n  Eq = 'eq',\n  Neq = 'neq',\n  Gt = 'gt',\n  Gte = 'gte',\n  Lt = 'lt',\n  Lte = 'lte',\n  Like = 'like',\n  Ilike = 'ilike',\n  In = 'in',\n  Nin = 'nin',\n  IsNull = 'is_null',\n  IsNotNull = 'is_not_null',\n}\n\n// ============================================\n// Cursor Configuration\n// ============================================\n\n/**\n * Configuration for cursor-based pagination.\n */\nexport interface CursorConfig {\n  /** The field to use for cursor-based pagination (e.g., 'id', 'created_at') */\n  field: string;\n  /** Sort direction for the cursor field */\n  direction: Direction;\n}\n\n/**\n * Per-table cursor configuration overrides.\n */\nexport interface TableCursorConfig {\n  [tableName: string]: CursorConfig;\n}\n\n// ============================================\n// Monitoring Configuration\n// ============================================\n\n/**\n * Configuration for the monitoring feature (Telescope).\n */\nexport interface MonitoringOptions {\n  /** Storage backend for monitoring data */\n  storage: TelescopeStorage;\n  /** Patterns to ignore when recording requests (supports wildcards) */\n  ignorePatterns?: string[];\n  /** Whether to record request/response bodies (default: true) */\n  recordBody?: boolean;\n  /** Maximum body size to record in bytes (default: 64KB) */\n  maxBodySize?: number;\n  /** Hours after which to prune old entries */\n  pruneAfterHours?: number;\n}\n\n// ============================================\n// Data Browser Configuration\n// ============================================\n\n/**\n * Configuration for the data browser feature.\n */\nexport interface DataBrowserOptions<DB = unknown> {\n  /** Kysely database instance */\n  db: Kysely<DB>;\n  /** Default cursor configuration for all tables */\n  cursor: CursorConfig;\n  /** Per-table cursor overrides */\n  tableCursors?: TableCursorConfig;\n  /** Tables to exclude from browsing */\n  excludeTables?: string[];\n  /** Maximum rows per page (default: 50, max: 100) */\n  defaultPageSize?: number;\n  /** Whether to allow viewing of binary/blob columns (default: false) */\n  showBinaryColumns?: boolean;\n}\n\n// ============================================\n// Studio Configuration\n// ============================================\n\n/**\n * Configuration for the Studio dashboard.\n */\nexport interface StudioOptions<DB = unknown> {\n  /** Monitoring configuration */\n  monitoring: MonitoringOptions;\n  /** Data browser configuration */\n  data: DataBrowserOptions<DB>;\n  /** Dashboard path (default: '/__studio') */\n  path?: string;\n  /** Whether Studio is enabled (default: true) */\n  enabled?: boolean;\n}\n\n/**\n * Normalized Studio options with all defaults applied.\n */\nexport interface NormalizedStudioOptions<DB = unknown> {\n  monitoring: Required<MonitoringOptions>;\n  data: Required<DataBrowserOptions<DB>>;\n  path: string;\n  enabled: boolean;\n}\n\n// ============================================\n// Table Introspection Types\n// ============================================\n\n/**\n * Generic column type classification.\n */\nexport type ColumnType =\n  | 'string'\n  | 'number'\n  | 'boolean'\n  | 'date'\n  | 'datetime'\n  | 'json'\n  | 'binary'\n  | 'uuid'\n  | 'unknown';\n\n/**\n * Information about a database column.\n */\nexport interface ColumnInfo {\n  /** Column name */\n  name: string;\n  /** Generic column type */\n  type: ColumnType;\n  /** Raw database type (e.g., 'varchar', 'int4') */\n  rawType: string;\n  /** Whether the column allows NULL values */\n  nullable: boolean;\n  /** Whether this column is part of the primary key */\n  isPrimaryKey: boolean;\n  /** Whether this column is a foreign key */\n  isForeignKey: boolean;\n  /** Referenced table if foreign key */\n  foreignKeyTable?: string;\n  /** Referenced column if foreign key */\n  foreignKeyColumn?: string;\n  /** Default value expression */\n  defaultValue?: string;\n}\n\n/**\n * Information about a database table.\n */\nexport interface TableInfo {\n  /** Table name */\n  name: string;\n  /** Schema name (e.g., 'public') */\n  schema: string;\n  /** List of columns */\n  columns: ColumnInfo[];\n  /** Primary key column names */\n  primaryKey: string[];\n  /** Estimated row count (if available) */\n  estimatedRowCount?: number;\n}\n\n/**\n * Complete schema information.\n */\nexport interface SchemaInfo {\n  /** List of tables */\n  tables: TableInfo[];\n  /** When the schema was last introspected */\n  updatedAt: Date;\n}\n\n// ============================================\n// Query Types\n// ============================================\n\n/**\n * A single filter condition.\n */\nexport interface FilterCondition {\n  /** Column to filter on */\n  column: string;\n  /** Filter operator */\n  operator: FilterOperator;\n  /** Value to compare against (optional for IsNull/IsNotNull operators) */\n  value?: unknown;\n}\n\n/**\n * Sort configuration for a column.\n */\nexport interface SortConfig {\n  /** Column to sort by */\n  column: string;\n  /** Sort direction */\n  direction: Direction;\n}\n\n/**\n * Options for querying table data.\n */\nexport interface QueryOptions {\n  /** Table to query */\n  table: string;\n  /** Filter conditions */\n  filters?: FilterCondition[];\n  /** Sort configuration */\n  sort?: SortConfig[];\n  /** Cursor for pagination */\n  cursor?: string | null;\n  /** Number of rows per page */\n  pageSize?: number;\n  /** Pagination direction */\n  direction?: 'next' | 'prev';\n}\n\n/**\n * Result of a paginated query.\n */\nexport interface QueryResult<T = Record<string, unknown>> {\n  /** Retrieved rows */\n  rows: T[];\n  /** Whether there are more rows */\n  hasMore: boolean;\n  /** Cursor for next page */\n  nextCursor: string | null;\n  /** Cursor for previous page */\n  prevCursor: string | null;\n  /** Estimated total row count */\n  totalEstimate?: number;\n}\n\n// ============================================\n// WebSocket Events\n// ============================================\n\n/**\n * Types of events broadcast via WebSocket.\n */\nexport type StudioEventType =\n  | 'request'\n  | 'exception'\n  | 'log'\n  | 'stats'\n  | 'connected'\n  | 'schema_updated';\n\n/**\n * A WebSocket event payload.\n */\nexport interface StudioEvent<T = unknown> {\n  /** Event type */\n  type: StudioEventType;\n  /** Event payload */\n  payload: T;\n  /** Event timestamp */\n  timestamp: number;\n}\n"],"mappings":";;;;AAUA,IAAY,kDAAL;AACL;AACA;;AACD;;;;AAKD,IAAY,4DAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD"}

package/dist/types-CMttUZYk.cjs

@@ -0,0 +1,43 @@
+
+//#region src/types.ts
+/**
+* Sort direction for cursor-based pagination and sorting.
+*/
+let Direction = /* @__PURE__ */ function(Direction$1) {
+	Direction$1["Asc"] = "asc";
+	Direction$1["Desc"] = "desc";
+	return Direction$1;
+}({});
+/**
+* Filter operators for querying data.
+*/
+let FilterOperator = /* @__PURE__ */ function(FilterOperator$1) {
+	FilterOperator$1["Eq"] = "eq";
+	FilterOperator$1["Neq"] = "neq";
+	FilterOperator$1["Gt"] = "gt";
+	FilterOperator$1["Gte"] = "gte";
+	FilterOperator$1["Lt"] = "lt";
+	FilterOperator$1["Lte"] = "lte";
+	FilterOperator$1["Like"] = "like";
+	FilterOperator$1["Ilike"] = "ilike";
+	FilterOperator$1["In"] = "in";
+	FilterOperator$1["Nin"] = "nin";
+	FilterOperator$1["IsNull"] = "is_null";
+	FilterOperator$1["IsNotNull"] = "is_not_null";
+	return FilterOperator$1;
+}({});
+
+//#endregion
+Object.defineProperty(exports, 'Direction', {
+  enumerable: true,
+  get: function () {
+    return Direction;
+  }
+});
+Object.defineProperty(exports, 'FilterOperator', {
+  enumerable: true,
+  get: function () {
+    return FilterOperator;
+  }
+});
+//# sourceMappingURL=types-CMttUZYk.cjs.map

package/dist/types-CMttUZYk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CMttUZYk.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { TelescopeStorage } from '@geekmidas/telescope';\nimport type { Kysely } from 'kysely';\n\n// ============================================\n// Enums\n// ============================================\n\n/**\n * Sort direction for cursor-based pagination and sorting.\n */\nexport enum Direction {\n  Asc = 'asc',\n  Desc = 'desc',\n}\n\n/**\n * Filter operators for querying data.\n */\nexport enum FilterOperator {\n  Eq = 'eq',\n  Neq = 'neq',\n  Gt = 'gt',\n  Gte = 'gte',\n  Lt = 'lt',\n  Lte = 'lte',\n  Like = 'like',\n  Ilike = 'ilike',\n  In = 'in',\n  Nin = 'nin',\n  IsNull = 'is_null',\n  IsNotNull = 'is_not_null',\n}\n\n// ============================================\n// Cursor Configuration\n// ============================================\n\n/**\n * Configuration for cursor-based pagination.\n */\nexport interface CursorConfig {\n  /** The field to use for cursor-based pagination (e.g., 'id', 'created_at') */\n  field: string;\n  /** Sort direction for the cursor field */\n  direction: Direction;\n}\n\n/**\n * Per-table cursor configuration overrides.\n */\nexport interface TableCursorConfig {\n  [tableName: string]: CursorConfig;\n}\n\n// ============================================\n// Monitoring Configuration\n// ============================================\n\n/**\n * Configuration for the monitoring feature (Telescope).\n */\nexport interface MonitoringOptions {\n  /** Storage backend for monitoring data */\n  storage: TelescopeStorage;\n  /** Patterns to ignore when recording requests (supports wildcards) */\n  ignorePatterns?: string[];\n  /** Whether to record request/response bodies (default: true) */\n  recordBody?: boolean;\n  /** Maximum body size to record in bytes (default: 64KB) */\n  maxBodySize?: number;\n  /** Hours after which to prune old entries */\n  pruneAfterHours?: number;\n}\n\n// ============================================\n// Data Browser Configuration\n// ============================================\n\n/**\n * Configuration for the data browser feature.\n */\nexport interface DataBrowserOptions<DB = unknown> {\n  /** Kysely database instance */\n  db: Kysely<DB>;\n  /** Default cursor configuration for all tables */\n  cursor: CursorConfig;\n  /** Per-table cursor overrides */\n  tableCursors?: TableCursorConfig;\n  /** Tables to exclude from browsing */\n  excludeTables?: string[];\n  /** Maximum rows per page (default: 50, max: 100) */\n  defaultPageSize?: number;\n  /** Whether to allow viewing of binary/blob columns (default: false) */\n  showBinaryColumns?: boolean;\n}\n\n// ============================================\n// Studio Configuration\n// ============================================\n\n/**\n * Configuration for the Studio dashboard.\n */\nexport interface StudioOptions<DB = unknown> {\n  /** Monitoring configuration */\n  monitoring: MonitoringOptions;\n  /** Data browser configuration */\n  data: DataBrowserOptions<DB>;\n  /** Dashboard path (default: '/__studio') */\n  path?: string;\n  /** Whether Studio is enabled (default: true) */\n  enabled?: boolean;\n}\n\n/**\n * Normalized Studio options with all defaults applied.\n */\nexport interface NormalizedStudioOptions<DB = unknown> {\n  monitoring: Required<MonitoringOptions>;\n  data: Required<DataBrowserOptions<DB>>;\n  path: string;\n  enabled: boolean;\n}\n\n// ============================================\n// Table Introspection Types\n// ============================================\n\n/**\n * Generic column type classification.\n */\nexport type ColumnType =\n  | 'string'\n  | 'number'\n  | 'boolean'\n  | 'date'\n  | 'datetime'\n  | 'json'\n  | 'binary'\n  | 'uuid'\n  | 'unknown';\n\n/**\n * Information about a database column.\n */\nexport interface ColumnInfo {\n  /** Column name */\n  name: string;\n  /** Generic column type */\n  type: ColumnType;\n  /** Raw database type (e.g., 'varchar', 'int4') */\n  rawType: string;\n  /** Whether the column allows NULL values */\n  nullable: boolean;\n  /** Whether this column is part of the primary key */\n  isPrimaryKey: boolean;\n  /** Whether this column is a foreign key */\n  isForeignKey: boolean;\n  /** Referenced table if foreign key */\n  foreignKeyTable?: string;\n  /** Referenced column if foreign key */\n  foreignKeyColumn?: string;\n  /** Default value expression */\n  defaultValue?: string;\n}\n\n/**\n * Information about a database table.\n */\nexport interface TableInfo {\n  /** Table name */\n  name: string;\n  /** Schema name (e.g., 'public') */\n  schema: string;\n  /** List of columns */\n  columns: ColumnInfo[];\n  /** Primary key column names */\n  primaryKey: string[];\n  /** Estimated row count (if available) */\n  estimatedRowCount?: number;\n}\n\n/**\n * Complete schema information.\n */\nexport interface SchemaInfo {\n  /** List of tables */\n  tables: TableInfo[];\n  /** When the schema was last introspected */\n  updatedAt: Date;\n}\n\n// ============================================\n// Query Types\n// ============================================\n\n/**\n * A single filter condition.\n */\nexport interface FilterCondition {\n  /** Column to filter on */\n  column: string;\n  /** Filter operator */\n  operator: FilterOperator;\n  /** Value to compare against (optional for IsNull/IsNotNull operators) */\n  value?: unknown;\n}\n\n/**\n * Sort configuration for a column.\n */\nexport interface SortConfig {\n  /** Column to sort by */\n  column: string;\n  /** Sort direction */\n  direction: Direction;\n}\n\n/**\n * Options for querying table data.\n */\nexport interface QueryOptions {\n  /** Table to query */\n  table: string;\n  /** Filter conditions */\n  filters?: FilterCondition[];\n  /** Sort configuration */\n  sort?: SortConfig[];\n  /** Cursor for pagination */\n  cursor?: string | null;\n  /** Number of rows per page */\n  pageSize?: number;\n  /** Pagination direction */\n  direction?: 'next' | 'prev';\n}\n\n/**\n * Result of a paginated query.\n */\nexport interface QueryResult<T = Record<string, unknown>> {\n  /** Retrieved rows */\n  rows: T[];\n  /** Whether there are more rows */\n  hasMore: boolean;\n  /** Cursor for next page */\n  nextCursor: string | null;\n  /** Cursor for previous page */\n  prevCursor: string | null;\n  /** Estimated total row count */\n  totalEstimate?: number;\n}\n\n// ============================================\n// WebSocket Events\n// ============================================\n\n/**\n * Types of events broadcast via WebSocket.\n */\nexport type StudioEventType =\n  | 'request'\n  | 'exception'\n  | 'log'\n  | 'stats'\n  | 'connected'\n  | 'schema_updated';\n\n/**\n * A WebSocket event payload.\n */\nexport interface StudioEvent<T = unknown> {\n  /** Event type */\n  type: StudioEventType;\n  /** Event payload */\n  payload: T;\n  /** Event timestamp */\n  timestamp: number;\n}\n"],"mappings":";;;;;AAUA,IAAY,kDAAL;AACL;AACA;;AACD;;;;AAKD,IAAY,4DAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@geekmidas/studio",
+  "version": "0.0.1",
+  "description": "Unified development tools dashboard with database browser and request monitoring",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "import": "./dist/data/index.mjs",
+      "require": "./dist/data/index.cjs"
+    },
+    "./server/hono": {
+      "types": "./dist/server/hono.d.ts",
+      "import": "./dist/server/hono.mjs",
+      "require": "./dist/server/hono.cjs"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geekmidas/toolbox"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "nanoid": "~5.1.5",
+    "@geekmidas/telescope": "0.0.1",
+    "@geekmidas/db": "0.1.0"
+  },
+  "peerDependencies": {
+    "hono": "^4.0.0",
+    "kysely": "^0.28.0"
+  },
+  "peerDependenciesMeta": {
+    "hono": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/pg": "~8.16.0",
+    "hono": "^4.7.0",
+    "kysely": "~0.28.2",
+    "pg": "~8.16.3"
+  },
+  "scripts": {
+    "build:ui": "pnpm --filter @geekmidas/studio-ui build && tsx ../ui/scripts/embed-ui.ts dist/ui src/ui-assets.ts"
+  }
+}

package/src/Studio.ts

@@ -0,0 +1,318 @@
+import { Telescope } from '@geekmidas/telescope';
+import { DataBrowser } from './data/DataBrowser';
+import type {
+  NormalizedStudioOptions,
+  StudioEvent,
+  StudioOptions,
+} from './types';
+
+/**
+ * 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 },
+ *   },
+ * });
+ * ```
+ */
+export class Studio<DB = unknown> {
+  private telescope: Telescope;
+  private dataBrowser: DataBrowser<DB>;
+  private options: NormalizedStudioOptions<DB>;
+  private wsClients = new Set<WebSocket>();
+
+  constructor(options: StudioOptions<DB>) {
+    this.options = this.normalizeOptions(options);
+
+    // Initialize Telescope internally
+    this.telescope = new Telescope({
+      storage: this.options.monitoring.storage,
+      enabled: this.options.enabled,
+      path: `${this.options.path}/monitoring`,
+      recordBody: this.options.monitoring.recordBody,
+      maxBodySize: this.options.monitoring.maxBodySize,
+      ignorePatterns: [
+        ...this.options.monitoring.ignorePatterns,
+        `${this.options.path}/*`, // Ignore Studio's own routes
+      ],
+      pruneAfterHours: this.options.monitoring.pruneAfterHours,
+    });
+
+    // Initialize DataBrowser
+    this.dataBrowser = new DataBrowser(this.options.data);
+  }
+
+  // ============================================
+  // Public API - Configuration
+  // ============================================
+
+  /**
+   * Get the Studio dashboard path.
+   */
+  get path(): string {
+    return this.options.path;
+  }
+
+  /**
+   * Check if Studio is enabled.
+   */
+  get enabled(): boolean {
+    return this.options.enabled;
+  }
+
+  /**
+   * Get the data browser instance.
+   */
+  get data(): DataBrowser<DB> {
+    return this.dataBrowser;
+  }
+
+  /**
+   * Check if body recording is enabled for monitoring.
+   */
+  get recordBody(): boolean {
+    return this.options.monitoring.recordBody;
+  }
+
+  /**
+   * Get max body size for monitoring.
+   */
+  get maxBodySize(): number {
+    return this.options.monitoring.maxBodySize;
+  }
+
+  // ============================================
+  // Public API - Monitoring (delegated to Telescope)
+  // ============================================
+
+  /**
+   * Record a request entry.
+   */
+  async recordRequest(
+    entry: Parameters<Telescope['recordRequest']>[0],
+  ): Promise<string> {
+    return this.telescope.recordRequest(entry);
+  }
+
+  /**
+   * Record log entries in batch.
+   */
+  async log(entries: Parameters<Telescope['log']>[0]): Promise<void> {
+    return this.telescope.log(entries);
+  }
+
+  /**
+   * Log a debug message.
+   */
+  async debug(
+    message: string,
+    context?: Record<string, unknown>,
+    requestId?: string,
+  ): Promise<void> {
+    return this.telescope.debug(message, context, requestId);
+  }
+
+  /**
+   * Log an info message.
+   */
+  async info(
+    message: string,
+    context?: Record<string, unknown>,
+    requestId?: string,
+  ): Promise<void> {
+    return this.telescope.info(message, context, requestId);
+  }
+
+  /**
+   * Log a warning message.
+   */
+  async warn(
+    message: string,
+    context?: Record<string, unknown>,
+    requestId?: string,
+  ): Promise<void> {
+    return this.telescope.warn(message, context, requestId);
+  }
+
+  /**
+   * Log an error message.
+   */
+  async error(
+    message: string,
+    context?: Record<string, unknown>,
+    requestId?: string,
+  ): Promise<void> {
+    return this.telescope.error(message, context, requestId);
+  }
+
+  /**
+   * Record an exception.
+   */
+  async exception(error: Error, requestId?: string): Promise<void> {
+    return this.telescope.exception(error, requestId);
+  }
+
+  /**
+   * Get requests from storage.
+   */
+  async getRequests(
+    options?: Parameters<Telescope['getRequests']>[0],
+  ): ReturnType<Telescope['getRequests']> {
+    return this.telescope.getRequests(options);
+  }
+
+  /**
+   * Get a single request by ID.
+   */
+  async getRequest(id: string): ReturnType<Telescope['getRequest']> {
+    return this.telescope.getRequest(id);
+  }
+
+  /**
+   * Get exceptions from storage.
+   */
+  async getExceptions(
+    options?: Parameters<Telescope['getExceptions']>[0],
+  ): ReturnType<Telescope['getExceptions']> {
+    return this.telescope.getExceptions(options);
+  }
+
+  /**
+   * Get a single exception by ID.
+   */
+  async getException(id: string): ReturnType<Telescope['getException']> {
+    return this.telescope.getException(id);
+  }
+
+  /**
+   * Get logs from storage.
+   */
+  async getLogs(
+    options?: Parameters<Telescope['getLogs']>[0],
+  ): ReturnType<Telescope['getLogs']> {
+    return this.telescope.getLogs(options);
+  }
+
+  /**
+   * Get storage statistics.
+   */
+  async getStats(): ReturnType<Telescope['getStats']> {
+    return this.telescope.getStats();
+  }
+
+  // ============================================
+  // Public API - WebSocket
+  // ============================================
+
+  /**
+   * Add a WebSocket client for real-time updates.
+   */
+  addWsClient(ws: WebSocket): void {
+    this.wsClients.add(ws);
+    // Also add to Telescope for monitoring events
+    this.telescope.addWsClient(ws);
+  }
+
+  /**
+   * Remove a WebSocket client.
+   */
+  removeWsClient(ws: WebSocket): void {
+    this.wsClients.delete(ws);
+    this.telescope.removeWsClient(ws);
+  }
+
+  /**
+   * Broadcast an event to all connected WebSocket clients.
+   */
+  broadcast(event: StudioEvent): void {
+    const data = JSON.stringify(event);
+    for (const client of this.wsClients) {
+      try {
+        client.send(data);
+      } catch {
+        this.wsClients.delete(client);
+      }
+    }
+  }
+
+  // ============================================
+  // Public API - Lifecycle
+  // ============================================
+
+  /**
+   * Check if a path should be ignored for request recording.
+   */
+  shouldIgnore(path: string): boolean {
+    // Ignore Studio's own routes
+    if (path.startsWith(this.options.path)) {
+      return true;
+    }
+    return this.telescope.shouldIgnore(path);
+  }
+
+  /**
+   * Manually prune old monitoring entries.
+   */
+  async prune(olderThan: Date): Promise<number> {
+    return this.telescope.prune(olderThan);
+  }
+
+  /**
+   * Clean up resources.
+   */
+  destroy(): void {
+    this.telescope.destroy();
+    this.wsClients.clear();
+  }
+
+  // ============================================
+  // Private Methods
+  // ============================================
+
+  private normalizeOptions(
+    options: StudioOptions<DB>,
+  ): NormalizedStudioOptions<DB> {
+    const path = options.path ?? '/__studio';
+
+    return {
+      monitoring: {
+        storage: options.monitoring.storage,
+        ignorePatterns: options.monitoring.ignorePatterns ?? [],
+        recordBody: options.monitoring.recordBody ?? true,
+        maxBodySize: options.monitoring.maxBodySize ?? 64 * 1024,
+        pruneAfterHours: options.monitoring.pruneAfterHours,
+      },
+      data: {
+        db: options.data.db,
+        cursor: options.data.cursor,
+        tableCursors: options.data.tableCursors ?? {},
+        excludeTables: options.data.excludeTables ?? [
+          // Kysely
+          'kysely_migration',
+          'kysely_migration_lock',
+          // Prisma
+          '_prisma_migrations',
+          // Rails/Knex
+          'schema_migrations',
+          // Generic
+          '_migrations',
+          'migrations',
+        ],
+        defaultPageSize: Math.min(options.data.defaultPageSize ?? 50, 100),
+        showBinaryColumns: options.data.showBinaryColumns ?? false,
+      },
+      path,
+      enabled: options.enabled ?? true,
+    };
+  }
+}

package/src/data/DataBrowser.ts

@@ -0,0 +1,166 @@
+import type { Kysely, SelectQueryBuilder } from 'kysely';
+import {
+  type CursorConfig,
+  type DataBrowserOptions,
+  Direction,
+  type QueryOptions,
+  type QueryResult,
+  type SchemaInfo,
+  type TableInfo,
+} from '../types';
+import { applyFilters, applySorting } from './filtering';
+import { introspectSchema } from './introspection';
+import { decodeCursor, encodeCursor } from './pagination';
+
+/**
+ * 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 });
+ * ```
+ */
+export class DataBrowser<DB = unknown> {
+  private db: Kysely<DB>;
+  private options: Required<DataBrowserOptions<DB>>;
+  private schemaCache: SchemaInfo | null = null;
+  private schemaCacheExpiry = 0;
+  private readonly CACHE_TTL_MS = 60 * 1000; // 1 minute
+
+  constructor(options: Required<DataBrowserOptions<DB>>) {
+    this.db = options.db;
+    this.options = options;
+  }
+
+  // ============================================
+  // Schema Introspection
+  // ============================================
+
+  /**
+   * Get the database schema information.
+   * Results are cached for 1 minute.
+   *
+   * @param forceRefresh - Force a refresh of the cache
+   */
+  async getSchema(forceRefresh = false): Promise<SchemaInfo> {
+    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: string): Promise<TableInfo | null> {
+    const schema = await this.getSchema();
+    return schema.tables.find((t) => t.name === tableName) ?? null;
+  }
+
+  // ============================================
+  // Data Querying
+  // ============================================
+
+  /**
+   * Query table data with pagination, filtering, and sorting.
+   */
+  async query(options: QueryOptions): Promise<QueryResult> {
+    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,
+    );
+
+    // Build base query selecting all columns
+    let query = this.db
+      .selectFrom(options.table as any)
+      .selectAll() as SelectQueryBuilder<any, any, any>;
+
+    // Apply filters if provided
+    if (options.filters && options.filters.length > 0) {
+      query = applyFilters(query, options.filters, tableInfo);
+    }
+
+    // Apply sorting if provided, otherwise use cursor field
+    if (options.sort && options.sort.length > 0) {
+      query = applySorting(query, options.sort, tableInfo);
+    } else {
+      query = query.orderBy(cursorConfig.field as any, cursorConfig.direction);
+    }
+
+    // Handle cursor-based pagination
+    if (options.cursor) {
+      const cursorValue = decodeCursor(options.cursor);
+      const operator = cursorConfig.direction === Direction.Asc ? '>' : '<';
+      query = query.where(cursorConfig.field as any, operator, cursorValue);
+    }
+
+    // Fetch one extra row to determine if there are more results
+    const rows = await query.limit(pageSize + 1).execute();
+
+    const hasMore = rows.length > pageSize;
+    const resultRows = hasMore ? rows.slice(0, pageSize) : rows;
+
+    // Generate cursors
+    let nextCursor: string | null = null;
+    let prevCursor: string | null = null;
+
+    if (hasMore && resultRows.length > 0) {
+      const lastRow = resultRows[resultRows.length - 1];
+      nextCursor = encodeCursor(lastRow[cursorConfig.field]);
+    }
+
+    // For prev cursor, we need to know if there are previous results
+    // This would require a separate query, so we'll only set it if there's an input cursor
+    if (options.cursor && resultRows.length > 0) {
+      const firstRow = resultRows[0];
+      prevCursor = encodeCursor(firstRow[cursorConfig.field]);
+    }
+
+    return {
+      rows: resultRows,
+      hasMore,
+      nextCursor,
+      prevCursor,
+    };
+  }
+
+  // ============================================
+  // Configuration Access
+  // ============================================
+
+  /**
+   * Get the cursor configuration for a table.
+   * Returns the table-specific config if defined, otherwise the default.
+   */
+  getCursorConfig(tableName: string): CursorConfig {
+    return this.options.tableCursors[tableName] ?? this.options.cursor;
+  }
+
+  /**
+   * Get the underlying Kysely database instance.
+   */
+  get database(): Kysely<DB> {
+    return this.db;
+  }
+}