ultimate-notion / ultimate-notion / 28282725302

push

github

Adding the Data Source API from Notion API version 2025-09-03 (#178)

* Add an initial CLAUDE.md

* docs: Add detailed migration plan for Notion API 2025-09-03

- Document conceptual changes (database -> datasource terminology)
- Define full-word naming convention (no abbreviations)
- Detail 7-phase migration plan with code examples
- List all files requiring changes (316 occurrences across 24 files)
- Add risk assessment and effort estimates
- Include often-overlooked items (errors, mentions, exports)

🤖 Generated with [Claude Code](https://claude.ai/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* build: Upgrade notion-client to ~=2.7.0

Upgrade to notion-sdk-py 2.7.0 which supports Notion API version
2025-09-03 with the new datasource concept.

Key changes in notion-sdk-py 2.7.0:
- New DataSourcesEndpoint with retrieve, query, create, update methods
- DatabasesEndpoint.query moved to DataSourcesEndpoint.query
- Databases now represent containers for multiple data sources

🤖 Generated with [Claude Code](https://claude.ai/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat(obj_api): Add DataSource class and DataSourcesEndpoint for API 2025-09-03

Phase 2 of the Notion API 2025-09-03 migration:

Low-level obj_api changes:
- Add DataSource class (formerly Database functionality)
- Add DataSourceRef and MentionDataSource in objects.py
- Add ChildDataSource block type
- Create DataSourcesEndpoint with create, retrieve, update, delete, query
- Update DatabasesEndpoint (now container concept, removed query)
- Update PropertyRelation to use data_source_id as primary key
- Rename DBQueryBuilder to DataSourceQueryBuilder
- Rename DBSort to DataSourceSort, DBQuery to DataSourceQuery
- Update SearchQueryBuilder with datasource_only filter

The high-level API (Phase 3) still references the old Database concept
and will be updated in a subsequent commit.

🤖 Generated with [Claude Code](https://claude.ai/claude-code)

Co-Authored-By... (continued)

297 of 517 new or added lines in 18 files covered. (57.45%)

4551 of 7746 relevant lines covered (58.75%)

4.01 hits per line