@geekmidas/studio 0.0.1

package/dist/DataBrowser-c-Gs6PZB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataBrowser-c-Gs6PZB.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  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":";;;;;;AAaA,SAAgB,eACdA,QACAC,YACoC;CAEpC,MAAMC,oBAAsD;EAC1D,QAAQ;GACNC,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;EAChB;EACD,QAAQ;GACNA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;EAChB;EACD,SAAS;GACPA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;EAChB;EACD,MAAM;GACJA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;EAChB;EACD,UAAU;GACRA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;EAChB;EACD,MAAM;GACJA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;EAChB;EACD,MAAM,CAACA,6BAAe,QAAQA,6BAAe,SAAU;EACvD,QAAQ,CAACA,6BAAe,QAAQA,6BAAe,SAAU;EACzD,SAAS;GACPA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;GACfA,6BAAe;EAChB;CACF;CAED,MAAM,aACJ,kBAAkB,WAAW,SAAS,kBAAkB;AAE1D,MAAK,WAAW,SAAS,OAAO,SAAS,CACvC,QAAO;EACL,OAAO;EACP,QAAQ,YAAY,OAAO,SAAS,mCAAmC,WAAW,KAAK;CACxF;AAGH,QAAO,EAAE,OAAO,KAAM;AACvB;;;;AAKD,SAAgB,aACdC,OACAC,SACAC,WAC+B;CAC/B,IAAI,SAAS;AAEb,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,SAAS,UAAU,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,OAAO,OAAO;AAEtE,OAAK,OACH,OAAM,IAAI,OACP,UAAU,OAAO,OAAO,wBAAwB,UAAU,KAAK;EAIpE,MAAM,aAAa,eAAe,QAAQ,OAAO;AACjD,OAAK,WAAW,MACd,OAAM,IAAI,MAAM,WAAW;AAG7B,WAAS,qBAAqB,QAAQ,OAAO;CAC9C;AAED,QAAO;AACR;AAED,SAAS,qBACPF,OACAJ,QAC+B;CAC/B,MAAM,EAAE,QAAQ,UAAU,OAAO,GAAG;AAEpC,SAAQ,UAAR;EACE,KAAKG,6BAAe,GAClB,QAAO,MAAM,MAAM,QAAe,KAAK,MAAM;EAC/C,KAAKA,6BAAe,IAClB,QAAO,MAAM,MAAM,QAAe,MAAM,MAAM;EAChD,KAAKA,6BAAe,GAClB,QAAO,MAAM,MAAM,QAAe,KAAK,MAAM;EAC/C,KAAKA,6BAAe,IAClB,QAAO,MAAM,MAAM,QAAe,MAAM,MAAM;EAChD,KAAKA,6BAAe,GAClB,QAAO,MAAM,MAAM,QAAe,KAAK,MAAM;EAC/C,KAAKA,6BAAe,IAClB,QAAO,MAAM,MAAM,QAAe,MAAM,MAAM;EAChD,KAAKA,6BAAe,KAClB,QAAO,MAAM,MAAM,QAAe,QAAQ,MAAM;EAClD,KAAKA,6BAAe,MAClB,QAAO,MAAM,MAAM,QAAe,SAAS,MAAM;EACnD,KAAKA,6BAAe,GAClB,QAAO,MAAM,MAAM,QAAe,MAAM,MAAe;EACzD,KAAKA,6BAAe,IAClB,QAAO,MAAM,MAAM,QAAe,UAAU,MAAe;EAC7D,KAAKA,6BAAe,OAClB,QAAO,MAAM,MAAM,QAAe,MAAM,KAAK;EAC/C,KAAKA,6BAAe,UAClB,QAAO,MAAM,MAAM,QAAe,UAAU,KAAK;EACnD,QACE,OAAM,IAAI,OAAO,2BAA2B,SAAS;CACxD;AACF;;;;AAKD,SAAgB,aACdC,OACAG,OACAD,WAC+B;CAC/B,IAAI,SAAS;AAEb,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,UAAU,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO;AAEpE,OAAK,OACH,OAAM,IAAI,OACP,UAAU,KAAK,OAAO,wBAAwB,UAAU,KAAK;AAIlE,WAAS,OAAO,QACd,KAAK,QACL,KAAK,cAAcE,wBAAU,MAAM,QAAQ,OAC5C;CACF;AAED,QAAO;AACR;;;;;;;;ACvLD,eAAsB,iBACpBC,IACAC,eACqB;CAErB,MAAM,sBACJ,cAAc,SAAS,IACnB,cAAc,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,KAAK,GACnD;CAEN,MAAM,eAAe;;;;;;;QAOf,cAAc,SAAS,KAAK,yBAAyB,oBAAoB,KAAK,GAAG;;;CAIvF,MAAM,eAAe,MAAM,GAAG,aAAa;EACzC,KAAK;EACL,YAAY;CACb,EAAQ;CAET,MAAMC,SAAsB,CAAE;AAE9B,MAAK,MAAM,OAAO,aAAa,MAAe;EAE5C,MAAM,YAAY,IAAI,cAAc,IAAI;EACxC,MAAM,cAAc,IAAI,gBAAgB,IAAI;EAC5C,MAAM,YAAY,MAAM,gBAAgB,IAAI,WAAW,YAAY;AACnE,SAAO,KAAK,UAAU;CACvB;AAED,QAAO;EACL;EACA,2BAAW,IAAI;CAChB;AACF;;;;AAKD,eAAsB,gBACpBF,IACAG,WACA,SAAS,UACW;CAEpB,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;CAwBtB,MAAM,gBAAgB,MAAM,GAAG,aAAa;EAC1C,KAAK;EACL,YAAY,CAAC,WAAW,MAAO;CAChC,EAAQ;CAGT,MAAM,WAAW;;;;;;;;;;;;;;;;CAiBjB,MAAM,WAAW,MAAM,GAAG,aAAa;EACrC,KAAK;EACL,YAAY,CAAC,WAAW,MAAO;CAChC,EAAQ;CAET,MAAM,8BAAc,IAAI;AACxB,MAAK,MAAM,OAAO,SAAS,MAAe;EAExC,MAAM,UAAU,IAAI,eAAe,IAAI;AACvC,cAAY,IAAI,SAAS;GACvB,OAAO,IAAI,iBAAiB,IAAI;GAChC,QAAQ,IAAI,kBAAkB,IAAI;EACnC,EAAC;CACH;CAED,MAAMC,UAAwB,AAAC,cAAc,KAAe,IAAI,CAAC,QAAQ;EAEvE,MAAM,UAAU,IAAI,eAAe,IAAI;EACvC,MAAM,UAAU,IAAI,YAAY,IAAI;EACpC,MAAM,aAAa,IAAI,eAAe,IAAI;EAC1C,MAAM,eAAe,IAAI,kBAAkB,IAAI;EAC/C,MAAM,gBAAgB,IAAI,kBAAkB,IAAI;EAEhD,MAAM,KAAK,YAAY,IAAI,QAAQ;AACnC,SAAO;GACL,MAAM;GACN,MAAM,gBAAgB,QAAQ;GAC9B,SAAS;GACT,UAAU,eAAe;GACX;GACd,gBAAgB;GAChB,iBAAiB,IAAI;GACrB,kBAAkB,IAAI;GACtB,cAAc;EACf;CACF,EAAC;CAEF,MAAM,aAAa,QAAQ,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK;CAG3E,MAAM,cAAc;;;;;CAMpB,IAAIC;AACJ,KAAI;EACF,MAAM,cAAc,MAAM,GAAG,aAAa;GACxC,KAAK;GACL,YAAY,CAAC,SAAU;EACxB,EAAQ;AACT,MAAI,YAAY,KAAK,SAAS,GAAG;GAC/B,MAAM,WAAY,YAAY,KAAK,GAAW;AAC9C,uBAAoB,WAAW,IAAI,OAAO,SAAS;EACpD;CACF,QAAO,CAEP;AAED,QAAO;EACL,MAAM;EACN;EACA;EACA;EACA;CACD;AACF;;;;AAKD,SAAS,gBAAgBC,SAA6B;CACpD,MAAMC,UAAsC;EAE1C,SAAS;EACT,MAAM;EACN,MAAM;EACN,MAAM;EACN,QAAQ;EAGR,MAAM;EACN,MAAM;EACN,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;EACR,WAAW;EAGX,MAAM;EAGN,MAAM;EACN,WAAW;EACX,aAAa;EACb,MAAM;EACN,QAAQ;EAGR,MAAM;EACN,OAAO;EAGP,OAAO;EAGP,MAAM;CACP;AAED,QAAO,QAAQ,YAAY;AAC5B;;;;;;;;;;;ACnND,SAAgB,aAAaC,OAAwB;CACnD,MAAM,UAAU;EACd,GAAG,iBAAiB,OAAO,MAAM,aAAa,GAAG;EACjD,GAAG,iBAAiB,OAAO,gBAAgB;CAC5C;AACD,QAAO,OAAO,KAAK,KAAK,UAAU,QAAQ,CAAC,CAAC,SAAS,YAAY;AAClE;;;;AAKD,SAAgB,aAAaC,QAAyB;AACpD,KAAI;EACF,MAAM,OAAO,OAAO,KAAK,QAAQ,YAAY,CAAC,SAAS,QAAQ;EAC/D,MAAM,UAAU,KAAK,MAAM,KAAK;AAEhC,MAAI,QAAQ,MAAM,OAChB,QAAO,IAAI,KAAK,QAAQ;AAG1B,SAAO,QAAQ;CAChB,QAAO;AACN,QAAM,IAAI,MAAM;CACjB;AACF;;;;;;;;;;;;;;;;;;ACJD,IAAa,cAAb,MAAuC;CACrC,AAAQ;CACR,AAAQ;CACR,AAAQ,cAAiC;CACzC,AAAQ,oBAAoB;CAC5B,AAAiB,eAAe,KAAK;CAErC,YAAYC,SAA2C;AACrD,OAAK,KAAK,QAAQ;AAClB,OAAK,UAAU;CAChB;;;;;;;CAYD,MAAM,UAAU,eAAe,OAA4B;EACzD,MAAM,MAAM,KAAK,KAAK;AAEtB,OAAK,gBAAgB,KAAK,eAAe,MAAM,KAAK,kBAClD,QAAO,KAAK;EAGd,MAAM,SAAS,MAAM,iBAAiB,KAAK,IAAI,KAAK,QAAQ,cAAc;AAE1E,OAAK,cAAc;AACnB,OAAK,oBAAoB,MAAM,KAAK;AAEpC,SAAO;CACR;;;;CAKD,MAAM,aAAaC,WAA8C;EAC/D,MAAM,SAAS,MAAM,KAAK,WAAW;AACrC,SAAO,OAAO,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,UAAU,IAAI;CAC3D;;;;CASD,MAAM,MAAMC,SAA6C;EACvD,MAAM,YAAY,MAAM,KAAK,aAAa,QAAQ,MAAM;AAExD,OAAK,UACH,OAAM,IAAI,OAAO,SAAS,QAAQ,MAAM;EAG1C,MAAM,eAAe,KAAK,gBAAgB,QAAQ,MAAM;EACxD,MAAM,WAAW,KAAK,IACpB,QAAQ,YAAY,KAAK,QAAQ,iBACjC,IACD;EAGD,IAAI,QAAQ,KAAK,GACd,WAAW,QAAQ,MAAa,CAChC,WAAW;AAGd,MAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,EAC9C,SAAQ,aAAa,OAAO,QAAQ,SAAS,UAAU;AAIzD,MAAI,QAAQ,QAAQ,QAAQ,KAAK,SAAS,EACxC,SAAQ,aAAa,OAAO,QAAQ,MAAM,UAAU;MAEpD,SAAQ,MAAM,QAAQ,aAAa,OAAc,aAAa,UAAU;AAI1E,MAAI,QAAQ,QAAQ;GAClB,MAAM,cAAc,aAAa,QAAQ,OAAO;GAChD,MAAM,WAAW,aAAa,cAAcC,wBAAU,MAAM,MAAM;AAClE,WAAQ,MAAM,MAAM,aAAa,OAAc,UAAU,YAAY;EACtE;EAGD,MAAM,OAAO,MAAM,MAAM,MAAM,WAAW,EAAE,CAAC,SAAS;EAEtD,MAAM,UAAU,KAAK,SAAS;EAC9B,MAAM,aAAa,UAAU,KAAK,MAAM,GAAG,SAAS,GAAG;EAGvD,IAAIC,aAA4B;EAChC,IAAIC,aAA4B;AAEhC,MAAI,WAAW,WAAW,SAAS,GAAG;GACpC,MAAM,UAAU,WAAW,WAAW,SAAS;AAC/C,gBAAa,aAAa,QAAQ,aAAa,OAAO;EACvD;AAID,MAAI,QAAQ,UAAU,WAAW,SAAS,GAAG;GAC3C,MAAM,WAAW,WAAW;AAC5B,gBAAa,aAAa,SAAS,aAAa,OAAO;EACxD;AAED,SAAO;GACL,MAAM;GACN;GACA;GACA;EACD;CACF;;;;;CAUD,gBAAgBJ,WAAiC;AAC/C,SAAO,KAAK,QAAQ,aAAa,cAAc,KAAK,QAAQ;CAC7D;;;;CAKD,IAAI,WAAuB;AACzB,SAAO,KAAK;CACb;AACF"}

package/dist/DataBrowser-hGwiTffZ.d.cts

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

package/dist/chunk-CUT6urMc.cjs

@@ -0,0 +1,30 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/data/index.cjs

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

package/dist/data/index.d.cts

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

package/dist/data/index.d.mts

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

package/dist/data/index.mjs

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

package/dist/index.cjs

@@ -0,0 +1,239 @@
+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 __geekmidas_telescope_storage_memory = require_chunk.__toESM(require("@geekmidas/telescope/storage/memory"));
+
+//#region src/Studio.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 },
+*   },
+* });
+* ```
+*/
+var Studio = class {
+	telescope;
+	dataBrowser;
+	options;
+	wsClients = /* @__PURE__ */ new Set();
+	constructor(options) {
+		this.options = this.normalizeOptions(options);
+		this.telescope = new __geekmidas_telescope.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}/*`],
+			pruneAfterHours: this.options.monitoring.pruneAfterHours
+		});
+		this.dataBrowser = new require_DataBrowser.DataBrowser(this.options.data);
+	}
+	/**
+	* Get the Studio dashboard path.
+	*/
+	get path() {
+		return this.options.path;
+	}
+	/**
+	* Check if Studio is enabled.
+	*/
+	get enabled() {
+		return this.options.enabled;
+	}
+	/**
+	* Get the data browser instance.
+	*/
+	get data() {
+		return this.dataBrowser;
+	}
+	/**
+	* Check if body recording is enabled for monitoring.
+	*/
+	get recordBody() {
+		return this.options.monitoring.recordBody;
+	}
+	/**
+	* Get max body size for monitoring.
+	*/
+	get maxBodySize() {
+		return this.options.monitoring.maxBodySize;
+	}
+	/**
+	* Record a request entry.
+	*/
+	async recordRequest(entry) {
+		return this.telescope.recordRequest(entry);
+	}
+	/**
+	* Record log entries in batch.
+	*/
+	async log(entries) {
+		return this.telescope.log(entries);
+	}
+	/**
+	* Log a debug message.
+	*/
+	async debug(message, context, requestId) {
+		return this.telescope.debug(message, context, requestId);
+	}
+	/**
+	* Log an info message.
+	*/
+	async info(message, context, requestId) {
+		return this.telescope.info(message, context, requestId);
+	}
+	/**
+	* Log a warning message.
+	*/
+	async warn(message, context, requestId) {
+		return this.telescope.warn(message, context, requestId);
+	}
+	/**
+	* Log an error message.
+	*/
+	async error(message, context, requestId) {
+		return this.telescope.error(message, context, requestId);
+	}
+	/**
+	* Record an exception.
+	*/
+	async exception(error, requestId) {
+		return this.telescope.exception(error, requestId);
+	}
+	/**
+	* Get requests from storage.
+	*/
+	async getRequests(options) {
+		return this.telescope.getRequests(options);
+	}
+	/**
+	* Get a single request by ID.
+	*/
+	async getRequest(id) {
+		return this.telescope.getRequest(id);
+	}
+	/**
+	* Get exceptions from storage.
+	*/
+	async getExceptions(options) {
+		return this.telescope.getExceptions(options);
+	}
+	/**
+	* Get a single exception by ID.
+	*/
+	async getException(id) {
+		return this.telescope.getException(id);
+	}
+	/**
+	* Get logs from storage.
+	*/
+	async getLogs(options) {
+		return this.telescope.getLogs(options);
+	}
+	/**
+	* Get storage statistics.
+	*/
+	async getStats() {
+		return this.telescope.getStats();
+	}
+	/**
+	* Add a WebSocket client for real-time updates.
+	*/
+	addWsClient(ws) {
+		this.wsClients.add(ws);
+		this.telescope.addWsClient(ws);
+	}
+	/**
+	* Remove a WebSocket client.
+	*/
+	removeWsClient(ws) {
+		this.wsClients.delete(ws);
+		this.telescope.removeWsClient(ws);
+	}
+	/**
+	* Broadcast an event to all connected WebSocket clients.
+	*/
+	broadcast(event) {
+		const data = JSON.stringify(event);
+		for (const client of this.wsClients) try {
+			client.send(data);
+		} catch {
+			this.wsClients.delete(client);
+		}
+	}
+	/**
+	* Check if a path should be ignored for request recording.
+	*/
+	shouldIgnore(path) {
+		if (path.startsWith(this.options.path)) return true;
+		return this.telescope.shouldIgnore(path);
+	}
+	/**
+	* Manually prune old monitoring entries.
+	*/
+	async prune(olderThan) {
+		return this.telescope.prune(olderThan);
+	}
+	/**
+	* Clean up resources.
+	*/
+	destroy() {
+		this.telescope.destroy();
+		this.wsClients.clear();
+	}
+	normalizeOptions(options) {
+		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_migration",
+					"kysely_migration_lock",
+					"_prisma_migrations",
+					"schema_migrations",
+					"_migrations",
+					"migrations"
+				],
+				defaultPageSize: Math.min(options.data.defaultPageSize ?? 50, 100),
+				showBinaryColumns: options.data.showBinaryColumns ?? false
+			},
+			path,
+			enabled: options.enabled ?? true
+		};
+	}
+};
+
+//#endregion
+exports.Direction = require_types.Direction;
+exports.FilterOperator = require_types.FilterOperator;
+Object.defineProperty(exports, 'InMemoryMonitoringStorage', {
+  enumerable: true,
+  get: function () {
+    return __geekmidas_telescope_storage_memory.InMemoryStorage;
+  }
+});
+exports.Studio = Studio;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

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