refactor: standardize datasource terminology and restructure packages

- Renamed query-related classes for consistency with Notion API 2025-09-03:
  * DatabaseQueryBuilder → DataSourceQueryBuilder
  * databaseQuery() → dataSourceQuery()
  * DatabaseQueryRequest → DataSourceQueryRequest
  * DatabaseQueryResponse → DataSourceQueryResponse
  * DatabaseFilter → DataSourceFilter
  * DatabaseSort → DataSourceSort

- Separated package structure:
  * models/databases/ - Database container objects
  * models/datasources/ - Data source (table) objects and queries

- Updated all docstrings to use "data source" terminology
- Updated all imports across codebase automatically via IntelliJ refactoring

Rationale: In Notion API 2025-09-03, "database" refers to containers
(like folders) while "data source" refers to the actual tables you query.
This refactoring aligns our code with the API's terminology.

Author: Jonas Saabel

QUICKSTART.md

@@ -1,7 +1,5 @@
 # Quick Start Guide
 
-> **⚠️ WORK IN PROGRESS**: This documentation is being actively developed and may be incomplete or subject to change.
-
 Get started with the Kotlin Notion Client in under 5 minutes.
 
 ## Prerequisites

docs/README.md

@@ -1,7 +1,5 @@
 # Documentation Index
 
-> **⚠️ WORK IN PROGRESS**: This documentation is being actively developed and may be incomplete or subject to change.
-
 ## API Guides
 
 ### Core APIs

docs/data-sources.md

@@ -1,7 +1,5 @@
 # Data Sources API
 
-> **⚠️ WORK IN PROGRESS**: This documentation is being actively developed and may be incomplete or subject to change.
-
 > **📝 Example Validation**: ✅ All examples verified - validated against live Notion API (see `src/test/kotlin/examples/DataSourcesExamples.kt`)
 
 ## Overview
@@ -153,22 +151,21 @@ val updated = notion.dataSources.update("data-source-id") {
 
 ## Understanding Data Sources vs. Databases
 
-**In older API versions (pre-2025-09-03)**:
-- You would query a "database" to get pages
-- You would add pages to a "database"
-
-**In 2025-09-03**:
-- **Databases** are containers (like folders)
-- **Data sources** are the tables inside those containers
-- You query **data sources** to get pages
+**Important terminology in the 2025-09-03 API**:
+- **Databases** are containers (like folders) that hold data sources
+- **Data sources** are the actual tables with properties and rows
+- You query **data sources** to get pages (not databases)
 - You add pages to **data sources** (using `dataSourceId` as parent)
 
 ```kotlin
-// ❌ This was the old way:
-// notion.databases.query("database-id")
-
-// ✅ This is the new way:
+// ✅ Query a data source (table)
 notion.dataSources.query("data-source-id")
+
+// ✅ Create a page in a data source
+notion.pages.create {
+    parent.dataSource("data-source-id")
+    // ...
+}
 ```
 
 ## Common Patterns

docs/databases.md

@@ -1,7 +1,5 @@
 # Databases API
 
-> **⚠️ WORK IN PROGRESS**: This documentation is being actively developed and may be incomplete or subject to change.
-
 > **📝 Example Validation**: ✅ All examples verified - validated against live Notion API (see `src/test/kotlin/examples/DatabasesExamples.kt`)
 
 ## Overview
@@ -386,51 +384,6 @@ parent.block("block-id")
 parent.workspace()
 ```
 
-## Migration from Pre-2025-09-03
-
-If you're migrating from an older API version:
-
-**Old way (2022-06-28)**:
-```kotlin
-// Create database
-val db = notion.databases.create {
-    parent.page("...")
-    title("...")
-    properties { /* schema here */ }
-}
-
-// Query it directly
-val pages = notion.databases.query(db.id) {}
-
-// Create page in it
-notion.pages.create {
-    parent.database(db.id)  // database_id
-    // ...
-}
-```
-
-**New way (2025-09-03)**:
-```kotlin
-// Create database (similar but uses initialDataSource)
-val db = notion.databases.create {
-    parent.page("...")
-    title("...")
-    properties { /* schema here */ }  // Wrapped as initialDataSource
-}
-
-// Get data source ID first
-val dataSourceId = db.dataSources.first().id
-
-// Query the data source
-val pages = notion.dataSources.query(dataSourceId) {}
-
-// Create page in data source
-notion.pages.create {
-    parent.dataSource(dataSourceId)  // data_source_id
-    // ...
-}
-```
-
 ## Related APIs
 
 - **[Data Sources](data-sources.md)** - The tables within database containers (query, update schema)

docs/pages.md

@@ -1,7 +1,5 @@
 # Pages API
 
-> **⚠️ WORK IN PROGRESS**: This documentation is being actively developed and may be incomplete or subject to change.
-
 > **📝 Example Validation**: ✅ All examples verified - validated against live Notion API (see `src/test/kotlin/examples/PagesExamples.kt`)
 
 ## Overview

docs/pagination.md

@@ -144,7 +144,7 @@ val pages = notion.dataSources.query(dataSourceId) { /* query builder */ }
 // Flow (item-level) - returns Flow<Page>
 notion.dataSources.queryAsFlow(dataSourceId) { /* query builder */ }
 
-// Flow (page-level) - returns Flow<DatabaseQueryResponse>
+// Flow (page-level) - returns Flow<DataSourceQueryResponse>
 notion.dataSources.queryPagedFlow(dataSourceId) { /* query builder */ }
 ```
 

docs/rich-text-dsl.md

@@ -1,7 +1,5 @@
 # Rich Text DSL
 
-> **⚠️ WORK IN PROGRESS**: This documentation is being actively developed and may be incomplete or subject to change.
-
 ## Overview
 
 The Rich Text DSL provides an intuitive Kotlin builder for creating formatted text with annotations, mentions, links, and equations.

docs/search.md

@@ -19,7 +19,7 @@ suspend fun search(query: String): SearchResponse
 ## Quick Start
 
 ```kotlin
-val notion = NotionClient(NotionConfig(apiToken = "your_token"))
+val notion = NotionClient("your_token")
 
 // Simple text search
 val results = notion.search.search("meeting notes")

docs/users.md

@@ -49,7 +49,7 @@ enum class UserType {
 Always available, doesn't require special capabilities:
 
 ```kotlin
-val notion = NotionClient(NotionConfig(apiToken = "your-secret-token"))
+val notion = NotionClient("your-secret-token")
 
 val botUser = notion.users.getCurrentUser()
 println("Bot name: ${botUser.name}")
@@ -151,7 +151,7 @@ when (user.type) {
 
 ```kotlin
 suspend fun initializeNotionClient(token: String): NotionClient {
-    val client = NotionClient(NotionConfig(apiToken = token))
+    val client = NotionClient(token)
 
     try {
         val botUser = client.users.getCurrentUser()